commit_message.py
# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------
#!/usr/bin/env python3
"""
Commit Message
=============================
Validate or generate conventional commit messages.
"""
import json
import sys
COMMIT_TYPES = {
"feat": "A new feature",
"fix": "A bug fix",
"docs": "Documentation changes",
"style": "Formatting, no code change",
"refactor": "Code restructuring",
"perf": "Performance improvement",
"test": "Adding/updating tests",
"chore": "Maintenance tasks",
"build": "Build system changes",
"ci": "CI/CD changes",
}
def validate(message: str) -> dict:
"""Validate a commit message."""
errors = []
warnings = []
lines = message.strip().split("\n")
if not lines or not lines[0]:
return {"valid": False, "errors": ["Empty commit message"]}
subject = lines[0]
# Check format: type: description
if ":" not in subject:
errors.append("Missing ':' separator (expected 'type: description')")
else:
type_part, desc = subject.split(":", 1)
type_part = type_part.strip().rstrip("!").split("(")[0]
desc = desc.strip()
if type_part not in COMMIT_TYPES:
errors.append(
f"Unknown type '{type_part}'. Valid: {', '.join(COMMIT_TYPES.keys())}"
)
if not desc:
errors.append("Description required after ':'")
if len(subject) > 72:
warnings.append(f"Subject is {len(subject)} chars (recommended: ≤72)")
return {"valid": len(errors) == 0, "errors": errors, "warnings": warnings}
def generate(commit_type: str, description: str, scope: str = None) -> dict:
"""Generate a commit message."""
if commit_type not in COMMIT_TYPES:
return {
"error": f"Unknown type '{commit_type}'. Valid: {', '.join(COMMIT_TYPES.keys())}"
}
if scope:
message = f"{commit_type}({scope}): {description}"
else:
message = f"{commit_type}: {description}"
return {"message": message, "type": commit_type, "description": description}
def list_types() -> dict:
"""List all valid commit types."""
return {"types": COMMIT_TYPES}
# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
try:
if len(sys.argv) < 2:
print(
json.dumps(
{
"error": "Usage: commit_message.py <validate|generate|types> [args]"
}
)
)
sys.exit(1)
command = sys.argv[1]
if command == "validate":
msg = sys.argv[2] if len(sys.argv) > 2 else sys.stdin.read()
result = validate(msg)
elif command == "generate":
if len(sys.argv) < 4:
result = {
"error": "Usage: commit_message.py generate <type> <description> [scope]"
}
else:
commit_type = sys.argv[2]
description = sys.argv[3]
scope = sys.argv[4] if len(sys.argv) > 4 else None
result = generate(commit_type, description, scope)
elif command == "types":
result = list_types()
else:
result = {
"error": f"Unknown command '{command}'. Use: validate, generate, types"
}
print(json.dumps(result, indent=2))
except Exception as e:
print(json.dumps({"error": str(e)}))
Run the Example
1
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
2
Install dependencies
uv pip install -U agno
3
Run the example
Save the code above as
commit_message.py, then run:python commit_message.py