Fix linting and only render subset of docs as jinja2

Author: rod7760

docs/conf.py

@@ -60,14 +60,17 @@
 
 def rstjinja(app, docname, source):
     """
-    Render our pages as a jinja template for fancy templating goodness.
+    Render certain pages as a jinja templates.
     """
     # this should only be run when building html
     if app.builder.format != "html":
         return
-    src = source[0]
-    rendered = app.builder.templates.render_string(src, app.config.html_context)
-    source[0] = rendered
+    # We currently only render docs/operations.rst
+    # and docs/facts.rst as jinja2 templates
+    if docname in ["operations", "facts"]:
+        src = source[0]
+        rendered = app.builder.templates.render_string(src, app.config.html_context)
+        source[0] = rendered
 
 
 def setup(app):

src/pyinfra/api/metadata.py

@@ -5,7 +5,7 @@
 """
 
 import tomllib
-from typing import Literal
+from typing import Literal, get_args
 
 from pydantic import BaseModel, TypeAdapter, field_validator
 
@@ -34,24 +34,17 @@ class Tag(BaseModel):
 
     @field_validator("value", mode="before")
     def _validate_value(cls, v) -> AllowedTagType:
-        allowed_tags = set(AllowedTagType.__args__)
+        allowed_tags = set(get_args(AllowedTagType))
         if v not in allowed_tags:
-            raise ValueError(f"Invalid tag: {self.value}. Allowed: {allowed_tags}")
+            raise ValueError(f"Invalid tag: {v}. Allowed: {allowed_tags}")
         return v
 
     @property
     def title_case(self) -> str:
         return " ".join([t.title() for t in self.value.split("-")])
 
-    def __eq__(self, other):
-        if isinstance(other, Tag):
-            return self.value == other.value
-        if isinstance(other, str):
-            return self.value == other
-        return NotImplemented
 
-
-ALLOWED_TAGS = [Tag(value=tag) for tag in set(AllowedTagType.__args__)]
+ALLOWED_TAGS = [Tag(value=tag) for tag in set(get_args(AllowedTagType))]
 
 
 class Plugin(BaseModel):
@@ -73,6 +66,4 @@ def parse_plugins(metadata_text: str) -> list[Plugin]:
     pyinfra_metadata = tomllib.loads(metadata_text).get("pyinfra", None)
     if not pyinfra_metadata:
         raise ValueError("Missing [pyinfra.plugins] section in pyinfra-metadata.toml")
-    return TypeAdapter(list[Plugin]).validate_python(
-        pyinfra_metadata["plugins"].values()
-    )
+    return TypeAdapter(list[Plugin]).validate_python(pyinfra_metadata["plugins"].values())