gsuite-manager 0.3.0__tar.gz

gsuite_manager-0.3.0/.devcontainer/devcontainer.json

@@ -0,0 +1,26 @@
+{
+  "name": "gsuite-manager",
+  "image": "mcr.microsoft.com/devcontainers/python:3.12",
+  "features": {
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+  "postCreateCommand": "pip install -e '.[dev]' && pre-commit install",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "charliermarsh.ruff",
+        "ms-python.mypy-type-checker",
+        "ms-python.python",
+        "tamasfe.even-better-toml"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/usr/local/bin/python",
+        "python.testing.pytestEnabled": true,
+        "[python]": {
+          "editor.defaultFormatter": "charliermarsh.ruff",
+          "editor.formatOnSave": true
+        }
+      }
+    }
+  }
+}

gsuite_manager-0.3.0/.editorconfig

@@ -0,0 +1,19 @@
+# https://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{yml,yaml,toml,json}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

gsuite_manager-0.3.0/.env.example

@@ -0,0 +1,63 @@
+# GSuite Manager configuration template
+# Copy to `.env` and fill in real values. NEVER commit `.env`.
+
+# ==============================================================================
+# Cloudflare
+# ==============================================================================
+# Get token at: https://dash.cloudflare.com/profile/api-tokens
+# Required scopes: Zone:Edit, DNS:Edit, Account:Read
+GSM_CF_API_TOKEN=your-cloudflare-api-token-here
+
+# Find at: https://dash.cloudflare.com -> right sidebar -> Account ID
+GSM_CF_ACCOUNT_ID=your-cloudflare-account-id-here
+
+# ==============================================================================
+# Google OAuth (Desktop App)
+# ==============================================================================
+# Create at: https://console.cloud.google.com -> APIs & Services -> Credentials
+# Type: "OAuth client ID" -> "Desktop app"
+# Download JSON, place at path below (default: ./credentials.json)
+GSM_GOOGLE_OAUTH_CLIENT_PATH=./credentials.json
+
+# Auto-generated after first browser login. Keep secret.
+GSM_GOOGLE_OAUTH_TOKEN_PATH=./token.json
+
+# ==============================================================================
+# Behavior tuning (defaults are conservative)
+# ==============================================================================
+# Delay between processing each domain (anti rate-limit)
+GSM_DELAY_PER_DOMAIN_SEC=3.0
+
+# Delay between processing each user
+GSM_DELAY_PER_USER_SEC=1.0
+
+# ==============================================================================
+# DNS propagation check
+# ==============================================================================
+# Public resolvers used to verify TXT propagation before calling Google verify.
+# Comma-separated. Default: Google + Cloudflare public resolvers.
+GSM_DNS_CHECK_RESOLVERS=["8.8.8.8","1.1.1.1"]
+
+# DNS query timeout per resolver
+GSM_DNS_CHECK_TIMEOUT_SEC=5.0
+
+# Max attempts to wait for DNS propagation before giving up
+GSM_DNS_CHECK_MAX_ATTEMPTS=6
+
+# Backoff schedule (seconds) between propagation attempts
+GSM_DNS_CHECK_BACKOFF_SEC=[10,20,30,60,120,180]
+
+# ==============================================================================
+# State / ledger
+# ==============================================================================
+# JSON file tracking progress for idempotent re-runs
+GSM_LEDGER_PATH=./gsm_state.json
+
+# ==============================================================================
+# Logging
+# ==============================================================================
+# Levels: DEBUG, INFO, WARNING, ERROR
+GSM_LOG_LEVEL=INFO
+
+# Format: console (pretty, for TTY) or json (structured, for piping/CI)
+GSM_LOG_FORMAT=console

gsuite_manager-0.3.0/.git-blame-ignore-revs

@@ -0,0 +1,8 @@
+# Commits that are pure formatting/refactoring — ignore in git blame
+# Usage: git config blame.ignoreRevsFile .git-blame-ignore-revs
+
+# SSS-tier GitHub infrastructure (templates, badges, docs)
+4a07061
+
+# Source code refactor (users module split, retry logic, error handling)
+88130d1

gsuite_manager-0.3.0/.github/CODEOWNERS

@@ -0,0 +1,15 @@
+# Default owner for everything
+* @nopperabbo
+
+# Source code
+/src/ @nopperabbo
+
+# Tests
+/tests/ @nopperabbo
+
+# CI/CD
+/.github/ @nopperabbo
+
+# Docs
+/docs/ @nopperabbo
+*.md @nopperabbo

gsuite_manager-0.3.0/.github/DISCUSSION_TEMPLATE/ideas.yml

@@ -0,0 +1,22 @@
+title: "Ideas & Feature Requests"
+labels: ["idea"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Share ideas for new features or improvements.
+        For bug reports, please use [Issues](https://github.com/nopperabbo/gsuite-manager/issues/new?template=bug_report.yml).
+
+  - type: textarea
+    id: idea
+    attributes:
+      label: Describe your idea
+      description: What would you like to see in gsuite-manager?
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use case
+      description: How would this help your workflow?

gsuite_manager-0.3.0/.github/DISCUSSION_TEMPLATE/questions.yml

@@ -0,0 +1,25 @@
+title: "Questions & Help"
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Before asking
+
+        - Check the [Usage Guide](https://github.com/nopperabbo/gsuite-manager/blob/main/docs/USAGE.md)
+        - Check [existing discussions](https://github.com/nopperabbo/gsuite-manager/discussions)
+        - Check [closed issues](https://github.com/nopperabbo/gsuite-manager/issues?q=is%3Aissue+is%3Aclosed)
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Your question
+      description: What do you need help with?
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: What are you trying to accomplish? What have you tried?

gsuite_manager-0.3.0/.github/DISCUSSION_TEMPLATE/show-and-tell.yml

@@ -0,0 +1,15 @@
+title: "Show & Tell"
+labels: ["showcase"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Share how you're using gsuite-manager! Screenshots, scripts, workflows — anything goes.
+
+  - type: textarea
+    id: showcase
+    attributes:
+      label: What did you build?
+      description: Share your setup, workflow, or integration
+    validations:
+      required: true

gsuite_manager-0.3.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [nopperabbo]

gsuite_manager-0.3.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,66 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting! Please fill in the details below.
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Clear description of the bug
+      placeholder: "When I do X, Y happens instead of Z"
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps to reproduce
+      placeholder: |
+        1. Run `gsm ...`
+        2. See error
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What should have happened
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: gsm version
+      description: Output of `gsm --version`
+      placeholder: "0.1.0"
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - macOS
+        - Linux (Ubuntu/Debian)
+        - Linux (Other)
+        - Windows
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      description: Output of `python --version`
+      placeholder: "3.12.1"
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs / error output
+      description: Paste any relevant log output
+      render: shell

gsuite_manager-0.3.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions & Discussion
+    url: https://github.com/nopperabbo/gsuite-manager/discussions
+    about: Ask questions and discuss ideas here
+  - name: Security Vulnerability
+    url: https://github.com/nopperabbo/gsuite-manager/blob/main/SECURITY.md
+    about: Report security vulnerabilities privately

gsuite_manager-0.3.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,44 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement! Please describe your idea below.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / Use case
+      description: What are you trying to do that gsm doesn't support yet?
+      placeholder: "I want to be able to..."
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: How should it work? Include command examples if possible.
+      placeholder: |
+        ```bash
+        gsm new-command --flag value
+        ```
+        Expected output: ...
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Any workarounds you've tried or other approaches you considered
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope
+      description: How big is this change?
+      options:
+        - Small (single command/flag)
+        - Medium (new subcommand)
+        - Large (new module/workflow)
+    validations:
+      required: true

gsuite_manager-0.3.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+## What
+
+<!-- One sentence: what does this PR do? -->
+
+## Why
+
+<!-- Context: what problem does this solve? Link issue if applicable. -->
+
+## How
+
+<!-- Brief technical approach -->
+
+## Checklist
+
+- [ ] Tests added/updated
+- [ ] `pytest && ruff check src tests && mypy src` passes
+- [ ] CHANGELOG.md updated
+- [ ] No new dependencies without discussion
+- [ ] Commit messages follow conventional format (`feat(scope): description`)

gsuite_manager-0.3.0/.github/dependabot.yml

@@ -0,0 +1,21 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+    commit-message:
+      prefix: "chore(deps)"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "ci"
+    commit-message:
+      prefix: "chore(ci)"
+    open-pull-requests-limit: 5

gsuite_manager-0.3.0/.github/labeler.yml

@@ -0,0 +1,33 @@
+labels:
+  # Type labels
+  - label: "bug"
+    color: "d73a4a"
+    description: "Something isn't working"
+  - label: "feature"
+    color: "a2eeef"
+    description: "New feature or request"
+  - label: "docs"
+    color: "0075ca"
+    description: "Documentation improvements"
+  - label: "chore"
+    color: "e4e669"
+    description: "Maintenance and tooling"
+  - label: "good first issue"
+    color: "7057ff"
+    description: "Good for newcomers"
+
+# Path-based auto-labeling
+"src/gsm/cli/**":
+  - cli
+"src/gsm/clients/**":
+  - api-clients
+"src/gsm/core/**":
+  - core
+"src/gsm/workflows/**":
+  - workflows
+"tests/**":
+  - tests
+"docs/**":
+  - docs
+".github/**":
+  - ci/cd

gsuite_manager-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,115 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  NO_COLOR: "1"
+  FORCE_COLOR: "0"
+  TERM: "dumb"
+  COLUMNS: "200"
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: pip install -e ".[dev]"
+      - name: Ruff check
+        run: ruff check src/ tests/
+      - name: Ruff format check
+        run: ruff format --check src/ tests/
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: pip install -e ".[dev]"
+      - name: Mypy
+        run: mypy
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: pip install -e ".[dev]"
+      - name: Test
+        run: pytest --no-cov -q
+
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: pip install -e ".[dev]"
+      - name: Test with coverage
+        run: pytest --cov=src/gsm --cov-report=xml --cov-fail-under=70
+      - name: Upload coverage
+        uses: codecov/codecov-action@75cd11691c0faa626561e295848008c8a7dddffe # v5
+        with:
+          file: coverage.xml
+          fail_ci_if_error: false
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: pip install -e ".[dev]" pip-audit
+      - name: Audit dependencies
+        run: pip-audit
+
+  smoke:
+    runs-on: ubuntu-latest
+    needs: [test]
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.12"
+      - name: Build wheel
+        run: pip install build && python -m build
+      - name: Install from wheel
+        run: pip install dist/*.whl
+      - name: Smoke test
+        run: gsm --help
+
+  alls-green:
+    if: always()
+    needs: [lint, typecheck, test, coverage, security, smoke]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Decide whether all jobs passed
+        uses: re-actors/alls-green@05ac9388f0aebcb5727afa17fcccfecd6f8ec5fe # v1.2.2
+        with:
+          jobs: ${{ toJSON(needs) }}

gsuite_manager-0.3.0/.github/workflows/docs.yml

@@ -0,0 +1,46 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+
+      - name: Install MkDocs
+        run: pip install mkdocs-material mkdocstrings[python]
+
+      - name: Build docs
+        run: mkdocs build
+
+      - uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
+        with:
+          path: site
+
+      - id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4

gsuite_manager-0.3.0/.github/workflows/labeler.yml

@@ -0,0 +1,17 @@
+name: Label PRs
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  label:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/labeler@8558fd74291d67161a8a78ce36a881fa83b30bea # v5.0.0
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"

gsuite_manager-0.3.0/.github/workflows/links.yml

@@ -0,0 +1,19 @@
+name: Check Links
+
+on:
+  push:
+    branches: [main]
+    paths: ["**/*.md"]
+  pull_request:
+    paths: ["**/*.md"]
+
+jobs:
+  links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - uses: lycheeverse/lychee-action@8646ba30535128ac92d33dfc9133794bfdd9b411 # v2
+        with:
+          args: --no-progress --exclude-mail '**/*.md'
+          fail: true

gsuite_manager-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,59 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -q
+
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+
+      - name: Extract changelog for this version
+        id: changelog
+        run: |
+          VERSION=${GITHUB_REF_NAME#v}
+          awk "/^## \[${VERSION}\]/{flag=1; next} /^## \[/{flag=0} flag" CHANGELOG.md > release_notes.md
+          echo "Found release notes for v${VERSION}"
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc # v1.12.4
+        with:
+          attestations: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@da05d552573ad5aba039eaac05058a918a7bf631 # v2.2.2
+        with:
+          body_path: release_notes.md
+          files: dist/*
+          generate_release_notes: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}