pip install oauth-https-proxy-client

git clone https://github.com/atrawog/oauth-https-proxy-client.git
cd oauth-https-proxy-client
pip install -e .

# Clone the repository
git clone https://github.com/atrawog/oauth-https-proxy-client.git
cd oauth-https-proxy-client

# Install with development dependencies
pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

# Core Configuration
export API_URL=http://localhost:80
export ADMIN_TOKEN=your_admin_token_here

# Optional Configuration
export LOG_LEVEL=INFO
export PROXY_REQUEST_TIMEOUT=120
export PROXY_CONNECT_TIMEOUT=30

# For testing
export TEST_TOKEN=test_token_here
export TEST_API_URL=https://test.yourdomain.org

# Use with environment variables
proxy-client token list

# Specify base URL and token explicitly
proxy-client --base-url http://localhost:9000 --token your_token token list

# Use a specific profile
proxy-client --profile production proxy list

# Output in different formats
proxy-client --format json token list
proxy-client --format yaml cert list

# List all tokens
proxy-client token list

# Create a new token
proxy-client token create my-token --cert-email admin@example.com

# Show token details
proxy-client token show my-token

# Reveal token value
proxy-client token reveal my-token

# Update token email
proxy-client token update-email my-token new@example.com

# Delete token
proxy-client token delete my-token

# List certificates
proxy-client cert list

# Create single-domain certificate
proxy-client cert create my-cert example.com --email admin@example.com

# Create multi-domain certificate
proxy-client cert create-multi my-cert example.com,www.example.com,api.example.com

# Check certificate status
proxy-client cert status my-cert

# Renew certificate
proxy-client cert renew my-cert

# Export certificate to files
proxy-client cert export my-cert --output-dir ./certs

# List all proxies
proxy-client proxy list

# Create a proxy
proxy-client proxy create api.example.com http://backend:8080

# Enable OAuth authentication
proxy-client proxy auth enable api.example.com auth.example.com forward

# Configure allowed users
proxy-client proxy auth config api.example.com --users alice,bob

# Set MCP metadata
proxy-client proxy resource set api.example.com --endpoint /mcp --scopes mcp:read,mcp:write

# Attach certificate
proxy-client proxy cert attach api.example.com my-cert

# Delete proxy
proxy-client proxy delete api.example.com

# List Docker services
proxy-client service list

# Create a service
proxy-client service create my-app nginx:latest --port 8080

# Control services
proxy-client service start my-app
proxy-client service stop my-app
proxy-client service restart my-app

# View logs
proxy-client service logs my-app --lines 100

# Add port to service
proxy-client service port add my-app 8081 --bind 0.0.0.0

# Register external service
proxy-client service external register api-gateway https://gateway.example.com

# List routes
proxy-client route list

# Create a route
proxy-client route create /auth/ service auth --priority 100

# Create proxy-specific route
proxy-client route create-proxy /admin/ port 8080 api.example.com --priority 90

# Delete route
proxy-client route delete route-id-123

# Search logs
proxy-client log search --query "status:404" --hours 24

# Query by IP
proxy-client log by-ip 192.168.1.100 --hours 1

# Show errors
proxy-client log errors --hours 6 --limit 50

# Follow logs in real-time
proxy-client log follow --interval 2

# Get event statistics
proxy-client log events --hours 24

# List OAuth clients
proxy-client oauth client list

# Show OAuth sessions
proxy-client oauth session list

# Revoke session
proxy-client oauth session revoke session-id-123

# Check OAuth health
proxy-client oauth health

# View OAuth metrics
proxy-client oauth metrics

# Export proxy list as JSON and process with jq
proxy-client --format json proxy list | jq '.[] | .hostname'

# Create multiple proxies from file
cat proxies.txt | while read hostname target; do
  proxy-client proxy create "$hostname" "$target"
done

# Export all certificates
proxy-client cert list --format json | jq -r '.[] | .cert_name' | \
  xargs -I {} proxy-client cert export {} --output-dir ./certs/{}

# Create multiple tokens
for name in alice bob charlie; do
  proxy-client token create "$name" --cert-email "$name@example.com"
done

# Update all proxy certificates to production
proxy-client proxy list --format json | jq -r '.[] | .hostname' | \
  xargs -I {} proxy-client proxy cert generate {} --production

# Run all tests
pytest

# Run with coverage
pytest --cov=oauth_proxy_client

# Run specific test file
pytest tests/test_tokens.py

# Run integration tests only
pytest -m integration

# Format code
black src tests

# Lint code
ruff check src tests

# Type checking
mypy src

# Build Sphinx documentation
sphinx-build -b html docs docs/_build/html

# Serve documentation locally
python -m http.server -d docs/_build/html 8000