yanga 0.1.0__tar.gz

yanga-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2022 cuinixam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yanga-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.1
+Name: yanga
+Version: 0.1.0
+Summary: Yet another ninja generator to build C/CPP projects.
+Home-page: https://github.com/cuinixam/yanga
+License: MIT
+Author: cuinixam
+Author-email: me@cuinixam.com
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries
+Requires-Dist: loguru (>=0.7.0,<0.8.0)
+Requires-Dist: mashumaro (>=3.5,<4.0)
+Project-URL: Bug Tracker, https://github.com/cuinixam/yanga/issues
+Project-URL: Changelog, https://github.com/cuinixam/yanga/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://yanga.readthedocs.io
+Project-URL: Repository, https://github.com/cuinixam/yanga
+Description-Content-Type: text/markdown
+
+# README
+
+<p align="center">
+  <a href="https://github.com/cuinixam/yanga/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/cuinixam/yanga/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://yanga.readthedocs.io">
+    <img src="https://img.shields.io/readthedocs/yanga.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status">
+  </a>
+  <a href="https://codecov.io/gh/cuinixam/yanga">
+    <img src="https://img.shields.io/codecov/c/github/cuinixam/yanga.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+</p>
+<p align="center">
+  <a href="https://python-poetry.org/">
+    <img src="https://img.shields.io/badge/packaging-poetry-299bd7?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAASCAYAAABrXO8xAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAJJSURBVHgBfZLPa1NBEMe/s7tNXoxW1KJQKaUHkXhQvHgW6UHQQ09CBS/6V3hKc/AP8CqCrUcpmop3Cx48eDB4yEECjVQrlZb80CRN8t6OM/teagVxYZi38+Yz853dJbzoMV3MM8cJUcLMSUKIE8AzQ2PieZzFxEJOHMOgMQQ+dUgSAckNXhapU/NMhDSWLs1B24A8sO1xrN4NECkcAC9ASkiIJc6k5TRiUDPhnyMMdhKc+Zx19l6SgyeW76BEONY9exVQMzKExGKwwPsCzza7KGSSWRWEQhyEaDXp6ZHEr416ygbiKYOd7TEWvvcQIeusHYMJGhTwF9y7sGnSwaWyFAiyoxzqW0PM/RjghPxF2pWReAowTEXnDh0xgcLs8l2YQmOrj3N7ByiqEoH0cARs4u78WgAVkoEDIDoOi3AkcLOHU60RIg5wC4ZuTC7FaHKQm8Hq1fQuSOBvX/sodmNJSB5geaF5CPIkUeecdMxieoRO5jz9bheL6/tXjrwCyX/UYBUcjCaWHljx1xiX6z9xEjkYAzbGVnB8pvLmyXm9ep+W8CmsSHQQY77Zx1zboxAV0w7ybMhQmfqdmmw3nEp1I0Z+FGO6M8LZdoyZnuzzBdjISicKRnpxzI9fPb+0oYXsNdyi+d3h9bm9MWYHFtPeIZfLwzmFDKy1ai3p+PDls1Llz4yyFpferxjnyjJDSEy9CaCx5m2cJPerq6Xm34eTrZt3PqxYO1XOwDYZrFlH1fWnpU38Y9HRze3lj0vOujZcXKuuXm3jP+s3KbZVra7y2EAAAAAASUVORK5CYII=" alt="Poetry">
+  </a>
+  <a href="https://github.com/ambv/black">
+    <img src="https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square" alt="black">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/yanga/">
+    <img src="https://img.shields.io/pypi/v/yanga.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/yanga.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/yanga.svg?style=flat-square" alt="License">
+</p>
+
+Yet another ninja generator to build C/CPP projects.
+
+## Installation
+
+Install this via pip (or your favourite package manager):
+
+`pip install yanga`
+
+## Start developing
+
+The project uses Poetry for dependencies management and packaging.
+If you do not have Poetry installed, you can run the `boostrap.ps1` script.
+This will install Python and Poetry as configured in `scoopfile.json`.
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope CurrentUser -Force
+.\bootstrap.ps1
+```
+
+To install the development dependencies in a virtual environment, type:
+
+```shell
+poetry install
+```
+
+This will also generate a `poetry.lock` file, you should track this file in version control. To execute the test suite, call pytest inside Poetry's virtual environment via `poetry run`:
+
+```shell
+poetry run pytest
+```
+
+Check out the Poetry documentation for more information on the available commands.
+
+For those using [VS Code](https://code.visualstudio.com/) there are tasks defined for the most common commands:
+
+- install development dependencies
+- run tests
+- run all checks configured for pre-commit
+- generate documentation
+
+See the `.vscode/tasks.json` for more details.
+
+## Committing changes
+
+This repository uses [commitlint](https://github.com/conventional-changelog/commitlint) for checking if the commit message meets the [conventional commit format](https://www.conventionalcommits.org/en).
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- markdownlint-disable -->
+<!-- markdownlint-enable -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.
+

yanga-0.1.0/README.md

@@ -0,0 +1,97 @@
+# README
+
+<p align="center">
+  <a href="https://github.com/cuinixam/yanga/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/cuinixam/yanga/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://yanga.readthedocs.io">
+    <img src="https://img.shields.io/readthedocs/yanga.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status">
+  </a>
+  <a href="https://codecov.io/gh/cuinixam/yanga">
+    <img src="https://img.shields.io/codecov/c/github/cuinixam/yanga.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+</p>
+<p align="center">
+  <a href="https://python-poetry.org/">
+    <img src="https://img.shields.io/badge/packaging-poetry-299bd7?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAASCAYAAABrXO8xAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAJJSURBVHgBfZLPa1NBEMe/s7tNXoxW1KJQKaUHkXhQvHgW6UHQQ09CBS/6V3hKc/AP8CqCrUcpmop3Cx48eDB4yEECjVQrlZb80CRN8t6OM/teagVxYZi38+Yz853dJbzoMV3MM8cJUcLMSUKIE8AzQ2PieZzFxEJOHMOgMQQ+dUgSAckNXhapU/NMhDSWLs1B24A8sO1xrN4NECkcAC9ASkiIJc6k5TRiUDPhnyMMdhKc+Zx19l6SgyeW76BEONY9exVQMzKExGKwwPsCzza7KGSSWRWEQhyEaDXp6ZHEr416ygbiKYOd7TEWvvcQIeusHYMJGhTwF9y7sGnSwaWyFAiyoxzqW0PM/RjghPxF2pWReAowTEXnDh0xgcLs8l2YQmOrj3N7ByiqEoH0cARs4u78WgAVkoEDIDoOi3AkcLOHU60RIg5wC4ZuTC7FaHKQm8Hq1fQuSOBvX/sodmNJSB5geaF5CPIkUeecdMxieoRO5jz9bheL6/tXjrwCyX/UYBUcjCaWHljx1xiX6z9xEjkYAzbGVnB8pvLmyXm9ep+W8CmsSHQQY77Zx1zboxAV0w7ybMhQmfqdmmw3nEp1I0Z+FGO6M8LZdoyZnuzzBdjISicKRnpxzI9fPb+0oYXsNdyi+d3h9bm9MWYHFtPeIZfLwzmFDKy1ai3p+PDls1Llz4yyFpferxjnyjJDSEy9CaCx5m2cJPerq6Xm34eTrZt3PqxYO1XOwDYZrFlH1fWnpU38Y9HRze3lj0vOujZcXKuuXm3jP+s3KbZVra7y2EAAAAAASUVORK5CYII=" alt="Poetry">
+  </a>
+  <a href="https://github.com/ambv/black">
+    <img src="https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square" alt="black">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/yanga/">
+    <img src="https://img.shields.io/pypi/v/yanga.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/yanga.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/yanga.svg?style=flat-square" alt="License">
+</p>
+
+Yet another ninja generator to build C/CPP projects.
+
+## Installation
+
+Install this via pip (or your favourite package manager):
+
+`pip install yanga`
+
+## Start developing
+
+The project uses Poetry for dependencies management and packaging.
+If you do not have Poetry installed, you can run the `boostrap.ps1` script.
+This will install Python and Poetry as configured in `scoopfile.json`.
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope CurrentUser -Force
+.\bootstrap.ps1
+```
+
+To install the development dependencies in a virtual environment, type:
+
+```shell
+poetry install
+```
+
+This will also generate a `poetry.lock` file, you should track this file in version control. To execute the test suite, call pytest inside Poetry's virtual environment via `poetry run`:
+
+```shell
+poetry run pytest
+```
+
+Check out the Poetry documentation for more information on the available commands.
+
+For those using [VS Code](https://code.visualstudio.com/) there are tasks defined for the most common commands:
+
+- install development dependencies
+- run tests
+- run all checks configured for pre-commit
+- generate documentation
+
+See the `.vscode/tasks.json` for more details.
+
+## Committing changes
+
+This repository uses [commitlint](https://github.com/conventional-changelog/commitlint) for checking if the commit message meets the [conventional commit format](https://www.conventionalcommits.org/en).
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- markdownlint-disable -->
+<!-- markdownlint-enable -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.

yanga-0.1.0/pyproject.toml

@@ -0,0 +1,99 @@
+[tool.poetry]
+name = "yanga"
+version = "0.1.0"
+description = "Yet another ninja generator to build C/CPP projects."
+authors = ["cuinixam <me@cuinixam.com>"]
+license = "MIT"
+readme = "README.md"
+repository = "https://github.com/cuinixam/yanga"
+documentation = "https://yanga.readthedocs.io"
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries",
+]
+packages = [
+    { include = "yanga", from = "src" },
+]
+
+[tool.poetry.urls]
+"Bug Tracker" = "https://github.com/cuinixam/yanga/issues"
+"Changelog" = "https://github.com/cuinixam/yanga/blob/main/CHANGELOG.md"
+
+[tool.poetry.dependencies]
+python = "^3.9"
+mashumaro = "^3.5"
+loguru = "^0.7.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^7.0"
+pytest-cov = "^4.0"
+black = "^23.1.0"
+pre-commit = "^3.1.1"
+
+[tool.poetry.group.docs]
+optional = true
+
+[tool.poetry.group.docs.dependencies]
+myst-parser = ">=0.16"
+sphinx = ">=4.0"
+sphinx-rtd-theme = ">=1.0"
+m2r = "^0.3.1"
+sphinxcontrib-mermaid = "^0.8.1"
+sphinxcontrib-bibtex = "^2.5.0"
+mlx-traceability = "^10.0.0"
+
+[tool.semantic_release]
+branch = "main"
+version_toml = "pyproject.toml:tool.poetry.version"
+version_variable = "src/yanga/__init__.py:__version__"
+build_command = "pip install poetry && poetry build"
+
+[tool.pytest.ini_options]
+addopts = "-v -Wdefault --cov=yanga --cov-report=term-missing:skip-covered -s"
+pythonpath = ["src"]
+
+[tool.coverage.run]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "@overload",
+    "if TYPE_CHECKING",
+    "raise NotImplementedError",
+    'if __name__ == "__main__":',
+]
+
+[tool.isort]
+profile = "black"
+known_first_party = ["yanga", "tests"]
+
+[tool.mypy]
+check_untyped_defs = true
+disallow_any_generics = true
+disallow_incomplete_defs = true
+disallow_untyped_defs = true
+mypy_path = "src/"
+no_implicit_optional = true
+show_error_codes = true
+warn_unreachable = true
+warn_unused_ignores = true
+exclude = [
+    'docs/.*',
+    'setup.py',
+]
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+allow_untyped_defs = true
+
+[[tool.mypy.overrides]]
+module = "docs.*"
+ignore_errors = true
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"

yanga-0.1.0/src/yanga/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

yanga-0.1.0/src/yanga/core/cmd_line.py

@@ -0,0 +1,83 @@
+from abc import ABC, abstractmethod
+from argparse import ArgumentError, ArgumentParser, Namespace
+from typing import Dict, List
+
+from yanga.core.docs_utils import fulfills
+from yanga.core.logger import logger
+
+
+class Command(ABC):
+    def __init__(self, name: str, description: str) -> None:
+        self.name = name
+        self.description = description
+        self.parser: ArgumentParser
+
+    @abstractmethod
+    def run(self, args: Namespace) -> int:
+        """Run the command with the provided arguments."""
+
+    def register_parser(self, parser_adder) -> None:  # type: ignore
+        """Register the command parser.
+
+        :param parser_adder: The return value of ``ArgumentParser.add_subparsers()``
+        """
+        self.parser = parser_adder.add_parser(
+            self.name, help=self.description, exit_on_error=False
+        )
+        self._register_arguments(self.parser)
+
+    @abstractmethod
+    def _register_arguments(self, parser: ArgumentParser) -> None:
+        """Register arguments for the command."""
+
+
+class CommandLineHandler:
+    """Handles the command line interface."""
+
+    def __init__(self, commands: Dict[str, Command], parser: ArgumentParser) -> None:
+        super().__init__()
+        self.commands = commands
+        self.parser = parser
+        self.logger = logger.bind()
+
+    @fulfills("REQ-CMDLINE_COMMAND_ARGS-0.0.1", "REQ-CMDLINE_COMMAND_EXEC-0.0.1")
+    def run(self, args: List[str]) -> int:
+        try:
+            parsed_args = self.parser.parse_args(args)
+        except ArgumentError as e:
+            self.logger.error(f"Argument error: {e}")
+            self.parser.print_help()
+            return 1
+        if (args is None) or (len(args) == 0):
+            self.logger.debug("No command provided")
+            self.parser.print_help()
+            return 1
+        command = self.commands.get(args[0], None)
+        if command:
+            return command.run(parsed_args)
+        else:
+            self.logger.error(f"Command {args[0]} not registered")
+            return 1
+
+
+class CommandLineHandlerBuilder:
+    """Builds a command line handler."""
+
+    def __init__(self) -> None:
+        self.commands: Dict[str, Command] = {}
+        self.parser = ArgumentParser(
+            prog="yanga", description="Yanga CLI", exit_on_error=False
+        )
+        self.subparsers = self.parser.add_subparsers(title="Commands", dest="command")
+
+    def create(self) -> CommandLineHandler:
+        return CommandLineHandler(self.commands, self.parser)
+
+    @fulfills("REQ-CMDLINE_REGISTER_COMMANDS-0.0.1", "REQ-CMDLINE_DUPLICATION-0.0.1")
+    def add_command(self, command: Command) -> "CommandLineHandlerBuilder":
+        """Add a command to the command line handler."""
+        if self.commands.get(command.name, None) is not None:
+            raise ValueError(f"Command {command.name} already exists")
+        self.commands[command.name] = command
+        command.register_parser(self.subparsers)
+        return self

yanga-0.1.0/src/yanga/core/docs_utils.py

@@ -0,0 +1,35 @@
+from typing import Any, Callable
+
+
+def validates(*req_ids: str) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
+    def _doc(func: Callable[..., Any]) -> Callable[..., Any]:
+        user_doc = func.__doc__ or ""
+        req_ids_str = " ".join(req_ids)
+        func.__doc__ = (
+            user_doc
+            + "\n"
+            + f"""
+         .. item:: UTEST-{func.__module__}.{func.__qualname__}
+            :validates: {req_ids_str}
+         """
+        )
+        return func
+
+    return _doc
+
+
+def fulfills(*req_ids: str) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
+    def _doc(func: Callable[..., Any]) -> Callable[..., Any]:
+        user_doc = func.__doc__ or ""
+        req_ids_str = " ".join(req_ids)
+        func.__doc__ = (
+            user_doc
+            + "\n"
+            + f"""
+         .. item:: IMPL-{func.__module__}.{func.__qualname__}
+            :fulfills: {req_ids_str}
+         """
+        )
+        return func
+
+    return _doc

yanga-0.1.0/src/yanga/core/logger.py

@@ -0,0 +1,52 @@
+""" Logging utilities. """
+
+import sys
+import time
+from pathlib import Path
+from typing import Any, Callable, Optional
+
+from loguru import logger as _logger
+
+from .docs_utils import fulfills
+
+logger = _logger
+
+# Adding custom logging levels
+logger.level("START", no=38, color="<yellow>")
+logger.level("STOP", no=39, color="<yellow>")
+
+
+@fulfills("REQ-LOGGING_TIME_IT-0.0.1")
+def time_it(message: Optional[str] = None) -> Callable[..., Any]:
+    """Decorator to time a function."""
+
+    def _time_it(func: Callable[..., Any]) -> Callable[..., Any]:
+        text = message or f"{func.__module__}.{func.__qualname__}"
+
+        def time_it(*args: Any, **kwargs: Any) -> Any:
+            start_time = time.time()
+            logger.log("START", f"Starting {text}")
+            result = func(*args, **kwargs)
+            end_time = time.time()
+            logger.log("STOP", f"Finished {text} in {end_time-start_time:.2f}s")
+            return result
+
+        return time_it
+
+    return _time_it
+
+
+@fulfills("REQ-LOGGING_FILE-0.0.1")
+def setup_logger(log_file: Optional[Path] = None, clear: bool = True) -> None:
+    """Setup logger to stdout and optionally to file."""
+    logger.remove()
+    logger.add(
+        sys.stdout,
+        format="<green>{time:YYYY-MM-DD HH:mm:ss.SSS}</green> | "
+        "<level>{level: <8}</level> | <level>{message}</level>",
+    )
+    if log_file is not None:
+        logger.add(log_file, level="DEBUG")
+        # Clear log file
+        if log_file.exists() and clear:
+            log_file.write_text("")

yanga-0.1.0/src/yanga/spl/variant.py

@@ -0,0 +1,32 @@
+from dataclasses import dataclass, field
+from typing import List, Optional
+
+from mashumaro.mixins.yaml import DataClassYAMLMixin
+
+
+@dataclass
+class VariantConfig(DataClassYAMLMixin):
+    """
+    .. item:: IMPL-VariantConfig
+        :fulfills:
+            REQ-VARIANT_NAME-0.0.1
+            REQ-VARIANT_SLUG-0.0.1
+            REQ-VARIANT_DESCRIPTION-0.0.1
+            REQ-VARIANT_TAGS-0.0.1
+    """
+
+    name: str
+    description: Optional[str] = None
+    tags: List[str] = field(default_factory=list)
+    _slug: Optional[str] = None
+
+    def generate_slug(self, slug: Optional[str] = None) -> str:
+        return (slug or self.name).lower().replace(" ", "-")
+
+    @property
+    def slug(self) -> str:
+        return self._slug or self.generate_slug()
+
+    @slug.setter
+    def slug(self, slug: str) -> None:
+        self._slug = self.generate_slug(slug)

yanga-0.1.0/src/yanga/ybuild.py

@@ -0,0 +1,23 @@
+import time
+from argparse import ArgumentParser, Namespace
+from pathlib import Path
+
+from yanga.core.cmd_line import Command
+from yanga.core.logger import logger, time_it
+
+
+class BuildCommand(Command):
+    def __init__(self) -> None:
+        super().__init__("build", "Build a yanga project")
+        self.logger = logger.bind()
+
+    @time_it()
+    def run(self, args: Namespace) -> int:
+        self.logger.info(f"Running {self.name} with args {args}")
+        time.sleep(0.3)
+        return 0
+
+    def _register_arguments(self, parser: ArgumentParser) -> None:
+        parser.add_argument(
+            "--project-dir", help="Project directory", default=Path("."), type=Path
+        )

yanga-0.1.0/src/yanga/yinit.py

@@ -0,0 +1,23 @@
+import time
+from argparse import ArgumentParser, Namespace
+from pathlib import Path
+
+from yanga.core.cmd_line import Command
+from yanga.core.logger import logger, time_it
+
+
+class InitCommand(Command):
+    def __init__(self) -> None:
+        super().__init__("init", "Init a yanga project")
+        self.logger = logger.bind()
+
+    @time_it()
+    def run(self, args: Namespace) -> int:
+        self.logger.info(f"Running {self.name} with args {args}")
+        time.sleep(0.3)
+        return 0
+
+    def _register_arguments(self, parser: ArgumentParser) -> None:
+        parser.add_argument(
+            "--project-dir", help="Project directory", default=Path("."), type=Path
+        )

yanga-0.1.0/src/yanga/ymain.py

@@ -0,0 +1,25 @@
+from pathlib import Path
+from sys import argv
+
+from yanga.core.cmd_line import CommandLineHandlerBuilder
+from yanga.core.logger import logger, setup_logger, time_it
+from yanga.ybuild import BuildCommand
+from yanga.yinit import InitCommand
+
+
+@time_it()
+def do_run() -> None:
+    logger.debug("Starting yanga")
+    builder = CommandLineHandlerBuilder()
+    builder.add_command(BuildCommand()).add_command(InitCommand())
+    handler = builder.create()
+    handler.run(argv[1:])
+
+
+def main() -> None:
+    setup_logger(Path(".yanga/logs/yanga.log"), clear=True)
+    do_run()
+
+
+if __name__ == "__main__":
+    main()