Python SDK

source ~/.ticket/.venv/bin/activate

~/.ticket/.venv/bin/python -c "import ticket_py; print(ticket_py.version())"

from ticket_py import Ticket
from pathlib import Path

# Initialize with your project directory
tk = Ticket(cwd=Path("/path/to/your/project"))

# Get issues ready to work on
ready = tk.ready()
for issue in ready:
    print(f"{issue.id}: {issue.title}")

# Get repository statistics
stats = tk.stats()
print(f"Total issues: {stats.total}")
print(f"Open: {stats.open}")

from ticket_py import Ticket
from pathlib import Path

tk = Ticket(cwd=Path.cwd())

import ticket_py

# Get version
print(ticket_py.version())

# List all issues (uses current directory)
issues = ticket_py.list_issues()

# Get ready issues
ready = ticket_py.ready_issues(limit=5)

# Show specific issue
issue = ticket_py.show_issue("tk-abc123")

# Create an issue
new_id = ticket_py.create_issue(
    title="Implement feature X",
    description="Details here...",
    issue_type="feature",
    priority=1
)

# Update an issue
ticket_py.update_issue(
    issue_id="tk-abc123",
    status="in_progress"
)

# Get statistics
stats = ticket_py.stats()

# Get triage recommendations
triage = ticket_py.triage()

# Get priority ranking
priorities = ticket_py.priority(limit=10)

@dataclass
class Issue:
    id: str
    title: str
    status: str
    issue_type: str
    priority: int
    deps: List[str]
    labels: List[str]
    assignee: Optional[str]
    body: str
    created: datetime
    updated: datetime

@dataclass
class Stats:
    total: int
    open: int
    in_progress: int
    closed: int
    blocked: int

@dataclass
class TriageResult:
    health_score: float
    quick_wins: List[Issue]
    blockers_to_clear: List[Issue]
    recommendations: List[str]

from ticket_py import Ticket
from pathlib import Path

tk = Ticket(cwd=Path.cwd())

# Get ready issues sorted by priority
ready = tk.ready()
high_priority = [i for i in ready if i.priority <= 1]

for issue in high_priority:
    print(f"[P{issue.priority}] {issue.id}: {issue.title}")

import ticket_py

tasks = [
    ("Set up CI/CD", "task", 1),
    ("Write documentation", "task", 2),
    ("Add unit tests", "task", 2),
]

for title, issue_type, priority in tasks:
    issue_id = ticket_py.create_issue(
        title=title,
        issue_type=issue_type,
        priority=priority
    )
    print(f"Created: {issue_id}")

import ticket_py
import json

issues = ticket_py.list_issues()
data = [
    {
        "id": i.id,
        "title": i.title,
        "status": i.status,
        "priority": i.priority,
    }
    for i in issues
]

with open("issues.json", "w") as f:
    json.dump(data, f, indent=2)

import ticket_py
import pandas as pd

issues = ticket_py.list_issues()
df = pd.DataFrame([
    {
        "id": i.id,
        "title": i.title,
        "status": i.status,
        "type": i.issue_type,
        "priority": i.priority,
        "deps_count": len(i.deps),
    }
    for i in issues
])

# Analyze by status
print(df.groupby("status").size())

# Find issues with most dependencies
print(df.nlargest(5, "deps_count")[["id", "title", "deps_count"]])