developer-utility-toolkit 0.1.1__tar.gz

developer_utility_toolkit-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artenis Alija
+
+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.

developer_utility_toolkit-0.1.1/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.2
+Name: developer-utility-toolkit
+Version: 0.1.1
+Summary: Security-focused modular developer multi-tool CLI.
+Author: Developer Utility Toolkit Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/artenisalija/developer-utility-kit
+Project-URL: Repository, https://github.com/artenisalija/developer-utility-kit
+Project-URL: Issues, https://github.com/artenisalija/developer-utility-kit/issues
+Keywords: cli,developer-tools,security,formatting,conversion
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer==0.16.0
+Requires-Dist: defusedxml==0.7.1
+Provides-Extra: image
+Requires-Dist: pillow==11.1.0; extra == "image"
+Provides-Extra: web
+Requires-Dist: requests==2.32.4; extra == "web"
+Provides-Extra: xml
+Requires-Dist: lxml==5.3.0; extra == "xml"
+Provides-Extra: yaml
+Requires-Dist: pyyaml==6.0.2; extra == "yaml"
+Provides-Extra: all
+Requires-Dist: pillow==11.1.0; extra == "all"
+Requires-Dist: requests==2.32.4; extra == "all"
+Requires-Dist: lxml==5.3.0; extra == "all"
+Requires-Dist: pyyaml==6.0.2; extra == "all"
+Provides-Extra: dev
+Requires-Dist: black==24.10.0; extra == "dev"
+Requires-Dist: ruff==0.9.6; extra == "dev"
+Requires-Dist: mypy==1.14.1; extra == "dev"
+Requires-Dist: pytest==8.3.4; extra == "dev"
+Requires-Dist: pytest-cov==6.0.0; extra == "dev"
+Requires-Dist: bandit==1.8.2; extra == "dev"
+Requires-Dist: pip-audit==2.7.3; extra == "dev"
+Requires-Dist: safety==3.2.14; extra == "dev"
+Requires-Dist: types-requests==2.32.0.20241016; extra == "dev"
+
+# Developer Utility Toolkit
+
+[![CI](https://github.com/artenisalija/developer-utility-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/artenisalija/developer-utility-kit/actions/workflows/ci.yml)
+[![Security](https://github.com/artenisalija/developer-utility-kit/actions/workflows/security.yml/badge.svg)](https://github.com/artenisalija/developer-utility-kit/actions/workflows/security.yml)
+[![Coverage](https://img.shields.io/badge/coverage-85%25%2B-brightgreen)](https://github.com/artenisalija/developer-utility-kit)
+
+Security-focused, modular, format-aware Python CLI for common developer tasks.
+
+## Features
+
+- Automatic input detection for text, JSON, XML, Base64, URL, and file extension types
+- Direct format conversion using a plugin-based transformer registry
+- JSON and XML formatting, minification, and validation
+- Encoding tools (Base64 and URL encode/decode)
+- Image pixelation utility (optional `pillow`)
+- Sitemap generator and sitemap fetcher with URL validation and request timeouts
+- Local command history (`~/.developer_utility_toolkit/history/history.jsonl`)
+
+## Architecture
+
+- `src/toolkit/core`: abstractions, registry, detector, and safe I/O helpers
+- `src/toolkit/transformers`: pluggable one-step transformers
+- `src/toolkit/formatters`: JSON/XML format/minify/validate services
+- `src/toolkit/image_tools`: image utilities
+- `src/toolkit/web_tools`: sitemap generation/fetching
+- `src/toolkit/history`: local history service
+- `src/toolkit/cli.py`: Typer entrypoint and command wiring
+
+Design choices:
+- No chained transformations by default (one direct transform per request target)
+- Safe XML parsing via `defusedxml`
+- Controlled output writes via sanitized filename + output directory constraints
+- Clear failure modes with explicit non-zero exit codes
+
+## Installation
+
+```bash
+python -m pip install --upgrade pip
+pip install .
+```
+
+Install all optional features:
+
+```bash
+pip install ".[all]"
+```
+
+Install directly from GitHub:
+
+```bash
+pip install "git+https://github.com/artenisalija/developer-utility-kit.git"
+```
+
+Install a specific version tag (recommended):
+
+```bash
+pip install "git+https://github.com/artenisalija/developer-utility-kit.git@v0.1.1"
+```
+
+Install from GitHub with all extras:
+
+```bash
+pip install "developer-utility-toolkit[all] @ git+https://github.com/artenisalija/developer-utility-kit.git@v0.1.1"
+```
+
+Install developer tooling:
+
+```bash
+pip install ".[all,dev]"
+```
+
+## Usage
+
+```bash
+toolkit analyze --text '{"name":"dev"}'
+toolkit convert --from text --to base64 --text "hello"
+toolkit format --kind json --text '{"b":2,"a":1}'
+toolkit validate --kind xml --text '<root><a>1</a></root>'
+toolkit minify --kind json --text '{"b":2,"a":1}'
+toolkit image pixelate --input-file ./input.png --output-name output.png
+toolkit sitemap generate --base-url https://example.com --path / --path /docs
+toolkit sitemap fetch --url https://example.com/sitemap.xml
+toolkit recent show --limit 10
+```
+
+## Security Philosophy
+
+- Secure defaults and explicit input validation
+- Defused XML parser to prevent XXE/entity expansion attacks
+- No `eval`/`exec` usage
+- Timeout-controlled network calls
+- Sanitized output file names with constrained output directories
+- Graceful errors with explicit status codes
+
+## Development
+
+Run local quality gates:
+
+```bash
+ruff check .
+black --check .
+mypy src tests
+pytest
+bandit -r src -ll
+pip-audit --strict
+safety check --full-report
+```
+
+Pre-commit:
+
+```bash
+pre-commit install
+pre-commit run --all-files
+```
+
+## CI/CD
+
+- `ci.yml`: lint + format + mypy + tests + coverage (>=85%) on Python 3.11/3.12
+- `security.yml`: Bandit + pip-audit + Safety
+- `release.yml`: runs on version tags (`v*.*.*`), builds wheel/sdist, runs tests, publishes to PyPI, creates GitHub release notes
+- Dependabot enabled for Python packages and GitHub Actions
+
+## Publishing to PyPI
+
+1. Create a PyPI API token.
+2. Add `PYPI_API_TOKEN` in GitHub repository secrets.
+3. Bump version in `pyproject.toml`.
+4. Tag and push:
+   ```bash
+   git tag v0.1.1
+   git push origin v0.1.1
+   ```
+5. GitHub Action `release.yml` publishes automatically.
+
+## Build Standalone Executable
+
+```bash
+pip install pyinstaller
+pyinstaller --onefile --name toolkit src/toolkit/cli.py
+```
+
+The executable will be available under `dist/`.
+
+## Contribution Guidelines
+
+1. Create a branch for your change.
+2. Add or update tests.
+3. Run all local quality checks and security scans.
+4. Open a pull request with rationale and risk notes.

developer_utility_toolkit-0.1.1/README.md

@@ -0,0 +1,149 @@
+# Developer Utility Toolkit
+
+[![CI](https://github.com/artenisalija/developer-utility-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/artenisalija/developer-utility-kit/actions/workflows/ci.yml)
+[![Security](https://github.com/artenisalija/developer-utility-kit/actions/workflows/security.yml/badge.svg)](https://github.com/artenisalija/developer-utility-kit/actions/workflows/security.yml)
+[![Coverage](https://img.shields.io/badge/coverage-85%25%2B-brightgreen)](https://github.com/artenisalija/developer-utility-kit)
+
+Security-focused, modular, format-aware Python CLI for common developer tasks.
+
+## Features
+
+- Automatic input detection for text, JSON, XML, Base64, URL, and file extension types
+- Direct format conversion using a plugin-based transformer registry
+- JSON and XML formatting, minification, and validation
+- Encoding tools (Base64 and URL encode/decode)
+- Image pixelation utility (optional `pillow`)
+- Sitemap generator and sitemap fetcher with URL validation and request timeouts
+- Local command history (`~/.developer_utility_toolkit/history/history.jsonl`)
+
+## Architecture
+
+- `src/toolkit/core`: abstractions, registry, detector, and safe I/O helpers
+- `src/toolkit/transformers`: pluggable one-step transformers
+- `src/toolkit/formatters`: JSON/XML format/minify/validate services
+- `src/toolkit/image_tools`: image utilities
+- `src/toolkit/web_tools`: sitemap generation/fetching
+- `src/toolkit/history`: local history service
+- `src/toolkit/cli.py`: Typer entrypoint and command wiring
+
+Design choices:
+- No chained transformations by default (one direct transform per request target)
+- Safe XML parsing via `defusedxml`
+- Controlled output writes via sanitized filename + output directory constraints
+- Clear failure modes with explicit non-zero exit codes
+
+## Installation
+
+```bash
+python -m pip install --upgrade pip
+pip install .
+```
+
+Install all optional features:
+
+```bash
+pip install ".[all]"
+```
+
+Install directly from GitHub:
+
+```bash
+pip install "git+https://github.com/artenisalija/developer-utility-kit.git"
+```
+
+Install a specific version tag (recommended):
+
+```bash
+pip install "git+https://github.com/artenisalija/developer-utility-kit.git@v0.1.1"
+```
+
+Install from GitHub with all extras:
+
+```bash
+pip install "developer-utility-toolkit[all] @ git+https://github.com/artenisalija/developer-utility-kit.git@v0.1.1"
+```
+
+Install developer tooling:
+
+```bash
+pip install ".[all,dev]"
+```
+
+## Usage
+
+```bash
+toolkit analyze --text '{"name":"dev"}'
+toolkit convert --from text --to base64 --text "hello"
+toolkit format --kind json --text '{"b":2,"a":1}'
+toolkit validate --kind xml --text '<root><a>1</a></root>'
+toolkit minify --kind json --text '{"b":2,"a":1}'
+toolkit image pixelate --input-file ./input.png --output-name output.png
+toolkit sitemap generate --base-url https://example.com --path / --path /docs
+toolkit sitemap fetch --url https://example.com/sitemap.xml
+toolkit recent show --limit 10
+```
+
+## Security Philosophy
+
+- Secure defaults and explicit input validation
+- Defused XML parser to prevent XXE/entity expansion attacks
+- No `eval`/`exec` usage
+- Timeout-controlled network calls
+- Sanitized output file names with constrained output directories
+- Graceful errors with explicit status codes
+
+## Development
+
+Run local quality gates:
+
+```bash
+ruff check .
+black --check .
+mypy src tests
+pytest
+bandit -r src -ll
+pip-audit --strict
+safety check --full-report
+```
+
+Pre-commit:
+
+```bash
+pre-commit install
+pre-commit run --all-files
+```
+
+## CI/CD
+
+- `ci.yml`: lint + format + mypy + tests + coverage (>=85%) on Python 3.11/3.12
+- `security.yml`: Bandit + pip-audit + Safety
+- `release.yml`: runs on version tags (`v*.*.*`), builds wheel/sdist, runs tests, publishes to PyPI, creates GitHub release notes
+- Dependabot enabled for Python packages and GitHub Actions
+
+## Publishing to PyPI
+
+1. Create a PyPI API token.
+2. Add `PYPI_API_TOKEN` in GitHub repository secrets.
+3. Bump version in `pyproject.toml`.
+4. Tag and push:
+   ```bash
+   git tag v0.1.1
+   git push origin v0.1.1
+   ```
+5. GitHub Action `release.yml` publishes automatically.
+
+## Build Standalone Executable
+
+```bash
+pip install pyinstaller
+pyinstaller --onefile --name toolkit src/toolkit/cli.py
+```
+
+The executable will be available under `dist/`.
+
+## Contribution Guidelines
+
+1. Create a branch for your change.
+2. Add or update tests.
+3. Run all local quality checks and security scans.
+4. Open a pull request with rationale and risk notes.

developer_utility_toolkit-0.1.1/pyproject.toml

@@ -0,0 +1,100 @@
+[build-system]
+requires = ["setuptools==75.8.0", "wheel==0.45.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "developer-utility-toolkit"
+version = "0.1.1"
+description = "Security-focused modular developer multi-tool CLI."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+  { name = "Developer Utility Toolkit Contributors" }
+]
+keywords = ["cli", "developer-tools", "security", "formatting", "conversion"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Utilities"
+]
+dependencies = [
+  "typer==0.16.0",
+  "defusedxml==0.7.1"
+]
+
+[project.optional-dependencies]
+image = ["pillow==11.1.0"]
+web = ["requests==2.32.4"]
+xml = ["lxml==5.3.0"]
+yaml = ["pyyaml==6.0.2"]
+all = [
+  "pillow==11.1.0",
+  "requests==2.32.4",
+  "lxml==5.3.0",
+  "pyyaml==6.0.2"
+]
+dev = [
+  "black==24.10.0",
+  "ruff==0.9.6",
+  "mypy==1.14.1",
+  "pytest==8.3.4",
+  "pytest-cov==6.0.0",
+  "bandit==1.8.2",
+  "pip-audit==2.7.3",
+  "safety==3.2.14",
+  "types-requests==2.32.0.20241016"
+]
+
+[project.urls]
+Homepage = "https://github.com/artenisalija/developer-utility-kit"
+Repository = "https://github.com/artenisalija/developer-utility-kit"
+Issues = "https://github.com/artenisalija/developer-utility-kit/issues"
+
+[project.scripts]
+toolkit = "toolkit.cli:app"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ["py311", "py312"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "S", "N"]
+ignore = ["S603", "S607"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*.py" = ["S101"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_generics = true
+no_implicit_optional = true
+plugins = []
+
+[tool.pytest.ini_options]
+addopts = "--cov=toolkit --cov-report=term-missing --cov-fail-under=85"
+testpaths = ["tests"]
+
+[tool.bandit]
+exclude_dirs = ["tests"]
+skips = ["B101"]

developer_utility_toolkit-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

developer_utility_toolkit-0.1.1/src/developer_utility_toolkit.egg-info/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.2
+Name: developer-utility-toolkit
+Version: 0.1.1
+Summary: Security-focused modular developer multi-tool CLI.
+Author: Developer Utility Toolkit Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/artenisalija/developer-utility-kit
+Project-URL: Repository, https://github.com/artenisalija/developer-utility-kit
+Project-URL: Issues, https://github.com/artenisalija/developer-utility-kit/issues
+Keywords: cli,developer-tools,security,formatting,conversion
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer==0.16.0
+Requires-Dist: defusedxml==0.7.1
+Provides-Extra: image
+Requires-Dist: pillow==11.1.0; extra == "image"
+Provides-Extra: web
+Requires-Dist: requests==2.32.4; extra == "web"
+Provides-Extra: xml
+Requires-Dist: lxml==5.3.0; extra == "xml"
+Provides-Extra: yaml
+Requires-Dist: pyyaml==6.0.2; extra == "yaml"
+Provides-Extra: all
+Requires-Dist: pillow==11.1.0; extra == "all"
+Requires-Dist: requests==2.32.4; extra == "all"
+Requires-Dist: lxml==5.3.0; extra == "all"
+Requires-Dist: pyyaml==6.0.2; extra == "all"
+Provides-Extra: dev
+Requires-Dist: black==24.10.0; extra == "dev"
+Requires-Dist: ruff==0.9.6; extra == "dev"
+Requires-Dist: mypy==1.14.1; extra == "dev"
+Requires-Dist: pytest==8.3.4; extra == "dev"
+Requires-Dist: pytest-cov==6.0.0; extra == "dev"
+Requires-Dist: bandit==1.8.2; extra == "dev"
+Requires-Dist: pip-audit==2.7.3; extra == "dev"
+Requires-Dist: safety==3.2.14; extra == "dev"
+Requires-Dist: types-requests==2.32.0.20241016; extra == "dev"
+
+# Developer Utility Toolkit
+
+[![CI](https://github.com/artenisalija/developer-utility-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/artenisalija/developer-utility-kit/actions/workflows/ci.yml)
+[![Security](https://github.com/artenisalija/developer-utility-kit/actions/workflows/security.yml/badge.svg)](https://github.com/artenisalija/developer-utility-kit/actions/workflows/security.yml)
+[![Coverage](https://img.shields.io/badge/coverage-85%25%2B-brightgreen)](https://github.com/artenisalija/developer-utility-kit)
+
+Security-focused, modular, format-aware Python CLI for common developer tasks.
+
+## Features
+
+- Automatic input detection for text, JSON, XML, Base64, URL, and file extension types
+- Direct format conversion using a plugin-based transformer registry
+- JSON and XML formatting, minification, and validation
+- Encoding tools (Base64 and URL encode/decode)
+- Image pixelation utility (optional `pillow`)
+- Sitemap generator and sitemap fetcher with URL validation and request timeouts
+- Local command history (`~/.developer_utility_toolkit/history/history.jsonl`)
+
+## Architecture
+
+- `src/toolkit/core`: abstractions, registry, detector, and safe I/O helpers
+- `src/toolkit/transformers`: pluggable one-step transformers
+- `src/toolkit/formatters`: JSON/XML format/minify/validate services
+- `src/toolkit/image_tools`: image utilities
+- `src/toolkit/web_tools`: sitemap generation/fetching
+- `src/toolkit/history`: local history service
+- `src/toolkit/cli.py`: Typer entrypoint and command wiring
+
+Design choices:
+- No chained transformations by default (one direct transform per request target)
+- Safe XML parsing via `defusedxml`
+- Controlled output writes via sanitized filename + output directory constraints
+- Clear failure modes with explicit non-zero exit codes
+
+## Installation
+
+```bash
+python -m pip install --upgrade pip
+pip install .
+```
+
+Install all optional features:
+
+```bash
+pip install ".[all]"
+```
+
+Install directly from GitHub:
+
+```bash
+pip install "git+https://github.com/artenisalija/developer-utility-kit.git"
+```
+
+Install a specific version tag (recommended):
+
+```bash
+pip install "git+https://github.com/artenisalija/developer-utility-kit.git@v0.1.1"
+```
+
+Install from GitHub with all extras:
+
+```bash
+pip install "developer-utility-toolkit[all] @ git+https://github.com/artenisalija/developer-utility-kit.git@v0.1.1"
+```
+
+Install developer tooling:
+
+```bash
+pip install ".[all,dev]"
+```
+
+## Usage
+
+```bash
+toolkit analyze --text '{"name":"dev"}'
+toolkit convert --from text --to base64 --text "hello"
+toolkit format --kind json --text '{"b":2,"a":1}'
+toolkit validate --kind xml --text '<root><a>1</a></root>'
+toolkit minify --kind json --text '{"b":2,"a":1}'
+toolkit image pixelate --input-file ./input.png --output-name output.png
+toolkit sitemap generate --base-url https://example.com --path / --path /docs
+toolkit sitemap fetch --url https://example.com/sitemap.xml
+toolkit recent show --limit 10
+```
+
+## Security Philosophy
+
+- Secure defaults and explicit input validation
+- Defused XML parser to prevent XXE/entity expansion attacks
+- No `eval`/`exec` usage
+- Timeout-controlled network calls
+- Sanitized output file names with constrained output directories
+- Graceful errors with explicit status codes
+
+## Development
+
+Run local quality gates:
+
+```bash
+ruff check .
+black --check .
+mypy src tests
+pytest
+bandit -r src -ll
+pip-audit --strict
+safety check --full-report
+```
+
+Pre-commit:
+
+```bash
+pre-commit install
+pre-commit run --all-files
+```
+
+## CI/CD
+
+- `ci.yml`: lint + format + mypy + tests + coverage (>=85%) on Python 3.11/3.12
+- `security.yml`: Bandit + pip-audit + Safety
+- `release.yml`: runs on version tags (`v*.*.*`), builds wheel/sdist, runs tests, publishes to PyPI, creates GitHub release notes
+- Dependabot enabled for Python packages and GitHub Actions
+
+## Publishing to PyPI
+
+1. Create a PyPI API token.
+2. Add `PYPI_API_TOKEN` in GitHub repository secrets.
+3. Bump version in `pyproject.toml`.
+4. Tag and push:
+   ```bash
+   git tag v0.1.1
+   git push origin v0.1.1
+   ```
+5. GitHub Action `release.yml` publishes automatically.
+
+## Build Standalone Executable
+
+```bash
+pip install pyinstaller
+pyinstaller --onefile --name toolkit src/toolkit/cli.py
+```
+
+The executable will be available under `dist/`.
+
+## Contribution Guidelines
+
+1. Create a branch for your change.
+2. Add or update tests.
+3. Run all local quality checks and security scans.
+4. Open a pull request with rationale and risk notes.