Skip to main content

reel-driven-development

Reel Driven Development (RDD) - turn recorded user walks (reels) into domain stories and outcome objects

PyPi PyPI Status License pypi format downloads
GitHub Github Actions Build Release Contributors Last Commit GitHub issues GitHub closed issues
Code style-black imports-isort
Docs API Docs formatter-docformatter style-google

Documentation

Wiki

Authors

Reel Driven Development

A reel is a recorded user walk - e.g. a screen-share demo where a domain expert walks through a system while talking. RDD treats the reel as a graph walk:

  • every context switch (page, browser tab, application) and every relevant interaction (submenu, filter, zoom, sort) is a hop
  • the narrative drives the sampling, never the clock
  • every hop gets an evidence frame (screenshot) or a proven-absent note
  • findings become outcome objects: a frustration spoken during a walk becomes a bug report, which is an acceptance criterion, which is an example

The first tooling milestone is HopDetection - see issue #1.

Example: GenWiki walk

Acceptance run on the test video segment 20:00-21:00 - a walk through wiki.genealogy.net category pages:

hopdetect ~/.rdd/cache/gVxk-zRb0wQ.mp4 --start 20:00 --end 21:00 --out hops
12 hops from 786 sampled frames -> hops/hops.json

Raw results in examples/genwiki-walk. Of the 12 detected hops, 9 are distinct content states of the walk (hop numbers kept as in hops.json):

hop time changes grouped content frame
hop01 20:02 32 Kategorie:PDF
hop02 20:06 11 Kategorie:PDF, media section
hop03 20:10 24 file page with PDF viewer (Todfall-Rodel Kloster Salem)
hop04 20:20 94 presentation slide with category links
hop05 20:28 57 Kategorie:Icons, media section
hop06 20:34 40 Kategorie:Icons
hop07 20:37 2 Kategorie:Portal icons
hop10 20:47 2 presentation slide revisited
hop12 20:59 73 Kategorie:SVG, flags gallery

False positives

Three detections are not content states of the walk - kept in the example as tool findings:

hop time reason
hop08 20:41 cursor-motion burst on the unchanged Kategorie:Portal icons page
hop09 20:45 transient browser tab-hover preview overlay, page unchanged
hop11 20:50 blank frame: Kategorie:SVG captured before rendering; the settled state is hop12

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

reel_driven_development-0.0.1.tar.gz (736.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

reel_driven_development-0.0.1-py3-none-any.whl (16.3 kB view details)

Uploaded Python 3

File details

Details for the file reel_driven_development-0.0.1.tar.gz.

File metadata

  • Download URL: reel_driven_development-0.0.1.tar.gz
  • Upload date:
  • Size: 736.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for reel_driven_development-0.0.1.tar.gz
Algorithm Hash digest
SHA256 a0c471f46e918ff938a4758dd5c1b46ec7a7ce2cd0d1e15370ea2bbeccca384e
MD5 3574389383e3c98d2ee99f441a0fbb12
BLAKE2b-256 05a87200ab0869ab6fc7a51ccf0e02132001b5099e47b6d1fb9055a46a052566

See more details on using hashes here.

Provenance

The following attestation bundles were made for reel_driven_development-0.0.1.tar.gz:

Publisher: upload-to-pypi.yml on WolfgangFahl/reel-driven-development

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reel_driven_development-0.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for reel_driven_development-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e87e45adf225efe90ee339d66cdd69e326539018dfd96d52865e2e8bfb9e9fbe
MD5 9246d8ca759e313608d30376f73ad9aa
BLAKE2b-256 e223e3dd8b1a7d34d69318be39045a698867530961f65782938a278b11f63385

See more details on using hashes here.

Provenance

The following attestation bundles were made for reel_driven_development-0.0.1-py3-none-any.whl:

Publisher: upload-to-pypi.yml on WolfgangFahl/reel-driven-development

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page