Amaurydev

.github/workflows/pytest.yml

@@ -0,0 +1,46 @@
+name: Tests Python
+
+on:
+  push:
+    branches: ["**"]
+
+jobs:
+  tests:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      # 1) Récupération du code
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Configure Git identity
+        run: |
+          git config --global user.name  "CI Bot"
+          git config --global user.email "[email protected]"
+
+      # 2) Installation de Python
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11.0"
+
+      # 3) Mettre en cache le dossier pip (accélère les exécutions)
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('pyproject.toml', 'setup.cfg', 'setup.py') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      # 4) Installer les dépendances
+      - name: Install dependencies
+        run: pip install -e .
+
+      # 5) Lancer les tests
+      - name: Run pytest
+        run: pytest

.gitignore

@@ -0,0 +1,196 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+.DS_Store

README.md

@@ -10,20 +10,24 @@ You will implement a subset of Git commands, both low-level (plumbing) and user-
 
 ## 🛠 Plumbing Commands
 
-### `git hash-object <file>`
+### `git hash-object [-w] <file>`
+
 - **Creates a blob** object from file content and writes its SHA-1 to stdout.
 - ❌ Reject directories or missing files.
 
 ### `git cat-file -t|-p <oid>`
+
 - `-t`: Print object type.
 - `-p`: Pretty-print blob/tree/commit content.
 - ❌ Reject invalid OIDs or missing options.
 
 ### `git write-tree`
+
 - Create a tree object from the staging area.
 - Writes SHA-1 of the tree to stdout.
 
 ### `git commit-tree <tree_sha> -m "msg" [-p <parent>]`
+
 - Creates a commit object pointing to a tree (and parent commit if any) and writes its oid to stdout
 - Requires `-m` message.
 - ❌ No annotated tags.
@@ -33,55 +37,68 @@ You will implement a subset of Git commands, both low-level (plumbing) and user-
 ## 🧑‍💻 Porcelain Commands
 
 ### `git init [<dir>]`
+
 - Initializes a Git repository in the given directory.
 - Create .git/objects, .git/refs/heads, HEAD, and minimal config
 
 ### `git add <file>…`
+
 - Adds files to the staging area (not directories).
 - ❌ No `-p`, no wildcards.
 
 ### `git rm <file>…`
+
 - Removes a file from working directory and index.
 
 ### `git commit -m "msg"`
+
 - Runs `write-tree`, creates a commit with HEAD as parent.
 - ❌ No editor or message prompt.
 
 ### `git status`
+
 - Shows staged and unstaged changes.
 
 ### `git checkout [-b] <branch|sha>`
+
 - Switch to existing commit or branch.
 - `-b <branch>` creates a new branch.
 - Change HEAD, update working dir, check for conflicts
 
 ### `git reset [--soft|--mixed|--hard] <sha>`
+
 - `--soft`: move HEAD
 - `--mixed`: + reset index
 - `--hard`: + reset working directory
 - ❌ No file-specific reset.
 
 ### `git log`
+
 - Print commit history from HEAD (one-line summary ok).
 
 ### `git ls-files`
+
 - List all files in the index.
 
 ### `git ls-tree <tree_sha>`
+
 - List contents of a tree object.
 
 ### `git rev-parse <ref>`
+
 - Convert ref/branch/HEAD into SHA-1.
 - ❌ No complex selectors
 
 ### `git show-ref`
+
 - List all refs and their hashes.
 
 ---
 
 ## 🧠 Advanced Feature: Merge Support
 
 ### `git merge <branch|sha>`
+
 - Perform 3-way merge and create a merge commit with 2 parents.
 - On conflict: insert `<<<<<<<`, `=======`, `>>>>>>>` markers into file(s).
 - ❌ No rebase, squash, or fast-forward-only merges.