notbugAs an Amazon Associate I earn from qualifying purchases.
Want a good read? Try FreeBSD Mastery: Jails (IT Mastery Book 15)
Want a good monitor light? See my photosAll times are UTC
Remember
I remember
2024-11-06 brought a new category: filesystems. Sadly, the website did not process it well. I''m working on that. It may take a few days.
Port details
py-mkdocstrings-python Python handler for mkdocstrings
1.12.2 textproc on this many watch lists=2 search for ports that depend on this port Find issues related to this port Report an issue related to this port View this port on Repology. pkg-fallout 1.10.9Version of this port present on the latest quarterly branch.
Maintainer: kai@FreeBSD.org search for ports maintained by this maintainer
Port Added: 2023-08-31 05:48:23
Last Update: 2024-11-03 10:13:40
Commit Hash: 19f71b7
People watching this port, also watch:: jdictionary, py311-Automat, py311-python-gdsii, py39-PyOpenGL, p5-Sane
Also Listed In: python
License: ISCL
WWW:
https://github.com/mkdocstrings/python
Description:
This Python handler for the "mkdocstrings" package uses Griffe (= textproc/py-griffe) to collect documentation from Python source code. Features: * Data collection from source code: collection of the object-tree and the docstrings is done thanks to Griffe. * Support for type annotations: Griffe collects your type annotations and mkdocstrings uses them to display parameter types or return types. * Recursive documentation of Python objects: just use the module dotted-path as an identifier, and you get the full module docs. You don't need to inject documentation for each class, function, etc. * Support for documented attributes: attributes (variables) followed by a docstring (triple-quoted string) will be recognized by Griffe in modules, classes and even in __init__ methods. * Multiple docstring-styles support: common support for Google-style, Numpydoc-style, and Sphinx-style docstrings. See Griffe's documentation on docstrings support.
Homepage    cgit ¦ Codeberg ¦ GitHub ¦ GitLab ¦ SVNWeb - no subversion history for this port

Manual pages:
FreshPorts has no man page information for this port.
pkg-plist: as obtained via: make generate-plist
There is no configure plist information for this port.
Dependency lines:
  • ${PYTHON_PKGNAMEPREFIX}mkdocstrings-python>0:textproc/py-mkdocstrings-python@${PY_FLAVOR}
Conflicts:
CONFLICTS_INSTALL:
  • py311-mkdocstrings-python-legacy
To install the port:
cd /usr/ports/textproc/py-mkdocstrings-python/ && make install clean
To add the package, run one of these commands:
  • pkg install textproc/py-mkdocstrings-python
  • pkg install py311-mkdocstrings-python
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above.
NOTE: This is a Python port. Instead of py311-mkdocstrings-python listed in the above command, you can pick from the names under the Packages section.
PKGNAME: py311-mkdocstrings-python
Package flavors (<flavor>: <package>)
  • py311: py311-mkdocstrings-python
distinfo:
TIMESTAMP = 1730478336 SHA256 (mkdocstrings_python-1.12.2.tar.gz) = 7a1760941c0b52a2cd87b960a9e21112ffe52e7df9d0b9583d04d47ed2e186f3 SIZE (mkdocstrings_python-1.12.2.tar.gz) = 168207

Packages (timestamps in pop-ups are UTC):
py39-mkdocstrings-python
ABIaarch64amd64armv6armv7i386powerpcpowerpc64powerpc64le
FreeBSD:13:latest--------
FreeBSD:13:quarterly-----1.7.51.7.51.7.5
FreeBSD:14:latest--------
FreeBSD:14:quarterly-----1.7.51.7.51.7.5
FreeBSD:15:latest--n/a-n/a1.8.01.8.01.8.0
 

py311-mkdocstrings-python
ABIaarch64amd64armv6armv7i386powerpcpowerpc64powerpc64le
FreeBSD:13:latest1.11.11.11.1-1.11.11.11.1---
FreeBSD:13:quarterly1.11.11.11.1-1.11.11.11.1---
FreeBSD:14:latest1.11.11.12.2-1.11.11.12.2---
FreeBSD:14:quarterly1.11.11.11.1-1.11.11.11.1---
FreeBSD:15:latest1.11.11.12.2n/a1.11.1n/a---
 

Dependencies
NOTE: FreshPorts displays only information on required and default dependencies. Optional dependencies are not covered.
Build dependencies:
  1. py311-pdm-backend>0 : devel/py-pdm-backend@py311
  2. python3.11 : lang/python311
  3. py311-build>=0 : devel/py-build@py311
  4. py311-installer>=0 : devel/py-installer@py311
Test dependencies:
  1. py311-mkdocs-material>0 : textproc/py-mkdocs-material@py311
  2. py311-mkdocstrings>=0.26 : textproc/py-mkdocstrings@py311
  3. py311-pytest>=7,1 : devel/py-pytest@py311
  4. python3.11 : lang/python311
Runtime dependencies:
  1. py311-griffe>=0.49 : textproc/py-griffe@py311
  2. py311-mkdocs-autorefs>=1.2 : textproc/py-mkdocs-autorefs@py311
  3. python3.11 : lang/python311
There are no ports dependent upon this port

Configuration Options:
No options to configure
Options name:
textproc_py-mkdocstrings-python
USES:
python:3.9+
FreshPorts was unable to extract/find any pkg message
Master Sites:
Expand this list (2 items)
Collapse this list.
  1. https://files.pythonhosted.org/packages/source/m/mkdocstrings_python/
  2. https://pypi.org/packages/source/m/mkdocstrings_python/
Collapse this list.

Number of commits found: 19

Commit History - (may be incomplete: for full details, see links to repositories near top of page)
CommitCreditsLog message
1.12.2
03 Nov 2024 10:13:40
commit hash: 19f71b70f4138ee338e95ebef921b6c17e810e26commit hash: 19f71b70f4138ee338e95ebef921b6c17e810e26commit hash: 19f71b70f4138ee338e95ebef921b6c17e810e26commit hash: 19f71b70f4138ee338e95ebef921b6c17e810e26 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.12.2

* Support for Python 3.8 was dropped with the 1.12.0 release, adjust
  USES=python accordingly.
1.11.1
06 Oct 2024 12:52:24
commit hash: 171b1649ecfa63ac4b227d0325fb7b893ee7e387commit hash: 171b1649ecfa63ac4b227d0325fb7b893ee7e387commit hash: 171b1649ecfa63ac4b227d0325fb7b893ee7e387commit hash: 171b1649ecfa63ac4b227d0325fb7b893ee7e387 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.11.1

Changelog since 1.10.9:

https://github.com/mkdocstrings/python/blob/1.11.1/CHANGELOG.md
1.10.9
02 Sep 2024 10:38:38
commit hash: 83c48bd7676941d3a5768b06cbaa6c3c9c0bce73commit hash: 83c48bd7676941d3a5768b06cbaa6c3c9c0bce73commit hash: 83c48bd7676941d3a5768b06cbaa6c3c9c0bce73commit hash: 83c48bd7676941d3a5768b06cbaa6c3c9c0bce73 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.10.9

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.10.9
1.10.8
18 Aug 2024 07:17:30
commit hash: 462f4c66ebe0a6d5add1e72c7aff5ba8345031dccommit hash: 462f4c66ebe0a6d5add1e72c7aff5ba8345031dccommit hash: 462f4c66ebe0a6d5add1e72c7aff5ba8345031dccommit hash: 462f4c66ebe0a6d5add1e72c7aff5ba8345031dc files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.10.8

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.10.8
1.10.7
27 Jul 2024 12:53:58
commit hash: 83f2d2e890b359f52216b8f1d87b2ac01b1825f0commit hash: 83f2d2e890b359f52216b8f1d87b2ac01b1825f0commit hash: 83f2d2e890b359f52216b8f1d87b2ac01b1825f0commit hash: 83f2d2e890b359f52216b8f1d87b2ac01b1825f0 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.10.7

* Switch back to PyPI because the tests are now available in the sdists
  again since the 1.10.7 release.

Changelogs since 1.10.5:

https://github.com/mkdocstrings/python/releases/tag/1.10.7
https://github.com/mkdocstrings/python/releases/tag/1.10.6
1.10.5
13 Jul 2024 07:25:36
commit hash: d9968fa361bc6eca7d5152e6e03efabd506bcb7ccommit hash: d9968fa361bc6eca7d5152e6e03efabd506bcb7ccommit hash: d9968fa361bc6eca7d5152e6e03efabd506bcb7ccommit hash: d9968fa361bc6eca7d5152e6e03efabd506bcb7c files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.10.5

* Switch to GitHub to continue using the test suite, which is currently
  not included with the recent sdist tarballs.  This now makes it
  possible to run all tests, some of which were not included in the
  sdist.

Changelog since 1.10.3:

https://github.com/mkdocstrings/python/blob/1.10.5/CHANGELOG.md
1.10.3
16 Jun 2024 08:09:08
commit hash: f227987982aed1fa1c6ad30a88aab2401fd8a6c7commit hash: f227987982aed1fa1c6ad30a88aab2401fd8a6c7commit hash: f227987982aed1fa1c6ad30a88aab2401fd8a6c7commit hash: f227987982aed1fa1c6ad30a88aab2401fd8a6c7 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.10.3

Changelog since 1.10.0:

https://github.com/mkdocstrings/python/blob/1.10.3/CHANGELOG.md
1.10.0
24 Apr 2024 03:58:46
commit hash: 7cbc2c867b45b587cab128119d6b22bfd4797ea4commit hash: 7cbc2c867b45b587cab128119d6b22bfd4797ea4commit hash: 7cbc2c867b45b587cab128119d6b22bfd4797ea4commit hash: 7cbc2c867b45b587cab128119d6b22bfd4797ea4 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.10.0

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.10.0
1.9.2
05 Apr 2024 14:00:41
commit hash: 67651d1622c8a2d94c122efef130f49af2ebed9dcommit hash: 67651d1622c8a2d94c122efef130f49af2ebed9dcommit hash: 67651d1622c8a2d94c122efef130f49af2ebed9dcommit hash: 67651d1622c8a2d94c122efef130f49af2ebed9d files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.9.2

Changelog since 1.9.0:

https://github.com/mkdocstrings/python/blob/1.9.2/CHANGELOG.md
1.9.0
16 Mar 2024 07:43:51
commit hash: 51fa2375a425766c3a33530f846b032e73add3ddcommit hash: 51fa2375a425766c3a33530f846b032e73add3ddcommit hash: 51fa2375a425766c3a33530f846b032e73add3ddcommit hash: 51fa2375a425766c3a33530f846b032e73add3dd files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.9.0

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.9.0
1.8.0
13 Jan 2024 11:23:49
commit hash: 9fe6a2b0dc0a42a711996dc3a76dc84be55c253fcommit hash: 9fe6a2b0dc0a42a711996dc3a76dc84be55c253fcommit hash: 9fe6a2b0dc0a42a711996dc3a76dc84be55c253fcommit hash: 9fe6a2b0dc0a42a711996dc3a76dc84be55c253f files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.8.0

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.8.0
1.7.5
03 Dec 2023 15:02:50
commit hash: d1976e40e080b438e8ecf0d7b94c8f4b3f09f12ecommit hash: d1976e40e080b438e8ecf0d7b94c8f4b3f09f12ecommit hash: d1976e40e080b438e8ecf0d7b94c8f4b3f09f12ecommit hash: d1976e40e080b438e8ecf0d7b94c8f4b3f09f12e files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.7.5

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.7.5
1.7.4
20 Nov 2023 11:25:43
commit hash: c78b42029b3363d956a3498cb1224603c57470c5commit hash: c78b42029b3363d956a3498cb1224603c57470c5commit hash: c78b42029b3363d956a3498cb1224603c57470c5commit hash: c78b42029b3363d956a3498cb1224603c57470c5 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.7.4

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.7.4
1.7.3
31 Oct 2023 12:33:16
commit hash: c486888148ac9addf3b5f72925fc29a915f81548commit hash: c486888148ac9addf3b5f72925fc29a915f81548commit hash: c486888148ac9addf3b5f72925fc29a915f81548commit hash: c486888148ac9addf3b5f72925fc29a915f81548 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.7.3

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.7.3
1.7.2
09 Oct 2023 10:25:52
commit hash: da38ac96ce1763a3a94ceaf2c5e50431a08b4752commit hash: da38ac96ce1763a3a94ceaf2c5e50431a08b4752commit hash: da38ac96ce1763a3a94ceaf2c5e50431a08b4752commit hash: da38ac96ce1763a3a94ceaf2c5e50431a08b4752 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.7.2

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.7.2
1.7.1
01 Oct 2023 10:27:58
commit hash: 000d9dda5fd0f02d8cc2dbe72caf3c554dca2dd0commit hash: 000d9dda5fd0f02d8cc2dbe72caf3c554dca2dd0commit hash: 000d9dda5fd0f02d8cc2dbe72caf3c554dca2dd0commit hash: 000d9dda5fd0f02d8cc2dbe72caf3c554dca2dd0 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.7.1

Changelog:

https://github.com/mkdocstrings/python/releases/tag/1.7.1
1.7.0
18 Sep 2023 05:14:16
commit hash: e75369a79ffbb80f8d50b3c7081e52cf2c14a2a6commit hash: e75369a79ffbb80f8d50b3c7081e52cf2c14a2a6commit hash: e75369a79ffbb80f8d50b3c7081e52cf2c14a2a6commit hash: e75369a79ffbb80f8d50b3c7081e52cf2c14a2a6 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.7.0

Changelog since 1.6.2:

https://github.com/mkdocstrings/python/blob/1.7.0/CHANGELOG.md
1.6.2
11 Sep 2023 03:16:07
commit hash: af02bab1fe864f9c3a7c05d6c6b2fbc6836b4c70commit hash: af02bab1fe864f9c3a7c05d6c6b2fbc6836b4c70commit hash: af02bab1fe864f9c3a7c05d6c6b2fbc6836b4c70commit hash: af02bab1fe864f9c3a7c05d6c6b2fbc6836b4c70 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: Update to 1.6.2

Changelog since 1.6.0:

https://github.com/mkdocstrings/python/blob/1.6.2/CHANGELOG.md
1.6.0
31 Aug 2023 05:43:40
commit hash: 656e2aeca87724087da0235269e9d7ae1e6118e8commit hash: 656e2aeca87724087da0235269e9d7ae1e6118e8commit hash: 656e2aeca87724087da0235269e9d7ae1e6118e8commit hash: 656e2aeca87724087da0235269e9d7ae1e6118e8 files touched by this commit
Kai Knoblich (kai) search for other commits by this committer
textproc/py-mkdocstrings-python: New port

This Python handler for the "mkdocstrings" package uses Griffe
(= textproc/py-griffe) to collect documentation from Python source code.

Features:

* Data collection from source code: collection of the object-tree and
  the docstrings is done thanks to Griffe.

* Support for type annotations: Griffe collects your type annotations
  and mkdocstrings uses them to display parameter types or return types.

* Recursive documentation of Python objects: just use the module
  dotted-path as an identifier, and you get the full module docs. You
  don't need to inject documentation for each class, function, etc.

* Support for documented attributes: attributes (variables) followed by
  a docstring (triple-quoted string) will be recognized by Griffe in
  modules, classes and even in __init__ methods.

* Multiple docstring-styles support: common support for Google-style,
  Numpydoc-style, and Sphinx-style docstrings. See Griffe's
  documentation on docstrings support.

Number of commits found: 19