chore: migrate to Ruff, deprecate .gitingest, and general code-quality sweep

* Pre-commit
  • Drop `black` + `darglint` hooks
  • Add `ruff-check` & `ruff-format` (astral-sh/ruff-pre-commit)
  • Swap `darglint` → `pydoclint` for doc-string lint/validation

* Dependencies
  • Remove `tomli`
  • Tighten `typing_extensions` pin; add `eval-type-backport`
  • `requirements-dev`: drop `black`, `djlint`, `pylint` (only used inside pre-commit virtualenv)

* Ignore handling
  • Deprecate `.gitingest` (TOML) → new `.gitingestignore` with git-wildmatch syntax
  • Delete `apply_gitingest_file`; reuse `_parse_ignore_file` shared with `.gitignore`

* Tooling / config
  • New `[tool.ruff]` section in `pyproject.toml`
  • Remove `[tool.black]`

* README
  • Refresh badges (PyPI, CI, Ruff, Discord, Trendshift)

* Codebase refactor
  • Enable `from __future__ import annotations`; add rich type hints throughout
  • Re-order function parameters and `__all__` exports for consistency
  • Move type-only imports under `if TYPE_CHECKING`
  • Extract CLI args to `TypedDict` `_CLIArgs`; form data to pydantic `QueryForm`
  • Deduplicate `cli.main` / `_async_main`
  • Split large blocks into helpers
  • Remove magic numbers → constants
  • Use `pathlib` over `os`; avoid `try/except` inside loops; no file-IO in async paths
  • Enforce kw-only args
  • Minor Ruff-driven clean-ups

* Bug fix
  • Remove silent logic bug in `notebook_utils._process_cell`

* Tests
  • Update fixtures & assertions

No functional API changes except the `.gitingestignore` addition & `.gitingest` deprecation.

Author: filipchristiansen

.pre-commit-config.yaml

@@ -38,11 +38,6 @@ repos:
       - id: absolufy-imports
         description: "Automatically convert relative imports to absolute. (Use `args: [--never]` to revert.)"
 
-  - repo: https://github.com/psf/black
-    rev: 25.1.0
-    hooks:
-      - id: black
-
   - repo: https://github.com/asottile/pyupgrade
     rev: v3.20.0
     hooks:
@@ -79,12 +74,18 @@ repos:
         description: "Lint markdown files."
         args: ["--disable=line-length"]
 
-  - repo: https://github.com/terrencepreilly/darglint
-    rev: v1.8.1
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.0
+    hooks:
+      - id: ruff-check
+      - id: ruff-format
+
+  - repo: https://github.com/jsh9/pydoclint
+    rev: 0.6.7
     hooks:
-      - id: darglint
-        name: darglint for source
-        args: [--docstring-style=numpy]
+      - id: pydoclint
+        name: pydoclint for source
+        args: [--style=numpy]
         files: ^src/
 
   - repo: https://github.com/pycqa/pylint
@@ -104,7 +105,6 @@ repos:
             slowapi,
             starlette>=0.40.0,
             tiktoken,
-            tomli,
             pathspec,
             uvicorn>=0.11.7,
           ]
@@ -124,7 +124,6 @@ repos:
             slowapi,
             starlette>=0.40.0,
             tiktoken,
-            tomli,
             pathspec,
             uvicorn>=0.11.7,
           ]

README.md

@@ -1,13 +1,16 @@
 # Gitingest
 
-[![Image](./docs/frontpage.png "Gitingest main page")](https://gitingest.com)
+[![Gitingest banner](./docs/frontpage.png)](https://gitingest.com)
 
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/cyclotruc/gitingest/blob/main/LICENSE)
-[![PyPI version](https://badge.fury.io/py/gitingest.svg)](https://badge.fury.io/py/gitingest)
-[![GitHub stars](https://img.shields.io/github/stars/cyclotruc/gitingest?style=social.svg)](https://github.com/cyclotruc/gitingest)
+[![PyPI](https://img.shields.io/pypi/v/gitingest.svg)](https://pypi.org/project/gitingest)
 [![Downloads](https://pepy.tech/badge/gitingest)](https://pepy.tech/project/gitingest)
+[![CI](https://github.com/cyclotruc/gitingest/workflows/CI/badge.svg)](https://github.com/cyclotruc/gitingest/actions)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License](https://img.shields.io/github/license/cyclotruc/gitingest.svg)](https://github.com/cyclotruc/gitingest/blob/main/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/cyclotruc/gitingest?style=social.svg)](https://github.com/cyclotruc/gitingest)
+[![Discord](https://img.shields.io/badge/Discord-Join_chat-%235865F2?logo=discord&logoColor=white)](https://discord.com/invite/zerRaGK9EC)
 
-[![Discord](https://dcbadge.limes.pink/api/server/https://discord.com/invite/zerRaGK9EC)](https://discord.com/invite/zerRaGK9EC)
+[![Trendshift badge](https://trendshift.io/api/badge/repositories/13519)](https://trendshift.io/repositories/13519)
 
 Turn any Git repository into a prompt-friendly text ingest for LLMs.
 

pyproject.toml

@@ -12,9 +12,8 @@ dependencies = [
     "slowapi",
     "starlette>=0.40.0",  # Vulnerable to https://osv.dev/vulnerability/GHSA-f96h-pmfr-66vw
     "tiktoken>=0.7.0",  # Support for o200k_base encoding
-    "tomli",
     "pathspec>=0.12.1",
-    "typing_extensions; python_version < '3.10'",
+    "typing_extensions>= 4.0.0; python_version < '3.10'",
     "uvicorn>=0.11.7",  # Vulnerable to https://osv.dev/vulnerability/PYSEC-2020-150
 ]
 
@@ -62,20 +61,46 @@ disable = [
     "fixme",
 ]
 
+[tool.ruff]
+line-length = 119
+fix = true
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [  # https://docs.astral.sh/ruff/rules/...
+    "D107", # undocumented-public-init
+    "FIX002", # line-contains-todo
+    "TD002", # missing-todo-author
+    "PLR0913", # too-many-arguments,
+
+    # TODO: fix the following issues:
+    "TD003", # missing-todo-link, TODO: add issue links
+    "T201", # print, TODO: replace with logging
+    "S108", # hardcoded-temp-file, TODO: replace with tempfile
+    "BLE001", # blind-except, TODO: replace with specific exceptions
+    "FAST003", # fast-api-unused-path-parameter, TODO: fix
+]
+per-file-ignores = { "tests/**/*.py" = ["S101"] } # Skip the “assert used” warning
+
+[tool.ruff.lint.pylint]
+max-returns = 10
+
+[tool.ruff.lint.isort]
+order-by-type = true
+case-sensitive = true
+
 [tool.pycln]
 all = true
 
+# TODO: Remove this once we figure out how to use ruff-isort
 [tool.isort]
 profile = "black"
 line_length = 119
 remove_redundant_aliases = true
-float_to_top = true
+float_to_top = true  # https://github.com/astral-sh/ruff/issues/6514
 order_by_type = true
 filter_files = true
 
-[tool.black]
-line-length = 119
-
 # Test configuration
 [tool.pytest.ini_options]
 pythonpath = ["src"]

requirements-dev.txt

@@ -1,8 +1,6 @@
 -r requirements.txt
-black
-djlint
+eval-type-backport
 pre-commit
-pylint
 pytest
 pytest-asyncio
 pytest-mock

requirements.txt

@@ -6,5 +6,4 @@ python-dotenv
 slowapi
 starlette>=0.40.0  # Vulnerable to https://osv.dev/vulnerability/GHSA-f96h-pmfr-66vw
 tiktoken>=0.7.0  # Support for o200k_base encoding
-tomli
 uvicorn>=0.11.7  # Vulnerable to https://osv.dev/vulnerability/PYSEC-2020-150

src/gitingest/__init__.py

@@ -5,4 +5,4 @@
 from gitingest.ingestion import ingest_query
 from gitingest.query_parsing import parse_query
 
-__all__ = ["ingest_query", "clone_repo", "parse_query", "ingest", "ingest_async"]
+__all__ = ["clone_repo", "ingest", "ingest_async", "ingest_query", "parse_query"]