pluginator 0.0.0__tar.gz

pluginator-0.0.0/.github/workflows/docs.yml

@@ -0,0 +1,26 @@
+name: Release docs
+on:
+  push:
+    branches:
+      - 0.0.x
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[docs]"
+
+      - name: Build and Deploy
+        run: mkdocs gh-deploy --force

pluginator-0.0.0/.github/workflows/lint.yml

@@ -0,0 +1,17 @@
+name: Lint
+on:
+  push:
+    branches: [0.0.x]
+  pull_request:
+    branches: [0.0.x]
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: check pluginator/ tests/
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: format --check pluginator/ tests/

pluginator-0.0.0/.github/workflows/new_version.yml

@@ -0,0 +1,21 @@
+name: Open New Version
+
+on:
+  workflow_dispatch:
+    inputs:
+      type:
+        description: "New version type"
+        required: true
+        type: choice
+        options: [minor, major]
+
+permissions:
+  contents: write
+
+jobs:
+  create-branch:
+    uses: qarium/ci/.github/workflows/library-new-version.yml@0.0.x
+    with:
+      type: ${{ inputs.type }}
+    secrets:
+      GH_TOKEN: ${{ secrets.GH_TOKEN }}

pluginator-0.0.0/.github/workflows/publish.yml

@@ -0,0 +1,17 @@
+name: Publish Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    uses: qarium/ci/.github/workflows/library-publish.yml@0.0.x
+    with:
+      src-package: 'pluginator'
+    secrets:
+      PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+      ZAI_TOKEN: ${{ secrets.ZAI_TOKEN }}

pluginator-0.0.0/.github/workflows/strictacode.yml

@@ -0,0 +1,43 @@
+name: Strictacode
+
+on:
+  push:
+    branches:
+      - 0.0.x
+  pull_request:
+    branches:
+      - 0.0.x
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - uses: qarium/strictacode/.github/actions/analyze@0.0.x
+        with:
+          install-cmd: pip install strictacode
+          working-directory: pluginator
+        env:
+          STRICTACODE_SCORE: 40
+          STRICTACODE_RP: 40
+          STRICTACODE_SCORE_DIFF: 3
+          STRICTACODE_RP_DIFF: 5
+          STRICTACODE_OP: 40
+          STRICTACODE_IMB: 35
+          STRICTACODE_DENSITY: 30
+          STRICTACODE_OP_DIFF: 5
+          STRICTACODE_DENSITY_DIFF: 3

pluginator-0.0.0/.github/workflows/tests.yml

@@ -0,0 +1,10 @@
+name: Tests
+on:
+  push:
+    branches: [0.0.x]
+  pull_request:
+    branches: [0.0.x]
+
+jobs:
+  test:
+    uses: qarium/ci/.github/workflows/library-tests.yml@0.0.x

pluginator-0.0.0/.gitignore

@@ -0,0 +1,210 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Agents
+.claude/

pluginator-0.0.0/.qarium/ai/employees/devops.md

@@ -0,0 +1,32 @@
+# DevOps
+
+## Config
+
+| Key            | Value            | Description                                 |
+|----------------|------------------|---------------------------------------------|
+| ci_provider    | github-actions   | CI provider                                 |
+| trigger_branch | 0.0.x            | Default branch for triggers                 |
+| diff_range     | HEAD~5           | Git diff range for auto-analysis in feature |
+
+## Rules
+
+### Workflow Registry
+
+| Workflow    | File              | Trigger                                       | Purpose                                      |
+|-------------|-------------------|-----------------------------------------------|----------------------------------------------|
+| Lint        | lint.yml          | push/PR to 0.0.x                              | Ruff lint + format check                     |
+| Tests       | tests.yml         | push/PR to 0.0.x                              | Pytest across Python 3.10–3.14               |
+| Docs        | docs.yml          | push to 0.0.x                                 | MkDocs build + deploy to GitHub Pages        |
+| Publish     | publish.yml       | workflow_dispatch from X.Y.x branch           | Build, publish to PyPI, create GitHub Release|
+| New Version | new_version.yml   | workflow_dispatch from default branch         | Create X.Y.x branch, set as default          |
+| Strictacode | strictacode.yml   | push/PR to 0.0.x                              | Code quality analysis                        |
+
+### Conventions
+
+- `tests.yml`, `publish.yml`, `new_version.yml` — caller-паттерн (`uses: qarium/ci`), не содержат steps
+- `lint.yml`, `docs.yml`, `strictacode.yml` — project-specific, полная реализация
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

pluginator-0.0.0/.qarium/ai/employees/lead.md

@@ -0,0 +1,36 @@
+# Lead
+
+## Config
+
+| Key            | Value  | Description                                  |
+|----------------|--------|----------------------------------------------|
+| default_branch | master | Default branch for CI triggers and diff base |
+
+## Architecture & Decisions
+- **Plugin framework for pytest with decorator DSL** — `@plugin()` class decorator + `option()` factory define plugins with config, actions, CLI options, env vars, and dependency checking
+- **Descriptor-based multi-source option resolution** — PluginOption uses `__get__`/`__set_name__` with priority: plugin_config_key > env_var > command_line > default_from
+- **Metaclass wraps pytest_addoption with called_once** — BasePluginMeta prevents duplicate CLI option registration
+- **Action pattern with lazy evaluation** — supports both immediate and lazy action execution via deepcopy of ActionContext
+
+## Project Structure
+- **define.py — public API decorators** — `@plugin()` and `option()` are the main user-facing entry points
+- **pytest.py — pytest integration layer** — BasePlugin, PluginMeta, CommandLine, PluginOption, install_pytest_plugins
+- **actions.py — action execution engine** — Action, ActionContext, ActionManager with configure/execute lifecycle
+- **utils.py — introspection utility** — `call_context()` accesses caller's globals via `inspect.stack()` for transparent pytest hook injection
+
+## Code Patterns
+- **PyHamcrest for test assertions** — `h.assert_that` with matchers, not plain assert or pytest.raises
+- **Pytest internal APIs** — imports from `_pytest.main`, `_pytest.config` for tight pytest integration (not the public API)
+- **typing.Optional for nullable types** — `t.Optional[X]` everywhere, not `X | None` (Python 3.10 compat)
+- **Relative package imports** — `from .module import Class` consistently across the package
+
+## TODO
+<!-- empty -->
+
+## LLM Directives
+<!-- empty -->
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

pluginator-0.0.0/.qarium/ai/employees/qa.md

@@ -0,0 +1,40 @@
+## Config
+
+| Setting          | Value                                    |
+|------------------|------------------------------------------|
+| run_tests_cmd    | pytest --tb=short                        |
+| lint_cmd         | ruff check pluginator/ tests/            |
+| lint_fix_cmd     | ruff check --fix pluginator/ tests/      |
+| format_cmd       | ruff format --check pluginator/ tests/   |
+| format_fix_cmd   | ruff format pluginator/ tests/           |
+
+## Rules
+
+Project test configuration. Used by the `qarium:employees:qa:feature` skill.
+
+### Mapping
+
+| Source path pattern   | Test directory       | Notes         |
+|-----------------------|----------------------|---------------|
+| `pluginator/**/*.py`  | `tests/`             | Mirror layout |
+
+### Mock Patterns
+
+| Pattern | Example |
+|---------|---------|
+
+### Helpers
+
+| Helper | Location | Purpose |
+|--------|----------|---------|
+
+### Conventions
+
+- Naming: `test_<what>_<scenario>`
+- Never mock `builtins.open` — use `tmp_path` fixture
+- Integration tests use `pytest.mark.skipif` when external tools unavailable
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

pluginator-0.0.0/.qarium/ai/employees/tech-writer.md

@@ -0,0 +1,25 @@
+# Tech Writer Config
+
+## Config
+
+| Key           | Value                                    | Description                         |
+|---------------|------------------------------------------|-------------------------------------|
+| build_cmd     | mkdocs build                             | Build validation command            |
+| deploy_cmd    | mkdocs gh-deploy --force                 | Deploy command                      |
+| examples_file | docs/examples.md                         | File for usage examples             |
+| logo_url      | https://avatars.githubusercontent.com/u/262344922?s=200&v=4 | Standard qarium logo |
+| base_branch   | 0.0.x                                    | Base branch for git diff comparison |
+
+## Rules
+
+### Mapping
+
+| Source path | Documentation files |
+|-------------|---------------------|
+
+### Conventions
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

pluginator-0.0.0/.strictacode.yml

@@ -0,0 +1,3 @@
+loader:
+  exclude:
+    - tests

pluginator-0.0.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: pluginator
+Version: 0.0.0
+Summary: Plugin management system
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: qools>=0.0.0
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: pytest-cov>=5.0; extra == "test"
+Requires-Dist: pytest-mock>=3.0; extra == "test"
+Requires-Dist: ruff>=0.15.0; extra == "test"
+Requires-Dist: pyhamcrest>=2.0; extra == "test"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
+
+# pluginator
+
+Plugin management system
+
+## Installation
+
+```bash
+pip install pluginator
+```
+
+## Quick Start
+
+```python
+from pluginator import define
+
+@define.plugin('my-plugin', config='config.yml')
+class MyPlugin:
+    name = define.option(str, required=True, env_var='PLUGIN_NAME')
+
+    def configure(self):
+        print(f'Configured: {self.name}')
+```
+
+## Documentation
+
+Full documentation: https://qarium.github.io/pluginator/

pluginator-0.0.0/README.md

@@ -0,0 +1,26 @@
+# pluginator
+
+Plugin management system
+
+## Installation
+
+```bash
+pip install pluginator
+```
+
+## Quick Start
+
+```python
+from pluginator import define
+
+@define.plugin('my-plugin', config='config.yml')
+class MyPlugin:
+    name = define.option(str, required=True, env_var='PLUGIN_NAME')
+
+    def configure(self):
+        print(f'Configured: {self.name}')
+```
+
+## Documentation
+
+Full documentation: https://qarium.github.io/pluginator/

pluginator-0.0.0/docs/api-reference.md

@@ -0,0 +1 @@
+# API Reference

pluginator-0.0.0/docs/configuration.md

@@ -0,0 +1 @@
+# Configuration

pluginator-0.0.0/docs/examples.md

@@ -0,0 +1 @@
+# Examples

pluginator-0.0.0/docs/getting-started.md

@@ -0,0 +1 @@
+# Getting Started

pluginator-0.0.0/docs/index.md

@@ -0,0 +1,3 @@
+# pluginator
+
+Plugin management system

pluginator-0.0.0/docs/overrides/main.html

@@ -0,0 +1,68 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+  {{ super() }}
+  <style>
+    /* Dark navbar — override palette in both themes */
+    [data-md-color-scheme=default][data-md-color-primary=custom],
+    [data-md-color-scheme=slate][data-md-color-primary=custom] {
+      --md-primary-fg-color: #0a0a13;
+      --md-primary-fg-color--light: #0a0a13cc;
+      --md-primary-bg-color: #ffffff;
+    }
+
+    .md-header__button.md-logo img,
+    .md-header__button.md-logo svg {
+      width: 32px;
+      height: 32px;
+      border-radius: 50%;
+    }
+
+    /* Search form — visible on dark header */
+    .md-search__overlay {
+      background-color: transparent !important;
+    }
+    [data-md-toggle=search]:checked~.md-header .md-search__overlay {
+      background-color: #0000008a !important;
+    }
+    .md-search__inner {
+      background-color: transparent !important;
+    }
+    .md-search__form {
+      background-color: #3a3a3a !important;
+      border-radius: 0.5rem;
+    }
+    .md-search__form:hover {
+      background-color: #4a4a4a !important;
+    }
+    .md-search__input {
+      color: #e0e0e0 !important;
+    }
+    .md-search__input::placeholder {
+      color: #999999 !important;
+    }
+    .md-search__icon {
+      color: #999999 !important;
+    }
+    .md-search__form:hover .md-search__icon,
+    .md-search__input:focus-visible ~ .md-search__icon {
+      color: #e0e0e0 !important;
+    }
+
+    /* Links in dark theme — readable on dark background */
+    [data-md-color-scheme=slate] .md-nav__link,
+    [data-md-color-scheme=slate] .md-toc__link,
+    [data-md-color-scheme=slate] article a {
+      color: #cbd5e0 !important;
+    }
+    [data-md-color-scheme=slate] .md-nav__link--passed,
+    [data-md-color-scheme=slate] .md-toc__link--passed {
+      color: #718096 !important;
+    }
+    [data-md-color-scheme=slate] .md-nav__link:hover,
+    [data-md-color-scheme=slate] .md-toc__link:hover,
+    [data-md-color-scheme=slate] article a:hover {
+      color: var(--md-accent-fg-color) !important;
+    }
+  </style>
+{% endblock %}