MkShields

Show source on GitHub

Container for Shields.io / GitHub badges.

ExamplesDocStringsBase classes⋔ Inheritance diagramNodeFileCode

Example: Regular

Jinja

{{ ["version", "status", "codecov"] | MkShields }}

Python

MkShields(['version', 'status', 'codecov'])

RenderedMarkdownHtmlRepr tree

[![PyPI Latest Version](https://img.shields.io/pypi/v/mknodes.svg)](https://pypi.org/project/mknodes/)
[![Package status](https://img.shields.io/pypi/status/mknodes.svg)](https://pypi.org/project/mknodes/)
[![Package status](https://codecov.io/gh/phil65/mknodes/branch/main/graph/badge.svg)](https://codecov.io/gh/phil65/mknodes/)

<p><a href="https://pypi.org/project//"><img alt="PyPI Latest Version" src="https://img.shields.io/pypi/v/.svg"></a>
<a href="https://pypi.org/project//"><img alt="Package status" src="https://img.shields.io/pypi/status/.svg"></a>
<a href="https://codecov.io/gh///"><img alt="Package status" src="https://codecov.io/gh///branch/main/graph/badge.svg"></a></p>

MkShields
├── MkImage('https://img.shields.io/pypi/v/mknodes.svg', target='https://pypi.org/project/mknodes/', title='PyPI Latest Version')
├── MkImage('https://img.shields.io/pypi/status/mknodes.svg', target='https://pypi.org/project/mknodes/', title='Package status')
╰── MkImage('https://codecov.io/gh/phil65/mknodes/branch/main/graph/badge.svg', target='https://codecov.io/gh/phil65/mknodes/', title='Package status')

Example: Explicit

Jinja

{{ ["version", "status", "codecov"] | MkShields(user="mkdocs", project="mkdocs") }}

Python

MkShields(['version', 'status', 'codecov'], user='mkdocs', project='mkdocs')

RenderedMarkdownHtmlRepr tree

[![PyPI Latest Version](https://img.shields.io/pypi/v/mkdocs.svg)](https://pypi.org/project/mkdocs/)
[![Package status](https://img.shields.io/pypi/status/mkdocs.svg)](https://pypi.org/project/mkdocs/)
[![Package status](https://codecov.io/gh/mkdocs/mkdocs/branch/main/graph/badge.svg)](https://codecov.io/gh/mkdocs/mkdocs/)

<p><a href="https://pypi.org/project/mkdocs/"><img alt="PyPI Latest Version" src="https://img.shields.io/pypi/v/mkdocs.svg"></a>
<a href="https://pypi.org/project/mkdocs/"><img alt="Package status" src="https://img.shields.io/pypi/status/mkdocs.svg"></a>
<a href="https://codecov.io/gh/mkdocs/mkdocs/"><img alt="Package status" src="https://codecov.io/gh/mkdocs/mkdocs/branch/main/graph/badge.svg"></a></p>

MkShields
├── MkImage('https://img.shields.io/pypi/v/mkdocs.svg', target='https://pypi.org/project/mkdocs/', title='PyPI Latest Version')
├── MkImage('https://img.shields.io/pypi/status/mkdocs.svg', target='https://pypi.org/project/mkdocs/', title='Package status')
╰── MkImage('https://codecov.io/gh/mkdocs/mkdocs/branch/main/graph/badge.svg', target='https://codecov.io/gh/mkdocs/mkdocs/', title='Package status')

Bases: MkContainer

__init__

__init__(
    shields: Sequence[badges.BadgeTypeStr] | None = None,
    *,
    user: str | None = None,
    project: str | None = None,
    branch: str | None = None,
    **kwargs: Any
)

Parameters:

Name	Type	Description	Default
shields	Sequence[BadgeTypeStr] | None	Shields to include	None
user	str | None	Github username for shields	None
project	str | None	project name for shields	None
branch	str | None	branch name for shields	None
kwargs	Any	Keyword arguments passed to parent	{}

Name	Children	Inherits
MkContainer mknodes.basenodes.mkcontainer A node containing other MkNodes.	MkBlock MkAdmonition MkBlockQuote MkCode MkTemplate MkList MkBaseTable MkTab MkTabContainer MkCritic MkAnnotation ...	MkNode

graph TD
  94854583219600["mkshields.MkShields"]
  94854582919984["mkcontainer.MkContainer"]
  94854582916880["mknode.MkNode"]
  94854582838576["node.Node"]
  140544995341632["builtins.object"]
  94854582919984 --> 94854583219600
  94854582916880 --> 94854582919984
  94854582838576 --> 94854582916880
  140544995341632 --> 94854582838576

/home/runner/work/mknodes/mknodes/mknodes/templatenodes/mkshields/metadata.toml

[metadata]
name = "MkShields"
icon = "simple-icons:shieldsdotio"
group = "badge"
virtual_children = true

[examples.regular]
title = "Regular"
jinja = """
{{ ["version", "status", "codecov"] | MkShields }}
"""

[examples.explicit]
title = "Explicit"
jinja = """
{{ ["version", "status", "codecov"] | MkShields(user="mkdocs", project="mkdocs") }}
"""

[output.markdown]
template = """
{{ node.items | join("\n") }}
"""
# {% for s in node.shields %}
# {{ s.image_url.format(user=node.user, project=node.project, branch=node.branch) | MkImage(target=s.get_url(user=node.user, project=node.project, title=node.title)) }}
# {% endfor %}

class MkShields(mkcontainer.MkContainer):
    """Container for Shields.io / GitHub badges."""

    ICON = "simple/shieldsdotio"
    VIRTUAL_CHILDREN = True
    ATTR_LIST_SEPARATOR = ""

    def __init__(
        self,
        shields: Sequence[badges.BadgeTypeStr] | None = None,
        *,
        user: str | None = None,
        project: str | None = None,
        branch: str | None = None,
        **kwargs: Any,
    ):
        """Constructor.

        Arguments:
            shields: Shields to include
            user: Github username for shields
            project: project name for shields
            branch: branch name for shields
            kwargs: Keyword arguments passed to parent
        """
        super().__init__(**kwargs)
        self.block_separator = "\n"
        self._user = user
        self._project = project
        self._branch = branch
        self._shields = shields

    @property
    def user(self):
        match self._user:
            case None:
                return self.ctx.metadata.repository_username
            case str():
                return self._user

    @user.setter
    def user(self, value):
        self._user = value

    @property
    def project(self):
        if isinstance(self._project, str):
            return self._project
        return self.ctx.metadata.repository_name

    @project.setter
    def project(self, value):
        self._project = value

    @property
    def shields(self):
        shields = self._shields or [i.identifier for i in badges.SHIELDS]
        return [s for s in badges.SHIELDS if s.identifier in shields]

    @property
    def branch(self) -> str:
        if isinstance(self._branch, str):
            return self._branch
        return self.ctx.git.main_branch or "main"

    @property
    def items(self) -> list[mknode.MkNode]:
        return [
            mkimage.MkImage(
                s.get_image_url(user=self.user, project=self.project, branch=self.branch),
                target=s.get_url(user=self.user, project=self.project),
                title=s.title,
                parent=self,
            )
            for s in self.shields
        ]

    @items.setter
    def items(self, value):
        pass