The Python package custom_inherit provides convenient, light-weight tools for
inheriting docstrings in customizeable ways.
Features:
* Metaclass that instructs children to inherit docstrings for their
attributes from their parents, using custom docstring inheritance styles.
* Decorator that merges a string/docstring with the docstring of the decorated
object using custom styles.
* Built-in docstring merging styles for popular docstring specifications:
* NumPy docstring specification
* Napoleon docstring specifications (for both Google and NumPy styles)
* Merging based on reST sections
* Simple inheritance from a parent, if the docstring is not overwritten
* Simple interface for using your own docstring inheritance style.
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 py312-custom_inherit listed in the above command, you can pick from the names under the Packages section.
python: bump all USE_PYTHON=distutils consumers after RUN_DEPENDS removal
Any missed ports, feel free to bump.
Any ports that need setuptools at runtime can have the devel/py-setuptools
manually added back to RUN_DEPENDS, but understand that this practice
is deprecated; see CHANGES for details.
all: remove explicit versions in USES=python for "3.x+"
The logic in USES=python will automatically convert this to 3.8+ by
itself.
Adjust two ports that only had Python 3.7 mentioned but build fine
on Python 3.8 too.
finance/quickfix: mark BROKEN with PYTHON
libtool: compile: c++ -DHAVE_CONFIG_H -I. -I../.. -I -I. -I.. -I../.. -I../C++
-DLIBICONV_PLUG -DPYTHON_MAJOR_VERSION=3 -Wno-unused-variable
-Wno-maybe-uninitialized -O2 -pipe -DLIBICONV_PLUG -fstack-protector-strong
-fno-strict-aliasing -DLIBICONV_PLUG -Wall -ansi
-Wno-unused-command-line-argument -Wpointer-arith -Wwrite-strings
-Wno-overloaded-virtual -Wno-deprecated-declarations -Wno-deprecated -std=c++0x
-MT _quickfix_la-QuickfixPython.lo -MD -MP -MF
.deps/_quickfix_la-QuickfixPython.Tpo -c QuickfixPython.cpp -fPIC -DPIC -o
.libs/_quickfix_la-QuickfixPython.o
warning: unknown warning option '-Wno-maybe-uninitialized'; did you mean
'-Wno-uninitialized'? [-Wunknown-warning-option]
QuickfixPython.cpp:175:11: fatal error: 'Python.h' file not found
^~~~~~~~~~
1 warning and 1 error generated.
Reviewed by: portmgr, vishwin, yuri
Differential Revision: <https://reviews.freebsd.org/D40568>
Remove WWW entries moved into port Makefiles
Commit b7f05445c00f has added WWW entries to port Makefiles based on
WWW: lines in pkg-descr files.
This commit removes the WWW: lines of moved-over URLs from these
pkg-descr files.
Approved by: portmgr (tcberner)
Add WWW entries to port Makefiles
It has been common practice to have one or more URLs at the end of the
ports' pkg-descr files, one per line and prefixed with "WWW:". These
URLs should point at a project website or other relevant resources.
Access to these URLs required processing of the pkg-descr files, and
they have often become stale over time. If more than one such URL was
present in a pkg-descr file, only the first one was tarnsfered into
the port INDEX, but for many ports only the last line did contain the
port specific URL to further information.
There have been several proposals to make a project URL available as
a macro in the ports' Makefiles, over time.
(Only the first 15 lines of the commit message are shown above )
Update to version 2.3.1
Changes between 2.2.0 and 2.3.1:
* Add three new built-in styles, numpy_with_merge, google_with_merge, and
numpy_napoleon_with_merge, which permit users to concatenate the respective
sections of a parent's and child's docstrings.
* Added the ability to configure DocInheritMeta so that special methods will
have their docstrings inherited as well.
* The Methods section in a NumPy-style docstring is now recognized.
The Python package custom_inherit provides convenient, light-weight tools for
inheriting docstrings in customizeable ways.
Features:
* Metaclass that instructs children to inherit docstrings for their
attributes from their parents, using custom docstring inheritance styles.
* Decorator that merges a string/docstring with the docstring of the decorated
object using custom styles.
* Built-in docstring merging styles for popular docstring specifications:
* NumPy docstring specification
* Napoleon docstring specifications (for both Google and NumPy styles)
* Merging based on reST sections
* Simple inheritance from a parent, if the docstring is not overwritten
* Simple interface for using your own docstring inheritance style.
WWW: https://github.com/meowklaski/custom_inherit
