readme_patcher 0.5.0

Generate README files from templates. Allow input from functions calls and cli output.

readme_patcher

Generate README files from templates. Allow input from functions calls and cli output.

cd your-project
vim README_template.rst
poetry add --group dev readme-patcher
poetry shell
readme-patcher # README.rst

Global objects

py_project

{{ py_project.repository }}

github

{{ github.name }}
{{ github.full_name }}
{{ github.description }}

badge

{{ badge.pypi }}
{{ badge.github_workflow('tests' 'Tests') }}
{{ badge.readthedocs }}

Functions

cli: Combined output (stdout and stderr) of command line interfaces (scripts / binaries)

{{ cli('awk --help') }}

func: return values of Python functions

{{ func('os.getcwd') }}

read: read text files

{{ read('code/example.py') | code('python') }}

Filters

code

{{ 'print("example")' | code('python') }}

.. code-block:: python

    print("example")

literal

{{ func('os.getcwd') | literal }}

::

    /home/repos/project

Configuration

[[tool.readme_patcher.file]]
src = "README_template.rst"
dest = "README.rst"
variables = { cwd = "func:os.getcwd", fortune = "cli:fortune --help" }