| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -40,3 +40,18 @@ jobs: | |||
| 40 | 40 | else | |
| 41 | 41 | pytest -o addopts= -v smmap/smmap/test | |
| 42 | 42 | fi | |
| 43 | + uv-sync: | ||
| 44 | + runs-on: ubuntu-latest | ||
| 45 | + steps: | ||
| 46 | + - uses: actions/checkout@v7 | ||
| 47 | + with: | ||
| 48 | + persist-credentials: false | ||
| 49 | + | ||
| 50 | + - name: Install uv | ||
| 51 | + uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0 | ||
| 52 | + with: | ||
| 53 | + enable-cache: false | ||
| 54 | + version: "0.12.13" # Released on 2026-09-10 | ||
| 55 | + | ||
| 56 | + # Ensure that dependencies and dependency groups are consistent and resolvable. | ||
| 57 | + - run: uv sync --all-extras --all-groups --dry-run | ||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -173,5 +173,5 @@ jobs: | |||
| 173 | 173 | - name: Documentation | |
| 174 | 174 | if: matrix.build-docs | |
| 175 | 175 | run: | | |
| 176 | - pip install '.[doc]' | ||
| 176 | + pip install --group doc | ||
| 177 | 177 | make -C doc html | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -52,3 +52,6 @@ output.txt | |||
| 52 | 52 | ||
| 53 | 53 | # Files created by OSS-Fuzz when running locally | |
| 54 | 54 | fuzz_*.pkg.spec | |
| 55 | + | ||
| 56 | + # Lock files created by uv, pixi, pipenv and others | ||
| 57 | + *.lock | ||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -13,6 +13,10 @@ build: | |||
| 13 | 13 | # nodejs: "20" | |
| 14 | 14 | # rust: "1.70" | |
| 15 | 15 | # golang: "1.20" | |
| 16 | + jobs: | ||
| 17 | + install: | ||
| 18 | + - python -m pip install --upgrade --no-cache-dir pip setuptools | ||
| 19 | + - python -m pip install --upgrade --upgrade-strategy only-if-needed --no-cache-dir --group doc . | ||
| 16 | 20 | ||
| 17 | 21 | # Build documentation in the "doc/" directory with Sphinx. | |
| 18 | 22 | sphinx: | |
@@ -24,13 +28,3 @@ sphinx: | |||
| 24 | 28 | ||
| 25 | 29 | # Optionally build your docs in additional formats such as PDF and ePub. | |
| 26 | 30 | formats: all | |
| 27 | - | ||
| 28 | - # Optional but recommended, declare the Python requirements required | ||
| 29 | - # to build your documentation. | ||
| 30 | - # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html | ||
| 31 | - python: | ||
| 32 | - install: | ||
| 33 | - - method: pip | ||
| 34 | - path: . | ||
| 35 | - extra_requirements: | ||
| 36 | - - doc | ||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -1,7 +1,42 @@ | |||
| 1 | + # Contribution guidelines | ||
| 2 | + | ||
| 3 | + Before starting work, read and follow [CONTRIBUTING.md](CONTRIBUTING.md), | ||
| 4 | + including the [Prevent agent impersonation](CONTRIBUTING.md#prevent-agent-impersonation) | ||
| 5 | + section governing identification when communicating through a person's account. | ||
| 6 | + | ||
| 1 | 7 | # Commit messages | |
| 2 | 8 | ||
| 3 | - Every commit must have a descriptive title and a substantive body. Title-only | ||
| 4 | - commit messages are not acceptable. | ||
| 9 | + Follow Conventional Commits for every commit. Every commit must have a | ||
| 10 | + descriptive title and a substantive body. Title-only commit messages are not | ||
| 11 | + acceptable. | ||
| 12 | + | ||
| 13 | + ## Formatting | ||
| 14 | + | ||
| 15 | + Write commit messages in Markdown and assume readers view them with syntax | ||
| 16 | + highlighting. Enclose code identifiers, package and module names, file paths, | ||
| 17 | + and shell commands in backticks. Use Markdown whenever it helps readers | ||
| 18 | + understand or navigate the prose. | ||
| 19 | + | ||
| 20 | + ## Titles | ||
| 21 | + | ||
| 22 | + - Every title must use the form `type: description` or | ||
| 23 | + `type(scope): description`. | ||
| 24 | + - Use `feat:` for user-visible features and `fix:` for user-visible fixes. | ||
| 25 | + - Use appropriate prefixes for other changes, such as `docs:`, `test:`, `ci:`, | ||
| 26 | + `build:`, `refactor:`, `perf:`, `style:`, or `chore:`. | ||
| 27 | + - Breaking changes must use `!` immediately before the colon, for example | ||
| 28 | + `feat!:`, `refactor!:`, or a scoped form such as `fix(repo)!:`. | ||
| 29 | + - Optionally scope a commit to the affected component, for example `fix(repo):`. | ||
| 30 | + | ||
| 31 | + Example titles: | ||
| 32 | + | ||
| 33 | + - `feat: add support for a new Git option` | ||
| 34 | + - `fix(repo): handle bare repositories correctly` | ||
| 35 | + - `build!: drop support for an older Python version` | ||
| 36 | + - `ci: add an independent documentation build` | ||
| 37 | + - `refactor(repo): simplify repository initialization` | ||
| 38 | + | ||
| 39 | + ## Body | ||
| 5 | 40 | ||
| 6 | 41 | The body must explain the problem or motivation, what changed, and why the | |
| 7 | 42 | chosen approach addresses it. Include relevant behavior before and after the | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -40,14 +40,20 @@ dynamic = ["license", "version", "dependencies", "optional-dependencies"] | |||
| 40 | 40 | "Source code" = "https://github.com/gitpython-developers/GitPython" | |
| 41 | 41 | "Documentation" = "https://gitpython.readthedocs.io/en/stable/" | |
| 42 | 42 | ||
| 43 | + [dependency-groups] | ||
| 44 | + doc = [ | ||
| 45 | + 'sphinx >=7.4.7,<8 ; python_version >= "3.9"', | ||
| 46 | + "sphinx-autodoc-typehints", | ||
| 47 | + "sphinx-rtd-theme", | ||
| 48 | + ] | ||
| 49 | + | ||
| 43 | 50 | [tool.setuptools] | |
| 44 | 51 | include-package-data = true | |
| 45 | 52 | ||
| 46 | 53 | [tool.setuptools.dynamic] | |
| 47 | 54 | version = {file = "VERSION"} | |
| 48 | 55 | dependencies = {file = "requirements.txt"} | |
| 49 | 56 | optional-dependencies."test" = {file = "test-requirements.txt"} | |
| 50 | - optional-dependencies."doc" = {file = "doc/requirements.txt"} | ||
| 51 | 57 | ||
| 52 | 58 | [tool.setuptools.packages.find] | |
| 53 | 59 | include = ["git", "git.*"] | |
| Back | FazBrowse Home | New Git URL |
0 commit comments