[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/coder3101/testcaser/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","coder3101","reponame","testcaser","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-01-28T19:51:39.088334Z","description","TestCaser is a header-only light-weight test case maker library written in C++.","is_private","last_updated","2019-03-11T00:10:04.677212Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",22340,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# TestCaser\n\n---\n\n| Platform | CI Status |\n| -------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| OSX | [![OSX Build Status](http://badges.herokuapp.com/travis/coder3101/testcaser?env=BADGE=osx&label=build&branch=master)](https://travis-ci.org/coder3101/testcaser) |\n| Linux | [![Linux Build Status](http://badges.herokuapp.com/travis/coder3101/testcaser?env=BADGE=linux&label=build&branch=master)](https://travis-ci.org/coder3101/testcaser) |\n| Windows | [![Build status](https://ci.appveyor.com/api/projects/status/kkggh13ohwi6w6qi/branch/master?svg=true)](https://ci.appveyor.com/project/coder3101/testcaser/branch/master)\n\n\n\n[![CocoapodsMetrics](https://img.shields.io/badge/docs-100%25-yellow.svg)](https://coder3101.github.io/testcaser)\n[![COVERITY](https://scan.coverity.com/projects/17653/badge.svg)](https://scan.coverity.com/projects/coder3101-testcaser) \n[![LICENSE](https://img.shields.io/hexpm/l/plug.svg)](https://github.com/coder3101/testcaser/blob/master/LICENSE) \n[![RELEASE](https://img.shields.io/badge/release-v0.5.3--beta-orange.svg)](https://github.com/coder3101/testcaser/releases/tag/v0.5.3-beta)\n\n\nTestCaser is a header-only light-weight test case maker library written in C++. It is easy, flexible and powerful library that can generate testcases, run your program on those test cases and compare two program's output for the given test case files and lists down the input that causes a different output to be produced. These features can come in handy when you are stuck on some corner cases for a problem or when you want to check your program on valid random inputs. TestCaser has three submodules namely maker, integrator and comparator (comparator is not developed yet). Maker module is used to generate test cases. Integrator integrates a program to accept the test cases made by maker. Comparator compares two program's outputs for given inputs. We also offer command a compiled virtualjudge binary which can be installed along side of the library.\n\n---\n\n## Installation of Library\n\n*For Updating the Version You need to First Uninstall the previous version and reinstall the new version.*\n\n### For Linux and MACOS\n\nTestCaser is only available on github. You need to download it to your local machine to use it.\nRun this command from your preferred directory (say downloads) on command line\n\n```bash\nwget https://github.com/coder3101/testcaser/archive/v0.5.3-beta.zip && unzip v0.5.3-beta.zip && cd testcaser-0.5.3-beta\n```\n\nRunning the above command will download the testcaser respository unzip it and switch to that directory.\n\nThere is no need to Compile the Source code. It is Header only hence you only need to specify to compiler the path of the testcaser. By default C++ compilers look at `/usr/include/` or `/usr/local/include/` for includes in a program. So we need to move testcaser to that directory.\n\nWe provide two bash scripts along with the source code namely `install.sh` and `uninstall.sh` To install the testcaser on a your machine run the install script as a superuser.\n\nYou are invited to check the scripts before you run them.\n\n```bash\nsudo ./install.sh\n```\n\nType in your password and wait for the script to install the testcaser. You will be asked if you want to install `virtualjudge` as well. Depending upon the choice, script will install the requested components. \n\nIf you get any Error make sure that scripts are executable by running\n\n```bash\nsudo chmod +x install.sh && sudo chmod +x uninstall.sh\n```\n\nYou can also specify the location using -I flag of g++ or clang++.\n\n### For Windows\n\nDownload the sources in a zip format from [here](https://github.com/coder3101/testcaser/archive/v0.5.3-beta.zip) and unzip it at your preferred location. Since testcase is Header-only you can simply use `-I\\path\\to\\testcaser\\root` flag while compiling with any C++ compiler. Make sure you enforce `-std=c++11` as well.\n\n---\n\n## Using the Docker Image\n\nWe also offer Docker Container for testcaser. You use the file `Dockerfile` from this repository to build your own docker image of testcaser. You must have docker installed for this on your Host Machine.\n\nTo build the docker image run :\n\n```bash\ndocker build -t testcaser \n```\n\nIt will pull the required dependencies and build the testcaser image. It will download about 400 Megabytes of data and will occupy about 1.5GB of Disk Space.\n\n**If you do not want to build the complete image you can do `docker pull coder3101/testcaser`. All the Steps remain same**\n\n### Compiling\n\nOnce you have built the image, you can run it with :\n\n```bash\ndocker run -it -v \"$PWD\":/usr/src/app testcaser g++ \n```\n\n> `-v \"$PWD\":/usr/src/app` will work on UNIX. For Windows replace it with `-v \"%cd%\":/usr/src/app`. `g++ ./relative/path` is the file you want to compile which includes testcaser headers. It uses g++-7.4.0 for compiling. Additionally you can also pass other compiler flags if you wish. It will produce the output in the current working directory.\n\nTo run the executable :\n\n```bash\ndocker run -it -v \"$PWD\":/usr/src/app testcaser ./a.out\n```\n\n### Running Virtual Judge under Docker\n\nThe docker image you just build also include the virtualjudge binary.\n\nTo invoke virtualjudge binary run :\n\n```bash\ndocker run -it testcaser virtualjudge --version\n```\n\nIt will show the version of virtualjudge installed on the image.\n\n---\n\n## Writing your First TestCase\n\n```cpp\n#include \n\nusing testcaser::maker::TestCaseBuilder;\nusing testcaser::maker::types::RandomUnsignedInteger;\n\nint main() {\n TestCaseBuilder builder(\"./test.txt\");\n\n RandomUnsignedInteger<> a({1, 100000});\n RandomUnsignedInteger<> b({1, 100});\n RandomUnsignedInteger<> t({1, 10});\n\n auto tt = builder.add(t);\n builder.add_line();\n\n for (int p = 0; p < tt; p++) {\n builder.add(a);\n builder.add_space();\n builder.add(b);\n builder.add_line();\n }\n\n builder.finalize();\n\n return 0;\n}\n```\n\nIt generates a testcaser binary for the problem given below. Everytime you execute this binary it will generate a random-valued test case file.\n\n>> **Input Format**\n>> \n>> The first contains T denoting the number of testcase Each test case contains two space\n>> separated Integer A and B\n>>\n>> **Constraints**\n>>\n>> 1 <= A < 100000\n>>\n>> 1 <= B < 100\n>>\n>> 1 <= T < 10\n\nFor Code Explaination and more information. Read the docs [here](https://coder3101.github.io/testcaser)\n\n## Writing your First VirtualJudge\n\n```cpp\n#include \n\nusing testcaser::integrator::VirtualJudge;\n\nint main() {\n const std::string root = \"./testcaser/core/integrator/tests/\";\n VirtualJudge()\n .set_binary(root + \"program.out\")\n .set_input_file(root + \"input.txt\")\n .set_output_file(root + \"output2.txt\")\n .set_time_limit(5)\n .set_memory_limit(1024*25)\n .execute()\n .print_result();\n return 0;\n}\n```\n\nIt Generates a binary which when executed tests if the `program.out` runs before 5 seconds and under 25 MB memory on `input.txt`. It also creates a `output2.txt` file which contains\nthe output from the program. \n\nHere is a Sample Output that it will generate.\n```\n>>> Child Process created with pid 19398\n>>> Setting the time constraint to 5 seconds\n>>> Process will be killed if not returned before 5 second\n>>> Executing ./testcaser/core/integrator/tests/program.out on child process.\n>>> Completed the child process with exit code 0\n\n************** RESULTS ***************\nAllocted Virtual Memory : 25600 KB (25 MB)\nPhysical Memory Used : 3412 KB (3.33203 MB)\nVirtual Memory Used : 20364 KB (19.8867 MB)\nAllocated Time : 5 second(s)\nExecution Time : 0.112149 second(s)\nExit Code : 0\nRemark : Success. Ran under memory and time limit\n***************************************\n```\n\nFor Code Explaination and more information. Read the docs [here](https://coder3101.github.io/testcaser)\n\n## Installation of Binary\n\n### For Linux and MACOS\n\nIt can difficult at times to write a complete VirtualJudge Program, so we provide a pre-compiled virtual judge binary `virtualjudge` for you to quickly judge your programs. Once you run the install script it will install testcaser and asks you to install `virtualjudge`, if installed it can be invoked from command line.\n\n### For Windows\n\n~~You can install the VirtualJudge Binary by running `install.bat` and remove it by running `uninstall.bat` **Run them from the root of the testcaser** . It will set/unset the path of virtualbinary in your environment variable. So that you can use it from command line.~~ **Don't use those scripts. Check Issue Section**\n\n## Checking the Installation\n\nYou can check if virtual judge is correctly installed or not by running.\n\n```bash\nvirtualjudge --version\n```\n\nIt will show the version of testcaser upon which this virtualjudge was compiled.\n\nUsing virtualjudge is as easy as a cake. To run the judge you need to provide at least 2 arguments, a simple virtualjudge invocation will look like\n\n```bash\nvirtualjudge --program your_executable --input your_input_file.txt\n```\n\n`your_executable` is the path to a executable or the python script with `.py` extension.\n\n`your_input_file.txt` is the path of the file that contains the input for the program.\n\nYou can also set the time limit and memory limit for the judge as\n\n```bash\nvirtualjudge --program executable \\\n --input input.txt \\\n --output output.txt \\\n --time 5 \\\n --memory 256\n```\n\n`--time` takes value in seconds and `--memory` takes value in Megabytes (MB). \n\nFor More Information You can run `virtualjudge --help`.\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",3394733541,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",3893058,"full_size",548262946,"id",45442191,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:4c45e5fc3f0b60bf0139b3666895a17dbd7935eb5b0ab14a443c790dc21d3a6c","features","","last_pulled","2026-09-23T08:54:30.541129149Z","last_pushed","2019-03-11T00:10:05Z","os","linux","os_features","os_version","size","variant","2019-03-11T00:10:04.062504Z","last_updater","last_updater_username","media_type","latest","repository",6613362,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":11,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

coder3101/testcaser

Tags for coder3101/testcaser