paces 0.0.3__tar.gz → 0.0.5__tar.gz

paces-0.0.3/README.md → paces-0.0.5/PKG-INFO

@@ -1,3 +1,37 @@
+Metadata-Version: 2.5
+Name: paces
+Version: 0.0.5
+Summary: Turn instructional media into structured, interactive learning material
+Project-URL: Homepage, https://github.com/thorwhalen/paces
+Project-URL: Repository, https://github.com/thorwhalen/paces
+Project-URL: Documentation, https://thorwhalen.github.io/paces
+Author: Thor Whalen
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dance,instructional-video,learning-material,practice,segmentation,steps,tutorial
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.6
+Provides-Extra: audio
+Requires-Dist: audioop-lts; (python_version >= '3.13') and extra == 'audio'
+Requires-Dist: mixing[audio,beats]>=0.0.36; extra == 'audio'
+Requires-Dist: numba>=0.59; extra == 'audio'
+Provides-Extra: cli
+Requires-Dist: argcomplete>=3; extra == 'cli'
+Requires-Dist: argh>=0.30; extra == 'cli'
+Provides-Extra: dev
+Requires-Dist: argh>=0.30; extra == 'dev'
+Requires-Dist: mixing[audio,beats]>=0.0.39; extra == 'dev'
+Requires-Dist: numba>=0.59; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == 'docs'
+Requires-Dist: sphinx>=6.0; extra == 'docs'
+Provides-Extra: media
+Requires-Dist: mixing>=0.0.39; extra == 'media'
+Description-Content-Type: text/markdown
+
 # paces
 
 Turn instructional media into structured, interactive learning material.
@@ -47,9 +81,17 @@ Same thing from the shell:
 ```bash
 paces segment VIDEO_URL --steps steps.json --grid grid.json --output seg.json
 paces to-document seg.json --source VIDEO_URL --title "My routine" --output document.json
+paces derive document.json --media routine.mp4   # real loop clips + gifs + posters
 paces render document.json --output page.html
 ```
 
+`derive` (`pip install paces[media]`) cuts a loopable mp4, a palette-quality
+gif and a poster for every excerpt-bearing span, writes them to `media/` next
+to the document, and the practice page embeds them as looping clips. Crop
+recipes persist in a hand-overridable `document.recipes.json` sidecar; the
+`subject_locator=` seam (default: no crop) is where pose-based auto-crop
+plugs in. Design record: `docs/adr/0005-media-derivation.md`.
+
 ## How it thinks
 
 **Analysis and rendering are separate phases** with a serialisable document
@@ -75,7 +117,11 @@ content (`OpenQuestion`), and human edits are protected from regeneration
 |---|---|
 | cut media into steps | `segment(media, steps=..., grid=...)` → `Segmentation` |
 | explicit/human boundaries | `segment(media, boundaries=[...], steps=[names])` |
+| use the video's own chapters | `segment(media, metadata=<yt-dlp info.json>)` |
+| measure the grid from the media | `segment(local_media, steps=[(name, counts), ...])` — no grid needed; tempo + structure measured, origin estimated and flagged (`pip install paces[audio]`) |
+| protect edits from regeneration | `apply_edits(doc, patches, by="user:you")` + `merge_regenerated(committed, fresh)` |
 | the committed artifact | `to_document(seg, ...)` → `StepDocument` |
+| real clips/gifs/posters for the page | `derive_document(doc, media=..., doc_path=...)` / `paces derive` (`pip install paces[media]`) |
 | a practice page | `render_html(doc)` |
 | wall-clock times from counts | `resolve(doc)` |
 | sanity checks | `validate_document(doc)` |

paces-0.0.3/PKG-INFO → paces-0.0.5/README.md

@@ -1,29 +1,3 @@
-Metadata-Version: 2.5
-Name: paces
-Version: 0.0.3
-Summary: Turn instructional media into structured, interactive learning material
-Project-URL: Homepage, https://github.com/thorwhalen/paces
-Project-URL: Repository, https://github.com/thorwhalen/paces
-Project-URL: Documentation, https://thorwhalen.github.io/paces
-Author: Thor Whalen
-License-Expression: MIT
-License-File: LICENSE
-Keywords: dance,instructional-video,learning-material,practice,segmentation,steps,tutorial
-Requires-Python: >=3.10
-Requires-Dist: pydantic>=2.6
-Provides-Extra: cli
-Requires-Dist: argcomplete>=3; extra == 'cli'
-Requires-Dist: argh>=0.30; extra == 'cli'
-Provides-Extra: dev
-Requires-Dist: argh>=0.30; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
-Provides-Extra: docs
-Requires-Dist: sphinx-rtd-theme>=1.0; extra == 'docs'
-Requires-Dist: sphinx>=6.0; extra == 'docs'
-Description-Content-Type: text/markdown
-
 # paces
 
 Turn instructional media into structured, interactive learning material.
@@ -73,9 +47,17 @@ Same thing from the shell:
 ```bash
 paces segment VIDEO_URL --steps steps.json --grid grid.json --output seg.json
 paces to-document seg.json --source VIDEO_URL --title "My routine" --output document.json
+paces derive document.json --media routine.mp4   # real loop clips + gifs + posters
 paces render document.json --output page.html
 ```
 
+`derive` (`pip install paces[media]`) cuts a loopable mp4, a palette-quality
+gif and a poster for every excerpt-bearing span, writes them to `media/` next
+to the document, and the practice page embeds them as looping clips. Crop
+recipes persist in a hand-overridable `document.recipes.json` sidecar; the
+`subject_locator=` seam (default: no crop) is where pose-based auto-crop
+plugs in. Design record: `docs/adr/0005-media-derivation.md`.
+
 ## How it thinks
 
 **Analysis and rendering are separate phases** with a serialisable document
@@ -101,7 +83,11 @@ content (`OpenQuestion`), and human edits are protected from regeneration
 |---|---|
 | cut media into steps | `segment(media, steps=..., grid=...)` → `Segmentation` |
 | explicit/human boundaries | `segment(media, boundaries=[...], steps=[names])` |
+| use the video's own chapters | `segment(media, metadata=<yt-dlp info.json>)` |
+| measure the grid from the media | `segment(local_media, steps=[(name, counts), ...])` — no grid needed; tempo + structure measured, origin estimated and flagged (`pip install paces[audio]`) |
+| protect edits from regeneration | `apply_edits(doc, patches, by="user:you")` + `merge_regenerated(committed, fresh)` |
 | the committed artifact | `to_document(seg, ...)` → `StepDocument` |
+| real clips/gifs/posters for the page | `derive_document(doc, media=..., doc_path=...)` / `paces derive` (`pip install paces[media]`) |
 | a practice page | `render_html(doc)` |
 | wall-clock times from counts | `resolve(doc)` |
 | sanity checks | `validate_document(doc)` |

{paces-0.0.3 → paces-0.0.5}/paces/__init__.py

@@ -48,7 +48,18 @@ from paces.model import (
     seconds_per_unit,
     validate_document,
 )
+from paces.derivation import (
+    DeriveResult,
+    DirStore,
+    LocateQuery,
+    SubjectObservation,
+    check_media_requirements,
+    derive_document,
+    full_frame,
+    resolve_crop_box,
+)
 from paces.edits import apply_edits, merge_regenerated
+from paces.measure import GridMeasurement, measure_grid
 from paces.projection import to_document
 from paces.render import render_html
 from paces.segmenters import (
@@ -87,7 +98,18 @@ __all__ = [
     "Capability",
     "register",
     "capabilities",
+    "measure_grid",
+    "GridMeasurement",
     "to_document",
+    # media derivation (issue #1, ADR-0005)
+    "derive_document",
+    "DeriveResult",
+    "DirStore",
+    "LocateQuery",
+    "SubjectObservation",
+    "full_frame",
+    "resolve_crop_box",
+    "check_media_requirements",
     # editing & regeneration
     "apply_edits",
     "merge_regenerated",