talk-python-cli 0.1.1__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.1 → talk_python_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: talk-python-cli
-Version: 0.1.1
+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
@@ -8,7 +8,7 @@ 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: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

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.1 → talk_python_cli-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "talk-python-cli"
-version = "0.1.1"
+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",

{talk_python_cli-0.1.1 → 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.1 → 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.1/.claude/settings.local.json

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