talk-python-cli 0.1.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

talk_python_cli/__init__.py

@@ -2,4 +2,4 @@
 
 from importlib.metadata import version
 
-__version__ = version("talk-python-cli")
+__version__ = version('talk-python-cli')

talk_python_cli/app.py

@@ -82,10 +82,10 @@ def status() -> None:
 def launcher(
     *tokens: Annotated[str, cyclopts.Parameter(show=False, allow_leading_hyphen=True)],
     format: Annotated[
-        Literal['text', 'json'],
+        Literal['text', 'json', 'markdown'],
         cyclopts.Parameter(
             name='--format',
-            help="Output format: 'text' (rich Markdown) or 'json'.",
+            help="Output format: 'text' (rich Markdown), 'json', or 'markdown' (raw).",
         ),
     ] = 'text',
     url: Annotated[

talk_python_cli/client.py

@@ -46,8 +46,8 @@ class MCPClient:
         return self._msg_id
 
     def _url(self) -> str:
-        if self.output_format == 'json':
-            return f'{self.base_url}?format=json'
+        if self.output_format in ('json', 'markdown'):
+            return f'{self.base_url}?format={self.output_format}'
         return self.base_url
 
     def _post(self, payload: dict) -> httpx.Response:

talk_python_cli/formatting.py

@@ -39,10 +39,17 @@ def display(content: str, output_format: str) -> None:
     """Route content to the appropriate renderer."""
     if output_format == 'json':
         display_json(content)
+    elif output_format == 'markdown':
+        display_markdown_raw(content)
     else:
         display_markdown(content)
 
 
+def display_markdown_raw(content: str) -> None:
+    """Print raw Markdown content to stdout without any Rich formatting."""
+    print(content)
+
+
 def display_markdown(content: str) -> None:
     """Render Markdown content with Rich, wrapped in a styled panel."""
     md = Markdown(content, code_theme='monokai')

{talk_python_cli-0.1.2.dist-info → talk_python_cli-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: talk-python-cli
-Version: 0.1.2
+Version: 0.2.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
@@ -44,12 +44,12 @@ Unlock 500+ episodes of [Talk Python to Me](https://talkpython.fm), full transcr
 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
+# Install it permanently with uv
 uv tool install talk-python-cli
 
+# Or try it instantly with uvx (no install needed)
+uvx --from talk-python-cli talkpython episodes recent
+
 # Or with pip
 pip install talk-python-cli
 ```
@@ -58,6 +58,8 @@ This installs the `talkpython` command.
 
 ## Quick start
 
+Copy this whole block and paste it into your terminal to see what you get.
+
 ```bash
 # Search for episodes about FastAPI
 talkpython episodes search "FastAPI"
@@ -109,41 +111,55 @@ talkpython courses list
 
 ## Output formats
 
-The CLI auto-detects the best output format:
+The CLI supports three output formats via `--format`:
 
-- **Interactive terminal** — Rich-formatted Markdown with styled panels and color.
-- **Piped / redirected** — Compact JSON, ready for processing.
-
-Override the default with `--format`:
+- **`text`** (default) — Rich-formatted Markdown with styled panels and color for human reading.
+- **`json`** — Structured JSON, pretty-printed on a TTY or compact when piped.
+- **`markdown`** — Raw Markdown output with no Rich formatting. Ideal for piping into AI agents, LLMs, and automation tools that consume Markdown natively.
 
 ```bash
 # Force JSON output in the terminal
 talkpython --format json episodes search "async"
 
+# Raw Markdown for AI agents and LLM pipelines
+talkpython --format markdown episodes get 535
+
 # Force rich text output even when piping
 talkpython --format text episodes recent | less -R
 ```
 
+## Agentic AI and LLM integration
+
+Use `--format markdown` when feeding output to AI agents, LLMs, or RAG pipelines. This gives you clean, raw Markdown without terminal styling — exactly what language models expect:
+
+```bash
+# Feed an episode summary to an LLM
+talkpython --format markdown episodes get 535 | llm "Summarize this podcast episode"
+
+# Grab a transcript for RAG ingestion
+talkpython --format markdown episodes transcript 535 | your-rag-pipeline ingest
+
+# Pipe course details into an AI agent
+talkpython --format markdown courses get 57 | your-agent process
+```
+
 ## 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:
+The `--format json` output integrates naturally with tools like `jq` or your own scripts:
 
 ```bash
 # Extract episode titles with jq
-talkpython episodes search "testing" | jq '.title'
+talkpython --format json 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
+# Process structured data in a script
+talkpython --format json episodes recent | python process_episodes.py
 ```
 
 ## Global options
 
 | Option | Description |
 |--------|-------------|
-| `--format text\|json` | Force output format (auto-detected by default) |
+| `--format text\|json\|markdown` | Output format: `text` (rich), `json`, or `markdown` (raw) |
 | `--url <mcp-url>` | Override the MCP server URL (default: `https://talkpython.fm/api/mcp`) |
 | `--version`, `-V` | Show version |
 

talk_python_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+talk_python_cli/__init__.py,sha256=9AFzBQG3tsc9-2x-DHoI0zsd_ItUNTySlkMnTHzHS1k,159
+talk_python_cli/__main__.py,sha256=CiR9VEA51QfEByCah9e1uvR7gqiFDoBmsRgFVWltjBU,100
+talk_python_cli/app.py,sha256=FoF_psdIKyIQrG-HeT5Hkedf82SX7gsQv9nMD--tcFE,4280
+talk_python_cli/client.py,sha256=xTRF2np0hOQuqJWL5uOsRLv8_MKEKdLDskzUFv5eC6Q,4808
+talk_python_cli/courses.py,sha256=EgWFbhLFeBTotDHu3xZ4fyiJokgWY2ZLFVaDRTU6NNo,1478
+talk_python_cli/episodes.py,sha256=7Mm6uZ_jzMV6JBPv-1xbmINo7eyI4ylKvsT4_xT3Umw,2453
+talk_python_cli/formatting.py,sha256=NmozYqluukNo0FTUNcCO6sVl9WH0xBvd-h1xpuEsDds,2920
+talk_python_cli/guests.py,sha256=O5MpmnhbACx1czKbV_p9KZywRwEo4jxOM5y8oU3ix50,1314
+talk_python_cli-0.2.0.dist-info/METADATA,sha256=59k7wQgqJD5s9tq35Z3x0gND9FoE5tkwTVkDcPvMRVo,6686
+talk_python_cli-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+talk_python_cli-0.2.0.dist-info/entry_points.txt,sha256=Q7eLneKcuKeoSY_Ps-RyMb8BF1q6QPytIZ0ZYm7fhBg,56
+talk_python_cli-0.2.0.dist-info/licenses/LICENSE,sha256=E1rfm5mKKkNGtHcctSAevPdM0uk6DqdPlcM48R1jGM4,1068
+talk_python_cli-0.2.0.dist-info/RECORD,,

talk_python_cli-0.1.2.dist-info/RECORD

@@ -1,13 +0,0 @@
-talk_python_cli/__init__.py,sha256=WEWAhfkC1qyOUqqsiLcIFzkQD3f3f1gvCv3jYUzGsxY,159
-talk_python_cli/__main__.py,sha256=CiR9VEA51QfEByCah9e1uvR7gqiFDoBmsRgFVWltjBU,100
-talk_python_cli/app.py,sha256=WdLzK60FqO9WPChyt1VMKu8h0V3CsaPNaXl7gmJykxI,4249
-talk_python_cli/client.py,sha256=NR48azeJlfHYFMqikUSjfrFOmCVClyOlq4yd0hyvxHY,4778
-talk_python_cli/courses.py,sha256=EgWFbhLFeBTotDHu3xZ4fyiJokgWY2ZLFVaDRTU6NNo,1478
-talk_python_cli/episodes.py,sha256=7Mm6uZ_jzMV6JBPv-1xbmINo7eyI4ylKvsT4_xT3Umw,2453
-talk_python_cli/formatting.py,sha256=Ww3pfIAK50Ms2MSSkKrKjvwam_5C3ltEB1klHRGeM8U,2699
-talk_python_cli/guests.py,sha256=O5MpmnhbACx1czKbV_p9KZywRwEo4jxOM5y8oU3ix50,1314
-talk_python_cli-0.1.2.dist-info/METADATA,sha256=AAuz2HdkW7KNEjP-oD__-1sWg6B33ckaNuL1eoKns3U,5877
-talk_python_cli-0.1.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-talk_python_cli-0.1.2.dist-info/entry_points.txt,sha256=Q7eLneKcuKeoSY_Ps-RyMb8BF1q6QPytIZ0ZYm7fhBg,56
-talk_python_cli-0.1.2.dist-info/licenses/LICENSE,sha256=E1rfm5mKKkNGtHcctSAevPdM0uk6DqdPlcM48R1jGM4,1068
-talk_python_cli-0.1.2.dist-info/RECORD,,