c-bertran / 42-exam-shell

Examshell will allow you to practice to be perfectly ready for the 42 exams
GNU General Public License v3.0
53 stars 3 forks source link
42 42-school exam exam-02 exam-03 exam-04 exam-05 exam-06 examrank examshell


Practice like a boss

Examshell will allow you to practice to be perfectly ready for the 42 exams

Workflow Status License Repo size Language count

⚠️ Pool exams and new exams are being added, as well as the possibility of practicing Javascript and Typescript. ⚠️

This one will have the same behaviors as the real examshell:

Some options have been added:

Exams

The following exams are available natively:

Setup

Download the latest version of the software. This one is available for MacOS and Linux

How to use

Launch your favorite command prompt, and simply run the program:

./examshell

If a rights problem occurs during the execution, make the following command:

chmod +x examshell && ./examshell

Arguments

Args Definition
-C or --custom Create the folder that can contain the exams created by other people, and also the configuration file
-N or --new Launch the cli to create the boilerplate for a new exam

Dependencies

Examshell is dependent on several external software. Under Linux, the installation can be done by the software itself at startup. However under MacOS you will have to install them yourself. Here is the list with their versions to help you Software Version
bash >= 3.2
clang >= 10.0
git >= 2.10
valgrind >= 3.10

Config examshell

You can configure the behavior of examshell via the config.json file in the exams folder. It has the following options:

{
    "checkUpdate": true,
    "checkLib": true,
    "signature": true,
    "exam": "exam_02",
    "lang": "en_US",
    "options": {
        "doom": false,
        "infinite": false,
    }
}

Create or install custom exam

Starting with version 0.3.0 examshell allows you to create your own exams in a simple and concise way. If you want to share your exam, don't hesitate to open a issue with the exam label so that it can be added to a list.

Install a custom exam

  1. Create a exams directory in the root of the application, or launch ./examshell -C
  2. Paste custom exam in this directory
  3. Start application, if exam is correct, it will appear in the selection list

Create a custom exam

You can create custom exam by adding new exercises: Contributing

Contributor

Thanks to you and your help, examshell is getting better every day. I would like to thank those people who gave their time 🧡

Filoji B-ki pulgamecanica

Disclaimer

The exams available are based as closely as possible on the official exams at 42, however there may be some differences. If you find a significant difference, don't hesitate to open an issue.

License

Examshell Copyright (C) 2022 - ...  Clément Bertrand

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.