mkdocs.yaml

site_name: "Exploring Python"
site_url: https://python.bradpenney.io
site_description: Python automation for platform engineers and SREs — from first script to production-grade automation tools.
site_author: Brad Penney
copyright: >-
  Copyright © Brad Penney —
  <a href="#__consent">Change cookie settings</a>

extra:
  analytics:
    provider: google
    property: G-V01MJ4R3SQ
  consent:
    title: Cookie consent
    description: >-
      We use cookies to measure how effective our content is and whether you
      find what you're looking for. With your consent, you help make these
      learning sites better. You can change your choice at any time.
    cookies:
      analytics:
        name: Google Analytics
        checked: false
    actions:
      - accept
      - reject
      - manage
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/bradpenney
    - icon: fontawesome/brands/linkedin
      link: https://linkedin.com/in/bradpenney
    - icon: fontawesome/solid/globe
      link: https://bradpenney.io
    - icon: fontawesome/solid/rss
      link: https://python.bradpenney.io/feed_rss_created.xml

extra_css:
  - stylesheets/extra.css

theme:
  name: material
  custom_dir: overrides
  font:
    text: IBM Plex Sans
    code: IBM Plex Mono
  palette:
    scheme: slate
    primary: black
    accent: amber
  logo: images/exploring_python.png
  favicon: images/exploring_python.png
  icon:
    admonition:
      note: octicons/tag-16
      abstract: octicons/checklist-16
      info: octicons/info-16
      tip: octicons/squirrel-16
      success: octicons/check-16
      question: octicons/question-16
      warning: octicons/alert-16
      failure: octicons/x-circle-16
      danger: octicons/zap-16
      bug: octicons/bug-16
      example: octicons/beaker-16
      quote: octicons/quote-16
  features:
    - content.code.annotate
    - content.code.copy
    - content.tabs.link
    - content.code.highlight
    - content.tooltips
    - content.code.mermaid
    - navigation.path

plugins:
  - search
  - meta
  - rss:
      match_path: ".*"
      pretty_print: true
      image: https://python.bradpenney.io/images/exploring_python.png
      abstract_chars_count: 160
      length: 20
      date_from_meta:
        as_creation: "date"
        as_update: "git"
        default_timezone: "America/Halifax"
      categories:
        - tags
      use_material_social_cards: false
  - social:
      cards: true
      cards_layout_options:
        background_color: "#1a202c"
        color: "#cbd5e0"

markdown_extensions:
  - toc:
      permalink: "🔗"
      permalink_title: "Link to this section"
  - admonition
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - attr_list
  - md_in_html
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg

nav:
  - Home: index.md

  - 🐍 Day One:
      - Overview: day_one/overview.md
      - "The Clean Setup": day_one/setup.md
      - Why Python (Not Just Bash): day_one/why_python.md
      - "Is It Still Up?": day_one/health_check.md
      - "What Just Broke?": day_one/parsing_logs.md
      - "Did the Config Change?": day_one/comparing_configs.md
      - "Run This Everywhere": day_one/run_everywhere.md
      - My Bash Script Is Getting Out of Hand: day_one/wrapping_bash.md
      - The "Don't Do This" Guide: day_one/safety_guide.md

  # 📦 Essentials — Core Python for working platform engineers
  - 📦 Essentials:
      - Overview: essentials/overview.md
      - Environment Variables and Secrets: essentials/env_and_secrets.md
      - Working with YAML: essentials/yaml.md
  #     - "Which Pods Aren't Running?": essentials/pods_not_running.md
  #     - Find the One Field You Need: essentials/api_response_filtering.md
  #     - "Which EC2 Instances Have No Name Tag?": essentials/aws_tag_audit.md
  #     - "Is My Cert Going to Expire?": essentials/cert_expiry.md
  #     - Summarize the Admission Controllers: essentials/admission_controllers.md

  # ⚡ Efficiency — Professional Python patterns
  - ⚡ Efficiency:
      - Overview: efficiency/overview.md
      - "Is This Whole Stack Healthy?": efficiency/stack_health.md
  #     - "What Changed Between Deploys?": efficiency/diff_deploys.md
  #     - "Which Repos Are Missing CODEOWNERS?": efficiency/repo_audit.md
  #     - "Is There an Active Incident?": efficiency/incident_check.md
  #     - "Send a Slack Message When the Deploy Finishes": efficiency/slack_notify.md
  #     - "Which Namespaces Have No Resource Limits?": efficiency/namespace_audit.md
  #     - Parse Logs With Regular Expressions: efficiency/regex_logs.md

  # 🎯 Mastery — Production Python for senior engineers
  # - 🎯 Mastery:
  #     - Reconcile Git vs Deployed: mastery/git_vs_deployed.md
  #     - Daily Cost Report by Team Tag: mastery/cost_report.md
  #     - "Is This Namespace Production-Ready?": mastery/namespace_readiness.md
  #     - Rotate a Service Account Token: mastery/rotate_tokens.md
  #     - Parse Terraform State: mastery/terraform_state.md