u-transcript-max 0.1.0a1__tar.gz

u_transcript_max-0.1.0a1/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+.venv/
+build/
+dist/
+*.egg-info/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.part
+*.part.json
+.worktrees/
+.claude/settings.local.json

u_transcript_max-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 U-C4N
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

u_transcript_max-0.1.0a1/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.5
+Name: u-transcript-max
+Version: 0.1.0a1
+Summary: YouTube transcripts, AI translation and downloads for Python, with zero dependencies.
+Project-URL: Homepage, https://github.com/U-C4N/U-transkript
+Project-URL: Issues, https://github.com/U-C4N/U-transkript/issues
+Author: U-C4N
+License-Expression: MIT
+License-File: LICENSE
+Keywords: captions,srt,subtitles,transcript,translation,vtt,youtube
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Provides-Extra: ai
+Requires-Dist: anthropic<2,>=1.8; extra == 'ai'
+Requires-Dist: google-genai<3,>=2.25; extra == 'ai'
+Requires-Dist: openai<4,>=3.19; extra == 'ai'
+Provides-Extra: claude
+Requires-Dist: anthropic<2,>=1.8; extra == 'claude'
+Provides-Extra: gemini
+Requires-Dist: google-genai<3,>=2.25; extra == 'gemini'
+Provides-Extra: mcp
+Requires-Dist: anyio<5,>=4.11; extra == 'mcp'
+Requires-Dist: mcp<3,>=2.2; extra == 'mcp'
+Provides-Extra: openai
+Requires-Dist: openai<4,>=3.19; extra == 'openai'
+Provides-Extra: openrouter
+Requires-Dist: openai<4,>=3.19; extra == 'openrouter'
+Description-Content-Type: text/markdown
+
+# u-transcript max
+
+YouTube transcripts, AI translation and downloads for Python — with zero dependencies.
+
+> **Alpha.** The first full release (0.1.0) is being finished. The design lives in
+> [docs/design](https://github.com/U-C4N/U-transkript/tree/main/docs/design).
+
+```bash
+pip install --pre u-transcript-max          # the library, no dependencies
+pip install --pre "u-transcript-max[mcp]"   # plus the MCP server, utmax-mcp
+```
+
+```python
+import utmax
+
+transcript = utmax.fetch("https://youtu.be/dQw4w9WgXcQ")
+transcript.save("rick.srt")
+```
+
+Add the MCP server to Claude Code (needs [uv](https://docs.astral.sh/uv/)):
+
+```bash
+claude mcp add --scope user utmax -- uvx --prerelease allow --from "u-transcript-max[mcp]" utmax-mcp
+```
+
+## License
+
+MIT

u_transcript_max-0.1.0a1/README.md

@@ -0,0 +1,28 @@
+# u-transcript max
+
+YouTube transcripts, AI translation and downloads for Python — with zero dependencies.
+
+> **Alpha.** The first full release (0.1.0) is being finished. The design lives in
+> [docs/design](https://github.com/U-C4N/U-transkript/tree/main/docs/design).
+
+```bash
+pip install --pre u-transcript-max          # the library, no dependencies
+pip install --pre "u-transcript-max[mcp]"   # plus the MCP server, utmax-mcp
+```
+
+```python
+import utmax
+
+transcript = utmax.fetch("https://youtu.be/dQw4w9WgXcQ")
+transcript.save("rick.srt")
+```
+
+Add the MCP server to Claude Code (needs [uv](https://docs.astral.sh/uv/)):
+
+```bash
+claude mcp add --scope user utmax -- uvx --prerelease allow --from "u-transcript-max[mcp]" utmax-mcp
+```
+
+## License
+
+MIT

u_transcript_max-0.1.0a1/pyproject.toml

@@ -0,0 +1,115 @@
+[build-system]
+requires = ["hatchling>=1.32"]
+build-backend = "hatchling.build"
+
+[project]
+name = "u-transcript-max"
+dynamic = ["version"]
+description = "YouTube transcripts, AI translation and downloads for Python, with zero dependencies."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [{ name = "U-C4N" }]
+keywords = ["youtube", "transcript", "subtitles", "captions", "srt", "vtt", "translation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Text Processing :: Linguistic",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+claude = ["anthropic>=1.8,<2"]
+openai = ["openai>=3.19,<4"]
+gemini = ["google-genai>=2.25,<3"]
+openrouter = ["openai>=3.19,<4"]
+ai = ["anthropic>=1.8,<2", "google-genai>=2.25,<3", "openai>=3.19,<4"]
+mcp = ["mcp>=2.2,<3", "anyio>=4.11,<5"]
+
+[project.scripts]
+utmax-mcp = "utmax.mcp:main"
+
+[project.urls]
+Homepage = "https://github.com/U-C4N/U-transkript"
+Issues = "https://github.com/U-C4N/U-transkript/issues"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.3",
+    "pytest>=9.1",
+    "pytest-cov>=7.1",
+    "ruff>=0.16",
+]
+
+[tool.hatch.version]
+path = "src/utmax/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/utmax"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/tests", "/README.md", "/LICENSE"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+extend-exclude = ["docs"]
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "UP", "B", "C4", "SIM", "PIE", "PERF", "RET", "PT", "N", "PL", "RUF", "TID"]
+ignore = [
+    "E501",    # the formatter owns line length; long literals are acceptable
+    "N818",    # error names mirror youtube-transcript-api (VideoUnavailable, ...)
+    "PLC0415", # models import core inside methods to avoid import cycles
+    "PLR0911", # table-like functions return early by design
+    "PLR0912",
+    "PLR0913", # the public API takes many keyword-only options
+    "PLR2004", # protocol constants and test values
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["RUF001", "RUF003"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["utmax"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.mypy]
+strict = true
+python_version = "3.11"
+files = ["src"]
+warn_unreachable = true
+
+[tool.pytest.ini_options]
+minversion = "9.0"
+testpaths = ["tests"]
+addopts = ["-ra", "--strict-markers", "--strict-config", "-m", "not live"]
+markers = ["live: talks to the real YouTube API; run with `uv run pytest -m live`", "ffmpeg: needs ffmpeg and ffprobe on PATH; run with `uv run pytest -m ffmpeg`"]
+xfail_strict = true
+filterwarnings = ["error"]
+
+[tool.coverage.run]
+branch = true
+source = ["utmax"]
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+skip_covered = true
+exclude_also = [
+    "if TYPE_CHECKING:",
+    "@overload",
+    "raise NotImplementedError",
+    "^\\s*\\.\\.\\.\\s*$",
+]