human-input-kit 0.2.1__py3-none-any.whl

human_input_kit-0.2.1.dist-info/RECORD

@@ -0,0 +1,23 @@
+human_input_kit/__init__.py,sha256=6YYhz4aOAoFe-sL-ccatlmOFUhpo5MS-LiUd-Gc-S9Q,690
+human_input_kit/async_.py,sha256=CwMk9EFPdhsi9qDOWLC0e8eosWAAqY23NVIOZA2zAlg,535
+human_input_kit/bezier.py,sha256=BiVrfFW8AGoE71JPHB1ha4SH2FOb0hrMyQHDLAXgA1M,1916
+human_input_kit/cli.py,sha256=-tqvlsfqZn0gvqD56kt1udRj_tA9JhDpTwWLimSFbG8,4040
+human_input_kit/deal.py,sha256=zq3igfmg6sDQmyS9jlB-i0PHdHPgeKAWhMqtZiyUJU0,809
+human_input_kit/gesture_schema.py,sha256=w47T9TMgfZoSm8xz4m55j6VUTc62B_OXZOXOdHYevyk,3402
+human_input_kit/gestures.py,sha256=GvD5yIyRtevYfKNTCIrI8dVzqLn5UEAdjdO51VOWW5w,2723
+human_input_kit/idle.py,sha256=w8yhcytqfAYLXqNn2rda8ixHzVVgXaR72mfcB5sM_jA,1215
+human_input_kit/keyboard.py,sha256=NwtDuSWOsGNBsqSV3oASMLcNNXvd7cj7sJM4hjl_b6o,789
+human_input_kit/record.py,sha256=5SiErR3SrIFB_SqhllCpn4SS4hjjstAhf7x4tKVP1_k,2842
+human_input_kit/replay.py,sha256=_3sjbSoQAGAMFSFSZq2wdMI5KqufiPodfD47Plm0f9Y,1950
+human_input_kit/rng.py,sha256=KRjPggSMyhe8RyJpVdR9VN2x57F8PzBdkjMgVTh2Td0,328
+human_input_kit/scroll.py,sha256=hvVBhyZTIHkPIdD4Vj9cJ7aPF_vbParkfiI_Cyren6U,678
+human_input_kit/sync_.py,sha256=WlW7ODczOXq1uGSCzPIsDaWmk88Jj-bEgqzhuujV-7o,4268
+examples/demo_warmup.py,sha256=MChB32hU0_ydDlQpVDVg1obZ1zs_JxjDAju5nQhOuw4,1750
+examples/mlx_warmup_demo.py,sha256=NQfQcuzZJhZ02KIVNLzx6ZCsf5wwgyczKD1WrDMRV3M,6740
+recipes/scroll_news.py,sha256=Q59XZ22e525NWThiZpro-ALvYaRI3jbsJcRqMcrkuhg,2287
+recipes/youtube_idle.py,sha256=YcA1YCg_UlsP4EC6B9EQEXKpTgoreqrhpzSbkZlIrI8,2345
+human_input_kit-0.2.1.dist-info/METADATA,sha256=sKHrcUMCqcI5mE1G2mUxQv8Zt4La-1efYxO43OEgPDk,11575
+human_input_kit-0.2.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+human_input_kit-0.2.1.dist-info/entry_points.txt,sha256=rZbVuriIoBQTzyoM08eiLPkL5S0uMxDWiiy_NYd9dDU,57
+human_input_kit-0.2.1.dist-info/licenses/LICENSE,sha256=m0P4i4pkm_Gu-65pQgOrWMo8VX6-HCZqnUL4Ywc7oGI,1085
+human_input_kit-0.2.1.dist-info/RECORD,,

human_input_kit-0.2.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

human_input_kit-0.2.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+human-input = human_input_kit.cli:main

human_input_kit-0.2.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 human-input-kit contributors
+
+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.

recipes/scroll_news.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+"""Scroll a news feed with human-like cadence.
+
+Run from the package root::
+
+    python recipes/scroll_news.py --seed 42
+    python recipes/scroll_news.py --seed 42 --url https://news.ycombinator.com --bursts 8 --headed
+
+Same motion repeats for a given ``--seed`` (uses ``human_input_kit.seed_rng``).
+"""
+
+from __future__ import annotations
+
+import argparse
+import asyncio
+
+from playwright.async_api import async_playwright
+
+from human_input_kit import seed_rng
+from human_input_kit.async_ import bezier_mouse_path, idle_jitter, move_mouse_along, random_scroll
+
+DEFAULT_URL = "https://news.ycombinator.com"
+
+
+async def scroll_news(*, url: str, seed: int, headless: bool, bursts: int) -> None:
+    seed_rng(seed)
+    async with async_playwright() as playwright:
+        browser = await playwright.chromium.launch(headless=headless)
+        page = await browser.new_page(viewport={"width": 1280, "height": 900})
+        await page.goto(url, wait_until="domcontentloaded", timeout=60_000)
+
+        # Drift into the feed before scrolling
+        path = bezier_mouse_path((120, 160), (640, 420), steps=22)
+        await move_mouse_along(page, path)
+        await random_scroll(page, bursts=bursts, min_delta=180, max_delta=480)
+        await idle_jitter(page, moves=4, radius=14)
+
+        # Second pass — slower tail read
+        await random_scroll(page, bursts=max(2, bursts // 2), min_delta=90, max_delta=260)
+        title = await page.title()
+        print(f"scroll_news done (seed={seed}, bursts={bursts}): {title}")
+        await browser.close()
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Human-like news feed scroll recipe")
+    parser.add_argument("--url", default=DEFAULT_URL, help="News page to open")
+    parser.add_argument("--seed", type=int, default=42, help="RNG seed for reproducible motion")
+    parser.add_argument("--bursts", type=int, default=6, help="Scroll wheel bursts per pass")
+    parser.add_argument("--headed", action="store_true", help="Show browser window")
+    args = parser.parse_args()
+    asyncio.run(
+        scroll_news(
+            url=args.url,
+            seed=args.seed,
+            headless=not args.headed,
+            bursts=args.bursts,
+        )
+    )
+
+
+if __name__ == "__main__":
+    main()

recipes/youtube_idle.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""Idle on a YouTube watch surface — micro-moves and occasional scroll.
+
+Run from the package root::
+
+    python recipes/youtube_idle.py --seed 42
+    python recipes/youtube_idle.py --seed 7 --seconds 30 --headed
+
+Use ``--headed`` for fewer consent / bot interstitials on youtube.com.
+Motion is deterministic per ``--seed``.
+"""
+
+from __future__ import annotations
+
+import argparse
+import asyncio
+
+from playwright.async_api import async_playwright
+
+from human_input_kit import seed_rng
+from human_input_kit.async_ import idle_jitter, random_scroll
+from human_input_kit.rng import get_rng
+
+DEFAULT_URL = "https://www.youtube.com"
+
+
+async def youtube_idle(*, url: str, seed: int, headless: bool, seconds: float) -> None:
+    seed_rng(seed)
+    rng = get_rng()
+    async with async_playwright() as playwright:
+        browser = await playwright.chromium.launch(headless=headless)
+        page = await browser.new_page(viewport={"width": 1280, "height": 720})
+        await page.goto(url, wait_until="domcontentloaded", timeout=60_000)
+
+        elapsed = 0.0
+        cycles = 0
+        while elapsed < seconds:
+            await idle_jitter(page, moves=rng.randint(3, 6), radius=12)
+            if rng.random() < 0.35:
+                await random_scroll(page, bursts=1, min_delta=60, max_delta=140)
+            pause = rng.uniform(2.0, 5.5)
+            await asyncio.sleep(pause)
+            elapsed += pause
+            cycles += 1
+
+        title = await page.title()
+        print(f"youtube_idle done (seed={seed}, {cycles} cycles, {elapsed:.1f}s): {title}")
+        await browser.close()
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="YouTube-style idle watch recipe")
+    parser.add_argument("--url", default=DEFAULT_URL, help="YouTube URL (home or watch page)")
+    parser.add_argument("--seed", type=int, default=42, help="RNG seed for reproducible motion")
+    parser.add_argument("--seconds", type=float, default=20.0, help="Approximate idle duration")
+    parser.add_argument("--headed", action="store_true", help="Show browser window")
+    args = parser.parse_args()
+    asyncio.run(
+        youtube_idle(
+            url=args.url,
+            seed=args.seed,
+            headless=not args.headed,
+            seconds=args.seconds,
+        )
+    )
+
+
+if __name__ == "__main__":
+    main()