utils_devops 0.1.119__tar.gz

utils_devops-0.1.119/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: utils_devops
+Version: 0.1.119
+Summary: Lightweight DevOps utilities for automation scripts: config editing (YAML/JSON/INI/.env), templating, diffing, and CLI tools
+License: MIT
+Keywords: devops,automation,nginx,cli,jinja2,yaml,config,diff,templating,logging,docker,compose,file-ops
+Author: Hamed Sheikhan
+Author-email: sh.sheikhan.m@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Dist: docker (>=6.0,<8.0)
+Requires-Dist: filelock (>=3.20.0,<4.0.0)
+Requires-Dist: inquirer (>=3.4.1,<4.0.0)
+Requires-Dist: jinja2 (>=3.1,<4.0)
+Requires-Dist: packaging (>=24.1,<25.0)
+Requires-Dist: paramiko (>=3.4.0,<4.0.0)
+Requires-Dist: psutil (>=6.0,<7.0)
+Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
+Requires-Dist: python-dotenv (>=1.0,<2.0)
+Requires-Dist: pyyaml (>=6.0,<7.0)
+Requires-Dist: requests (>=2.32,<3.0)
+Requires-Dist: rich (>=13.9,<14.0)
+Requires-Dist: ruamel-yaml (>=0.18.6,<0.19.0)
+Requires-Dist: scp (>=0.14.0,<0.15.0)
+Requires-Dist: slack-sdk (>=3.37.0,<4.0.0)
+Requires-Dist: sshtunnel (>=0.4.0,<0.5.0)
+Requires-Dist: tenacity (>=9.0,<10.0)
+Requires-Dist: typer (>=0.12.5,<0.13.0)
+Description-Content-Type: text/markdown
+
+

utils_devops-0.1.119/pyproject.toml

@@ -0,0 +1,175 @@
+[tool.poetry]
+name = "utils_devops"
+version = "0.1.119"  # Bumped for new string features + diffing
+description = "Lightweight DevOps utilities for automation scripts: config editing (YAML/JSON/INI/.env), templating, diffing, and CLI tools"
+authors = ["Hamed Sheikhan <sh.sheikhan.m@gmail.com>"]
+license = "MIT"
+readme = "README.md"
+keywords = [
+    "devops",
+    "automation",
+    "nginx",
+    "cli",
+    "jinja2",
+    "yaml",
+    "config",
+    "diff",
+    "templating",
+    "logging",
+    "docker",
+    "compose",
+    "file-ops"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Natural Language :: English"
+]
+packages = [{ include = "utils_devops", from = "src" }]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+# Core
+python-dotenv = "^1.0"
+pyyaml = "^6.0"           # For safe_load/dump fallback
+ruamel-yaml = "^0.18.6"   # Critical: preserves comments, formatting in YAML
+jinja2 = "^3.1"
+typer = "^0.12.5"
+rich = "^13.9"
+# System & File
+psutil = "^6.0"
+filelock = "^3.20.0"
+# Network & Resilience
+requests = "^2.32"
+tenacity = "^9.0"
+# Utils
+packaging = "^24.1"
+python-dateutil = "^2.9.0.post0"
+inquirer = "^3.4.1"
+slack-sdk = "^3.37.0"
+docker = ">=6.0,<8.0"
+# ssh Tools 
+paramiko = "^3.4.0"        # Best pure-Python SSH implementation
+sshtunnel = "^0.4.0"       # Optional: for SSH tunneling/port forwarding
+scp = "^0.14.0"            # High-level SCP over Paramiko (very clean API)
+
+# Built-in enhanced
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0"
+pytest-mock = "^3.0"
+mypy = "^1.8"
+black = "^24.0"
+ruff = "^0.12"
+pre-commit = "^4.0"
+tox = "^4.0"
+bandit = "^1.8"
+twine = "^4.0"
+shiv = "^0.4"
+pytest-cov = "^5.0"       # Code coverage
+mkdocs = "^1.6"           # Optional: if you want docs
+mkdocs-material = "^9.5"  # Optional: beautiful docs
+docker = ">=6.0,<8.0"          # for integration tests and local dev
+testcontainers = "^4.11"      # run ephemeral containers in tests
+pytest-xdist = "^3.8"
+
+[tool.poetry.scripts]
+utils-devops = "utils_devops.cli:app"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+# ========================
+# Tool Configurations
+# ========================
+
+[tool.black]
+line-length = 100
+target-version = ['py310']
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+    \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | _build
+  | buck-out
+  | build
+  | dist
+)/
+'''
+
+[tool.ruff]
+select = [
+    "E", "W", "F", "I", "B", "C4", "UP", "BLE", "A",
+    "COM", "ISC", "PIE", "T20", "Q", "RET", "SIM", "TID",
+    "ARG", "PTH", "PL", "TRY", "FLY", "NPY", "PERF", "ANN"
+]
+ignore = ["E501"]  # Let black handle line length
+line-length = 100
+target-version = "py310"
+src = ["src"]
+extend-exclude = ["__pycache__", "*.egg-info", "build", "dist"]
+
+[tool.ruff.per-file-ignores]
+"tests/*" = ["S101", "ANN"]  # Allow assert + missing annotations in tests
+"src/utils_devops/cli.py" = ["ANN"]  # Typer may not annotate fully
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+exclude = ["build", "dist", "tests/fixtures"]
+warn_unused_configs = true
+disallow_untyped_decorators = false  # Allow Typer
+
+[[tool.mypy.overrides]]
+module = "ruamel.yaml.*"
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+addopts = "-ra -q --cov=utils_devops --cov-report=term-missing"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+markers = [
+    "integration: marks tests as integration (deselect with '-m \"not integration\"')",
+    "unit: marks tests as unit"
+]
+
+[tool.coverage.run]
+source = ["src/utils_devops"]
+omit = [
+    "src/utils_devops/__init__.py",
+    "src/utils_devops/cli.py"  # CLI entrypoint
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:"
+]
+fail_under = 85
+
+# Optional: MkDocs (if you want documentation)
+[tool.mkdocs]
+# Configuration would go in mkdocs.yml, but this keeps it discoverable

utils_devops-0.1.119/src/utils_devops/__init__.py

@@ -0,0 +1,72 @@
+# src/utils_devops/__init__.py
+"""
+utils_devops - Lightweight DevOps utilities for automation scripts.
+
+Design decisions:
+- `core` is a real package (always imported).
+- `extras` is a real package that performs lazy imports on attribute access
+  (see utils_devops/extras/__init__.py). This means both:
+      import utils_devops.extras
+  and
+      from utils_devops.extras import nginx_ops
+  will work and lazily import the submodule when needed.
+"""
+
+from __future__ import annotations
+
+import importlib
+import sys
+from typing import Any
+
+__version__ = "0.1.5"
+__author__ = "Hamed Sheikhan <sh.sheikhan.m@gmail.com>"
+
+# console (optional)
+try:
+    from rich.console import Console
+    console = Console()
+except Exception:
+    console = None  # type: ignore
+
+# --- Core package (always imported) ---
+# Import the core package module itself (not individual functions).
+try:
+    core = importlib.import_module("utils_devops.core")
+except Exception as e:
+    # Fail fast if core cannot import
+    raise ImportError("Failed to import utils_devops.core — check installation") from e
+
+# re-export convenient names to match older API
+datetimes = core.datetimes
+envs = core.envs
+files = core.files
+logs = core.logs
+strings = core.strings
+systems = core.systems
+script_helpers = core.script_helpers
+
+# --- Extras package (the package module implements lazy loading) ---
+# Import the extras package module (it will internally lazy-load submodules).
+try:
+    extras = importlib.import_module("utils_devops.extras")
+except Exception:
+    # extras is optional — leave it as a placeholder module with limited behavior
+    extras = None  # type: ignore
+
+# top-level visible names
+__all__ = [
+    "__version__",
+    "core",
+    "extras",
+    # core convenience re-exports
+    "datetimes",
+    "envs",
+    "files",
+    "logs",
+    "strings",
+    "systems",
+    "script_helpers",
+]
+
+if console:
+    console.log("[bold green]utils_devops core modules loaded[/bold green]")

utils_devops-0.1.119/src/utils_devops/core/__init__.py

@@ -0,0 +1,25 @@
+# src/utils_devops/core/__init__.py
+"""
+Core utilities for utils_devops.
+Always loaded — safe and dependency-free.
+"""
+
+from . import (
+    datetimes,
+    envs,
+    files,
+    logs,
+    script_helpers,
+    strings,
+    systems,
+)
+
+__all__ = [
+    "datetimes",
+    "envs",
+    "files",
+    "logs",
+    "script_helpers",
+    "strings",
+    "systems",
+]