Perses is a language-agnostic program reducer to minimize a program with respect to a set of constraints. It takes as input a program to reduce, and a test script which specifies the constraints. It outputs a minimized program which still satisfies the constraints specified in the test script. Compared to Delta Debugging and Hierarchical Delta Debugging, Perses leverages the syntax information in the Antlr grammar, and prunes the search space by avoiding generating syntactically invalid programs.
Currently, Perses supports reduction for the following programming languages:
Support for other languages is coming soon.
There are three ways to obtain Perses.
Download a prebuilt release JAR file from our release page, for example,
wget https://github.com/perses-project/perses/releases/download/v1.4/perses_deploy.jar
java -jar perses_deploy.jar [options]? --test-script <test-script.sh> --input-file <program file>
Clone the repo and build Perses from the source.
git clone https://github.com/perses-project/perses.git
cd perses
bazel build //src/org/perses:perses_deploy.jar
java -jar bazel-bin/src/org/perses/perses_deploy.jar [options]? --test-script <test-script.sh> --input-file <program file>
If you want to always use the trunk version of Perses, perses-trunk automatically downloads and builds the latest version.
NOTE: Bazel is the prerequisite to run perses-trunk successfully.
wget https://raw.githubusercontent.com/perses-project/perses/master/scripts/perses-trunk chmod +x perses-trunk ./perses-trunk [options]? --test-script <test-script.sh> --input-file <program file>
--test-script
--input-file
Check all available command line arguments
java -jar perses_deploy.jar --help
GNU General Public License 3.
This repository contains the implementations of the techniques proposed in the following papers.
@inproceedings{perses,
author = {Sun, Chengnian and Li, Yuanbo and Zhang, Qirun and Gu, Tianxiao and Su, Zhendong},
title = {Perses: Syntax-Guided Program Reduction},
year = {2018},
publisher = {Association for Computing Machinery},
doi = {10.1145/3180155.3180236},
booktitle = {Proceedings of the 40th International Conference on Software Engineering},
pages = {361–371},
}
@article{vulcan,
title={Pushing the Limit of 1-Minimality of Language-Agnostic Program Reduction},
author={Xu, Zhenyang and Tian, Yongqiang and Zhang, Mengxiao and Zhao, Gaosen and Jiang, Yu and Sun, Chengnian},
journal={Proceedings of the ACM on Programming Languages},
volume={7},
number={OOPSLA1},
pages={636--664},
year={2023},
publisher={ACM New York, NY, USA}
}
@inproceedings{ppr,
title={PPR: Pairwise Program Reduction},
author={Zhang, Mengxiao and Xu, Zhenyang and Tian, Yongqiang and Jiang, Yu and Sun, Chengnian},
booktitle={Proceedings of the 31st ACM Joint European Software Engineering Conference and Symposium on the Foundations of Software Engineering},
pages={338--349},
year={2023}
}
@article{perses-caching,
title={On the Caching Schemes to Speed Up Program Reduction},
author={Tian, Yongqiang and Zhang, Xueyan and Dong, Yiwen and Xu, Zhenyang and Zhang, Mengxiao and Jiang, Yu and Cheung, Shing-Chi and Sun, Chengnian},
journal={ACM Transactions on Software Engineering and Methodology},
volume={33},
number={1},
pages={1--30},
year={2023},
publisher={ACM New York, NY, USA}
}