python-ulid 3.0.0__tar.gz → 3.2.1__tar.gz

python_ulid-3.2.1/.envrc

@@ -0,0 +1 @@
+use flox

python_ulid-3.2.1/.github/workflows/lint-and-test.yml

@@ -0,0 +1,101 @@
+name: lint-and-test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          python-version: "3.14"
+      - name: Lint documentation
+        run: uv run doc8 docs/source
+
+  lint-code:
+    runs-on: ubuntu-latest
+    name: Lint code
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          python-version: "3.14"
+      - name: Lint style
+        run: uv run ruff check
+
+  lint-typing:
+    runs-on: ubuntu-latest
+    name: Lint type annotations
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          python-version: "3.14"
+      - name: Lint typing
+        run: uv run poe check-types
+
+  test:
+    runs-on: ubuntu-latest
+    name: Run tests
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Test
+        run: uv run poe test
+
+      - name: Upload coverage data
+        uses: actions/upload-artifact@v7
+        with:
+          include-hidden-files: true
+          name: coverage-${{ matrix.python-version }}
+          path: .coverage*
+
+
+  coverage:
+    runs-on: ubuntu-latest
+    name: Report coverage
+    needs:
+      - test
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+
+      - name: Download coverage data
+        uses: actions/download-artifact@v8
+        with:
+          pattern: coverage-*
+          merge-multiple: true
+
+      - name: Combine coverage data
+        run: uv run poe cov-combine
+
+      - name: Export coverage reports
+        run: uv run poe cov-xml
+
+      - uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+
+  package:
+    name: Build & verify package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: hynek/build-and-inspect-python-package@v2

python_ulid-3.2.1/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: publish
+
+on:
+  push:
+    tags: ["*"]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          python-version: "3.14"
+      - name: Build
+        run: uv build
+      - name: Publish
+        env:
+          UV_PUBLISH_USERNAME: ${{ secrets.PYPI_USERNAME }}
+          UV_PUBLISH_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+        run: uv publish

{python_ulid-3.0.0 → python_ulid-3.2.1}/.gitignore

@@ -4,12 +4,12 @@ __pycache__
 
 /.tox
 /.coverage
+/.coverage.*
 /.cache
 /.eggs
 /.mypy_cache
 /.pytest_cache
 /.ruff_cache
-/.devbox
 
 /coverage.xml
 /dist/

python_ulid-3.2.1/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.4
+    hooks:
+      - id: ruff-check
+      - id: ruff-format
+  - repo: https://github.com/pycqa/doc8
+    rev: v2.0.0
+    hooks:
+      - id: doc8
+  - repo: local
+    hooks:
+      - id: pyrefly-check
+        name: pyrefly
+        entry: uv run pyrefly check
+        language: system
+        types: [python]
+        pass_filenames: false

{python_ulid-3.0.0 → python_ulid-3.2.1}/.readthedocs.yml

@@ -3,7 +3,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.11"
+    python: "3.13"
 
 sphinx:
   configuration: docs/source/conf.py

{python_ulid-3.0.0 → python_ulid-3.2.1}/.ruff_defaults.toml

@@ -386,7 +386,6 @@ select = [
   "S317",
   "S318",
   "S319",
-  "S320",
   "S321",
   "S323",
   "S324",
@@ -446,12 +445,12 @@ select = [
   "T100",
   "T201",
   "T203",
-  "TCH001",
-  "TCH002",
-  "TCH003",
-  "TCH004",
-  "TCH005",
-  "TCH010",
+  "TC001",
+  "TC002",
+  "TC003",
+  "TC004",
+  "TC005",
+  "TC010",
   "TD004",
   "TD005",
   "TD006",
@@ -463,9 +462,9 @@ select = [
   "TRY003",
   "TRY004",
   "TRY201",
+  "TRY203",
   "TRY300",
   "TRY301",
-  "TRY302",
   "TRY400",
   "TRY401",
   "UP001",
@@ -502,7 +501,6 @@ select = [
   "UP035",
   "UP036",
   "UP037",
-  "UP038",
   "UP039",
   "UP040",
   "UP041",

python_ulid-3.2.1/AGENTS.md

@@ -0,0 +1,77 @@
+# Guidelines for AI Coding Agents
+
+Welcome! If you are an AI assistant, coding agent, or language model (e.g., Antigravity, Claude Code, Cursor, Copilot) helping to develop `python-ulid`, please adhere to the guidelines in this document.
+
+These instructions ensure consistency, prevent common development errors, and keep code quality aligned with the project's standards.
+
+---
+
+## 🏗️ Project Stack & Tooling
+
+We use modern, fast, and strict tooling for Python development. Always use the specified commands below.
+
+- **Dependency Manager**: We use **[uv](https://github.com/astral-sh/uv)**.
+  - Do *not* use raw `pip`, `poetry`, or `pdm`.
+  - To install dependencies, run: `uv sync`.
+  - Always prefix commands with `uv run` to execute them in the correct environment (e.g., `uv run pytest`).
+- **Task Runner**: We use **[Poe the Poet](https://github.com/nat-n/poethepoet)**.
+  - Development tasks are defined in `pyproject.toml` under `[tool.poe.tasks]`.
+  - Run checks with `uv run poe check`.
+- **Linting & Formatting**: We use **[Ruff](https://github.com/astral-sh/ruff)**.
+  - Standard line-length limit is **100 characters**.
+  - Auto-format code using `uv run poe fmt`.
+- **Static Typing**: We use **[pyrefly](https://github.com/mdomke/pyrefly)** for strict static analysis.
+  - Run type checking using `uv run poe check-types`.
+
+---
+
+## 🎯 Coding Standards for Agents
+
+### 1. Mandatory Type Annotations
+We require full, strict type annotations across the entire codebase.
+- **Rules**:
+  - Always annotate all function parameters and return values.
+  - Avoid `Any` where possible; use specific types, unions, or generics.
+  - Run type checking to verify compliance: `uv run poe check-types`.
+
+### 2. Ruff Compliance
+- **Formatting**: Run formatting before finalizing any file modifications.
+  - Use `uv run poe fmt` to auto-format.
+  - Code style rules are detailed in `pyproject.toml` and `.ruff_defaults.toml`.
+- **Imports**: We use single-line imports and specific import order (`isort` rules). Let Ruff handle this automatically.
+
+### 3. Production-Ready Code Only
+- Never generate code with comments like `# TODO: implement this`, `# placeholder`, or partial code blocks.
+- Implement the full logic requested, ensuring error handling and correct edge cases are covered.
+
+---
+
+## 🛠️ Verification Workflow
+
+Before completing any task, you **MUST** run the verification commands to ensure no regressions or style issues are introduced.
+
+1. **Format Code**:
+   ```bash
+   uv run poe fmt
+   ```
+2. **Run Lints, Types & Style Checks**:
+   ```bash
+   uv run poe check
+   ```
+3. **Run Test Suite**:
+   ```bash
+   uv run poe test
+   ```
+
+Make sure all checks pass without errors.
+
+---
+
+## 📂 Codebase Navigation
+
+- **`/ulid`**: Contains the source code of the `python-ulid` package.
+- **`/tests`**: Contains all unit and integration tests. Write corresponding test cases here for any new logic.
+- **`/docs`**: Contains Sphinx-based documentation.
+- **`pyproject.toml`**: The single source of truth for dependencies, tools configuration, and Poe tasks.
+
+Refer to the primary developer documentation and [CONTRIBUTING.md](file:///Users/martin.domke/Source/private/ulid/CONTRIBUTING.md) for more details.

{python_ulid-3.0.0 → python_ulid-3.2.1}/CHANGELOG.rst

@@ -5,11 +5,49 @@ Changelog
 
 Versions follow `Semantic Versioning <http://www.semver.org>`_
 
+`3.2.0`_ - 2026-07-17
+---------------------
+Added
+~~~~~
+* Added transparent bidirectional UUIDv7 conversion methods (``ULID.to_uuid7`` and
+  ``ULID.from_uuidv7``) `@pirate <https://github.com/pirate>`_.
+* Added a ``--uuid7`` option to the CLI's ``show`` command to convert and output a ULID as an
+  RFC 4122 compliant UUIDv7.
+
+Changed
+~~~~~~~
+* Dropped support for Python 3.9 and added support for Python 3.14
+  `@Avihais12344 <https://github.com/Avihais12344>`_.
+* Depend on ``typing-extensions`` only when running on Python < 3.11 `@musicinmybrain <https://github.com/musicinmybrain>`_.
+* Migrated package and development workflow from Hatch to ``uv`` and ``poethepoet``.
+* Configured Flox for bootstrapping the development environment.
+
+Fixed
+~~~~~
+* Fixed a clock-skew bug where non-monotonic ULIDs could be generated when crossing a millisecond boundary between timestamp and randomness sampling `@gaoflow <https://github.com/gaoflow>`_.
+* Fixed warning from ``uv`` during synchronization `@jaseemabid <https://github.com/jaseemabid>`_.
+* Resolved various Ruff linter warnings and Pyrefly type checker issues.
+
+`3.1.0`_ - 2025-08-18
+---------------------
+Changed
+~~~~~~~
+* Added Python 3.13 to the trove classifiers.
+* Optimze ``@property`` to ``@cached_property`` `@WH-2099 <https://github.com/WH-2099>`_.
+* When generating ULIDs within the same millisecond, the library will ensure monotonic sort order by
+  incrementing the randomness component by 1 bit. This process is descrbied in the
+  `spec <https://github.com/ulid/spec/blob/master/README.md#monotonicity>`_.
+
+Fixed
+~~~~~
+* Sharpen regular expression for Pydantic `@aplhk <https://github.com/aplhk>`_.
+* Fix Sphinx warnings when referencing ULID from an external project. `@BoboTiG <https://github.com/BoboTiG>`_.
+
 `3.0.0`_ - 2024-10-11
 ---------------------
 Changed
 ~~~~~~~
-* Raise `TypeError` instead of `ValueError` if constructor is called with value of wrong type.
+* Raise ``TypeError`` instead of ``ValueError`` if constructor is called with value of wrong type.
 * Update ``ruff`` linter rules and switch to ``hatch fmt``.
 
 Added
@@ -71,7 +109,7 @@ Added
 ~~~~~
 * Added a new flag ``--uuid4`` to the CLI ``show`` command, that converts the provided ``ULID``
   into an RFC 4122 compliant ``UUID``.
-* The `ulid build` command allows the use of the special value ``-`` for all options to read its
+* The ``ulid build`` command allows the use of the special value ``-`` for all options to read its
   inputs from ``stdin``. E.g.
 
   .. code-block:: bash
@@ -128,7 +166,7 @@ Changed
 Added
 ~~~~~
 * Added support for Python 3.10.
-* Added :attr:`__version__` variable to package.
+* Added ``__version__`` variable to package.
 
 
 `1.0.3`_ - 2021-07-14
@@ -153,7 +191,7 @@ Added
 Changed
 ~~~~~~~
 * Dropped support for Python 2. Only Python 3.6+ is supported.
-* The named constructor :meth:`.ULID.new` has been removed. Use one of the specifc named
+* The named constructor ``ULID.new`` has been removed. Use one of the specifc named
   constructors instead. For a new :class:`.ULID` created from the current timestamp use the
   standard constructor.
 
@@ -169,8 +207,8 @@ Changed
     ulid = ULID.from_timestamp(time.time())
     ulid = ULID.from_datetime(datetime.now())
 
-* The :meth:`.ULID.str` and :meth:`.ULID.int` methods have been removed in favour of the more
-  Pythonic special dunder-methods. Use `str(ulid)` and `int(ulid)` instead.
+* The ``ULID.str`` and ``ULID.int`` methods have been removed in favour of the more
+  Pythonic special dunder-methods. Use ``str(ulid)`` and ``int(ulid)`` instead.
 * Added the property :meth:`.ULID.hex` that returns a hex representation of the :class:`.ULID`.
 
   .. code-block:: python
@@ -182,6 +220,8 @@ Changed
 * The package now has no external dependencies.
 * The test-coverage has been raised to 100%.
 
+.. _3.2.0: https://github.com/mdomke/python-ulid/compare/3.1.0...3.2.0
+.. _3.1.0: https://github.com/mdomke/python-ulid/compare/3.0.0...3.1.0
 .. _3.0.0: https://github.com/mdomke/python-ulid/compare/2.7.0...3.0.0
 .. _2.7.0: https://github.com/mdomke/python-ulid/compare/2.6.0...2.7.0
 .. _2.6.0: https://github.com/mdomke/python-ulid/compare/2.5.0...2.6.0

python_ulid-3.2.1/CONTRIBUTING.md

@@ -0,0 +1,146 @@
+# Contributing to python-ulid
+
+Thank you for your interest in contributing to `python-ulid`! We appreciate all kinds of contributions: fixing bugs, improving documentation, submitting feature requests, or writing code.
+
+This document guides you through setting up your local environment and details our development workflow and coding standards.
+
+---
+
+## 🚀 Getting Started
+
+We support two ways to set up your local development environment: **Flox** (recommended, zero-configuration setup) or a **Manual** setup.
+
+### Option 1: Using Flox (Recommended)
+
+If you have [Flox](https://flox.dev/) installed, setting up your environment is completely automated. Flox will automatically handle installing `uv`, Python, project dependencies, and pre-commit hooks inside a reproducible environment.
+
+1. **Fork and clone** the repository:
+   ```bash
+   git clone https://github.com/<your-username>/python-ulid.git
+   cd python-ulid
+   ```
+
+2. **Activate the Flox environment**:
+   ```bash
+   flox activate
+   ```
+   That's it! Flox automatically sets up everything for you and activates your python virtual environment.
+
+---
+
+### Option 2: Manual Setup
+
+If Flox is not an option, you can set up your environment manually. We use [uv](https://github.com/astral-sh/uv) for fast, robust package and dependency management.
+
+1. **Prerequisites**:
+   - **Python**: `>= 3.10`
+   - **uv**: Install via `curl -LsSf https://astral.sh/uv/install.sh | sh` (or your preferred package manager)
+
+2. **Fork and clone** the repository:
+   ```bash
+   git clone https://github.com/<your-username>/python-ulid.git
+   cd python-ulid
+   ```
+
+3. **Sync the dependencies**:
+   This will automatically create a `.venv` virtual environment and install all packages in the developer and documentation groups:
+   ```bash
+   uv sync
+   ```
+
+4. **Install pre-commit hooks**:
+   We use `prek` (a fast, Rust-based alternative to pre-commit) to manage our Git hooks, ensuring code style, formatting, and static typing checks run automatically before each commit.
+   ```bash
+   uv run prek install
+   ```
+
+---
+
+## 🛠️ Development Tasks & Commands
+
+We use [Poe the Poet](https://github.com/nat-n/poethepoet) as our task runner. Depending on how you set up your development environment, you can invoke the tasks directly or via `uv run`:
+
+- **With Flox (Recommended)**: Since the virtual environment is automatically activated in your shell, you can run all commands directly:
+  ```bash
+  poe test
+  ```
+- **With Manual Setup**: If you did not use Flox, prefix all tasks with `uv run`:
+  ```bash
+  uv run poe test
+  ```
+  (You can also manually activate the virtual environment to get the same shorthands as above).
+
+### Common Development Tasks
+
+| Task | Command (Flox) | Command (Manual) | Description |
+| :--- | :--- | :--- | :--- |
+| **All Checks** | `poe check` | `uv run poe check` | Run linter, formatter checks, type checking, and docs check. |
+| **Formatting** | `poe fmt` | `uv run poe fmt` | Auto-format Python source files using `ruff format`. |
+| **Lint** | `poe check-code` | `uv run poe check-code` | Check source files for lint and code style issues using `ruff`. |
+| **Format Check** | `poe check-fmt` | `uv run poe check-fmt` | Dry-run format check without modifying files. |
+| **Type Check** | `poe check-types` | `uv run poe check-types` | Run strict static analysis and type verification with `pyrefly`. |
+| **Docs Lint** | `poe check-docs` | `uv run poe check-docs` | Lint documentation style using `doc8`. |
+| **Run Tests** | `poe test` | `uv run poe test` | Run pytest with code coverage tracking. |
+| **Build Docs** | `poe docs` | `uv run poe docs` | Build the HTML documentation locally using Sphinx. |
+
+> [!TIP]
+> Before pushing any changes or opening a Pull Request, always make sure to run the complete checks suite with **`poe check`** (or `uv run poe check`) and run the test suite with **`poe test`** (or `uv run poe test`).
+
+### Manual Hook Execution with prek
+
+If you want to run all checks against your staged or unstaged files manually:
+
+- **With Flox**:
+  ```bash
+  prek run --all-files
+  ```
+- **With Manual Setup**:
+  ```bash
+  uv run prek run --all-files
+  ```
+
+---
+
+## 🎨 Coding Standards
+
+To maintain a clean, readable, and highly maintainable codebase, we enforce the following development standards:
+
+### 1. Type Annotations
+- **Strictly Required**: We enforce type annotations across the entire codebase. This includes all function signatures, arguments, and return types.
+- **Static Analysis**: Our configuration has `disallow_untyped_defs = true` set for Mypy and uses strict `pyrefly` checks. Untyped or partially-typed code will fail the lint pipelines.
+- **Example**:
+  ```python
+  def generate_ulid(timestamp: float | None = None) -> ULID:
+      ...
+  ```
+
+### 2. Ruff Formatting & Linting
+- **Formatting**: We use [Ruff](https://github.com/astral-sh/ruff) for automatic code formatting (`ruff format`).
+- **Code Style**: Ruff also handles our lint checks, including import sorting (`isort`), code complexity limits (`mccabe`), and code style conventions.
+- **Configuration**:
+  - Line length limit: **100 characters**.
+  - Imports are forced to single lines and ordered.
+  - Standard Ruff defaults apply (see `.ruff_defaults.toml`).
+
+---
+
+## 📬 Submitting a Pull Request
+
+1. **Create a branch** for your feature or bugfix:
+   ```bash
+   git checkout -b feature/my-cool-improvement
+   ```
+2. **Make your changes**, ensuring you write comprehensive unit tests.
+3. **Format and verify** your code (e.g. using `poe` directly if using Flox, or prefixed with `uv run` if manual):
+   ```bash
+   poe fmt
+   poe check
+   poe test
+   ```
+4. **Commit your changes**:
+   Our pre-commit hooks will automatically trigger to verify your work.
+5. **Push and open a PR** on GitHub! Please provide a descriptive title and detailed explanation of your changes in the PR description.
+
+---
+
+Thank you for helping make `python-ulid` better! 🌟

{python_ulid-3.0.0 → python_ulid-3.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: python-ulid
-Version: 3.0.0
+Version: 3.2.1
 Summary: Universally unique lexicographically sortable identifier
 Project-URL: Homepage, https://github.com/mdomke/python-ulid
 Project-URL: Documentation, https://python-ulid.readthedocs.io
@@ -18,12 +18,14 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.9
+Requires-Python: >=3.10
+Requires-Dist: typing-extensions; python_version < '3.11'
 Provides-Extra: pydantic
 Requires-Dist: pydantic>=2.0; extra == 'pydantic'
 Description-Content-Type: text/x-rst
@@ -39,6 +41,7 @@ A ``ULID`` is a *universally unique lexicographically sortable identifier*. It i
 * Uses Crockford's base32 for better efficiency and readability (5 bits per character)
 * Case insensitive
 * No special characters (URL safe)
+* Monotonic sort order (correctly detects and handles the same millisecond)
 
 In general the structure of a ULID is as follows:
 
@@ -147,6 +150,20 @@ The ``ULID`` class can be directly used for the popular data validation library
 
 .. pydantic-end
 
+.. monotonic-begin
+
+Monotonic Support
+-----------------
+
+This library by default supports the implementation for monotonic sort order suggested by the
+official ULID specification.
+
+This means that ULID values generated in the same millisecond will have linear increasing randomness
+values. If :math:`r_1` and :math:`r_2` are the randomness values of two ULIDs with the same
+timestamp, then :math:`r_2 = r_1 + 1`.
+
+.. monotonic-end
+
 .. cli-begin
 
 Command line interface
@@ -204,3 +221,9 @@ Other implementations
 * `ulid/javascript <https://github.com/ulid/javascript>`_
 * `RobThree/NUlid <https://github.com/RobThree/NUlid>`_
 * `imdario/go-ulid <https://github.com/imdario/go-ulid>`_
+
+Contributions
+-------------
+
+Contributions are welcome! Feel free to create pull-requests for issues or feature requests.
+It might be worth creating an issue upfront to discuss the matter.

{python_ulid-3.0.0 → python_ulid-3.2.1}/README.rst

@@ -42,6 +42,7 @@ A ``ULID`` is a *universally unique lexicographically sortable identifier*. It i
 * Uses Crockford's base32 for better efficiency and readability (5 bits per character)
 * Case insensitive
 * No special characters (URL safe)
+* Monotonic sort order (correctly detects and handles the same millisecond)
 
 In general the structure of a ULID is as follows:
 
@@ -150,6 +151,20 @@ The ``ULID`` class can be directly used for the popular data validation library
 
 .. pydantic-end
 
+.. monotonic-begin
+
+Monotonic Support
+-----------------
+
+This library by default supports the implementation for monotonic sort order suggested by the
+official ULID specification.
+
+This means that ULID values generated in the same millisecond will have linear increasing randomness
+values. If :math:`r_1` and :math:`r_2` are the randomness values of two ULIDs with the same
+timestamp, then :math:`r_2 = r_1 + 1`.
+
+.. monotonic-end
+
 .. cli-begin
 
 Command line interface
@@ -207,3 +222,9 @@ Other implementations
 * `ulid/javascript <https://github.com/ulid/javascript>`_
 * `RobThree/NUlid <https://github.com/RobThree/NUlid>`_
 * `imdario/go-ulid <https://github.com/imdario/go-ulid>`_
+
+Contributions
+-------------
+
+Contributions are welcome! Feel free to create pull-requests for issues or feature requests.
+It might be worth creating an issue upfront to discuss the matter.

{python_ulid-3.0.0 → python_ulid-3.2.1}/docs/source/conf.py

@@ -12,7 +12,7 @@ import ulid
 copyright = f"{datetime.now(timezone.utc).year}, Martin Domke"
 author = "Martin Domke"
 master_doc = "index"
-source_suffix = [".rst", ".md"]
+source_suffix = {".rst": "restructuredtext", ".md": "restructuredtext"}
 
 # The full version, including alpha/beta/rc tags
 release = ulid.__version__
@@ -23,6 +23,7 @@ version = release.rsplit(".", 1)[0]
 # ones.
 extensions = [
     "sphinx.ext.autodoc",
+    "sphinx.ext.intersphinx",
     "sphinx.ext.napoleon",
     "sphinx.ext.viewcode",
     "sphinx_copybutton",
@@ -31,11 +32,6 @@ extensions = [
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = []
-
 
 # -- Options for HTML output -------------------------------------------------
 
@@ -76,7 +72,10 @@ html_sidebars = {
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
 pygments_style = "sphinx"
 
 autodoc_member_order = "groupwise"
+# ----------------------------------------------
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {"python": ("https://docs.python.org/3", None)}