talk-python-cli 0.1.0__tar.gz → 0.1.2__tar.gz

talk_python_cli-0.1.2/.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(UV_PROJECT_ENVIRONMENT=venv uv run pytest:*)",
+      "Bash(./venv/bin/python -m talk_python_cli.app status:*)",
+      "Bash(./venv/bin/talkpython status:*)",
+      "Bash(./venv/bin/pip install:*)",
+      "Bash(./venv/bin/talkpython:*)"
+    ]
+  }
+}

talk_python_cli-0.1.2/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: talk-python-cli
+Version: 0.1.2
+Summary: CLI for the Talk Python to Me podcast and courses
+Project-URL: Homepage, https://github.com/talkpython/talk-python-cli
+Project-URL: Source, https://github.com/talkpython/talk-python-cli
+Project-URL: Documentation, https://github.com/talkpython/talk-python-cli
+Author-email: Michael Kennedy <michael@talkpython.fm>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Education
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.12
+Requires-Dist: cyclopts>=3.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+# Talk Python CLI
+
+[![PyPI version](https://badge.fury.io/py/talk-python-cli.svg)](https://pypi.org/project/talk-python-cli/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+Unlock 500+ episodes of [Talk Python to Me](https://talkpython.fm), full transcripts, guest profiles, and 50+ [Talk Python Training](https://training.talkpython.fm) courses — all from your terminal. Search, browse, and pipe structured data into your scripts, AI agents, or automation workflows.
+
+## Why use this?
+
+- **Automation** — Query episode data, guest info, and course catalogs from scripts and pipelines.
+- **LLM & AI integration** — Pipe JSON or Markdown output directly into AI agents, RAG systems, or chat workflows. Feed transcripts into RAG pipelines, build podcast assistants, or enrich your AI tools with real Python community knowledge.
+- **Quick lookups** — Search episodes, pull transcripts, and browse courses without leaving the terminal.
+
+## Installation
+
+Requires Python 3.12+.
+
+```bash
+# Try it instantly with uvx (no install needed)
+uvx --from talk-python-cli talkpython episodes recent
+
+# Or install it permanently with uv
+uv tool install talk-python-cli
+
+# Or with pip
+pip install talk-python-cli
+```
+
+This installs the `talkpython` command.
+
+## Quick start
+
+```bash
+# Search for episodes about FastAPI
+talkpython episodes search "FastAPI"
+
+# Get full details for a specific episode
+talkpython episodes get 535
+
+# Pull the transcript for an episode
+talkpython episodes transcript 535
+
+# List recent episodes
+talkpython episodes recent --limit 5
+
+# Search for a guest
+talkpython guests search "Hynek"
+
+# Browse all training courses
+talkpython courses list
+```
+
+## Commands
+
+### Episodes
+
+| Command | Description |
+|---------|-------------|
+| `talkpython episodes search <query> [--limit N]` | Search episodes by keyword (default limit: 10) |
+| `talkpython episodes get <show_id>` | Get full details for an episode |
+| `talkpython episodes list` | List all episodes |
+| `talkpython episodes recent [--limit N]` | Get the most recent episodes |
+| `talkpython episodes transcript <show_id>` | Get the plain-text transcript |
+| `talkpython episodes transcript-vtt <show_id>` | Get the WebVTT transcript (with timestamps) |
+
+### Guests
+
+| Command | Description |
+|---------|-------------|
+| `talkpython guests search <query> [--limit N]` | Search guests by name |
+| `talkpython guests get <guest_id>` | Get details for a specific guest |
+| `talkpython guests list` | List all guests, sorted by number of appearances |
+
+### Courses
+
+| Command | Description |
+|---------|-------------|
+| `talkpython courses search <query> [--course_id N]` | Search courses, chapters, and lectures |
+| `talkpython courses get <course_id>` | Get full course details including chapters and lectures |
+| `talkpython courses list` | List all available training courses |
+
+## Output formats
+
+The CLI auto-detects the best output format:
+
+- **Interactive terminal** — Rich-formatted Markdown with styled panels and color.
+- **Piped / redirected** — Compact JSON, ready for processing.
+
+Override the default with `--format`:
+
+```bash
+# Force JSON output in the terminal
+talkpython --format json episodes search "async"
+
+# Force rich text output even when piping
+talkpython --format text episodes recent | less -R
+```
+
+## Piping JSON to other tools
+
+Because the CLI outputs JSON automatically when piped, it integrates naturally with tools like `jq`, `llm`, or your own scripts:
+
+```bash
+# Extract episode titles with jq
+talkpython episodes search "testing" | jq '.title'
+
+# Feed episode data into an LLM
+talkpython episodes get 535 | llm "Summarize this podcast episode"
+
+# Grab a transcript for RAG ingestion
+talkpython episodes transcript 535 | your-rag-pipeline ingest
+```
+
+## Global options
+
+| Option | Description |
+|--------|-------------|
+| `--format text\|json` | Force output format (auto-detected by default) |
+| `--url <mcp-url>` | Override the MCP server URL (default: `https://talkpython.fm/api/mcp`) |
+| `--version`, `-V` | Show version |
+
+## Part of the Talk Python ecosystem
+
+Talk Python CLI is one way to tap into the data behind the [Talk Python to Me](https://talkpython.fm) podcast and [Talk Python Training](https://training.talkpython.fm) courses. It connects to the same public [MCP server](https://talkpython.fm/api/mcp) that powers Talk Python's AI integrations — so whether you're building an agent, a search tool, or just want quick answers from the terminal, you're working with the real data.
+
+- [Talk Python to Me Podcast](https://talkpython.fm)
+- [Talk Python Training](https://training.talkpython.fm)
+
+## License
+
+MIT

talk_python_cli-0.1.2/change-log.md

@@ -0,0 +1,67 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.2] - 2026-02-07
+
+### Added
+- `talkpython status` command to check MCP server health and display version info
+
+### Changed
+- Version is now read dynamically from package metadata via `importlib.metadata`
+- Default output format is now always `text` (removed auto-detect that defaulted to `json` when piped)
+- Development status upgraded from Alpha to Beta
+- Added `readme` field to `pyproject.toml` so PyPI renders the README
+
+---
+
+## [0.1.0] - 2026-02-06
+
+Initial release of the Talk Python CLI.
+
+- Query podcast episodes by number or keyword
+- Look up guest appearances
+- Browse and search the Talk Python course catalog
+- Rich terminal output with Markdown rendering
+- JSON output mode via `--format json`
+- Configurable MCP server URL via `--url`
+
+---
+
+## Template for Future Entries
+
+<!--
+## [X.Y.Z] - YYYY-MM-DD
+
+### Added
+- New features or capabilities
+- Files: `path/to/new/file.ext`, `another/file.ext`
+
+### Changed
+- Modifications to existing functionality
+- Files: `path/to/modified/file.ext` (summary if many files)
+
+### Deprecated
+- Features that will be removed in future versions
+- Files affected: `path/to/deprecated/file.ext`
+
+### Removed
+- Features or files that were deleted
+- Files: `path/to/removed/file.ext`
+
+### Fixed
+- Bug fixes and corrections
+- Files: `path/to/fixed/file.ext`
+
+### Security
+- Security patches or vulnerability fixes
+- Files: `path/to/security/file.ext`
+
+### Notes
+- Additional context or important information
+- Major dependencies updated
+- Breaking changes explanation
+-->

{talk_python_cli-0.1.0 → talk_python_cli-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "talk-python-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "CLI for the Talk Python to Me podcast and courses"
 requires-python = ">=3.12"
 license = "MIT"
@@ -8,7 +8,7 @@ authors = [
     { name = "Michael Kennedy", email = "michael@talkpython.fm" },
 ]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
@@ -20,6 +20,7 @@ classifiers = [
     "Topic :: Multimedia :: Sound/Audio",
     "Topic :: Education",
 ]
+readme = "README.md"
 dependencies = [
     "cyclopts>=3.0",
     "httpx>=0.27",

talk_python_cli-0.1.2/src/talk_python_cli/__init__.py

@@ -0,0 +1,5 @@
+"""Talk Python to Me CLI — query podcast episodes, guests, and courses."""
+
+from importlib.metadata import version
+
+__version__ = version("talk-python-cli")

{talk_python_cli-0.1.0 → talk_python_cli-0.1.2}/src/talk_python_cli/app.py

@@ -2,14 +2,17 @@
 
 from __future__ import annotations
 
+import json
 import sys
+import time
 from typing import Annotated, Literal
 
 import cyclopts
+import httpx
 
 from talk_python_cli import __version__
 from talk_python_cli.client import DEFAULT_URL, MCPClient
-from talk_python_cli.formatting import is_tty, print_error
+from talk_python_cli.formatting import console, display_json, print_error
 
 # ── Shared state ─────────────────────────────────────────────────────────────
 # The meta-app handler stores the client here so command modules can access it.
@@ -42,6 +45,38 @@ app.command(guests_app)
 app.command(courses_app)
 
 
+@app.command
+def status() -> None:
+    """Check whether the Talk Python MCP server is up and display its version info."""
+    base = _client.base_url if _client else DEFAULT_URL
+    t0 = time.monotonic()
+    try:
+        resp = httpx.get(base, timeout=15.0)
+        elapsed_ms = (time.monotonic() - t0) * 1000
+        resp.raise_for_status()
+        data = resp.json()
+    except httpx.HTTPError as exc:
+        elapsed_ms = (time.monotonic() - t0) * 1000
+        console.print(f'[tp.error]STATUS: FAILED ({elapsed_ms:.2f} ms)[/tp.error]')
+        console.print(f'[red]{exc}[/red]')
+        sys.exit(1)
+
+    # If piped / --format json, emit raw JSON
+    if _client and _client.output_format == 'json':
+        data['status'] = 'SUCCESS'
+        data['response_ms'] = round(elapsed_ms, 2)
+        display_json(json.dumps(data))
+        return
+
+    console.print()
+    console.print(f'[tp.success]STATUS: SUCCESS[/tp.success] [tp.dim]({elapsed_ms:.2f} ms)[/tp.dim]')
+    console.print()
+    for key in ('name', 'version', 'description', 'documentation'):
+        if key in data:
+            console.print(f'[tp.label]{key}:[/tp.label] {data[key]}')
+    console.print()
+
+
 # ── Meta-app: handles global options before dispatching to sub-commands ──────
 @app.meta.default
 def launcher(
@@ -50,9 +85,9 @@ def launcher(
         Literal['text', 'json'],
         cyclopts.Parameter(
             name='--format',
-            help="Output format: 'text' (rich Markdown) or 'json'. Defaults to 'json' when stdout is piped.",
+            help="Output format: 'text' (rich Markdown) or 'json'.",
         ),
-    ] = None,  # type: ignore
+    ] = 'text',
     url: Annotated[
         str,
         cyclopts.Parameter(
@@ -64,10 +99,6 @@ def launcher(
 ) -> None:
     global _client
 
-    # Auto-detect: default to json when piped, text when interactive
-    if format is None:
-        format = 'text' if is_tty() else 'json'
-
     _client = MCPClient(base_url=url, output_format=format)
     try:
         app(tokens)

{talk_python_cli-0.1.0 → talk_python_cli-0.1.2}/uv.lock

@@ -235,7 +235,7 @@ wheels = [
 
 [[package]]
 name = "talk-python-cli"
-version = "0.1.0"
+version = "0.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "cyclopts" },

talk_python_cli-0.1.0/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(UV_PROJECT_ENVIRONMENT=venv uv run pytest:*)"
-    ]
-  }
-}

talk_python_cli-0.1.0/PKG-INFO

@@ -1,25 +0,0 @@
-Metadata-Version: 2.4
-Name: talk-python-cli
-Version: 0.1.0
-Summary: CLI for the Talk Python to Me podcast and courses
-Project-URL: Homepage, https://github.com/talkpython/talk-python-cli
-Project-URL: Source, https://github.com/talkpython/talk-python-cli
-Project-URL: Documentation, https://github.com/talkpython/talk-python-cli
-Author-email: Michael Kennedy <michael@talkpython.fm>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: 3.15
-Classifier: Topic :: Education
-Classifier: Topic :: Multimedia :: Sound/Audio
-Requires-Python: >=3.12
-Requires-Dist: cyclopts>=3.0
-Requires-Dist: httpx>=0.27
-Requires-Dist: rich>=13.0

talk_python_cli-0.1.0/src/talk_python_cli/__init__.py

@@ -1,3 +0,0 @@
-"""Talk Python to Me CLI — query podcast episodes, guests, and courses."""
-
-__version__ = '0.1.0'