base on An easy to use testing framework for the 42 projects # Francinette ## :exclamation: This repo is long abandoned. It's probably way out of date, and does not work on newer systems. Please seek other alternatives. :exclamation: # Also: write your own tests!! # An easy to use testing framework for the 42 projects. Use `francinette` or `paco` inside a project folder to run it. Currently has tests for: `libft`, `ft_printf`, `get_next_line`, `minitalk` and `pipex`. `Francinette` is only tested and confirmed to work on MacOS on non ARM chips. Some testers may work on Linux and ARM, but I give no guaranties of any test working or even compiling. ## :exclamation: Important note: If you have little to no experience programming, I highly highly highly recommend that you write your own tests first. For example, for `ft_split` try to write a main that tests that your code works in most cases. It is also useful to think about corner cases, like what should it return if the string is `""` or `" "` or `"word"`. Don't rely just on `francinette` or other tests. ### :warning: Write your own tests, It's a very essential part of programming. :warning: ## Table of Contents 1. [Purpose](#purpose) 2. [Install](#install) 3. [Update](#update) 4. [Running](#Running) 5. [Uninstall](#uninstall) 6. [FAQ](#faq) 7. [Acknowledgments](#acknowledgments) ## Purpose: This is designed to function as a kind of `moulinette` that you can execute in local. That means that by executing `francinette` it will check `norminette`, compile the code and execute the tests. You can use it as a local test battery, to test your code. #### Example execution:  ## Install: Francinette has an automatic installer. Copy the line bellow to your console and execute it. It will automatically download the repo, create the necessary folders and alias, and install a python virtual environment dedicated to running this tool. In linux it will also download and install the necessary packages for it to run. It needs admin permission to do that. ``` bash -c "$(curl -fsSL https://raw.github.com/xicodomingues/francinette/master/bin/install.sh)" ``` The francinette folder will be under your `$HOME` directory (`/Users/<your_username>/`) ## Update: Normally francinette will prompt you when there is a new version, and you can then update it. You can also force it from francinette itself: ``` ~ $> francinette -u # Forces francinette to update ``` If the above does not work you can also execute the command bellow: ``` bash -c "$(curl -fsSL https://raw.github.com/xicodomingues/francinette/master/bin/update.sh)" ``` ## Running: If you are on a root of a project, `francinette` should be able to tell which project it is and execute the corresponding tests. You can also use the shorter version of the command: `paco` To see all the available options execute `paco -h` ``` /C00 $> francinette # Execute the tests for C00 /C00/ex00 $> francinette # Execute only the tests for ex00 in C00 /libft $> francinette # Execute the tests for libft ~ $> francinette -h # Shows the help message libft $> paco memset isalpha memcpy # Executes only the specified tests ``` The name of the folder is not important. What is important is that you have a `Makefile` that contains the name of the project (for example `libft`), or the expected delivery files. If there is no `Makefile` or delivery files are not present `francinette` will not know what project to execute. ``` ~ $> francinette [email protected]/intra-uuid-234 ``` This command clones the git repository present in `[email protected]/intra-uuid-234` into the current folder and executes the corresponding tests All the files are copied to the folder `~/francinette/temp/<project>`. In here is where the norminette is checked, the code compiled and the tests executed. Normally you do not need to access this directory for anything. But if you run into unexpected problems, this is where the magic happens. Log files can be found in: `~/francinette/logs` ## Uninstall To uninstall `francinette` delete the `francinette` folder. It should be located under your `$HOME` directory (`/Users/<your_username>/` or `/home/<your_username>/`) You also need to remove the automatically created aliases. For that open your `~/.zshrc` file and delete the lines: ``` alias francinette="$HOME"/francinette/tester.sh alias paco="$HOME"/francinette/tester.sh ``` ## FAQ If you have any questions you can create an issue or reach me on slack under `fsoares-` #### I'm more advanced than the tests you have available. When are you adding more tests? When I reach that exercise or project. You can also add them. For that you need to create a `ProjectTester.py` file. and change the function `guess_project` in `main.py` to recognize the project. #### This test that you put up is incorrect! Please create a new github issue, indicating for what exercise which test fails, and a description of what you think is wrong. You can also try to fix it and create a pull request for that change! #### What is NULL_CHECK in strict? This is a way to test if you are protecting your `malloc` calls. This means that it will make every call to `malloc` fail and return `NULL` instead of a newly allocated pointer. You need to take this into account when programming so that you don't get segmentation faults. #### The tester for get_next_line is giving me Timeout errors This is something that is very common. My tester will get slower for every malloc that you do, so if you do a lot of mallocs it will probably timeout. If it timeouts while in the strict mode, don't worry, this one is very very inefficient. I have plans to change some things to not make it so horrible, but for the time being, don't worry if it gives a Timeout. ## Troubleshooting #### I've installed francinette, but when I try to execute it I get the message: `command not found: francinette` In the install script I try to set two alias to for `francinette`: `francinette` and `paco`. If you are in MacOS I do that by adding two lines to the `.zshrc` file, and to `.bashrc` in linux. If by some chance you are using other shell, or for some other reason it does not work, You can try to set the aliases yourself, by adding: ``` alias francinette="$HOME"/francinette/tester.sh alias paco="$HOME"/francinette/tester.sh ``` Now it should work. If it does not, don't be afraid to contact me. ## Acknowledgments * To 42 for providing me this opportunity * To [Tripouille](https://github.com/Tripouille) for [libftTester](https://github.com/Tripouille/libftTester), [gnlTester](https://github.com/Tripouille/gnlTester) and [printfTester](https://github.com/Tripouille/printfTester) * To [jtoty](https://github.com/jtoty) and [y3ll0w42](https://github.com/y3ll0w42) for [libft-war-machine](https://github.com/y3ll0w42/libft-war-machine) * To [alelievr](https://github.com/alelievr) for [libft-unit-test](https://github.com/alelievr/libft-unit-test) and [printf-unit-test](https://github.com/alelievr/printf-unit-test) * To [cacharle](https://github.com/cacharle) for [ft_printf_test](https://github.com/cacharle/ft_printf_test) * To [ombhd](https://github.com/ombhd) for [Cleaner_42](https://github.com/ombhd/Cleaner_42) * To [arsalas](https://github.com/arsalas) for the help in the minitalk tester * To [vfurmane](https://github.com/vfurmane) for [pipex-tester](https://github.com/vfurmane/pipex-tester) * To [gmarcha](https://github.com/gmarcha) for [pipexMedic](https://github.com/gmarcha/pipexMedic) ", Assign "at most 3 tags" to the expected json: {"id":"11990","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"