granny-devops 0.5.0__tar.gz → 0.7.0__tar.gz

granny_devops-0.7.0/PKG-INFO

@@ -0,0 +1,354 @@
+Metadata-Version: 2.4
+Name: granny-devops
+Version: 0.7.0
+Summary: Cloud tools collection -- AWS infrastructure, CDN, and DevOps automation
+Author-email: Martin Wieser <martin.wieser@pseekoo.com>
+License: MIT License
+        
+        Copyright (c) 2026 Martin Wieser
+        
+        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.
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: boto3>=1.38
+Requires-Dist: click>=8.1
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: requests>=2.32
+Provides-Extra: all
+Requires-Dist: anthropic>=0.54.0; extra == 'all'
+Requires-Dist: azure-identity>=1.23; extra == 'all'
+Requires-Dist: azure-identity>=1.23.0; extra == 'all'
+Requires-Dist: azure-mgmt-billing>=6.1; extra == 'all'
+Requires-Dist: azure-mgmt-compute>=33; extra == 'all'
+Requires-Dist: azure-mgmt-consumption>=10.0; extra == 'all'
+Requires-Dist: azure-mgmt-costmanagement>=4.0; extra == 'all'
+Requires-Dist: azure-mgmt-reservations>=2.3; extra == 'all'
+Requires-Dist: azure-mgmt-subscription>=3.1; extra == 'all'
+Requires-Dist: beautifulsoup4~=4.13.4; extra == 'all'
+Requires-Dist: boto3-stubs>=1.40; extra == 'all'
+Requires-Dist: certifi>=2025.6.15; extra == 'all'
+Requires-Dist: cloudflare==4.3.1; extra == 'all'
+Requires-Dist: earthengine-api>=1.5.20; extra == 'all'
+Requires-Dist: elasticsearch-dsl<9.0.0,>=8.0.0; extra == 'all'
+Requires-Dist: elasticsearch<9.0.0,>=8.0.0; extra == 'all'
+Requires-Dist: flask-cors>=6.0.1; extra == 'all'
+Requires-Dist: flask>=3.1.1; extra == 'all'
+Requires-Dist: google-auth>=2.40.3; extra == 'all'
+Requires-Dist: google-cloud-billing>=1.16; extra == 'all'
+Requires-Dist: google-cloud-compute>=1.21; extra == 'all'
+Requires-Dist: google-cloud-resource-manager>=1.12; extra == 'all'
+Requires-Dist: google-generativeai>=0.8.5; extra == 'all'
+Requires-Dist: gspread>=6.2.1; extra == 'all'
+Requires-Dist: hetzner-dns-api>=1.0.0; extra == 'all'
+Requires-Dist: ipython~=9.3.0; extra == 'all'
+Requires-Dist: json5>=0.12.0; extra == 'all'
+Requires-Dist: jsonschema>=4.0.0; extra == 'all'
+Requires-Dist: langchain-openai>=0.3.24; extra == 'all'
+Requires-Dist: langchain>=0.3.26; extra == 'all'
+Requires-Dist: langdetect>=1.0.9; extra == 'all'
+Requires-Dist: litellm>=1.73.0; extra == 'all'
+Requires-Dist: matplotlib>=3.10.3; extra == 'all'
+Requires-Dist: msoffcrypto-tool>=5.4.2; extra == 'all'
+Requires-Dist: numpy>=2.3.1; extra == 'all'
+Requires-Dist: ollama>=0.5.1; extra == 'all'
+Requires-Dist: openai>=1.90.0; extra == 'all'
+Requires-Dist: openpyxl==3.1.5; extra == 'all'
+Requires-Dist: pandas>=2.3.0; extra == 'all'
+Requires-Dist: pdf2image>=1.17.0; extra == 'all'
+Requires-Dist: pillow>=11.2.1; extra == 'all'
+Requires-Dist: playwright>=1.52.0; extra == 'all'
+Requires-Dist: pyairtable~=3.1.1; extra == 'all'
+Requires-Dist: pydantic>=2.11.7; extra == 'all'
+Requires-Dist: pymilvus>=2.5.11; extra == 'all'
+Requires-Dist: pymongo>=4.13; extra == 'all'
+Requires-Dist: pypdf>=5.6.1; extra == 'all'
+Requires-Dist: pytesseract>=0.3.13; extra == 'all'
+Requires-Dist: pyzbar>=0.1.9; extra == 'all'
+Requires-Dist: selenium>=4.33.0; extra == 'all'
+Requires-Dist: sentinelhub>=3.11.1; extra == 'all'
+Requires-Dist: sentry-sdk>=2.30.0; extra == 'all'
+Requires-Dist: tiktoken>=0.9.0; extra == 'all'
+Requires-Dist: webdriver-manager>=4.0.2; extra == 'all'
+Requires-Dist: zxing>=1.0.3; extra == 'all'
+Provides-Extra: azure
+Requires-Dist: azure-identity>=1.23; extra == 'azure'
+Requires-Dist: azure-mgmt-billing>=6.1; extra == 'azure'
+Requires-Dist: azure-mgmt-compute>=33; extra == 'azure'
+Requires-Dist: azure-mgmt-consumption>=10.0; extra == 'azure'
+Requires-Dist: azure-mgmt-costmanagement>=4.0; extra == 'azure'
+Requires-Dist: azure-mgmt-reservations>=2.3; extra == 'azure'
+Requires-Dist: azure-mgmt-subscription>=3.1; extra == 'azure'
+Provides-Extra: browser
+Requires-Dist: playwright>=1.52.0; extra == 'browser'
+Requires-Dist: selenium>=4.33.0; extra == 'browser'
+Requires-Dist: webdriver-manager>=4.0.2; extra == 'browser'
+Provides-Extra: cdn
+Requires-Dist: cloudflare==4.3.1; extra == 'cdn'
+Requires-Dist: hetzner-dns-api>=1.0.0; extra == 'cdn'
+Provides-Extra: data
+Requires-Dist: beautifulsoup4~=4.13.4; extra == 'data'
+Requires-Dist: gspread>=6.2.1; extra == 'data'
+Requires-Dist: openpyxl==3.1.5; extra == 'data'
+Requires-Dist: pandas>=2.3.0; extra == 'data'
+Requires-Dist: pyairtable~=3.1.1; extra == 'data'
+Requires-Dist: pymongo>=4.13; extra == 'data'
+Provides-Extra: dev
+Requires-Dist: hatch>=1.14; extra == 'dev'
+Requires-Dist: prek>=0.2; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.11; extra == 'dev'
+Requires-Dist: twine>=6.1; extra == 'dev'
+Provides-Extra: gcp
+Requires-Dist: google-cloud-billing>=1.16; extra == 'gcp'
+Requires-Dist: google-cloud-compute>=1.21; extra == 'gcp'
+Requires-Dist: google-cloud-resource-manager>=1.12; extra == 'gcp'
+Provides-Extra: ml
+Requires-Dist: anthropic>=0.54.0; extra == 'ml'
+Requires-Dist: google-generativeai>=0.8.5; extra == 'ml'
+Requires-Dist: langchain-openai>=0.3.24; extra == 'ml'
+Requires-Dist: langchain>=0.3.26; extra == 'ml'
+Requires-Dist: litellm>=1.73.0; extra == 'ml'
+Requires-Dist: ollama>=0.5.1; extra == 'ml'
+Requires-Dist: openai>=1.90.0; extra == 'ml'
+Requires-Dist: tiktoken>=0.9.0; extra == 'ml'
+Provides-Extra: vault
+Description-Content-Type: text/markdown
+
+# Granny
+
+> One CLI for the cloud chores you'd otherwise do across six tabs.
+
+`granny` is a pragmatic, multi-provider DevOps toolkit with a strong bias
+toward European cloud infrastructure. It wraps the parts of provider APIs
+you actually use day-to-day — Bunny pull zones, Cloudflare DNS, Hetzner S3,
+Scaleway functions, Mailjet sender setup, INWX zones, AWS Lambda inventory
+— behind a single command:
+
+```shell
+granny dns add api.example.com --type A --value 203.0.113.4 --provider hetzner
+granny cdn purge 12345
+granny storage bunny upload my-zone ./dist
+granny credentials status
+```
+
+## What it is
+
+- **Pragmatic, not exhaustive.** Granny implements the parts of each
+  provider API the maintainers needed in production. It will not cover
+  every endpoint of every service — and it will not pretend to. Add what
+  you need; the [contributor guide](Project_Guidelines.md) explains how.
+- **Multi-cloud, with a European tilt.** First-class support for Bunny,
+  Cloudflare, Hetzner, deSEC, ClouDNS, INWX, Scaleway, and Mailjet
+  alongside AWS S3 / Lambda / WorkMail. The cloud world doesn't end at
+  AWS, and granny doesn't pretend it does.
+- **Secrets done right.** Every credential goes through one resolver
+  chain — environment variable first, optional Vaultwarden vault second,
+  never hardcoded. `.env` and `.deploy.env` are auto-loaded; vault support
+  is a one-line activation when you want it.
+- **Library or CLI.** Every CLI subcommand is a thin shim over a small
+  Python module. Import `granny.dns.cloudflare`, `granny.cdn.bunny`,
+  `granny.cloudflare.d1` directly when you need to script something the
+  CLI doesn't expose yet.
+- **Small, composable, no plugin system.** The whole package is one
+  `pip install` away. No daemon, no service, no opinionated framework.
+  Drop it into your CI image and call it a day.
+
+## Install
+
+```shell
+pip install granny-devops
+# or
+uv add granny-devops
+```
+
+Optional extras enable additional providers:
+
+```shell
+pip install "granny-devops[gcp]"     # GCP for granny analyze (gpus|credits|costs)
+pip install "granny-devops[azure]"   # Azure for granny analyze (gpus|credits|costs)
+pip install "granny-devops[cdn]"     # Cloudflare, Hetzner DNS
+```
+
+Tagged releases land on **pypi.org** and the public GitLab PyPI registry
+in parallel. If PyPI is propagating slowly, fall back to the registry:
+
+```shell
+pip install --extra-index-url https://gitlab.com/api/v4/projects/81189862/packages/pypi/simple granny-devops
+```
+
+For Vaultwarden (Locke) credential resolution, install separately:
+
+```shell
+pip install "locke @ git+https://gitlab.com/martin-wieser/locke.git#subdirectory=python"
+```
+
+## Configure
+
+Granny reads secrets from environment variables, falling back to a
+Vaultwarden vault when Locke is installed. Copy the example and fill in
+what you need:
+
+```shell
+cp .env.example .env
+```
+
+Common keys:
+
+| Provider | Variables |
+|---|---|
+| Bunny | `BUNNY_API_KEY` (+ `BUNNY_API_KEY_<CUSTOMER>` for multi-account) |
+| Cloudflare | `CLOUDFLARE_API_TOKEN` |
+| Hetzner | `HETZNER_S3_ACCESS_KEY`, `HETZNER_S3_SECRET_KEY`, `HETZNER_DNS_API_TOKEN` |
+| Scaleway | `SCW_ACCESS_KEY`, `SCW_SECRET_KEY`, `SCW_DEFAULT_PROJECT_ID` |
+| Mailjet | `MAILJET_API_KEY`, `MAILJET_SECRET_KEY` |
+| deSEC | `DESEC_API_TOKEN` |
+| ClouDNS | `CLOUDNS_AUTH_ID`/`_PASSWORD` (or `_SUB_AUTH_ID`/`_SUB_AUTH_USER`) |
+| INWX | `INWX_USERNAME`, `INWX_PASSWORD`, `INWX_SHARED_SECRET` (only with 2FA) |
+| Docker Hub | `DOCKER_HUB_USER`, `DOCKER_HUB_TOKEN` |
+
+Set only the ones you need. Use `granny credentials status` to verify
+what's configured at any time.
+
+## Use
+
+```shell
+granny --help                          # see every command group
+granny <group> --help                  # drill into one
+```
+
+The CLI is organized by capability, not by provider. You pick the
+provider per command:
+
+```shell
+# DNS — same command, any of seven providers
+granny dns list example.com --provider cloudflare
+granny dns add www.example.com --type CNAME --value example.com --provider bunny
+granny dns nameservers example.com --provider inwx
+
+# CDN — Bunny pull zones
+granny cdn list-zones
+granny cdn purge 12345
+granny cdn ssl www.example.com --dns01
+
+# Object storage — three providers, one verb set
+granny storage bunny create my-assets --region DE
+granny storage hetzner create my-bucket --region fsn1 --public
+granny storage aws create my-website --website
+
+# AWS inventory (read-only)
+granny analyze vpcs --json-output
+granny analyze lambdas --region us-east-1 eu-west-1
+
+# Cross-cloud GPU / credit / cost inventory (AWS + GCP + Azure)
+granny analyze gpus                                # running GPUs everywhere
+granny analyze gpus --filter h100,h200             # find Hopper clusters
+granny analyze gpus --include-reserved             # also capacity blocks / RIs
+granny analyze gpus --provider aws --profile prod --profile dev
+granny analyze credits                             # available balances
+granny analyze costs                               # MTD + month-end forecast
+
+# Cloudflare account resources (Workers, D1, R2, KV)
+granny cloudflare d1 create my-app
+granny cloudflare r2 create my-app-media
+granny cloudflare site provision my-app --secret-from-vault MAILJET_API_KEY
+
+# Multi-arch Docker builds with deterministic tags
+granny docker build-base --image myapp-base --hash-file requirements.txt
+
+# Scaleway FaaS
+granny serverless deploy my-fn --source-dir ./dist --namespace my-app
+
+# Mailjet + WorkMail
+granny email mailjet setup-dns example.com
+granny email workmail create-user example.com --email user@example.com
+
+# One-shot infrastructure provisioning (dispatches granny/create/*.py)
+granny create s3-website example.com --help
+granny create scaleway-container --name my-app --port 3000
+granny create mailjet-dns example.com
+```
+
+## Capability matrix
+
+| Capability | Providers |
+|---|---|
+| DNS | Cloudflare, Bunny, Hetzner, deSEC, ClouDNS, INWX, manual |
+| CDN | Bunny |
+| Edge scripting | Bunny |
+| Object storage | AWS S3, Bunny Storage, Hetzner S3 |
+| Serverless functions | Scaleway FaaS, Scaleway Containers |
+| Workers / KV / D1 / R2 | Cloudflare |
+| Email send infra | Mailjet, AWS SES, AWS WorkMail |
+| AWS inventory | VPCs, Lambdas |
+| Cross-cloud inventory | GPU instances + reservations, credit balances, MTD spend + forecast (AWS, GCP, Azure) |
+| SSL automation | Bunny, Cloudflare, ACM |
+
+## As a library
+
+Every CLI command is a thin wrapper. Import the underlying module when
+the CLI doesn't have what you need:
+
+```python
+from granny.dns.factory import get_provider
+from granny.cloudflare.d1 import D1Client
+from granny.credentials import get_secret, load_secrets_into_env
+
+# Multi-provider DNS
+dns = get_provider("inwx")
+zone = dns.get_zone_id("example.com")
+dns.upsert_record(zone, "_acme-challenge", "TXT", "abc-token", ttl=300)
+
+# Cloudflare D1 directly
+db = D1Client().create_database("my-app", primary_location_hint="weur")
+
+# Bulk-load registered secrets into os.environ for downstream tools
+load_secrets_into_env()
+```
+
+## Project layout
+
+```
+granny/
+  cli/           Click command groups (granny <group> <verb>)
+  analyze/      Cross-cloud inventory (AWS, GCP, Azure)
+  cdn/          Bunny CDN
+  cloudflare/   Cloudflare Workers / D1 / R2 / KV
+  create/       Standalone setup scripts (granny create <name>)
+  credentials/  Env + vault secret resolution
+  dns/          Provider-agnostic DNS CRUD
+  docker/       Multi-arch image builds
+  edge/         Bunny Edge Scripting
+  email/        Mailjet, WorkMail, SES forwarding
+  serverless/   Scaleway FaaS
+  storage/      Object storage (AWS / Bunny / Hetzner)
+```
+
+## Where to look next
+
+- [`Project_Guidelines.md`](Project_Guidelines.md) — contributor toolchain,
+  conventions, extension checklists, release flow.
+- [`AGENTS.md`](AGENTS.md) — instructions for AI coding agents working
+  in the repository (Claude Code reads `CLAUDE.md` which imports this).
+- `.env.example` — full list of supported environment variables.
+- `granny --help` and `granny <group> --help` — authoritative command docs,
+  always in sync with the installed version.
+
+## License
+
+MIT — see [`LICENSE`](LICENSE). Built and maintained by Martin Wieser.

granny_devops-0.7.0/README.md

@@ -0,0 +1,222 @@
+# Granny
+
+> One CLI for the cloud chores you'd otherwise do across six tabs.
+
+`granny` is a pragmatic, multi-provider DevOps toolkit with a strong bias
+toward European cloud infrastructure. It wraps the parts of provider APIs
+you actually use day-to-day — Bunny pull zones, Cloudflare DNS, Hetzner S3,
+Scaleway functions, Mailjet sender setup, INWX zones, AWS Lambda inventory
+— behind a single command:
+
+```shell
+granny dns add api.example.com --type A --value 203.0.113.4 --provider hetzner
+granny cdn purge 12345
+granny storage bunny upload my-zone ./dist
+granny credentials status
+```
+
+## What it is
+
+- **Pragmatic, not exhaustive.** Granny implements the parts of each
+  provider API the maintainers needed in production. It will not cover
+  every endpoint of every service — and it will not pretend to. Add what
+  you need; the [contributor guide](Project_Guidelines.md) explains how.
+- **Multi-cloud, with a European tilt.** First-class support for Bunny,
+  Cloudflare, Hetzner, deSEC, ClouDNS, INWX, Scaleway, and Mailjet
+  alongside AWS S3 / Lambda / WorkMail. The cloud world doesn't end at
+  AWS, and granny doesn't pretend it does.
+- **Secrets done right.** Every credential goes through one resolver
+  chain — environment variable first, optional Vaultwarden vault second,
+  never hardcoded. `.env` and `.deploy.env` are auto-loaded; vault support
+  is a one-line activation when you want it.
+- **Library or CLI.** Every CLI subcommand is a thin shim over a small
+  Python module. Import `granny.dns.cloudflare`, `granny.cdn.bunny`,
+  `granny.cloudflare.d1` directly when you need to script something the
+  CLI doesn't expose yet.
+- **Small, composable, no plugin system.** The whole package is one
+  `pip install` away. No daemon, no service, no opinionated framework.
+  Drop it into your CI image and call it a day.
+
+## Install
+
+```shell
+pip install granny-devops
+# or
+uv add granny-devops
+```
+
+Optional extras enable additional providers:
+
+```shell
+pip install "granny-devops[gcp]"     # GCP for granny analyze (gpus|credits|costs)
+pip install "granny-devops[azure]"   # Azure for granny analyze (gpus|credits|costs)
+pip install "granny-devops[cdn]"     # Cloudflare, Hetzner DNS
+```
+
+Tagged releases land on **pypi.org** and the public GitLab PyPI registry
+in parallel. If PyPI is propagating slowly, fall back to the registry:
+
+```shell
+pip install --extra-index-url https://gitlab.com/api/v4/projects/81189862/packages/pypi/simple granny-devops
+```
+
+For Vaultwarden (Locke) credential resolution, install separately:
+
+```shell
+pip install "locke @ git+https://gitlab.com/martin-wieser/locke.git#subdirectory=python"
+```
+
+## Configure
+
+Granny reads secrets from environment variables, falling back to a
+Vaultwarden vault when Locke is installed. Copy the example and fill in
+what you need:
+
+```shell
+cp .env.example .env
+```
+
+Common keys:
+
+| Provider | Variables |
+|---|---|
+| Bunny | `BUNNY_API_KEY` (+ `BUNNY_API_KEY_<CUSTOMER>` for multi-account) |
+| Cloudflare | `CLOUDFLARE_API_TOKEN` |
+| Hetzner | `HETZNER_S3_ACCESS_KEY`, `HETZNER_S3_SECRET_KEY`, `HETZNER_DNS_API_TOKEN` |
+| Scaleway | `SCW_ACCESS_KEY`, `SCW_SECRET_KEY`, `SCW_DEFAULT_PROJECT_ID` |
+| Mailjet | `MAILJET_API_KEY`, `MAILJET_SECRET_KEY` |
+| deSEC | `DESEC_API_TOKEN` |
+| ClouDNS | `CLOUDNS_AUTH_ID`/`_PASSWORD` (or `_SUB_AUTH_ID`/`_SUB_AUTH_USER`) |
+| INWX | `INWX_USERNAME`, `INWX_PASSWORD`, `INWX_SHARED_SECRET` (only with 2FA) |
+| Docker Hub | `DOCKER_HUB_USER`, `DOCKER_HUB_TOKEN` |
+
+Set only the ones you need. Use `granny credentials status` to verify
+what's configured at any time.
+
+## Use
+
+```shell
+granny --help                          # see every command group
+granny <group> --help                  # drill into one
+```
+
+The CLI is organized by capability, not by provider. You pick the
+provider per command:
+
+```shell
+# DNS — same command, any of seven providers
+granny dns list example.com --provider cloudflare
+granny dns add www.example.com --type CNAME --value example.com --provider bunny
+granny dns nameservers example.com --provider inwx
+
+# CDN — Bunny pull zones
+granny cdn list-zones
+granny cdn purge 12345
+granny cdn ssl www.example.com --dns01
+
+# Object storage — three providers, one verb set
+granny storage bunny create my-assets --region DE
+granny storage hetzner create my-bucket --region fsn1 --public
+granny storage aws create my-website --website
+
+# AWS inventory (read-only)
+granny analyze vpcs --json-output
+granny analyze lambdas --region us-east-1 eu-west-1
+
+# Cross-cloud GPU / credit / cost inventory (AWS + GCP + Azure)
+granny analyze gpus                                # running GPUs everywhere
+granny analyze gpus --filter h100,h200             # find Hopper clusters
+granny analyze gpus --include-reserved             # also capacity blocks / RIs
+granny analyze gpus --provider aws --profile prod --profile dev
+granny analyze credits                             # available balances
+granny analyze costs                               # MTD + month-end forecast
+
+# Cloudflare account resources (Workers, D1, R2, KV)
+granny cloudflare d1 create my-app
+granny cloudflare r2 create my-app-media
+granny cloudflare site provision my-app --secret-from-vault MAILJET_API_KEY
+
+# Multi-arch Docker builds with deterministic tags
+granny docker build-base --image myapp-base --hash-file requirements.txt
+
+# Scaleway FaaS
+granny serverless deploy my-fn --source-dir ./dist --namespace my-app
+
+# Mailjet + WorkMail
+granny email mailjet setup-dns example.com
+granny email workmail create-user example.com --email user@example.com
+
+# One-shot infrastructure provisioning (dispatches granny/create/*.py)
+granny create s3-website example.com --help
+granny create scaleway-container --name my-app --port 3000
+granny create mailjet-dns example.com
+```
+
+## Capability matrix
+
+| Capability | Providers |
+|---|---|
+| DNS | Cloudflare, Bunny, Hetzner, deSEC, ClouDNS, INWX, manual |
+| CDN | Bunny |
+| Edge scripting | Bunny |
+| Object storage | AWS S3, Bunny Storage, Hetzner S3 |
+| Serverless functions | Scaleway FaaS, Scaleway Containers |
+| Workers / KV / D1 / R2 | Cloudflare |
+| Email send infra | Mailjet, AWS SES, AWS WorkMail |
+| AWS inventory | VPCs, Lambdas |
+| Cross-cloud inventory | GPU instances + reservations, credit balances, MTD spend + forecast (AWS, GCP, Azure) |
+| SSL automation | Bunny, Cloudflare, ACM |
+
+## As a library
+
+Every CLI command is a thin wrapper. Import the underlying module when
+the CLI doesn't have what you need:
+
+```python
+from granny.dns.factory import get_provider
+from granny.cloudflare.d1 import D1Client
+from granny.credentials import get_secret, load_secrets_into_env
+
+# Multi-provider DNS
+dns = get_provider("inwx")
+zone = dns.get_zone_id("example.com")
+dns.upsert_record(zone, "_acme-challenge", "TXT", "abc-token", ttl=300)
+
+# Cloudflare D1 directly
+db = D1Client().create_database("my-app", primary_location_hint="weur")
+
+# Bulk-load registered secrets into os.environ for downstream tools
+load_secrets_into_env()
+```
+
+## Project layout
+
+```
+granny/
+  cli/           Click command groups (granny <group> <verb>)
+  analyze/      Cross-cloud inventory (AWS, GCP, Azure)
+  cdn/          Bunny CDN
+  cloudflare/   Cloudflare Workers / D1 / R2 / KV
+  create/       Standalone setup scripts (granny create <name>)
+  credentials/  Env + vault secret resolution
+  dns/          Provider-agnostic DNS CRUD
+  docker/       Multi-arch image builds
+  edge/         Bunny Edge Scripting
+  email/        Mailjet, WorkMail, SES forwarding
+  serverless/   Scaleway FaaS
+  storage/      Object storage (AWS / Bunny / Hetzner)
+```
+
+## Where to look next
+
+- [`Project_Guidelines.md`](Project_Guidelines.md) — contributor toolchain,
+  conventions, extension checklists, release flow.
+- [`AGENTS.md`](AGENTS.md) — instructions for AI coding agents working
+  in the repository (Claude Code reads `CLAUDE.md` which imports this).
+- `.env.example` — full list of supported environment variables.
+- `granny --help` and `granny <group> --help` — authoritative command docs,
+  always in sync with the installed version.
+
+## License
+
+MIT — see [`LICENSE`](LICENSE). Built and maintained by Martin Wieser.

{granny_devops-0.5.0 → granny_devops-0.7.0}/granny/__init__.py

@@ -1,6 +1,6 @@
 """Granny -- Cloud tools collection for AWS infrastructure and DevOps automation."""
 
-__version__ = "0.5.0"
+__version__ = "0.7.0"
 __all__ = [
     "get_secret",
     "load_secrets_into_env",

granny_devops-0.7.0/granny/analyze/__init__.py

@@ -0,0 +1,41 @@
+"""Cloud resource analysis and inventory (AWS, GCP, Azure)."""
+
+from granny.analyze.lambdas import get_all_regions, list_lambdas
+from granny.analyze.vpcs import list_vpcs
+
+__all__ = [
+    "get_all_regions",
+    "list_lambdas",
+    "list_vpcs",
+]
+
+
+def __getattr__(name: str):
+    # Lazy re-exports so importing `granny.analyze` doesn't drag in boto3
+    # for the new cross-cloud helpers, and so optional GCP/Azure SDKs aren't
+    # required for AWS-only callers.
+    if name in {
+        "GpuInstance",
+        "GpuReservation",
+        "aws_profiles",
+        "list_aws_gpu_instances",
+        "list_aws_gpu_reservations",
+        "gcp_projects",
+        "list_gcp_gpu_instances",
+        "list_gcp_gpu_reservations",
+        "azure_subscriptions",
+        "list_azure_gpu_instances",
+        "list_azure_gpu_reservations",
+    }:
+        from granny.analyze import gpus
+
+        return getattr(gpus, name)
+    if name in {"CreditBalance", "aws_credits", "gcp_credits", "azure_credits"}:
+        from granny.analyze import credits
+
+        return getattr(credits, name)
+    if name in {"CostSummary", "aws_costs", "gcp_costs", "azure_costs"}:
+        from granny.analyze import costs
+
+        return getattr(costs, name)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")