{"id":28188834,"url":"https://github.com/toro-nicolas/setting_up","last_synced_at":"2025-07-13T15:39:34.741Z","repository":{"id":245267865,"uuid":"751021395","full_name":"toro-nicolas/setting_up","owner":"toro-nicolas","description":"An algorithmic project in C consists in finding the largest square on a map as quickly as possible.","archived":false,"fork":false,"pushed_at":"2024-06-20T10:05:30.000Z","size":54,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-06-21T02:35:44.654Z","etag":null,"topics":["algorythm","bsq","c","epitech","optimization","setting-up"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toro-nicolas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-31T19:25:39.000Z","updated_at":"2024-06-21T02:38:11.283Z","dependencies_parsed_at":"2024-06-21T02:38:10.882Z","dependency_job_id":"4324b5bd-557f-46fa-9ad8-d3414f0929b7","html_url":"https://github.com/toro-nicolas/setting_up","commit_stats":null,"previous_names":["toro-nicolas/setting_up"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toro-nicolas%2Fsetting_up","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toro-nicolas%2Fsetting_up/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toro-nicolas%2Fsetting_up/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toro-nicolas%2Fsetting_up/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toro-nicolas","download_url":"https://codeload.github.com/toro-nicolas/setting_up/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254501542,"owners_count":22081532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["algorythm","bsq","c","epitech","optimization","setting-up"],"created_at":"2025-05-16T09:12:06.026Z","updated_at":"2025-05-16T09:12:07.019Z","avatar_url":"https://github.com/toro-nicolas.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Setting Up 📏\n\n## Table of contents 📑\n- [Description](https://github.com/toro-nicolas/setting-up/blob/main/README.md#description-)\n- [Usage](https://github.com/toro-nicolas/setting-up/blob/main/README.md#usage-%EF%B8%8F)\n- [Result](https://github.com/toro-nicolas/setting-up/blob/main/README.md#result-)\n- [Compilation](https://github.com/toro-nicolas/setting-up/blob/main/README.md#compilation-%EF%B8%8F)\n- [Code mandatory](https://github.com/toro-nicolas/setting-up/blob/main/README.md#code-mandatory-)\n- [What's next ?](https://github.com/toro-nicolas/setting-up/blob/main/README.md#whats-next--)\n- [Contributors](https://github.com/toro-nicolas/setting-up/blob/main/README.md#contributors-)\n\n\n## Description 📝\nThe **Setting Up** is a project carried out in **solo**, during our **1st year** in [**EPITECH**](https://www.epitech.eu/) Grand Ecole program.  \nIts purpose is to create in [**C**](https://en.wikipedia.org/wiki/C_(programming_language)) a program to **find the largest square in a zone**.\n\n\n## Usage ⚔️\nYou can run the setting-up like this :\n- Map resolution :\n```sh\n./setting-up exemple_files/maps/intermediate_map_100_100\n```\n- Map generation and resolution :\n```sh\n./setting_up 10000 \"......o..\"\n```\n\n\n## Result 🚩\nThe result of this project is a **perfect Setting Up**.  \nIf you discover a **problem** or an **error**, don't hesitate to **create an issue** and **report it** to us as soon as possible.\n\n\n### my.epitech.eu result\n\n| Category                                | Percentage | Numbers of tests |  Crash   |\n|-----------------------------------------|:----------:|:----------------:|:--------:|\n| Algorithm app. - Generating column      |    100%    |       3/3        |    No    |\n| Algorithm app. - Generating edges       |    100%    |       2/2        |    No    |\n| Algorithm app. - Generating line        |    100%    |       3/3        |    No    |\n| Algorithm app. - Generating square      |    100%    |       3/3        |    No    |\n| Algorithm app. - Opening column         |    100%    |       3/3        |    No    |\n| Algorithm app. - Opening edges          |    100%    |       2/2        |    No    |\n| Algorithm app. - Opening line           |    100%    |       3/3        |    No    |\n| Algorithm app. - Opening rectangle      |    100%    |       3/3        |    No    |\n| Basics                                  |    100%    |       6/6        |    No    |\n| Data structure - Generating             |    100%    |       3/3        |    No    |\n| Data structure - Opening                |    100%    |       3/3        |    No    |\n| Optimization - Generating 100 to 500    |    100%    |       4/4        |    No    |\n| Optimization - Generating 1000 to 2000  |    100%    |       2/2        |    No    |\n| Optimization - Generating 5000 to 10000 |    100%    |       2/2        |    No    |\n| Optimization - Opening 100 to 500       |    100%    |       4/4        |    No    |\n| Optimization - Opening 1000 to 2000     |    100%    |       2/2        |    No    |\n| Optimization - Opening 5000 to 10000    |    100%    |       2/2        |    No    |\n| Parsing - Opening                       |    100%    |       3/3        |    No    |\n| Robustness - Generating empty map       |    100%    |       4/4        |    No    |\n| Robustness - Generating filled map      |    100%    |       2/2        |    No    |\n| Robustness - Generating valid board     |    100%    |       5/5        |    No    |\n| Robustness - Opening empty map          |    100%    |       6/6        |    No    |\n| Robustness - Opening filled map         |    100%    |       6/6        |    No    |\n| Robustness - Opening valid file         |    100%    |       5/5        |    No    |\n| **Results**                             |  **100%**  |    **81/81**     |  **No**  |\n\n\n### Tests and code coverage\n**Unit tests** were performed using [criterion](https://criterion.readthedocs.io/en/master/intro.html).  \nIn this project, **only** the **library code is covered**.\nUnit tests are still to be performed, but a large part of the code is already covered.\n\nYou can compile the project and run the unit tests with this command :\n```sh\nmake tests_run\n```\n\n\n## Compilation 🛠️\nYou can compile the project with this command :\n```sh\nmake\n```\n\nIf you want clean the project, you can run this command :\n```sh\nmake fclean\n```\n\nYou can clean and compile the project with ```make re```.\n\nYou can compile the unit tests with this command :\n```sh\nmake unit_tests\n```\n\n\n## Code mandatory 📦\n- You'll need to create a branch where you'll push your code. Once you've completed your tasks on this branch, we'll work together to merge it and check that everything works.\n- Every function you add must be code-style.\n- Before merging, you'll need to check that all unit tests pass by running ```make tests_run```.\n- Each commit will contain ```[+]``` or ```[-]``` or ```[~]``` followed by a message\n    - ```[+]``` : Add feature\n    - ```[-]``` : Delete feature\n    - ```[~]``` : Edit feature\n\n**Of course, in exceptional cases, we may depart from these rules.**\n\n\n## What's next ? 🚀\n- Add help section\n- Add a graphical visualization\n- Add github actions\n- Improve the memory management\n- Add a documentation for each function\n- Add unit tests on each piece of code\n\n\n## Contributors 👤\nThis project was carried out alone by [**Nicolas TORO**](https://github.com/toro-nicolas).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoro-nicolas%2Fsetting_up","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoro-nicolas%2Fsetting_up","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoro-nicolas%2Fsetting_up/lists"}