| Name | delfino-core JSON |
| Version |
10.0.0
JSON |
| download |
| home_page | None |
| Summary | Delfino core plugin |
| upload_time | 2025-09-13 16:39:31 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10.0 |
| license | MIT License |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<h1 align="center" style="border-bottom: none;"> 🔌 Delfino Core 🔌</h1>
<h3 align="center">A <a href="https://github.com/radeklat/delfino">Delfino</a> plugin with core functionality.</h3>
<p align="center">
<a href="https://app.circleci.com/pipelines/github/radeklat/delfino-core?branch=main">
<img alt="CircleCI" src="https://img.shields.io/circleci/build/github/radeklat/delfino-core">
</a>
<a href="https://app.codecov.io/gh/radeklat/delfino-core/">
<img alt="Codecov" src="https://img.shields.io/codecov/c/github/radeklat/delfino-core">
</a>
<a href="https://github.com/radeklat/delfino-core/tags">
<img alt="GitHub tag (latest SemVer)" src="https://img.shields.io/github/tag/radeklat/delfino-core">
</a>
<img alt="Maintenance" src="https://img.shields.io/maintenance/yes/2025">
<a href="https://github.com/radeklat/delfino-core/commits/main">
<img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/radeklat/delfino-core">
</a>
<a href="https://www.python.org/doc/versions/">
<img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/delfino-core">
</a>
<a href="https://pypistats.org/packages/delfino-core">
<img alt="Downloads" src="https://img.shields.io/pypi/dm/delfino-core">
</a>
</p>
# Commands
| Command | Description |
|-----------------------|-----------------------------------------------------|
| coverage-open | Open coverage results in default browser. |
| coverage-report | Analyse coverage and generate a term/HTML report. |
| dependencies-update | Manages the process of updating dependencies. |
| ensure-pre-commit | Ensures pre-commit is installed and enabled. |
| gh | Extends `gh` or passes through. |
| glab | Extends `glab` or passes through. |
| mypy | Run type checking on source code. |
| pre-commit | Run all pre-commit stages in the current project... |
| pytest | Runs pytest for individual test suites. |
| pytest-integration | Run integration tests. |
| pytest-unit | Run unit tests. |
| ruff | Run ruff. |
| switch-python-version | Switches Python venv to a different Python version. |
| test | Runs pytest, coverage-report. |
| vcs | Alias for `gh`/`glab` with auto-detection. |
| verify | Runs ensure-pre-commit, ruff, mypy, test. |
# Installation
- pip: `pip install delfino-core`
- Poetry: `poetry add -D delfino-core`
- Pipenv: `pipenv install -d delfino-core`
## Optional dependencies
Each project may use different sub-set of [commands](#commands). Therefore, dependencies of all commands are optional and checked only when the command is executed.
Using `[all]` installs all the [optional dependencies](https://setuptools.pypa.io/en/latest/userguide/dependency_management.html#optional-dependencies) used by all the commands. If you want only a sub-set of those dependencies, there are finer-grained groups available:
- For individual commands (matches the command names):
- `mypy`
- `ruff`
- `dependencies-update`
- `pre-commit`
- `vsc`
- For groups of commands:
- `test` - for testing and coverage commands
- For groups of groups:
- `verify` - same as `[mypy,ruff]`
- `all` - all optional packages
# Configuration
Delfino doesn't load any plugins by default. To enable this plugin, add the following config into `pyproject.toml`:
```toml
[tool.delfino.plugins.delfino-core]
```
## Plugin configuration
This plugin has several options. All the values are optional and defaults are shown below:
```toml
[tool.delfino.plugins.delfino-core]
# Source files - may have different rules than tests (usually stricter)
sources_directory = "src"
# Test files
tests_directory = "tests"
# Where to store reports generated by various tools
reports_directory = "reports"
# Types of tests you have nested under the `tests_directory`. Will be executed in given order.
test_types = ["unit", "integration"]
# One or more module to wrap `pytest` in, executing it as `python -m <MODULE> pytest ...`
pytest_modules = []
# Coommand groups and commands to run as a quality gate in given order.
verify_commands = ["ensure-pre-commit", "ruff", "mypy", "test"]
test_commands = ["pytest", "coverage-report"]
# Do not install pre-commit if this is set to true.
disable_pre_commit = false
```
## Commands configuration
Several commands have their own configuration as well.
### `mypy`
```toml
[tool.delfino.plugins.delfino-core.mypy]
# One or more directories where type hint will be required. By default they are optional.
strict_directories = []
```
### `vcs`
```toml
[tool.delfino.plugins.delfino-core.vcs]
# Enable to manually specify the branch prefix. By default it is set to git username.
# branch_prefix = ""
[tool.delfino.plugins.delfino-core.vcs.issue_tracking]
# Prefix for issue numbers, including a trailing hyphen if used. If not set, just the issue numbers will be used.
# issue_prefix = "ISSUE-"
# URL for the issue tracker. If not set, issue tracker integration will be disabled.
# Implemented trackers: Jira.
# tracker_url = "https://<SUBDOMAIN>.atlassian.net"
# Environment variable name for the issue tracking username. If not set, 'ISSUE_TRACKER_USERNAME' will be used by default.
# username_env_var = ""
# Environment variable name for the issue tracking API key. If not set, 'ISSUE_TRACKER_API_KEY' will be used by default.
# api_key_env_var = ""
```
# Usage
Run `delfino --help`.
# Development
To develop against editable `delfino` sources:
1. Make sure `delfino` sources are next to this plugin:
```shell
cd ..
git clone https://github.com/radeklat/delfino.git
```
2. Install `delfino` as editable package:
```shell
pip install -e ../delfino
```
Note that poetry will reset this to the released package when you install/update anything.
Raw data
{
"_id": null,
"home_page": null,
"name": "delfino-core",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10.0",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Radek L\u00e1t <radek.lat@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/65/d7/988437b9a8cc33dff91972758c4a12c5e9740851bd9fff70a52b824c7d53/delfino_core-10.0.0.tar.gz",
"platform": null,
"description": "<h1 align=\"center\" style=\"border-bottom: none;\"> \ud83d\udd0c Delfino Core \ud83d\udd0c</h1>\n<h3 align=\"center\">A <a href=\"https://github.com/radeklat/delfino\">Delfino</a> plugin with core functionality.</h3>\n\n<p align=\"center\">\n <a href=\"https://app.circleci.com/pipelines/github/radeklat/delfino-core?branch=main\">\n <img alt=\"CircleCI\" src=\"https://img.shields.io/circleci/build/github/radeklat/delfino-core\">\n </a>\n <a href=\"https://app.codecov.io/gh/radeklat/delfino-core/\">\n <img alt=\"Codecov\" src=\"https://img.shields.io/codecov/c/github/radeklat/delfino-core\">\n </a>\n <a href=\"https://github.com/radeklat/delfino-core/tags\">\n <img alt=\"GitHub tag (latest SemVer)\" src=\"https://img.shields.io/github/tag/radeklat/delfino-core\">\n </a>\n <img alt=\"Maintenance\" src=\"https://img.shields.io/maintenance/yes/2025\">\n <a href=\"https://github.com/radeklat/delfino-core/commits/main\">\n <img alt=\"GitHub last commit\" src=\"https://img.shields.io/github/last-commit/radeklat/delfino-core\">\n </a>\n <a href=\"https://www.python.org/doc/versions/\">\n <img alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/delfino-core\">\n </a>\n <a href=\"https://pypistats.org/packages/delfino-core\">\n <img alt=\"Downloads\" src=\"https://img.shields.io/pypi/dm/delfino-core\">\n </a>\n</p>\n\n# Commands\n \n| Command | Description |\n|-----------------------|-----------------------------------------------------|\n| coverage-open | Open coverage results in default browser. |\n| coverage-report | Analyse coverage and generate a term/HTML report. |\n| dependencies-update | Manages the process of updating dependencies. |\n| ensure-pre-commit | Ensures pre-commit is installed and enabled. |\n| gh | Extends `gh` or passes through. |\n| glab | Extends `glab` or passes through. |\n| mypy | Run type checking on source code. |\n| pre-commit | Run all pre-commit stages in the current project... |\n| pytest | Runs pytest for individual test suites. |\n| pytest-integration | Run integration tests. |\n| pytest-unit | Run unit tests. |\n| ruff | Run ruff. |\n| switch-python-version | Switches Python venv to a different Python version. |\n| test | Runs pytest, coverage-report. |\n| vcs | Alias for `gh`/`glab` with auto-detection. |\n| verify | Runs ensure-pre-commit, ruff, mypy, test. |\n\n# Installation\n\n- pip: `pip install delfino-core`\n- Poetry: `poetry add -D delfino-core`\n- Pipenv: `pipenv install -d delfino-core`\n\n## Optional dependencies\n\nEach project may use different sub-set of [commands](#commands). Therefore, dependencies of all commands are optional and checked only when the command is executed.\n\nUsing `[all]` installs all the [optional dependencies](https://setuptools.pypa.io/en/latest/userguide/dependency_management.html#optional-dependencies) used by all the commands. If you want only a sub-set of those dependencies, there are finer-grained groups available:\n\n- For individual commands (matches the command names):\n - `mypy`\n - `ruff`\n - `dependencies-update`\n - `pre-commit`\n - `vsc`\n- For groups of commands:\n - `test` - for testing and coverage commands\n- For groups of groups:\n - `verify` - same as `[mypy,ruff]`\n - `all` - all optional packages\n\n# Configuration\n\nDelfino doesn't load any plugins by default. To enable this plugin, add the following config into `pyproject.toml`:\n\n```toml\n[tool.delfino.plugins.delfino-core]\n\n```\n\n## Plugin configuration\n\nThis plugin has several options. All the values are optional and defaults are shown below: \n\n```toml\n[tool.delfino.plugins.delfino-core]\n# Source files - may have different rules than tests (usually stricter)\nsources_directory = \"src\"\n\n# Test files\ntests_directory = \"tests\"\n\n# Where to store reports generated by various tools\nreports_directory = \"reports\"\n\n# Types of tests you have nested under the `tests_directory`. Will be executed in given order.\ntest_types = [\"unit\", \"integration\"]\n\n# One or more module to wrap `pytest` in, executing it as `python -m <MODULE> pytest ...`\npytest_modules = []\n\n# Coommand groups and commands to run as a quality gate in given order.\nverify_commands = [\"ensure-pre-commit\", \"ruff\", \"mypy\", \"test\"]\ntest_commands = [\"pytest\", \"coverage-report\"]\n\n# Do not install pre-commit if this is set to true.\ndisable_pre_commit = false\n```\n\n## Commands configuration\n\nSeveral commands have their own configuration as well.\n\n### `mypy`\n\n```toml\n[tool.delfino.plugins.delfino-core.mypy]\n# One or more directories where type hint will be required. By default they are optional.\nstrict_directories = [] \n```\n\n### `vcs`\n\n```toml\n[tool.delfino.plugins.delfino-core.vcs]\n# Enable to manually specify the branch prefix. By default it is set to git username.\n# branch_prefix = \"\"\n\n[tool.delfino.plugins.delfino-core.vcs.issue_tracking]\n# Prefix for issue numbers, including a trailing hyphen if used. If not set, just the issue numbers will be used.\n# issue_prefix = \"ISSUE-\"\n\n# URL for the issue tracker. If not set, issue tracker integration will be disabled.\n# Implemented trackers: Jira.\n# tracker_url = \"https://<SUBDOMAIN>.atlassian.net\"\n\n# Environment variable name for the issue tracking username. If not set, 'ISSUE_TRACKER_USERNAME' will be used by default.\n# username_env_var = \"\"\n\n# Environment variable name for the issue tracking API key. If not set, 'ISSUE_TRACKER_API_KEY' will be used by default.\n# api_key_env_var = \"\"\n```\n\n\n# Usage\n\nRun `delfino --help`.\n\n# Development\n\nTo develop against editable `delfino` sources:\n\n1. Make sure `delfino` sources are next to this plugin:\n ```shell\n cd ..\n git clone https://github.com/radeklat/delfino.git\n ```\n2. Install `delfino` as editable package:\n ```shell\n pip install -e ../delfino\n ```\n Note that poetry will reset this to the released package when you install/update anything.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Delfino core plugin",
"version": "10.0.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ae4b026c83dde4302777827ac6f56ac183fbd137e6ccb061c59f897c0108e395",
"md5": "71674a560b2d5daf1ecfbb10c4ed027f",
"sha256": "4be39d34caca1efe4501a4de0c7d702b311da6d9257ba19a277db56ff603fda9"
},
"downloads": -1,
"filename": "delfino_core-10.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "71674a560b2d5daf1ecfbb10c4ed027f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.0",
"size": 11519,
"upload_time": "2025-09-13T16:39:29",
"upload_time_iso_8601": "2025-09-13T16:39:29.721332Z",
"url": "https://files.pythonhosted.org/packages/ae/4b/026c83dde4302777827ac6f56ac183fbd137e6ccb061c59f897c0108e395/delfino_core-10.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "65d7988437b9a8cc33dff91972758c4a12c5e9740851bd9fff70a52b824c7d53",
"md5": "c7a9ef4506c48429e50bc8cbd23f1cbe",
"sha256": "217b50baa638ee41eb272541d0dc5eaeb5216f5e6c89c70ae72c7e5563d489b1"
},
"downloads": -1,
"filename": "delfino_core-10.0.0.tar.gz",
"has_sig": false,
"md5_digest": "c7a9ef4506c48429e50bc8cbd23f1cbe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.0",
"size": 77430,
"upload_time": "2025-09-13T16:39:31",
"upload_time_iso_8601": "2025-09-13T16:39:31.055284Z",
"url": "https://files.pythonhosted.org/packages/65/d7/988437b9a8cc33dff91972758c4a12c5e9740851bd9fff70a52b824c7d53/delfino_core-10.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-13 16:39:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "delfino-core"
}
