Media Management Command Line Interface

Summary

An intuitive command line interface that wraps boto3 to search and manage media assets

Installing mgmt & Supported Versions

mgmt is available on PyPI:

uv tool install mgmt

Media Management Command Line Interface officially supports Python 3.9, 3.10, 3.11, 3.12, 3.13, and 3.14.

Quick Start

• setup global config file ~/.config/mgmt/config

mgmt config

fill out prompts

mgmt config

check configs are correct

mgmt ls

Supported Features & Usage

For help, run:

➜ mgmt --help

 Usage: mgmt [OPTIONS] COMMAND [ARGS]...

╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --version          Show the version and exit.                                                                   │
│ --help             Show this message and exit.                                                                  │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ config        Configures the application                                                                        │
│ delete        Deletes the specified file from S3; requires confirmation                                         │
│ download      Downloads the specified file from S3                                                              │
│ ls            Lists the files in the specified location                                                         │
│ search        Searches for files that contain the specified keyword in their names                              │
│ status        Retrieves and prints the metadata of the specified file                                           │
│ upload        Uploads the specified file to S3                                                                  │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Why not use awscli?

You can, and I do, in tandem with mgmt -- the purpose is to create an additional interface that minimized the lookup/copy/paste process I found myself frequently going through

Development

To contribute to this tool, first checkout the code:

git clone https://github.com/will-wright-eng/media-mgmt-cli.git
cd media-mgmt-cli

Prerequisites

This project uses uv for fast and reliable dependency management. Install uv if you haven't already:

# Install uv (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via pip
pip install uv

Development Setup

The project includes a comprehensive Makefile for development tasks:

# Complete project setup (installs dependencies and pre-commit hooks)
make setup

# Or manually:
uv sync --extra test --extra dev
uv run pre-commit install

Available Development Commands

# Run tests
make test

# Run linting and formatting
make lint

# Fix linting issues
make lint-fix

# Show CLI help
make cli

# Clean up build artifacts
make clean

# Show project status
make status

Code Quality

The project uses modern Python tooling for code quality:

• Ruff: Fast linting and formatting
• ty: Type checking
• Pre-commit: Automated quality checks
• Codespell: Spelling checks

All quality checks run automatically on commit via pre-commit hooks.

Why uv?

This project uses uv for dependency management because it offers:

• 🚀 Speed: 10-100x faster than pip for dependency resolution
• 🔒 Reliability: Deterministic builds with lock files
• 🛠️ Modern tooling: Built-in support for virtual environments, project management, and publishing
• 📦 Better dependency resolution: More reliable conflict resolution than traditional tools
• 🔄 Drop-in replacement: Compatible with existing pip workflows

Project Status

This project follows modern Python development practices:

• ✅ Modern dependency management with uv
• ✅ Comprehensive CI/CD with GitHub Actions
• ✅ Automated code quality with Ruff, ty, and pre-commit
• ✅ Type safety with comprehensive type hints
• ✅ Testing with pytest and coverage reporting
• ✅ Documentation with automated quality checks

Modern Python Development

This project showcases modern Python development practices:

• uv for fast dependency management and project tooling
• Ruff for lightning-fast linting and formatting
• ty for static type checking
• Pre-commit for automated quality gates
• GitHub Actions for CI/CD automation
• Hatchling for modern Python packaging

References

• PyPI Package
• uv Documentation
• Based on cookiecutter template will-wright-eng/click-app
• Rewrite of original project will-wright-eng/media_mgmt_cli