Python Operations

Python-based tooling and automation covering networking, security, infrastructure, cloud, databases, AI/ML, and life utilities.

Philosophy

  • PEP 723 inline metadata - Single-file scripts with embedded dependencies

  • uv for execution - Zero environment setup, instant dependency resolution

  • Portable and shareable - Each script is self-contained

  • CLI-first - Terminal-native, pipe-friendly, composable

Quick Start

All scripts use uv run --script for automatic dependency management:

# Business search
biz "coffee shops pasadena"

# Distance calculation
geodist "Los Angeles" "San Francisco"
geodist --here "Micro Center Tustin"

Sections

Section Description

CLI Tools

Standalone utilities for daily tasks (search, geo, conversion)

Networking

Network automation, API clients, protocol implementations

Security

Security tools, cryptography, auditing, compliance

Automation

Task automation, workflow orchestration, scripting patterns

Databases

Database utilities, migrations, query tools

Cloud

Cloud provider automation, infrastructure as code

AI & ML

Machine learning utilities, data processing, model interaction

Systems Administration

Linux/Windows system automation, monitoring, maintenance

Patterns

Best practices, uv patterns, packaging, testing

Script Pattern

All tools follow this PEP 723 pattern:

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.11"
# dependencies = ["requests", "click"]
# ///
"""
tool-name - Brief description

Usage:
    tool-name [options] <args>
"""

import sys
# ... implementation ...

if __name__ == "__main__":
    main()

Install to ~/.local/bin/ for global availability:

ln -s /path/to/script ~/.local/bin/script-name