Files
InvenTree/docs
dependabot[bot]andMatthias Mair 742c8a56ee chore(deps): bump the dependencies group across 3 directories with 22 updates (#13269)
* chore(deps): bump the dependencies group across 3 directories with 22 updates

Bumps the dependencies group with 2 updates in the /contrib/dev_reqs directory: [uv](https://github.com/astral-sh/uv) and [pip](https://github.com/pypa/pip).
Bumps the dependencies group with 1 update in the /docs directory: [mkdocs-git-revision-date-localized-plugin](https://github.com/timvink/mkdocs-git-revision-date-localized-plugin).
Bumps the dependencies group with 20 updates in the /src/backend directory:

| Package | From | To |
| --- | --- | --- |
| [pip](https://github.com/pypa/pip) | `26.2.2` | `26.3` |
| [click](https://github.com/pallets/click) | `8.5.0` | `8.5.1` |
| [coverage](https://github.com/coveragepy/coveragepy) | `7.17.0` | `7.17.2` |
| [mypy-extensions](https://github.com/python/mypy_extensions) | `1.1.0` | `1.2.0` |
| [prek](https://github.com/j178/prek) | `0.5.9` | `0.5.10` |
| [pydantic](https://github.com/pydantic/pydantic) | `2.14.2` | `2.14.3` |
| [pydantic-core](https://github.com/pydantic/pydantic) | `2.50.2` | `2.50.4` |
| [pytest-codspeed](https://github.com/CodSpeedHQ/pytest-codspeed) | `5.0.3` | `5.0.4` |
| [scim2-client](https://github.com/python-scim/scim2-client) | `0.13.2` | `0.14.1` |
| [scim2-models](https://github.com/python-scim/scim2-models) | `0.12.2` | `0.12.4` |
| [scim2-tester](https://github.com/python-scim/scim2-tester) | `0.5.2` | `0.6.4` |
| [sqlparse](https://github.com/andialbrecht/sqlparse) | `0.6.0` | `0.6.1` |
| [types-pyyaml](https://github.com/python/typeshed) | `6.0.12.20261030` | `6.0.12.20261103` |
| [typing-inspection](https://github.com/pydantic/typing-inspection) | `0.4.4` | `0.4.5` |
| [boto3](https://github.com/boto/boto3) | `1.43.122` | `1.43.125` |
| [botocore](https://github.com/boto/botocore) | `1.43.122` | `1.43.125` |
| [django-fsm-2](https://github.com/django-commons/django-fsm-2) | `4.2.4` | `4.3.0` |
| [django-taggit](https://github.com/jazzband/django-taggit) | `6.1.0` | `7.0.0` |
| [markdown](https://github.com/Python-Markdown/markdown) | `3.11.2` | `3.11.3` |
| [python-dateutil](https://github.com/dateutil/dateutil) | `2.9.0.post0` | `4.0.0` |



Updates `uv` from 0.13.6 to 0.13.7
- [Release notes](https://github.com/astral-sh/uv/releases)
- [Changelog](https://github.com/astral-sh/uv/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/uv/compare/0.13.6...0.13.7)

Updates `pip` from 26.3 to 
- [Changelog](https://github.com/pypa/pip/blob/main/NEWS.rst)
- [Commits](https://github.com/pypa/pip/commits)

Updates `mkdocs-git-revision-date-localized-plugin` from 1.6.2 to 1.6.3
- [Release notes](https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/releases)
- [Commits](https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.6.2...v1.6.3)

Updates `pip` from 26.2.2 to 26.3
- [Changelog](https://github.com/pypa/pip/blob/main/NEWS.rst)
- [Commits](https://github.com/pypa/pip/commits)

Updates `click` from 8.5.0 to 8.5.1
- [Release notes](https://github.com/pallets/click/releases)
- [Changelog](https://github.com/pallets/click/blob/main/CHANGES.md)
- [Commits](https://github.com/pallets/click/compare/8.5.0...8.5.1)

Updates `coverage` from 7.17.0 to 7.17.2
- [Release notes](https://github.com/coveragepy/coveragepy/releases)
- [Changelog](https://github.com/coveragepy/coveragepy/blob/main/CHANGES.rst)
- [Commits](https://github.com/coveragepy/coveragepy/compare/7.17.0...7.17.2)

Updates `mypy-extensions` from 1.1.0 to 1.2.0
- [Commits](https://github.com/python/mypy_extensions/compare/1.1.0...1.2.0)

Updates `prek` from 0.5.9 to 0.5.10
- [Release notes](https://github.com/j178/prek/releases)
- [Changelog](https://github.com/j178/prek/blob/main/CHANGELOG.md)
- [Commits](https://github.com/j178/prek/compare/v0.5.9...v0.5.10)

Updates `pydantic` from 2.14.2 to 2.14.3
- [Release notes](https://github.com/pydantic/pydantic/releases)
- [Changelog](https://github.com/pydantic/pydantic/blob/main/HISTORY.md)
- [Commits](https://github.com/pydantic/pydantic/compare/v2.14.2...v2.14.3)

Updates `pydantic-core` from 2.50.2 to 2.50.4
- [Release notes](https://github.com/pydantic/pydantic/releases)
- [Changelog](https://github.com/pydantic/pydantic/blob/main/HISTORY.md)
- [Commits](https://github.com/pydantic/pydantic/compare/core-v2.50.2...core-v2.50.4)

Updates `pytest-codspeed` from 5.0.3 to 5.0.4
- [Release notes](https://github.com/CodSpeedHQ/pytest-codspeed/releases)
- [Changelog](https://github.com/CodSpeedHQ/pytest-codspeed/blob/master/CHANGELOG.md)
- [Commits](https://github.com/CodSpeedHQ/pytest-codspeed/compare/v5.0.3...v5.0.4)

Updates `scim2-client` from 0.13.2 to 0.14.1
- [Release notes](https://github.com/python-scim/scim2-client/releases)
- [Changelog](https://github.com/python-scim/scim2-client/blob/main/doc/changelog.rst)
- [Commits](https://github.com/python-scim/scim2-client/compare/0.13.2...0.14.1)

Updates `scim2-models` from 0.12.2 to 0.12.4
- [Release notes](https://github.com/python-scim/scim2-models/releases)
- [Changelog](https://github.com/python-scim/scim2-models/blob/main/doc/changelog.rst)
- [Commits](https://github.com/python-scim/scim2-models/compare/0.12.2...0.12.4)

Updates `scim2-tester` from 0.5.2 to 0.6.4
- [Release notes](https://github.com/python-scim/scim2-tester/releases)
- [Changelog](https://github.com/python-scim/scim2-tester/blob/main/doc/changelog.rst)
- [Commits](https://github.com/python-scim/scim2-tester/compare/0.5.2...0.6.4)

Updates `sqlparse` from 0.6.0 to 0.6.1
- [Changelog](https://github.com/andialbrecht/sqlparse/blob/master/CHANGELOG)
- [Commits](https://github.com/andialbrecht/sqlparse/compare/0.6.0...0.6.1)

Updates `types-pyyaml` from 6.0.12.20261030 to 6.0.12.20261103
- [Commits](https://github.com/python/typeshed/commits)

Updates `typing-inspection` from 0.4.4 to 0.4.5
- [Release notes](https://github.com/pydantic/typing-inspection/releases)
- [Changelog](https://github.com/pydantic/typing-inspection/blob/main/HISTORY.md)
- [Commits](https://github.com/pydantic/typing-inspection/compare/v0.4.4...v0.4.5)

Updates `boto3` from 1.43.122 to 1.43.125
- [Release notes](https://github.com/boto/boto3/releases)
- [Commits](https://github.com/boto/boto3/compare/1.43.122...1.43.125)

Updates `botocore` from 1.43.122 to 1.43.125
- [Commits](https://github.com/boto/botocore/compare/1.43.122...1.43.125)

Updates `django-fsm-2` from 4.2.4 to 4.3.0
- [Release notes](https://github.com/django-commons/django-fsm-2/releases)
- [Changelog](https://github.com/django-commons/django-fsm-2/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/django-commons/django-fsm-2/compare/4.2.4...4.3.0)

Updates `django-taggit` from 6.1.0 to 7.0.0
- [Changelog](https://github.com/jazzband/django-taggit/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/jazzband/django-taggit/compare/6.1.0...7.0.0)

Updates `markdown` from 3.11.2 to 3.11.3
- [Release notes](https://github.com/Python-Markdown/markdown/releases)
- [Changelog](https://github.com/Python-Markdown/markdown/blob/master/docs/changelog.md)
- [Commits](https://github.com/Python-Markdown/markdown/compare/3.11.2...3.11.3)

Updates `python-dateutil` from 2.9.0.post0 to 4.0.0
- [Release notes](https://github.com/dateutil/dateutil/releases)
- [Changelog](https://github.com/dateutil/dateutil/blob/master/NEWS)
- [Commits](https://github.com/dateutil/dateutil/compare/2.9.0.post0...4.0.0)

---
updated-dependencies:
- dependency-name: uv
  dependency-version: 0.13.7
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: pip
  dependency-version:
  dependency-type: direct:production
  dependency-group: dependencies
- dependency-name: mkdocs-git-revision-date-localized-plugin
  dependency-version: 1.6.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: pip
  dependency-version: '26.3'
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: click
  dependency-version: 8.5.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: coverage
  dependency-version: 7.17.2
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: mypy-extensions
  dependency-version: 1.2.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: prek
  dependency-version: 0.5.10
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: pydantic
  dependency-version: 2.14.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: pydantic-core
  dependency-version: 2.50.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: pytest-codspeed
  dependency-version: 5.0.4
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: scim2-client
  dependency-version: 0.14.1
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: scim2-models
  dependency-version: 0.12.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: scim2-tester
  dependency-version: 0.6.4
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: sqlparse
  dependency-version: 0.6.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: types-pyyaml
  dependency-version: 6.0.12.20261103
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: typing-inspection
  dependency-version: 0.4.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: boto3
  dependency-version: 1.43.125
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: botocore
  dependency-version: 1.43.125
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: django-fsm-2
  dependency-version: 4.3.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: django-taggit
  dependency-version: 7.0.0
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: dependencies
- dependency-name: markdown
  dependency-version: 3.11.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: python-dateutil
  dependency-version: 4.0.0
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: dependencies
...

Signed-off-by: dependabot[bot] <support@github.com>

* fix style

* fix style

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Matthias Mair <code@mjmair.com>
2026-11-16 11:13:05 +11:00
..
2026-11-14 22:34:18 +11:00
2024-08-27 09:04:55 +10:00
2026-11-15 15:26:47 +11:00
2023-04-22 23:35:25 +10:00
2026-11-14 22:34:18 +11:00
2026-11-14 22:34:18 +11:00
2023-04-22 22:40:29 +10:00
2026-11-14 22:34:18 +11:00
2026-11-14 22:34:18 +11:00
2026-11-14 22:34:18 +11:00
2026-11-14 22:34:18 +11:00

InvenTree Documentation

Documentation Status

This repository hosts the official documentation for InvenTree, an open source inventory management system.

Prerequisites

InvenTree uses Zensical to convert Markdown format .md files into HTML suitable for viewing in a web browser. The site configuration is in docs/mkdocs.yml (Zensical reads the mkdocs configuration format).

!!! info "Prerequisites" To build and serve this documentation locally (e.g. for development), you will need:

* Python 3 installed on your system.
* An existing InvenTree installation containing the virtual environment that was created during installation.

These instructions assume you followed the [InvenTree bare metal installation instructions](./docs/start/install.md), so you'll have an `inventree` user, a home directory at `/home/inventree`, the InvenTree source code cloned from [GitHub](https://github.com/inventree/inventree) into `/home/inventree/src`, and a virtual environment at `/home/inventree/env`.  If you installed InvenTree some other way, this might vary, and you'll have to adjust these instructions accordingly.

!!! warning "Your InvenTree install will be updated!" Some of the commands that follow will make changes to your install, for example, by running any pending database migrations. There's a small risk this may cause issues with your existing installation. If you can't risk this, consider setting up a separate InvenTree installation specifically for documentation development.

Building the documentation locally

To build the documentation locally, run these commands as the inventree user:

cd /home/inventree
source env/bin/activate

!!! info "(env) prefix" The shell prompt should now display the (env) prefix, showing that you are operating within the context of the python virtual environment

You can now install the additional packages needed to build the documentation:

cd src
pip install --require-hashes -r docs/requirements.txt

Schema generation

Building the documentation requires extracting the API schema (and settings definitions) from the source code. The API reference pages in docs/docs/api/schema/ are generated from this schema and are not tracked in git.

!!! tip This command is only required when building the documentation for the first time, or when changes have been made to the API schema.

invoke build-docs

You will see output similar to this (truncated for brevity):

Running InvenTree database migrations...
Exporting definitions...
Exporting settings definition to '/home/inventree/src/docs/generated/inventree_settings.json'...
Exported InvenTree settings definitions to '/home/inventree/src/docs/generated/inventree_settings.json'
Exported InvenTree tag definitions to '/home/inventree/src/docs/generated/inventree_tags.yml'
Exported InvenTree filter definitions to '/home/inventree/src/docs/generated/inventree_filters.yml'
Exported InvenTree report context definitions to '/home/inventree/src/docs/generated/inventree_report_context.json'
Exporting definitions complete
Exporting schema file to '/home/inventree/src/docs/generated/schema.yml'

Schema export completed: /home/inventree/src/docs/generated/schema.yml
Documentation build complete, but zensical build not requested

To generate the schema files and build the static HTML site (in docs/site/), including the post-build checks that all settings are documented, run:

invoke build-docs --build

Viewing the documentation

Generate the HTML files from the markdown source files, and start the zensical webpage server:

zensical serve -a localhost:8080 -f docs/mkdocs.yml

You can then point your web browser at http://localhost:8080/

Alternatively, you can use the invoke command:

invoke dev.docs-server

If you need to, use the -a option after zensical serve or invoke to set the address and port. Run invoke dev.docs-server --help for details.

Editing the Documentation Files

Once the server is running, it will monitor the documentation files for changes, and regenerate the HTML pages as required. Refresh your web browser to see the changes.

Admonitions

"Admonition" blocks can be added to the documentation source as follows:

!!! info "This is the admonition block title"
    This is the admonition block content

Refer to the reference documentation to customize the admonition block to the use-case (eg. warning, missing, info, etc.).

Links to internal documentation pages must use relative pathing, otherwise the link will be broken by the readthedocs URL formatting.

Also, linking to an internal page must use the .md suffix!

For example, to link to the page /part/views from /stock/stocktake, the link must be formed as follows:

Click [here](../part/views.md)

Formatting the link as follows:

Click [here](/part/views)

will result in a broken link.

Images

Images are served from the ./docs/assets/images folder and can be added as follows:

{{ image("image_name.png", base="subfolder", title="Image title") }}

See the image macro in ./docs/main.py for more information.

Icons

Icons can be rendered (using the tabler icon set) as follows:

{{ icon("brand-github", color="red")}}

See the icon macro in ./docs/main.py for more information.

Global variables

Refer to the reference documentation to find out how to add global variables to the documentation site.

Global variables should be added in the # Global Variables section of the mkdocs.yml configuration file.

Credits

This documentation is built with Zensical, from the team behind Material for MkDocs