KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

42-cli

★ 18 Open GitHub ↗

Interactive tester CLI for the 42 Common Core — subject compliance, libft tester, norminette.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 42-cli — the all-in-one 42 tester

### 🧪 An interactive terminal tester for the **École 42** Common Core & Piscine

Test your **libft**, **ft_printf**, **get_next_line** and **push_swap**, run **norminette**,
grade your **Python** projects with **flake8** & **mypy**, and sit randomized **practice exams** —
all from one beautiful menu.

[![Made for 42](https://img.shields.io/badge/made%20for-42-000000?style=for-the-badge)](https://42.fr)
[![Version](https://img.shields.io/badge/version-0.4.0-2188ff?style=for-the-badge)](https://github.com/brunogo25/42-cli/releases)
[![Node](https://img.shields.io/badge/node-%E2%89%A518-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org)
[![License: MIT](https://img.shields.io/badge/license-MIT-22c55e?style=for-the-badge)](https://raw.githubusercontent.com/brunogo25/42-cli/main/LICENSE)
 
[![Stars](https://img.shields.io/github/stars/brunogo25/42-cli?style=for-the-badge&color=f5b301)](https://github.com/brunogo25/42-cli/stargazers)
[![Issues](https://img.shields.io/github/issues/brunogo25/42-cli?style=for-the-badge)](https://github.com/brunogo25/42-cli/issues)
[![PRs welcome](https://img.shields.io/badge/PRs-welcome-ff69b4?style=for-the-badge)](https://github.com/brunogo25/42-cli/pulls)

</div>

---

```text
  ‹  [ Programming Fundamentals ]   Object Oriented Programming   Algorithmics  ›

Master C from the ground up: strings, memory, file I/O and algorithmic
  problem-solving — build the foundational tools every great programmer needs.

❯ Libft
    ft_printf
    get_next_line
    push_swap
    Exam Practice

← →  switch module   ·   ↑ ↓  choose   ·   Enter  select   ·   Esc  back
```

> **One install. Every Common Core test you need.** No more cloning ten different
> testers — `42-cli` bundles the libft tester, the ft_printf tester, the
> get_next_line tester, norminette, the Python project graders, and a full
> exam simulator behind a single command: **`42`**.

## 📑 Table of contents

- [Why 42-cli](#-why-42-cli)
- [Features](#-features)
- [Install](#-install)
- [Quick start](#-quick-start)
- [Modules & what gets tested](#-modules--what-gets-tested)
- [Exam Practice](#-exam-practice)
- [Achievements, languages & feedback](#-achievements-languages--feedback)
- [Requirements](#-requirements)
- [Updating & uninstalling](#-updating--uninstalling)
- [Contributing](#-contributing)
- [FAQ](#-faq)
- [License](#-license)

## 💡 Why 42-cli

If you're a **42 student** looking for a **42 tester** that *just works*, this is it.
Point it at a project folder and it auto-detects what you're building, runs the right
tests, checks the norm, and tells you — clearly — what passes and what doesn't.
And when you think you're ready, **Exam Practice** drops you into real exam conditions
so you don't get surprised by the moulinette.

## ✨ Features

- 🧪 **Bundled testers** — libft (all 42 functions, or pick specific ones), ft_printf, get_next_line (multiple `BUFFER_SIZE`s).
- 📏 **Norminette** — run the norm and combined norm + tests in one go.
- ✅ **Subject compliance** — checks your Makefile, headers and required files match the subject.
- 🐍 **Python graders** — behavioural tests for the seven OOP / data-engineering projects, plus **flake8** (style) and **mypy** (type hints).
- 📝 **Exam Practice** — randomized, auto-graded mock exams in **C and Python**, with selectable count and difficulty (1–4, ascending or fixed).
- 🧭 **Module navigator** — browse the cursus with a clean tab bar (`← →` between modules, `↑ ↓` inside).
- 🔍 **Auto-detection** — run it from inside a project folder and it figures out which project you're on.
- 🏆 **Achievements** — 50+ unlockables to keep the grind fun.
- 🌍 **Bilingual** — full **English** and **Français** UI.
- 💌 **In-CLI feedback** — found a bug or a false pass? Send it to the maintainer without leaving the terminal.
- 🔄 **Self-updating** — `42 update` pulls the latest version.

## 🚀 Install

```sh
curl -fsSL https://raw.githubusercontent.com/brunogo25/42-cli/main/install.sh | bash
```

Re-run the same command anytime to upgrade. Requires **Node.js 18+**.

<details>
<summary>Other ways to install</summary>

**With npm (from GitHub):**

```sh
npm install -g github:brunogo25/42-cli
```

**Clone & link manually:**

```sh
git clone https://github.com/brunogo25/42-cli.git ~/.42-cli
ln -s ~/.42-cli/bin/42.js ~/.local/bin/42
```

</details>

## 🕹️ Quick start

```sh
42
```

That's it. Navigate the menu, pick a module, pick a project. From inside a `libft`
(or `ft_printf`, `get_next_line`, …) directory the CLI auto-detects the project, so
you can also just `cd` into your repo and run `42`.

```sh
42 --version     # print the installed version
42 update        # upgrade to the latest release
42 --help        # show all commands
```

## 🧩 Modules & what gets tested

| Module | Projects covered | What it runs |
| --- | --- | --- |
| **Programming Fundamentals** (C) | `libft` · `ft_printf` · `get_next_line` · `push_swap` | function testers · norminette · subject compliance |
| **Object Oriented Programming** (Python) | Growing Code · Garden Guardian · Data Quest · Code Cultivation · Code Nexus · The Codex · Data Archivist | behavioural tests · flake8 · mypy |
| **Exam Practice** | C & Python | randomized, auto-graded mock exams |
| Systems & Network Admin · Algorithmics · AI · System & Network Programming · Web | — | 🚧 coming soon |

## 📝 Exam Practice

Each active module has its own **Exam Practice** — C for Programming Fundamentals,
Python for everything after. It works like the real thing:

1. **Choose** how many exercises (1–5) and the difficulty: **ascending** (easy → hard)
 or a **fixed level** (1–4).
2. The CLI picks random exercises and scaffolds a fresh `exam-<timestamp>/` folder,
 one subject per exercise.
3. **Solve them** in your editor.
4. **Grade** each one: C solutions are compiled with `-Wall -Wextra -Werror` and run
 against hidden test cases; Python solutions are executed and checked — and you can
 run **flake8** and **mypy** on them too.

No spoilers, no peeking — just like exam mode. 🔒

## 🏆 Achievements, languages & feedback

- **Achievements** — launch streaks, test milestones, exam runs, secret unlocks… 50+ in total.
- **Languages** — switch between 🇬🇧 English and 🇫🇷 Français anytime in Settings.
- **Feedback** — the `Feedback` menu lets you report a bug, a suggestion, or the dreaded
  *"the tester said PASS but I failed the moulinette"* case. It reaches the maintainer
  directly, and contributors get credited.

## ⚙️ Requirements

| Need | For |
| --- | --- |
| **Node.js 18+** | the CLI itself |
| **cc / gcc**, **norminette** | C testers & the C exam |
| **Python 3.10+** | Python project graders & the Python exam |
| **flake8**, **mypy** | Python style & type checks — `pip install flake8 mypy` |

The CLI degrades gracefully: missing optional tools are reported and skipped, never crash the run.

## 🔄 Updating & uninstalling

```sh
42 update          # or re-run the install command
```

```sh
rm -f ~/.local/bin/42 ~/.local/bin/42cli
rm -rf ~/.local/share/42-cli
```

## 🤝 Contributing

Bug reports, ideas and PRs are very welcome — this tester gets better because of the
community using it. Open an [issue](https://github.com/brunogo25/42-cli/issues), send a
PR, or just hit **Feedback** inside the CLI. Every accepted contribution earns you a spot
in the in-app **Contributors** list. 💙

> ⚠️ **Beta:** 42-cli is under active development. If a test result looks wrong, please
> report it via the in-CLI **Feedback** menu or open an issue — that's how we squash it fast.

## ❓ FAQ

<details>
<summary>Is this an official 42 tool?</summary>
No. It's a community-made, unofficial tester built by a 42 student to help other students. Always trust the official moulinette as the source of truth.
</details>

<details>
<summary>Does passing here mean I'll pass the moulinette?</summary>
It's a strong signal, not a guarantee. 42-cli mirrors the subjects as closely as possible, but only the official evaluation is final. If you pass here and fail there, please send feedback so the test can be fixed.
</details>

<details>
<summary>Which projects are supported right now?</summary>
libft, ft_printf, get_next_line and push_swap for C; the seven Python OOP / data-engineering projects; plus C & Python Exam Practice. More modules are on the roadmap.
</details>

## 📜 License

---

**Keywords:** 42 · 42 tester · 42 school · École 42 · Ecole 42 · 42 Common Core · 42 Piscine ·
Python Piscine · libft tester · ft_printf tester · get_next_line tester · push_swap ·
norminette · moulinette · flake8 · mypy · 42 exam · Exam Rank · 42cursus · 1337 · 42 Network

⭐ If this saved you time, consider starring the repo — it helps other 42 students find it.

</div>

42-cli

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README