paces 0.0.4__tar.gz → 0.0.6__tar.gz

{paces-0.0.4 → paces-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: paces
-Version: 0.0.4
+Version: 0.0.6
 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
@@ -20,7 +20,7 @@ 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.36; 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'
@@ -28,6 +28,8 @@ 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
@@ -79,9 +81,18 @@ 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 suggest-excerpts document.json --output document.json   # mark each block's loop window
+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
@@ -111,6 +122,7 @@ content (`OpenQuestion`), and human edits are protected from regeneration
 | 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.4 → paces-0.0.6}/README.md

@@ -47,9 +47,18 @@ 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 suggest-excerpts document.json --output document.json   # mark each block's loop window
+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
@@ -79,6 +88,7 @@ content (`OpenQuestion`), and human edits are protected from regeneration
 | 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.4 → paces-0.0.6}/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.excerpts import ExcerptResult, suggest_excerpts
 from paces.measure import GridMeasurement, measure_grid
 from paces.projection import to_document
 from paces.render import render_html
@@ -91,6 +102,17 @@ __all__ = [
     "measure_grid",
     "GridMeasurement",
     "to_document",
+    # media derivation (issue #1, ADR-0005)
+    "suggest_excerpts",
+    "ExcerptResult",
+    "derive_document",
+    "DeriveResult",
+    "DirStore",
+    "LocateQuery",
+    "SubjectObservation",
+    "full_frame",
+    "resolve_crop_box",
+    "check_media_requirements",
     # editing & regeneration
     "apply_edits",
     "merge_regenerated",