rstobj 2.0.0__tar.gz → 2.0.1__tar.gz

{rstobj-2.0.0/rstobj.egg-info → rstobj-2.0.1}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: rstobj
-Version: 2.0.0
-Summary: An example project generated by cookiecutter-pywf_open_source.
-Author-email: Sanhe Hu <husanhe@email.com>
-Maintainer-email: Sanhe Hu <husanhe@email.com>
+Version: 2.0.1
+Summary: Construct reStructuredText markup and directives from Python code.
+Author-email: Sanhe Hu <husanhe@gmail.com>
+Maintainer-email: Sanhe Hu <husanhe@gmail.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/MacHu-GWU/rstobj-project
 Project-URL: Documentation, https://rstobj.readthedocs.io/en/latest/
@@ -17,30 +17,36 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: Unix
-Requires-Python: <4.0,>=3.10
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <4.0,>=3.11
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 License-File: AUTHORS.rst
-Requires-Dist: jinja2
+Requires-Dist: jinja2<4.0.0,>=3.1.0
 Provides-Extra: dev
-Requires-Dist: rich<14.0.0,>=13.8.1; extra == "dev"
+Requires-Dist: rich<15.0.0,>=14.3.4; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pytest<9.0.0,>=8.2.2; extra == "test"
-Requires-Dist: pytest-cov<7.0.0,>=6.0.0; extra == "test"
+Requires-Dist: pytest<10.0.0,>=9.1.1; extra == "test"
+Requires-Dist: pytest-cov<8.0.0,>=7.1.0; extra == "test"
+Requires-Dist: docutils<1.0.0,>=0.21.2; extra == "test"
 Provides-Extra: doc
-Requires-Dist: Sphinx<8.0.0,>=7.4.7; extra == "doc"
+Requires-Dist: Sphinx<9.0.0,>=8.2.3; extra == "doc"
 Requires-Dist: sphinx-copybutton<1.0.0,>=0.5.2; extra == "doc"
-Requires-Dist: sphinx-design<1.0.0,>=0.6.1; extra == "doc"
+Requires-Dist: sphinx-design<1.0.0,>=0.7.0; extra == "doc"
 Requires-Dist: sphinx-jinja<3.0.0,>=2.0.2; extra == "doc"
-Requires-Dist: furo==2024.8.6; extra == "doc"
+Requires-Dist: furo==2025.12.19; extra == "doc"
 Requires-Dist: pygments<3.0.0,>=2.18.0; extra == "doc"
 Requires-Dist: ipython<8.19.0,>=8.18.1; extra == "doc"
-Requires-Dist: nbsphinx<1.0.0,>=0.8.12; extra == "doc"
-Requires-Dist: docfly==3.0.1; extra == "doc"
+Requires-Dist: ipykernel<8.0.0,>=7.3.0; extra == "doc"
+Requires-Dist: nbsphinx<1.0.0,>=0.9.8; extra == "doc"
+Requires-Dist: docfly<4.0.0,>=3.0.3; extra == "doc"
 Provides-Extra: mise
 Requires-Dist: PyGithub<3.0.0,>=2.8.0; extra == "mise"
-Requires-Dist: httpx<1.0.0,>=0.28.0; extra == "mise"
-Requires-Dist: tomli<3.0.0,>=2.0.0; python_version < "3.11" and extra == "mise"
+Requires-Dist: httpx2<3.0.0,>=2.13.1; extra == "mise"
 Dynamic: license-file
 
 
@@ -116,23 +122,21 @@ I have a `Blog Post <https://github.com/MacHu-GWU/Tech-Blog/issues/6>`_ to share
 
 .. code-block:: python
 
-    import rstobj # or from rstobj import *
+    import rstobj.api as rstobj
 
     header = rstobj.markup.Header(title="Section1", header_level=1, auto_label=True)
-    rst_header = header.render()
-    print(rst_header)
+    print(header.render())
 
     ltable = rstobj.directives.ListTable(
         data=[["id", "name"], [1, "Alice"], [2, "Bob"]],
         title="Users",
         header=True,
     )
-    rst = ltable.render()
-    print(rst_ltable)
+    print(ltable.render())
 
 Output::
 
-    .. _section1:
+    .. _Section1:
 
     Section1
     ========
@@ -148,7 +152,9 @@ Output::
         * - 2
           - Bob
 
-I recommend to use this in your jinja2 template, content of ``outut.rst``::
+See the `Rendering Gallery <https://rstobj.readthedocs.io/en/latest/01-Rendering-Gallery/index.html>`_ for every supported markup and directive, with its Python code, its output, and how it renders.
+
+I recommend to use this in your jinja2 template, content of ``output.rst``::
 
     {{ header.render() }}
     {{ ltable.render() }}
@@ -195,3 +201,16 @@ To upgrade to latest version:
 .. code-block:: console
 
     $ pip install --upgrade rstobj
+
+.. _use-with-ai-coding-agents:
+
+Use with AI Coding Agents
+------------------------------------------------------------------------------
+
+This repo ships an `Agent Skill <https://code.claude.com/docs/en/skills>`_ that documents the public API of ``rstobj``, so an AI coding agent such as Claude Code can use the library without reading its source. It lives in `.claude/skills/pypi-rstobj <https://github.com/MacHu-GWU/rstobj-project/tree/main/.claude/skills/pypi-rstobj>`_. To use it in your project, copy it into your project's ``.claude/skills/`` folder. Run this from your project's root:
+
+.. code-block:: console
+
+    $ git clone --depth 1 https://github.com/MacHu-GWU/rstobj-project.git /tmp/rstobj-project
+    $ mkdir -p .claude/skills
+    $ cp -R /tmp/rstobj-project/.claude/skills/pypi-rstobj .claude/skills/

{rstobj-2.0.0 → rstobj-2.0.1}/README.rst

@@ -71,23 +71,21 @@ I have a `Blog Post <https://github.com/MacHu-GWU/Tech-Blog/issues/6>`_ to share
 
 .. code-block:: python
 
-    import rstobj # or from rstobj import *
+    import rstobj.api as rstobj
 
     header = rstobj.markup.Header(title="Section1", header_level=1, auto_label=True)
-    rst_header = header.render()
-    print(rst_header)
+    print(header.render())
 
     ltable = rstobj.directives.ListTable(
         data=[["id", "name"], [1, "Alice"], [2, "Bob"]],
         title="Users",
         header=True,
     )
-    rst = ltable.render()
-    print(rst_ltable)
+    print(ltable.render())
 
 Output::
 
-    .. _section1:
+    .. _Section1:
 
     Section1
     ========
@@ -103,7 +101,9 @@ Output::
         * - 2
           - Bob
 
-I recommend to use this in your jinja2 template, content of ``outut.rst``::
+See the `Rendering Gallery <https://rstobj.readthedocs.io/en/latest/01-Rendering-Gallery/index.html>`_ for every supported markup and directive, with its Python code, its output, and how it renders.
+
+I recommend to use this in your jinja2 template, content of ``output.rst``::
 
     {{ header.render() }}
     {{ ltable.render() }}
@@ -149,4 +149,17 @@ To upgrade to latest version:
 
 .. code-block:: console
 
-    $ pip install --upgrade rstobj
+    $ pip install --upgrade rstobj
+
+.. _use-with-ai-coding-agents:
+
+Use with AI Coding Agents
+------------------------------------------------------------------------------
+
+This repo ships an `Agent Skill <https://code.claude.com/docs/en/skills>`_ that documents the public API of ``rstobj``, so an AI coding agent such as Claude Code can use the library without reading its source. It lives in `.claude/skills/pypi-rstobj <https://github.com/MacHu-GWU/rstobj-project/tree/main/.claude/skills/pypi-rstobj>`_. To use it in your project, copy it into your project's ``.claude/skills/`` folder. Run this from your project's root:
+
+.. code-block:: console
+
+    $ git clone --depth 1 https://github.com/MacHu-GWU/rstobj-project.git /tmp/rstobj-project
+    $ mkdir -p .claude/skills
+    $ cp -R /tmp/rstobj-project/.claude/skills/pypi-rstobj .claude/skills/

rstobj-2.0.1/pyproject.toml

@@ -0,0 +1,131 @@
+# [project] table: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+[project]
+name = "rstobj"
+# Bump before each release (https://semver.org/), then ``mise run inst`` to update ``uv.lock``.
+version = "2.0.1"
+description = "Construct reStructuredText markup and directives from Python code."
+# An SPDX license expression (PEP 639); keep ``LICENSE.txt`` in sync.
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license-and-license-files
+# Valid identifiers: https://spdx.org/licenses/
+license = "MIT"
+license-files = ["LICENSE.txt", "AUTHORS.rst"]
+authors = [
+    { name = "Sanhe Hu", email = "husanhe@gmail.com" },
+]
+maintainers = [
+    { name = "Sanhe Hu", email = "husanhe@gmail.com" },
+]
+keywords = []
+readme = "README.rst"
+requires-python = ">=3.11,<4.0"
+# Read: https://pypi.org/classifiers/
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: MacOS",
+    "Operating System :: Unix",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+# --- Dependencies ---
+# Edit these lists, then ``mise run inst`` to update ``uv.lock`` and ``.venv``.
+dependencies = [
+    "jinja2>=3.1.0,<4.0.0", # renders the reST templates in rstobj/templates
+]
+
+# --- Optional dependencies (extras) ---
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#dependencies-optional-dependencies
+# Each one must support every Python version in ``requires-python``.
+[project.optional-dependencies]
+
+# local development
+dev = [
+    "rich>=14.3.4,<15.0.0",
+]
+
+# tests and coverage
+test = [
+    "pytest>=9.1.1,<10.0.0",
+    "pytest-cov>=7.1.0,<8.0.0",
+    "docutils>=0.21.2,<1.0.0", # checks that the rendered reST is valid
+]
+
+# docs build
+doc = [
+    "Sphinx>=8.2.3,<9.0.0", # held below 9 until its autodoc rewrite is verified
+    "sphinx-copybutton>=0.5.2,<1.0.0", # copy button on code blocks
+    "sphinx-design>=0.7.0,<1.0.0", # cards, tabs, grids
+    "sphinx-jinja>=2.0.2,<3.0.0", # jinja in reST
+    "furo==2025.12.19", # theme
+    "pygments>=2.18.0,<3.0.0", # syntax highlighting
+    "ipython>=8.18.1,<8.19.0", # notebook execution
+    "ipykernel>=7.3.0,<8.0.0", # notebook kernel
+    "nbsphinx>=0.9.8,<1.0.0", # notebooks as doc pages
+    "docfly>=3.0.3,<4.0.0", # toctree and API reference
+]
+
+# mise tasks
+mise = [
+    "PyGithub>=2.8.0,<3.0.0", # GitHub API client
+    "httpx2>=2.13.1,<3.0.0", # Codecov and Read the Docs APIs
+]
+
+[project.urls]
+Homepage = "https://github.com/MacHu-GWU/rstobj-project"
+Documentation = "https://rstobj.readthedocs.io/en/latest/"
+Repository = "https://github.com/MacHu-GWU/rstobj-project"
+Issues = "https://github.com/MacHu-GWU/rstobj-project/issues"
+Changelog = "https://github.com/MacHu-GWU/rstobj-project/blob/main/release-history.rst"
+Download = "https://pypi.org/pypi/rstobj#files"
+
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#creating-executable-scripts
+[project.scripts]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = [
+    "rstobj*",
+]
+exclude = [
+    "rstobj.tests",
+    "rstobj.tests.*",
+    "rstobj.docs",
+    "rstobj.docs.*",
+]
+
+# Non-Python files shipped in the wheel: the jinja2 templates rendered by ``rstobj.templates``.
+[tool.setuptools.package-data]
+rstobj = [
+    "templates/*.rst",
+]
+
+# --- ruff: ``mise run format`` / ``mise run lint`` ---
+[tool.ruff]
+extend-exclude = [
+    "rstobj/vendor",
+    ".claude/skills/*/assets", # templates, not valid Python
+]
+
+[tool.ruff.lint.per-file-ignores]
+# re-export modules
+"**/__init__.py" = ["F401"]
+"**/api.py" = ["F401"]
+
+# --- pytest 9+ native table ---
+# Read: https://docs.pytest.org/en/stable/reference/customize.html#pyproject-toml
+[tool.pytest]
+testpaths = ["tests"]
+# strict = true # only with a pinned pytest
+# filterwarnings = ["error"]
+# markers = ["slow: tests that take more than a few seconds"]
+
+# --- Build (``mise run build``); setuptools 77+ for PEP 639 ``license`` ---
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"

rstobj-2.0.1/rstobj/base.py

@@ -0,0 +1,139 @@
+# -*- coding: utf-8 -*-
+
+"""
+RestructuredText Object abstraction.
+"""
+
+from __future__ import annotations
+
+import typing as T
+from dataclasses import dataclass
+
+if T.TYPE_CHECKING:  # pragma: no cover
+    from jinja2 import Template
+
+from .templates import env
+from .option import Options
+
+
+def _indent_line(line: str, prefix: str) -> str:
+    """
+    Prefix a line and strip its trailing whitespace. A blank line stays empty,
+    so indenting never leaves whitespace-only lines.
+    """
+    line = line.rstrip()
+    if line:
+        return prefix + line
+    else:
+        return ""
+
+
+def _indent_continuation(text: str, width: int, force: bool) -> str:
+    """
+    Indent every line after the first by ``width`` spaces, so a multi-line
+    text stays inside the list item or table cell it starts in.
+
+    :param force: if False, text whose continuation lines are all indented by
+        at least ``width`` already is returned unchanged, so callers that
+        indented their strings by hand keep the same output.
+    """
+    lines = text.split("\n")
+    rest = lines[1:]
+    if not force:
+        is_indented = all(
+            (not line.strip()) or (len(line) - len(line.lstrip(" ")) >= width)
+            for line in rest
+        )
+        if is_indented:
+            return text
+    prefix = " " * width
+    return "\n".join([lines[0]] + [_indent_line(line, prefix) for line in rest])
+
+
+@dataclass(kw_only=True)
+class RstObj:
+    """
+    The base restructured text object.
+    """
+
+    @property
+    def template_name(self) -> str:
+        """
+        Find template file.
+        """
+        return "{}.{}.rst".format(self.__module__, self.__class__.__name__)
+
+    @property
+    def template(self) -> Template:
+        """
+        Return ``jinja2.Template`` instance.
+        """
+        return env.get_template(self.template_name)
+
+    def render(
+        self,
+        indent: int | None = None,
+        first_line_indent: int | None = None,
+        **kwargs,
+    ) -> str:
+        """
+        Render this object into text.
+
+        :param indent: global indent. Indent length can be changed in
+            :attr:`rstobj.option.Options.tab`.
+
+        :param first_line_indent: sometimes we only need to indent
+            first line, this option will overwrite the ``indent`` argument.
+
+        :param kwargs: other optional arguments.
+        """
+        out = self.template.render(obj=self, tab=Options.tab)
+        if indent or first_line_indent:
+            origin_lines = out.split("\n")
+            target_lines = [
+                _indent_line(line, Options.tab * (indent or 0)) for line in origin_lines
+            ]
+            if first_line_indent is not None:
+                if first_line_indent >= 0:
+                    target_lines[0] = _indent_line(
+                        origin_lines[0],
+                        Options.tab * first_line_indent,
+                    )
+                else:  # pragma: no cover
+                    raise TypeError
+            out = "\n".join(target_lines)
+        return out
+
+    @staticmethod
+    def str_or_render(
+        value: str | RstObj,
+        **kwargs,
+    ) -> str:
+        """
+        If it is a string type, then just return. If it is a RstObj type,
+        then return the rendered string.
+        """
+        if isinstance(value, RstObj):
+            return value.render(**kwargs)
+        else:
+            return str(value)
+
+    @staticmethod
+    def _render_nested(
+        value: str | RstObj,
+        width: int,
+    ) -> str:
+        """
+        Render a list item or table cell whose text starts after a marker
+        ``width`` characters wide, such as ``"- "`` or ``"    * - "``.
+
+        A :class:`RstObj` is rendered without its leading and trailing blank
+        lines, and all its continuation lines are indented. A string is taken
+        as reStructuredText; its continuation lines are indented unless they
+        already are.
+        """
+        if isinstance(value, RstObj):
+            text = value.render().strip("\n")
+            return _indent_continuation(text, width, force=True)
+        else:
+            return _indent_continuation(str(value), width, force=False)

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/directives/base.py

@@ -3,7 +3,8 @@
 from __future__ import annotations
 
 import typing as T
-from dataclasses import dataclass, field
+from dataclasses import dataclass
+from dataclasses import field
 from ..base import RstObj
 
 
@@ -13,6 +14,8 @@ class Directive(RstObj):
     name: str | None = field(default=None)
 
     meta_directive_keyword: T.ClassVar[str | None] = None
+    #: False for a directive that has no ``:name:`` option, such as ``contents``.
+    meta_supports_name: T.ClassVar[bool] = True
 
     @property
     def arg(self):  # pragma: no cover

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/directives/codeblock.py

@@ -22,6 +22,9 @@ class Code(RstObj):
 @dataclass(kw_only=True)
 class CodeBlockEmpty(Directive):
     """
+    A literal block (``::``). It has no options, so ``class_`` and ``name``
+    are not rendered.
+
     Example::
 
         code = "your code ..."
@@ -92,7 +95,7 @@ Example::
 
 Output::
 
-    .. code-block: {}
+    .. code-block:: {}
 
         your code ...
 """.strip()

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/directives/image.py

@@ -7,7 +7,8 @@ image related directives.
 from __future__ import annotations
 
 import typing as T
-from dataclasses import dataclass, field
+from dataclasses import dataclass
+from dataclasses import field
 from .base import Directive
 
 
@@ -21,9 +22,12 @@ class Image(Directive):
     :param uri: required.
     :param height: optional.
     :param width: optional.
-    :param scale: optional.
+    :param scale: optional, a percentage, rendered as ``:scale: 50%``.
     :param alt_text: optional.
     :param align: optional. one of :class:`Image.AlignOptions`.
+        ``"top"``, ``"middle"`` and ``"bottom"`` are only valid for an image
+        inside a substitution definition; a standalone image accepts
+        ``"left"``, ``"center"`` and ``"right"``.
 
     Example::
 

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/directives/miscellaneous.py

@@ -7,7 +7,8 @@ Other directives.
 from __future__ import annotations
 
 import typing as T
-from dataclasses import dataclass, field
+from dataclasses import dataclass
+from dataclasses import field
 from .base import Directive
 
 

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/directives/table.py

@@ -7,7 +7,8 @@ table related directives.
 from __future__ import annotations
 
 import typing as T
-from dataclasses import dataclass, field
+from dataclasses import dataclass
+from dataclasses import field
 from .base import Directive
 
 

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/directives/toc.py

@@ -7,7 +7,8 @@ table of content directive.
 from __future__ import annotations
 
 import typing as T
-from dataclasses import dataclass, field
+from dataclasses import dataclass
+from dataclasses import field
 from .base import Directive
 
 
@@ -22,6 +23,9 @@ class TableOfContent(Directive):
     :param depth: int, optional.
     :param local: bool, optional.
 
+    The ``contents`` directive has no ``:name:`` option, so ``name`` is
+    not rendered.
+
     :type backlinks: str
     :param backlinks: optional. one of
         :attr:`TableOfContent.BacklinksOptions`.
@@ -43,6 +47,7 @@ class TableOfContent(Directive):
     backlinks: str | None = field(default=None)
 
     meta_directive_keyword: T.ClassVar[str] = "contents"
+    meta_supports_name: T.ClassVar[bool] = False
 
     class BacklinksOptions:
         """

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/markup/enum_list.py

@@ -6,7 +6,8 @@ Enumerate list.
 
 from __future__ import annotations
 
-from dataclasses import dataclass, field
+from dataclasses import dataclass
+from dataclasses import field
 from ..base import RstObj
 
 

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/markup/header.py

@@ -16,8 +16,9 @@ Default `section header line <http://docutils.sourceforge.net/docs/user/rst/quic
 
 from __future__ import annotations
 
-import typing as T
-from dataclasses import dataclass, field
+import unicodedata
+from dataclasses import dataclass
+from dataclasses import field
 from ..base import RstObj
 
 dash_char_list = " _~"
@@ -39,6 +40,23 @@ def to_label(title: str) -> str:
     ])
 
 
+def _display_width(text: str) -> int:
+    """
+    The number of columns ``text`` takes on screen, as docutils counts them
+    to check a section underline: wide East Asian characters and emoji count
+    as two columns, combining characters as zero.
+    """
+    width = 0
+    for char in text:
+        if unicodedata.combining(char):
+            continue
+        if unicodedata.east_asian_width(char) in ("W", "F"):
+            width += 2
+        else:
+            width += 1
+    return width
+
+
 HEADER_CHAR_MAPPER = {
     1: "=",
     2: "-",
@@ -92,7 +110,7 @@ class Header(RstObj):
         if self.auto_label and (self.ref_label is None):
             self.ref_label = to_label(self.title)
 
-        title_length = len(self.title)
+        title_length = _display_width(self.title)
         if self.bar_length is None:
             self.bar_length = title_length
         elif self.bar_length < title_length:
@@ -112,12 +130,14 @@ class HeaderLevel(Header):
     pass
 
 
+# Starts with a newline: autodoc dedents every line after the first, so the
+# literal block must be indented relative to "Example::" on a later line.
 header_doc_string = """
-Example::
+    Example::
 
-    Header{level}
-    {bar}
-""".strip()
+        Header{level}
+        {bar}
+"""
 
 
 def _build_doc_string(header_level: int) -> str:

{rstobj-2.0.0 → rstobj-2.0.1}/rstobj/paths.py

@@ -15,6 +15,7 @@ class PathEnum:
     absolute paths to eliminate current directory dependencies and ensure consistent path
     resolution across different execution contexts and DevOps workflows.
     """
+
     @cached_property
     def dir_home(self):
         return Path.home()
@@ -24,10 +25,9 @@ class PathEnum:
 
     # Source Code
     dir_package = _dir_here
-    path_version_py = dir_package / "_version.py"
     path_pyproject_toml = dir_project_root / "pyproject.toml"
     path_requirements_txt = dir_project_root / "requirements.txt"
-    path_authors = dir_project_root / "AUTHORS.txt"
+    path_authors = dir_project_root / "AUTHORS.rst"
     path_license = dir_project_root / "LICENSE.txt"
     path_release_history = dir_project_root / "release-history.rst"
 

rstobj-2.0.1/rstobj/templates/__init__.py

@@ -0,0 +1,12 @@
+# -*- coding: utf-8 -*-
+
+import os
+from jinja2 import Environment
+from jinja2 import FileSystemLoader
+from jinja2 import StrictUndefined
+
+# StrictUndefined: a typo in a template raises instead of rendering nothing.
+env = Environment(
+    loader=FileSystemLoader(os.path.dirname(__file__)),
+    undefined=StrictUndefined,
+)

rstobj-2.0.1/rstobj/templates/rstobj.directives.base.Directive.rst

@@ -0,0 +1,8 @@
+.. {{ obj.meta_directive_keyword }}::{% if obj.arg %} {{ obj.arg }}{% endif %}
+{%- if obj.class_ is not none %}
+{{ tab }}:class: {{ obj.class_ }}
+{%- endif %}
+{%- if obj.name is not none and obj.meta_supports_name %}
+{{ tab }}:name: {{ obj.name }}
+{%- endif %}
+{%- block other %}{% endblock %}