cuju-render 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- cuju/render/__init__.py +759 -0
- cuju/render/__main__.py +1065 -0
- cuju/render/_export/__init__.py +3 -0
- cuju/render/_export/feed.py +542 -0
- cuju/render/_export/sizes.py +157 -0
- cuju/render/_export/video.py +1618 -0
- cuju/render/_export/video_jobs.py +408 -0
- cuju/render/_format/__init__.py +3 -0
- cuju/render/_format/annotations.py +235 -0
- cuju/render/_format/codec.py +307 -0
- cuju/render/_format/keep.py +121 -0
- cuju/render/_format/recording.py +860 -0
- cuju/render/_format/writer.py +54 -0
- cuju/render/_guide/__init__.py +3 -0
- cuju/render/_guide/doctor.py +523 -0
- cuju/render/_guide/help.py +62 -0
- cuju/render/_guide/tutorial.py +254 -0
- cuju/render/_http/__init__.py +3 -0
- cuju/render/_http/commands.py +57 -0
- cuju/render/_http/headers.py +103 -0
- cuju/render/_http/launch.py +500 -0
- cuju/render/_http/launchers.py +408 -0
- cuju/render/_http/pwa.py +128 -0
- cuju/render/_http/server.py +2105 -0
- cuju/render/_http/window.py +360 -0
- cuju/render/_moments/__init__.py +3 -0
- cuju/render/_moments/captions.py +284 -0
- cuju/render/_moments/events.py +1123 -0
- cuju/render/_moments/search.py +694 -0
- cuju/render/_packages/__init__.py +3 -0
- cuju/render/_packages/glsl.py +746 -0
- cuju/render/_packages/loudness.py +334 -0
- cuju/render/_packages/pack.py +1959 -0
- cuju/render/_packages/presentation.py +1376 -0
- cuju/render/_packages/vocabulary.py +609 -0
- cuju/render/_playing/__init__.py +3 -0
- cuju/render/_playing/achievements.py +463 -0
- cuju/render/_playing/bench.py +609 -0
- cuju/render/_playing/challenges.py +1813 -0
- cuju/render/_playing/demo.py +323 -0
- cuju/render/_playing/draw.py +211 -0
- cuju/render/_playing/errors.py +20 -0
- cuju/render/_playing/game.py +645 -0
- cuju/render/_playing/limits.py +339 -0
- cuju/render/_playing/play.py +926 -0
- cuju/render/_playing/policy_worker.py +250 -0
- cuju/render/_playing/strict.py +810 -0
- cuju/render/_registry/__init__.py +3 -0
- cuju/render/_registry/clips.py +394 -0
- cuju/render/_registry/joints.py +108 -0
- cuju/render/_registry/teams.py +2058 -0
- cuju/render/_store/__init__.py +3 -0
- cuju/render/_store/home.py +70 -0
- cuju/render/_store/library.py +604 -0
- cuju/render/_store/samples.py +163 -0
- cuju/render/_text/__init__.py +3 -0
- cuju/render/_text/languages.py +637 -0
- cuju/render/_text/messages.py +1396 -0
- cuju/render/_tournaments/__init__.py +3 -0
- cuju/render/_tournaments/results.py +547 -0
- cuju/render/_tournaments/tournament.py +2742 -0
- cuju/render/_tournaments/tournament_cli.py +587 -0
- cuju/render/_tournaments/tournament_runner.py +1975 -0
- cuju/render/_version.py +6 -0
- cuju/render/_watch/__init__.py +3 -0
- cuju/render/_watch/grid.py +265 -0
- cuju/render/_watch/live.py +664 -0
- cuju/render/_watch/notebook.py +79 -0
- cuju/render/_watch/show.py +171 -0
- cuju/render/samples/sample-11v11.cjr +0 -0
- cuju/render/samples/sample-5v5.cjr +0 -0
- cuju/render/samples/teams/starter/main.py +33 -0
- cuju/render/scenarios/benchmark_full_game_11_vs_11_easy.py +46 -0
- cuju/render/scenarios/benchmark_full_game_11_vs_11_hard.py +46 -0
- cuju/render/scenarios/benchmark_full_game_11_vs_11_medium.py +46 -0
- cuju/render/scenarios/benchmark_full_game_5_vs_5_easy.py +34 -0
- cuju/render/scenarios/benchmark_full_game_5_vs_5_hard.py +34 -0
- cuju/render/scenarios/benchmark_full_game_5_vs_5_medium.py +34 -0
- cuju/render/web/assets/adboard_polygon.webp +0 -0
- cuju/render/web/assets/adboard_your_ad_here.webp +0 -0
- cuju/render/web/assets/animations/kaykit-rig-medium-combatmelee.glb +0 -0
- cuju/render/web/assets/animations/kaykit-rig-medium-general.glb +0 -0
- cuju/render/web/assets/animations/kaykit-rig-medium-movementadvanced.glb +0 -0
- cuju/render/web/assets/animations/kaykit-rig-medium-movementbasic.glb +0 -0
- cuju/render/web/assets/animations/kaykit-rig-medium-simulation.glb +0 -0
- cuju/render/web/assets/animations/kaykit-rig-medium-special.glb +0 -0
- cuju/render/web/assets/ball.glb +0 -0
- cuju/render/web/assets/challenges/3_vs_1_with_keeper.mp4 +0 -0
- cuju/render/web/assets/challenges/3_vs_1_with_keeper.webp +0 -0
- cuju/render/web/assets/challenges/corner.mp4 +0 -0
- cuju/render/web/assets/challenges/corner.webp +0 -0
- cuju/render/web/assets/challenges/counterattack_easy.mp4 +0 -0
- cuju/render/web/assets/challenges/counterattack_easy.webp +0 -0
- cuju/render/web/assets/challenges/counterattack_hard.mp4 +0 -0
- cuju/render/web/assets/challenges/counterattack_hard.webp +0 -0
- cuju/render/web/assets/challenges/empty_goal.mp4 +0 -0
- cuju/render/web/assets/challenges/empty_goal.webp +0 -0
- cuju/render/web/assets/challenges/empty_goal_close.mp4 +0 -0
- cuju/render/web/assets/challenges/empty_goal_close.webp +0 -0
- cuju/render/web/assets/challenges/manifest.json +375 -0
- cuju/render/web/assets/challenges/one_on_one.mp4 +0 -0
- cuju/render/web/assets/challenges/one_on_one.webp +0 -0
- cuju/render/web/assets/challenges/one_on_one_hard.mp4 +0 -0
- cuju/render/web/assets/challenges/one_on_one_hard.webp +0 -0
- cuju/render/web/assets/challenges/pass_and_shoot_with_keeper.mp4 +0 -0
- cuju/render/web/assets/challenges/pass_and_shoot_with_keeper.webp +0 -0
- cuju/render/web/assets/challenges/run_pass_and_shoot_with_keeper.mp4 +0 -0
- cuju/render/web/assets/challenges/run_pass_and_shoot_with_keeper.webp +0 -0
- cuju/render/web/assets/challenges/run_to_score.mp4 +0 -0
- cuju/render/web/assets/challenges/run_to_score.webp +0 -0
- cuju/render/web/assets/challenges/run_to_score_with_keeper.mp4 +0 -0
- cuju/render/web/assets/challenges/run_to_score_with_keeper.webp +0 -0
- cuju/render/web/assets/challenges/single_goal_versus_lazy.mp4 +0 -0
- cuju/render/web/assets/challenges/single_goal_versus_lazy.webp +0 -0
- cuju/render/web/assets/crowd.webp +0 -0
- cuju/render/web/assets/crowd_normal.webp +0 -0
- cuju/render/web/assets/cuju-logo-384.png +0 -0
- cuju/render/web/assets/cuju-logo.png +0 -0
- cuju/render/web/assets/cuju-logo.svg +46 -0
- cuju/render/web/assets/cuju-mark-light.svg +33 -0
- cuju/render/web/assets/cuju-mark.svg +33 -0
- cuju/render/web/assets/goal.glb +0 -0
- cuju/render/web/assets/grass.webp +0 -0
- cuju/render/web/assets/hair_black.png +0 -0
- cuju/render/web/assets/hair_blonde.png +0 -0
- cuju/render/web/assets/hair_brown.png +0 -0
- cuju/render/web/assets/hair_darkblonde.png +0 -0
- cuju/render/web/assets/hair_long01.glb +0 -0
- cuju/render/web/assets/hair_long02.glb +0 -0
- cuju/render/web/assets/hair_medium01.glb +0 -0
- cuju/render/web/assets/hair_red.png +0 -0
- cuju/render/web/assets/hair_short01.glb +0 -0
- cuju/render/web/assets/hair_short02.glb +0 -0
- cuju/render/web/assets/icons/cuju-192.png +0 -0
- cuju/render/web/assets/icons/cuju-512.png +0 -0
- cuju/render/web/assets/icons/cuju-maskable-512.png +0 -0
- cuju/render/web/assets/kit_goalkeeper.webp +0 -0
- cuju/render/web/assets/kit_mask.png +0 -0
- cuju/render/web/assets/kit_normal.webp +0 -0
- cuju/render/web/assets/manifest.json +601 -0
- cuju/render/web/assets/models/kaykit-barbarian.glb +0 -0
- cuju/render/web/assets/models/kaykit-barbarian.json +23 -0
- cuju/render/web/assets/models/kaykit-knight.glb +0 -0
- cuju/render/web/assets/models/kaykit-knight.json +23 -0
- cuju/render/web/assets/models/kaykit-mage.glb +0 -0
- cuju/render/web/assets/models/kaykit-mage.json +23 -0
- cuju/render/web/assets/models/kaykit-mannequin-medium.glb +0 -0
- cuju/render/web/assets/models/kaykit-mannequin-medium.json +23 -0
- cuju/render/web/assets/models/kaykit-ranger.glb +0 -0
- cuju/render/web/assets/models/kaykit-ranger.json +23 -0
- cuju/render/web/assets/models/kaykit-rogue-hooded.glb +0 -0
- cuju/render/web/assets/models/kaykit-rogue-hooded.json +23 -0
- cuju/render/web/assets/models/kaykit-rogue.glb +0 -0
- cuju/render/web/assets/models/kaykit-rogue.json +23 -0
- cuju/render/web/assets/models/kaykit-skeleton-mage.glb +0 -0
- cuju/render/web/assets/models/kaykit-skeleton-mage.json +23 -0
- cuju/render/web/assets/models/kaykit-skeleton-minion.glb +0 -0
- cuju/render/web/assets/models/kaykit-skeleton-minion.json +23 -0
- cuju/render/web/assets/models/kaykit-skeleton-rogue.glb +0 -0
- cuju/render/web/assets/models/kaykit-skeleton-rogue.json +23 -0
- cuju/render/web/assets/models/kaykit-skeleton-warrior.glb +0 -0
- cuju/render/web/assets/models/kaykit-skeleton-warrior.json +23 -0
- cuju/render/web/assets/pitch.webp +0 -0
- cuju/render/web/assets/pitch_normal.webp +0 -0
- cuju/render/web/assets/player.glb +0 -0
- cuju/render/web/assets/shoe.webp +0 -0
- cuju/render/web/assets/shoe_sole.png +0 -0
- cuju/render/web/assets/skin_01.png +0 -0
- cuju/render/web/assets/skin_02.png +0 -0
- cuju/render/web/assets/skin_03.png +0 -0
- cuju/render/web/assets/skin_04.png +0 -0
- cuju/render/web/assets/sounds/applause.ogg +0 -0
- cuju/render/web/assets/sounds/beach-wave-1.ogg +0 -0
- cuju/render/web/assets/sounds/beach-wave-2.ogg +0 -0
- cuju/render/web/assets/sounds/beach-wave-3.ogg +0 -0
- cuju/render/web/assets/sounds/beach-wave-4.ogg +0 -0
- cuju/render/web/assets/sounds/city-horn.ogg +0 -0
- cuju/render/web/assets/sounds/city-loop.ogg +0 -0
- cuju/render/web/assets/sounds/city-siren.ogg +0 -0
- cuju/render/web/assets/sounds/crowd-cheer.ogg +0 -0
- cuju/render/web/assets/sounds/crowd-loop.ogg +0 -0
- cuju/render/web/assets/sounds/crowd-ooh.ogg +0 -0
- cuju/render/web/assets/sounds/gulls.ogg +0 -0
- cuju/render/web/assets/sounds/neon-sting.ogg +0 -0
- cuju/render/web/assets/sounds/rain-loop.ogg +0 -0
- cuju/render/web/assets/sounds/sounds.json +46 -0
- cuju/render/web/assets/sounds/space-beep.ogg +0 -0
- cuju/render/web/assets/sounds/space-hum.ogg +0 -0
- cuju/render/web/assets/sounds/space-radio.ogg +0 -0
- cuju/render/web/assets/sounds/whistle-long.ogg +0 -0
- cuju/render/web/assets/sounds/whistle-short.ogg +0 -0
- cuju/render/web/assets/sounds/wind-loop.ogg +0 -0
- cuju/render/web/easy.css +357 -0
- cuju/render/web/export.html +23 -0
- cuju/render/web/feed.css +262 -0
- cuju/render/web/feed.html +28 -0
- cuju/render/web/flat.css +120 -0
- cuju/render/web/home.css +837 -0
- cuju/render/web/index.html +373 -0
- cuju/render/web/js/boot.js +50 -0
- cuju/render/web/js/broadcast/audio.js +2141 -0
- cuju/render/web/js/broadcast/celebrate.js +1238 -0
- cuju/render/web/js/broadcast/decisions.js +609 -0
- cuju/render/web/js/broadcast/hud.js +352 -0
- cuju/render/web/js/broadcast/show.js +3614 -0
- cuju/render/web/js/broadcast/transition.js +2231 -0
- cuju/render/web/js/broadcast/voices.js +153 -0
- cuju/render/web/js/capture.js +101 -0
- cuju/render/web/js/core/accessibility.js +90 -0
- cuju/render/web/js/core/api.js +429 -0
- cuju/render/web/js/core/comfort.js +135 -0
- cuju/render/web/js/core/i18n.js +705 -0
- cuju/render/web/js/core/icons.js +167 -0
- cuju/render/web/js/core/input-settings.js +156 -0
- cuju/render/web/js/core/keys.js +277 -0
- cuju/render/web/js/core/language-ui.js +125 -0
- cuju/render/web/js/core/menu.js +853 -0
- cuju/render/web/js/core/names.js +113 -0
- cuju/render/web/js/core/page-structure.js +110 -0
- cuju/render/web/js/core/scenarios.js +109 -0
- cuju/render/web/js/core/spoilers.js +236 -0
- cuju/render/web/js/core/typeahead.js +38 -0
- cuju/render/web/js/export/dom-picture.js +330 -0
- cuju/render/web/js/export/export-host.js +97 -0
- cuju/render/web/js/export/feed-dialog.js +191 -0
- cuju/render/web/js/export/feed-params.js +266 -0
- cuju/render/web/js/export/feed.js +363 -0
- cuju/render/web/js/export/mp4-mux.js +295 -0
- cuju/render/web/js/export/photo-core.js +313 -0
- cuju/render/web/js/export/photo.js +1314 -0
- cuju/render/web/js/export/safe-frame.js +59 -0
- cuju/render/web/js/export/size-fields.js +103 -0
- cuju/render/web/js/export/sizes.js +178 -0
- cuju/render/web/js/export/video-boot.js +55 -0
- cuju/render/web/js/export/video-browser.js +325 -0
- cuju/render/web/js/export/video-export.js +417 -0
- cuju/render/web/js/export/video-plan.js +207 -0
- cuju/render/web/js/export/video-range.js +185 -0
- cuju/render/web/js/export/webm-mux.js +198 -0
- cuju/render/web/js/feed-boot.js +151 -0
- cuju/render/web/js/feed-frame.js +101 -0
- cuju/render/web/js/help/doctor.js +488 -0
- cuju/render/web/js/help/firstrun.js +379 -0
- cuju/render/web/js/help/help-center.js +438 -0
- cuju/render/web/js/help/install-offer.js +164 -0
- cuju/render/web/js/help/install-state.js +104 -0
- cuju/render/web/js/help/lessons-core.js +207 -0
- cuju/render/web/js/help/lessons.js +463 -0
- cuju/render/web/js/help/palette.js +584 -0
- cuju/render/web/js/help/pwa.js +257 -0
- cuju/render/web/js/help/tour-core.js +241 -0
- cuju/render/web/js/help/tour.js +461 -0
- cuju/render/web/js/main.js +2513 -0
- cuju/render/web/js/pages/draw.js +188 -0
- cuju/render/web/js/pages/fieldpage.js +530 -0
- cuju/render/web/js/pages/home.js +521 -0
- cuju/render/web/js/pages/matches.js +779 -0
- cuju/render/web/js/pages/moments-ui.js +359 -0
- cuju/render/web/js/pages/queue-filters.js +63 -0
- cuju/render/web/js/pages/recording-groups.js +80 -0
- cuju/render/web/js/pages/recordings.js +1069 -0
- cuju/render/web/js/play/bench.js +347 -0
- cuju/render/web/js/play/challenges.js +1302 -0
- cuju/render/web/js/play/medals.js +127 -0
- cuju/render/web/js/play/play.js +1953 -0
- cuju/render/web/js/play/teasers.js +196 -0
- cuju/render/web/js/play/touch.js +350 -0
- cuju/render/web/js/play/tournament-layout.js +487 -0
- cuju/render/web/js/play/tournament-results.js +441 -0
- cuju/render/web/js/play/tournament-strict.js +560 -0
- cuju/render/web/js/play/tournament.js +2585 -0
- cuju/render/web/js/players/animate.js +972 -0
- cuju/render/web/js/players/clips.js +224 -0
- cuju/render/web/js/players/kaykit.js +162 -0
- cuju/render/web/js/players/kits.js +676 -0
- cuju/render/web/js/players/number-patch.js +82 -0
- cuju/render/web/js/players/players.js +2694 -0
- cuju/render/web/js/players/recolor.js +893 -0
- cuju/render/web/js/players/retarget.js +325 -0
- cuju/render/web/js/players/rig-numbers.js +174 -0
- cuju/render/web/js/presentation/animator.js +231 -0
- cuju/render/web/js/presentation/assign.js +85 -0
- cuju/render/web/js/presentation/behaviors.js +440 -0
- cuju/render/web/js/presentation/budget.js +209 -0
- cuju/render/web/js/presentation/catalog.js +1674 -0
- cuju/render/web/js/presentation/clocks.js +72 -0
- cuju/render/web/js/presentation/commands.js +301 -0
- cuju/render/web/js/presentation/contract.js +240 -0
- cuju/render/web/js/presentation/effects.js +904 -0
- cuju/render/web/js/presentation/flash.js +605 -0
- cuju/render/web/js/presentation/freeze-worklet.js +22 -0
- cuju/render/web/js/presentation/glsl.js +464 -0
- cuju/render/web/js/presentation/host.js +323 -0
- cuju/render/web/js/presentation/index.js +2066 -0
- cuju/render/web/js/presentation/loudness-worklet.js +235 -0
- cuju/render/web/js/presentation/loudness.js +740 -0
- cuju/render/web/js/presentation/moments.js +536 -0
- cuju/render/web/js/presentation/post.js +327 -0
- cuju/render/web/js/presentation/preview.js +180 -0
- cuju/render/web/js/presentation/protocol.js +174 -0
- cuju/render/web/js/presentation/reach.js +158 -0
- cuju/render/web/js/presentation/rigging.js +130 -0
- cuju/render/web/js/presentation/sandbox.js +157 -0
- cuju/render/web/js/presentation/shaders.js +235 -0
- cuju/render/web/js/presentation/stage.js +402 -0
- cuju/render/web/js/presentation/teamaudio.js +722 -0
- cuju/render/web/js/presentation/tracks.js +197 -0
- cuju/render/web/js/presentation/values.js +81 -0
- cuju/render/web/js/recording/annotation-data.js +203 -0
- cuju/render/web/js/recording/captions.js +491 -0
- cuju/render/web/js/recording/codec.js +185 -0
- cuju/render/web/js/recording/decode-worker.js +70 -0
- cuju/render/web/js/recording/decode.js +94 -0
- cuju/render/web/js/recording/episodes.js +46 -0
- cuju/render/web/js/recording/format.js +461 -0
- cuju/render/web/js/recording/live.js +348 -0
- cuju/render/web/js/recording/moments-query.js +59 -0
- cuju/render/web/js/recording/moments.js +149 -0
- cuju/render/web/js/recording/pose.js +86 -0
- cuju/render/web/js/recording/timeline.js +275 -0
- cuju/render/web/js/teams/art.js +50 -0
- cuju/render/web/js/teams/clip-editor.js +293 -0
- cuju/render/web/js/teams/editor.js +1979 -0
- cuju/render/web/js/teams/library.js +344 -0
- cuju/render/web/js/teams/painter.js +633 -0
- cuju/render/web/js/teams/surprise-ui.js +195 -0
- cuju/render/web/js/teams/surprise.js +497 -0
- cuju/render/web/js/teams/team-check.js +127 -0
- cuju/render/web/js/watch/annotations.js +270 -0
- cuju/render/web/js/watch/flat.js +366 -0
- cuju/render/web/js/watch/grid.js +436 -0
- cuju/render/web/js/watch/pitch2d.js +289 -0
- cuju/render/web/js/watch/player-tools.js +192 -0
- cuju/render/web/js/watch/presets.js +201 -0
- cuju/render/web/js/world/arenas.js +997 -0
- cuju/render/web/js/world/ball.js +204 -0
- cuju/render/web/js/world/cameras.js +982 -0
- cuju/render/web/js/world/crowd.js +376 -0
- cuju/render/web/js/world/field.js +227 -0
- cuju/render/web/js/world/framing.js +145 -0
- cuju/render/web/js/world/occlusion.js +48 -0
- cuju/render/web/js/world/pitch.js +703 -0
- cuju/render/web/js/world/scene.js +395 -0
- cuju/render/web/js/world/sky.js +325 -0
- cuju/render/web/js/world/stadium.js +1262 -0
- cuju/render/web/js/world/vendor-sky.js +367 -0
- cuju/render/web/js/world/weather.js +264 -0
- cuju/render/web/languages/en.json +4750 -0
- cuju/render/web/lessons.json +137 -0
- cuju/render/web/manifest.webmanifest +23 -0
- cuju/render/web/style.css +8399 -0
- cuju/render/web/sw.js +235 -0
- cuju/render/web/vendor/fabric/LICENSE +16 -0
- cuju/render/web/vendor/fabric/fabric.min.mjs +1 -0
- cuju/render/web/vendor/lucide/LICENSE +43 -0
- cuju/render/web/vendor/lucide/icons.js +141 -0
- cuju/render/web/vendor/three/LICENSE +21 -0
- cuju/render/web/vendor/three/build/three.core.js +60586 -0
- cuju/render/web/vendor/three/build/three.module.js +19719 -0
- cuju/render/web/vendor/three/examples/jsm/loaders/GLTFLoader.js +4925 -0
- cuju/render/web/vendor/three/examples/jsm/postprocessing/EffectComposer.js +365 -0
- cuju/render/web/vendor/three/examples/jsm/postprocessing/MaskPass.js +195 -0
- cuju/render/web/vendor/three/examples/jsm/postprocessing/OutputPass.js +148 -0
- cuju/render/web/vendor/three/examples/jsm/postprocessing/Pass.js +191 -0
- cuju/render/web/vendor/three/examples/jsm/postprocessing/RenderPass.js +193 -0
- cuju/render/web/vendor/three/examples/jsm/postprocessing/ShaderPass.js +135 -0
- cuju/render/web/vendor/three/examples/jsm/postprocessing/UnrealBloomPass.js +541 -0
- cuju/render/web/vendor/three/examples/jsm/shaders/CopyShader.js +52 -0
- cuju/render/web/vendor/three/examples/jsm/shaders/LuminosityHighPassShader.js +68 -0
- cuju/render/web/vendor/three/examples/jsm/shaders/OutputShader.js +103 -0
- cuju/render/web/vendor/three/examples/jsm/utils/BufferGeometryUtils.js +1501 -0
- cuju/render/web/vendor/three/examples/jsm/utils/SkeletonUtils.js +496 -0
- cuju_render-0.1.0.dist-info/METADATA +116 -0
- cuju_render-0.1.0.dist-info/RECORD +382 -0
- cuju_render-0.1.0.dist-info/WHEEL +4 -0
- cuju_render-0.1.0.dist-info/licenses/LICENSE +202 -0
- cuju_render-0.1.0.dist-info/licenses/LICENSES/CC-BY-4.0.txt +396 -0
- cuju_render-0.1.0.dist-info/licenses/LICENSES/CC0-1.0.txt +127 -0
- cuju_render-0.1.0.dist-info/licenses/LICENSES/ISC.txt +16 -0
- cuju_render-0.1.0.dist-info/licenses/LICENSES/MIT.txt +24 -0
- cuju_render-0.1.0.dist-info/licenses/LICENSES/Unlicense.txt +13 -0
- cuju_render-0.1.0.dist-info/licenses/NOTICE +35 -0
|
@@ -0,0 +1,254 @@
|
|
|
1
|
+
# Copyright 2026 The cuju Authors
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
|
|
4
|
+
"""The hands-on tutorial for agents, the lessons of the page as steps of the command line, Python
|
|
5
|
+
and the page's scripts, each checked from the state of the renderer's home folder.
|
|
6
|
+
|
|
7
|
+
The page and this module read one catalog, `web/lessons.json`, so a person and an agent learn the
|
|
8
|
+
same lessons in the same order. A person's lesson ends when the page sees it done, and an agent's
|
|
9
|
+
lesson ends when its check holds.
|
|
10
|
+
|
|
11
|
+
- `recording` holds when the library keeps a recording outside the Trash.
|
|
12
|
+
- `match_played` holds when the library keeps a game of the Play page or a requested match of at
|
|
13
|
+
least 300 steps, 30 seconds of match time.
|
|
14
|
+
- `team` holds when the registry keeps a team besides the built-in AI.
|
|
15
|
+
- `challenge` holds when the library keeps an attempt of a headless challenge or a leaderboard
|
|
16
|
+
keeps a run.
|
|
17
|
+
- `page` holds once a page has reported the lesson done, as the page does for every lesson it
|
|
18
|
+
sees done, so an agent that drives the page through `window.cuju` learns those lessons there.
|
|
19
|
+
The page watches these lessons whether or not one was started, so the printed steps alone do.
|
|
20
|
+
|
|
21
|
+
The page reports its lessons to `POST /api/help/tutorial`, which keeps them in `tutorial.json` of
|
|
22
|
+
the home folder, and the reset of the tutorial clears that file.
|
|
23
|
+
"""
|
|
24
|
+
|
|
25
|
+
from __future__ import annotations
|
|
26
|
+
|
|
27
|
+
import json
|
|
28
|
+
import time
|
|
29
|
+
from pathlib import Path
|
|
30
|
+
from typing import Any
|
|
31
|
+
|
|
32
|
+
from cuju.errors import ArgumentError
|
|
33
|
+
|
|
34
|
+
from .._registry import teams as _teams
|
|
35
|
+
from .._store import home as _home
|
|
36
|
+
from .._store import library as _library
|
|
37
|
+
from .._text import messages as _messages
|
|
38
|
+
from .._text.messages import MessageError
|
|
39
|
+
|
|
40
|
+
_CATALOG = Path(__file__).parents[1] / 'web' / 'lessons.json'
|
|
41
|
+
# The file of the home folder that keeps the lessons a page reported done.
|
|
42
|
+
_PROGRESS = 'tutorial.json'
|
|
43
|
+
# The steps of a game that count as 30 seconds of match time.
|
|
44
|
+
PLAYED_STEPS = 300
|
|
45
|
+
CHECKS = ('recording', 'match_played', 'team', 'challenge', 'page')
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def lessons() -> list[dict[str, Any]]:
|
|
49
|
+
"""Returns the lessons of the catalog in their order."""
|
|
50
|
+
document = json.loads(_CATALOG.read_text(encoding='utf-8'))
|
|
51
|
+
return list(document['lessons'])
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
def _ids() -> list[str]:
|
|
55
|
+
return [lesson['id'] for lesson in lessons()]
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
def page_progress() -> dict[str, Any]:
|
|
59
|
+
"""Returns the lessons that pages reported done, with the time of each report."""
|
|
60
|
+
try:
|
|
61
|
+
stored = json.loads((_home.home() / _PROGRESS).read_text(encoding='utf-8'))
|
|
62
|
+
except (OSError, ValueError):
|
|
63
|
+
return {}
|
|
64
|
+
known = set(_ids())
|
|
65
|
+
if not isinstance(stored, dict) or not isinstance(stored.get('page'), dict):
|
|
66
|
+
return {}
|
|
67
|
+
return {
|
|
68
|
+
key: value
|
|
69
|
+
for key, value in stored['page'].items()
|
|
70
|
+
if key in known and isinstance(value, str)
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
def _keep(progress: dict[str, Any]) -> None:
|
|
75
|
+
path = _home.home() / _PROGRESS
|
|
76
|
+
path.parent.mkdir(parents=True, exist_ok=True)
|
|
77
|
+
temporary = path.with_name(path.name + '.part')
|
|
78
|
+
temporary.write_text(json.dumps({'page': progress}), encoding='utf-8')
|
|
79
|
+
temporary.replace(path)
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def report(done: Any) -> dict[str, Any]:
|
|
83
|
+
"""Keeps the lessons that a page reports done and returns the state of every lesson.
|
|
84
|
+
|
|
85
|
+
Raises:
|
|
86
|
+
ArgumentError: If `done` is not a list of lesson identifiers.
|
|
87
|
+
"""
|
|
88
|
+
known = _ids()
|
|
89
|
+
if not isinstance(done, list) or not all(isinstance(item, str) for item in done):
|
|
90
|
+
raise MessageError('server.tutorial.done', known=known, done=repr(done))
|
|
91
|
+
unknown = [item for item in done if item not in known]
|
|
92
|
+
if unknown:
|
|
93
|
+
raise MessageError('server.tutorial.unknown', known=known, unknown=unknown)
|
|
94
|
+
progress = page_progress()
|
|
95
|
+
stamp = time.strftime('%Y-%m-%dT%H:%M:%S')
|
|
96
|
+
for item in done:
|
|
97
|
+
progress.setdefault(item, stamp)
|
|
98
|
+
_keep(progress)
|
|
99
|
+
return state()
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
def reset() -> dict[str, Any]:
|
|
103
|
+
"""Forgets the lessons that pages reported, and returns the state of every lesson.
|
|
104
|
+
|
|
105
|
+
The lessons whose checks read the library and the registry stay done while those hold.
|
|
106
|
+
"""
|
|
107
|
+
(_home.home() / _PROGRESS).unlink(missing_ok=True)
|
|
108
|
+
return state()
|
|
109
|
+
|
|
110
|
+
|
|
111
|
+
def _facts() -> dict[str, bool]:
|
|
112
|
+
"""Returns which of the checks of the home folder hold."""
|
|
113
|
+
recordings = _library.matches()
|
|
114
|
+
played = False
|
|
115
|
+
attempted = False
|
|
116
|
+
for entry in recordings:
|
|
117
|
+
provenance = entry.get('provenance') if isinstance(entry.get('provenance'), dict) else {}
|
|
118
|
+
source = provenance.get('source')
|
|
119
|
+
steps = entry.get('steps') if isinstance(entry.get('steps'), int) else 0
|
|
120
|
+
if source in ('human_game', 'requested_match') and steps >= PLAYED_STEPS:
|
|
121
|
+
played = True
|
|
122
|
+
if source == 'challenge':
|
|
123
|
+
attempted = True
|
|
124
|
+
if not attempted:
|
|
125
|
+
folder = _home.home() / 'challenges'
|
|
126
|
+
for path in folder.glob('*.json') if folder.is_dir() else []:
|
|
127
|
+
try:
|
|
128
|
+
document = json.loads(path.read_text(encoding='utf-8'))
|
|
129
|
+
except (OSError, ValueError):
|
|
130
|
+
continue
|
|
131
|
+
if isinstance(document, dict) and document.get('entries'):
|
|
132
|
+
attempted = True
|
|
133
|
+
break
|
|
134
|
+
team = any(entry.get('kind') != 'builtin' for entry in _teams.teams())
|
|
135
|
+
return {
|
|
136
|
+
'recording': bool(recordings),
|
|
137
|
+
'match_played': played,
|
|
138
|
+
'team': team,
|
|
139
|
+
'challenge': attempted,
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
def state() -> dict[str, Any]:
|
|
144
|
+
"""Returns every lesson with its agent's goal and steps and whether its check holds.
|
|
145
|
+
|
|
146
|
+
Returns:
|
|
147
|
+
A dictionary with `lessons`, each with `id`, `title`, `check`, `goal`, `steps` and `done`,
|
|
148
|
+
`next`, the first lesson not done or `None`, and `page`, the lessons that pages reported.
|
|
149
|
+
"""
|
|
150
|
+
facts = _facts()
|
|
151
|
+
reported = page_progress()
|
|
152
|
+
entries = []
|
|
153
|
+
for lesson in lessons():
|
|
154
|
+
agent = lesson['agent']
|
|
155
|
+
check = agent['check']
|
|
156
|
+
done = lesson['id'] in reported or facts.get(check, False)
|
|
157
|
+
entries.append(
|
|
158
|
+
{
|
|
159
|
+
'id': lesson['id'],
|
|
160
|
+
'title': lesson['title'],
|
|
161
|
+
'page': lesson['page'],
|
|
162
|
+
'check': check,
|
|
163
|
+
'goal': agent['goal'],
|
|
164
|
+
'steps': agent['steps'],
|
|
165
|
+
'done': bool(done),
|
|
166
|
+
}
|
|
167
|
+
)
|
|
168
|
+
upcoming = next((entry['id'] for entry in entries if not entry['done']), None)
|
|
169
|
+
return {'lessons': entries, 'next': upcoming, 'page': sorted(reported)}
|
|
170
|
+
|
|
171
|
+
|
|
172
|
+
def lesson_state(identifier: str) -> dict[str, Any]:
|
|
173
|
+
"""Returns the state of one lesson.
|
|
174
|
+
|
|
175
|
+
Raises:
|
|
176
|
+
ArgumentError: If no lesson has that identifier.
|
|
177
|
+
"""
|
|
178
|
+
for entry in state()['lessons']:
|
|
179
|
+
if entry['id'] == identifier:
|
|
180
|
+
return entry
|
|
181
|
+
raise MessageError('server.tutorial.lesson', lessons=_ids(), identifier=repr(identifier))
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
def _step_line(step: dict[str, Any]) -> str:
|
|
185
|
+
for kind, label in (('run', 'run'), ('python', 'python'), ('http', 'http'), ('script', 'page')):
|
|
186
|
+
if kind in step:
|
|
187
|
+
return f' {label} {step[kind]}'
|
|
188
|
+
return ''
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
def text(document: dict[str, Any]) -> str:
|
|
192
|
+
"""Returns the tutorial, or one lesson of it, as lines for a terminal."""
|
|
193
|
+
entries = document['lessons'] if 'lessons' in document else [document]
|
|
194
|
+
lines = []
|
|
195
|
+
for number, entry in enumerate(entries, 1):
|
|
196
|
+
mark = 'done' if entry['done'] else 'to do'
|
|
197
|
+
lines.append(f'{number}. {entry["title"]}, {mark}, lesson {entry["id"]}')
|
|
198
|
+
lines.append(f' {entry["goal"]}')
|
|
199
|
+
for step in entry['steps']:
|
|
200
|
+
lines.append(f' - {step["say"]}')
|
|
201
|
+
line = _step_line(step)
|
|
202
|
+
if line:
|
|
203
|
+
lines.append(line)
|
|
204
|
+
if entry['check'] == 'page' and not entry['done']:
|
|
205
|
+
lines.append(
|
|
206
|
+
' The page reports this lesson once a person or a script does it there, '
|
|
207
|
+
'with the page open on the server.'
|
|
208
|
+
)
|
|
209
|
+
if 'lessons' in document:
|
|
210
|
+
upcoming = document.get('next')
|
|
211
|
+
if upcoming is None:
|
|
212
|
+
lines.append('Every lesson is done.')
|
|
213
|
+
else:
|
|
214
|
+
title = next(entry['title'] for entry in entries if entry['id'] == upcoming)
|
|
215
|
+
lines.append(f'Next, {title}, cuju render tutorial {upcoming}')
|
|
216
|
+
return '\n'.join(lines)
|
|
217
|
+
|
|
218
|
+
|
|
219
|
+
def get(parts: list[str], query: dict[str, str]) -> tuple[Any, int]:
|
|
220
|
+
"""Answers `GET /api/help/tutorial` and `GET /api/help/tutorial/<lesson>`."""
|
|
221
|
+
if not parts:
|
|
222
|
+
return state(), 200
|
|
223
|
+
if len(parts) == 1:
|
|
224
|
+
try:
|
|
225
|
+
return lesson_state(parts[0]), 200
|
|
226
|
+
except ArgumentError as error:
|
|
227
|
+
return _messages.error_fields(error), 404
|
|
228
|
+
return _messages.fields('server.no_resource'), 404
|
|
229
|
+
|
|
230
|
+
|
|
231
|
+
def post(parts: list[str], document: dict[str, Any]) -> tuple[Any, int]:
|
|
232
|
+
"""Answers `POST /api/help/tutorial`, with `done` to report lessons or `reset` to clear them."""
|
|
233
|
+
if parts:
|
|
234
|
+
return _messages.fields('server.no_resource'), 404
|
|
235
|
+
if document.get('reset') is True:
|
|
236
|
+
return reset(), 200
|
|
237
|
+
return report(document.get('done')), 200
|
|
238
|
+
|
|
239
|
+
|
|
240
|
+
def run(lesson: str | None, as_json: bool, clear: bool, check: bool) -> int:
|
|
241
|
+
"""Runs `cuju render tutorial`, printing the lessons or one lesson, and returns the status.
|
|
242
|
+
|
|
243
|
+
With `check`, the status is 0 when the lessons shown are done and 2 otherwise.
|
|
244
|
+
"""
|
|
245
|
+
document = reset() if clear else state()
|
|
246
|
+
shown: dict[str, Any] = lesson_state(lesson) if lesson else document
|
|
247
|
+
if as_json:
|
|
248
|
+
print(json.dumps(shown, indent=2))
|
|
249
|
+
else:
|
|
250
|
+
if clear:
|
|
251
|
+
print('cleared the lessons that pages reported')
|
|
252
|
+
print(text(shown))
|
|
253
|
+
done = shown['done'] if lesson else shown['next'] is None
|
|
254
|
+
return 0 if done or not check else 2
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# Copyright 2026 The cuju Authors
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
|
|
4
|
+
"""The commands of `cuju render` that serve the page or open it, `serve`, `open` and the bare one.
|
|
5
|
+
|
|
6
|
+
A server of the home folder that already runs is reused, so `cuju render open` and a bare
|
|
7
|
+
`cuju render` open its page and return, and otherwise they serve the page in the foreground until
|
|
8
|
+
interrupted, with the browser opened on what they name.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
import argparse
|
|
14
|
+
import urllib.parse
|
|
15
|
+
|
|
16
|
+
from .._store import home as _home
|
|
17
|
+
from . import launch as _launch
|
|
18
|
+
from . import server as _server
|
|
19
|
+
|
|
20
|
+
_LOOPBACK = ('127.0.0.1', 'localhost', '::1')
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def _opened(url: str) -> int:
|
|
24
|
+
"""Opens `url` in the browser of a running server, says so, and returns the exit status."""
|
|
25
|
+
action = 'opened' if _launch.open_browser(url) else 'open it in a browser at'
|
|
26
|
+
print(f'cuju render serves {_home.home()} already, {action} {url}', flush=True)
|
|
27
|
+
return 0
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def serve_page(port: int, options: argparse.Namespace) -> int:
|
|
31
|
+
"""Runs `cuju render serve`, or a bare `cuju render`, which also opens the Home page."""
|
|
32
|
+
if options.command is None:
|
|
33
|
+
server = _launch.running()
|
|
34
|
+
if server is not None:
|
|
35
|
+
return _opened(server.url)
|
|
36
|
+
_server.serve(port, True)
|
|
37
|
+
return 0
|
|
38
|
+
chosen = {'remote': options.remote, 'parent': options.parent, 'colab': options.colab}
|
|
39
|
+
_server.serve(port, options.open, **{key: value for key, value in chosen.items() if value})
|
|
40
|
+
return 0
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def open_target(target: str, port: int) -> int:
|
|
44
|
+
"""Runs `cuju render open`, which opens a recording file, an identifier or a URL."""
|
|
45
|
+
place = _launch.resolve(target)
|
|
46
|
+
server = _launch.running()
|
|
47
|
+
if '://' in place:
|
|
48
|
+
address = urllib.parse.urlsplit(place)
|
|
49
|
+
if server is not None or address.hostname not in _LOOPBACK:
|
|
50
|
+
return _opened(place)
|
|
51
|
+
fragment = f'#{address.fragment}' if address.fragment else ''
|
|
52
|
+
_server.serve(address.port or 80, True, page=fragment)
|
|
53
|
+
return 0
|
|
54
|
+
if server is not None:
|
|
55
|
+
return _opened(server.url + place)
|
|
56
|
+
_server.serve(port, True, page=place)
|
|
57
|
+
return 0
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Copyright 2026 The cuju Authors
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
"""The security headers of the server's responses, which say who may frame or open each one.
|
|
4
|
+
|
|
5
|
+
The module uses the standard library alone and imports nothing of the renderer, so the mock servers
|
|
6
|
+
of `ci` load it from its file and answer with the same headers as the server.
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
from __future__ import annotations
|
|
10
|
+
|
|
11
|
+
import base64
|
|
12
|
+
import hashlib
|
|
13
|
+
import secrets
|
|
14
|
+
from collections.abc import Mapping
|
|
15
|
+
from pathlib import Path
|
|
16
|
+
|
|
17
|
+
# The pages that may frame the viewer once they hold the key of its server, the notebooks of
|
|
18
|
+
# Jupyter on this machine or behind a forwarded port, of VS Code and of Google Colab.
|
|
19
|
+
FRAME_ANCESTORS = ' '.join(
|
|
20
|
+
[
|
|
21
|
+
"'self'",
|
|
22
|
+
'http://localhost:*',
|
|
23
|
+
'http://127.0.0.1:*',
|
|
24
|
+
'http://[::1]:*',
|
|
25
|
+
'https://localhost:*',
|
|
26
|
+
'https://127.0.0.1:*',
|
|
27
|
+
'https://colab.research.google.com',
|
|
28
|
+
'https://*.googleusercontent.com',
|
|
29
|
+
'https://*.colab.dev',
|
|
30
|
+
'https://*.vscode-cdn.net',
|
|
31
|
+
'vscode-webview:',
|
|
32
|
+
'vscode-file:',
|
|
33
|
+
]
|
|
34
|
+
)
|
|
35
|
+
# The policy of the sandbox page of team presentation workers, which runs its own bootstrap, blob
|
|
36
|
+
# scripts and WebAssembly alone, connects nowhere and may be framed by the pages it names. Its
|
|
37
|
+
# sandbox directive gives the page an opaque origin wherever it loads, in the renderer's frame or
|
|
38
|
+
# opened on its own as a whole window, so it never holds the storage, caches or service worker of
|
|
39
|
+
# the server's origin.
|
|
40
|
+
SANDBOX_POLICY = (
|
|
41
|
+
'sandbox allow-scripts; '
|
|
42
|
+
"default-src 'none'; script-src '{hash}' blob: 'wasm-unsafe-eval'; worker-src blob:; "
|
|
43
|
+
"connect-src 'none'; img-src blob: data:; frame-ancestors {ancestors}; base-uri 'none'; "
|
|
44
|
+
"form-action 'none'"
|
|
45
|
+
)
|
|
46
|
+
# The ways a response may be framed. Most responses may sit in no frame. The page asked for with
|
|
47
|
+
# the key of the server may sit in the frame of a notebook, the page of a clean feed and the page
|
|
48
|
+
# that draws a video export in a page of this server alone, and the sandbox says who may frame it
|
|
49
|
+
# in a policy of its own.
|
|
50
|
+
DENY = 'deny'
|
|
51
|
+
EMBED = 'embed'
|
|
52
|
+
SAME_ORIGIN = 'same-origin'
|
|
53
|
+
OWN = 'own'
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
def framing(relative: str, query: Mapping[str, str], key: str | None) -> str:
|
|
57
|
+
"""Returns how a file of the page may be framed, from its path inside `web` and its query.
|
|
58
|
+
|
|
59
|
+
`key` is the key of the server that `show` hands to a notebook, or `None` when it has none.
|
|
60
|
+
"""
|
|
61
|
+
if relative != 'index.html':
|
|
62
|
+
return DENY
|
|
63
|
+
given = query.get('embed', '').encode()
|
|
64
|
+
if key and secrets.compare_digest(given, key.encode()):
|
|
65
|
+
return EMBED
|
|
66
|
+
# The clean feed and the video export of the browser each frame the page on its own origin.
|
|
67
|
+
if 'feed' in query or ('capture' in query and 'export' in query):
|
|
68
|
+
return SAME_ORIGIN
|
|
69
|
+
return DENY
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
def security(kind: str = DENY) -> list[tuple[str, str]]:
|
|
73
|
+
"""Returns the headers that every response carries, for a response that may be framed so.
|
|
74
|
+
|
|
75
|
+
Every response also keeps its window apart from a window of another site that opened it, so
|
|
76
|
+
such a window can neither reach the page nor post to the sandbox opened on its own.
|
|
77
|
+
"""
|
|
78
|
+
headers = []
|
|
79
|
+
if kind == EMBED:
|
|
80
|
+
headers.append(('Content-Security-Policy', f'frame-ancestors {FRAME_ANCESTORS}'))
|
|
81
|
+
elif kind == SAME_ORIGIN:
|
|
82
|
+
headers.append(('X-Frame-Options', 'SAMEORIGIN'))
|
|
83
|
+
headers.append(('Content-Security-Policy', "frame-ancestors 'self'"))
|
|
84
|
+
elif kind != OWN:
|
|
85
|
+
headers.append(('X-Frame-Options', 'DENY'))
|
|
86
|
+
headers.append(('Content-Security-Policy', "frame-ancestors 'none'"))
|
|
87
|
+
headers.append(('X-Content-Type-Options', 'nosniff'))
|
|
88
|
+
headers.append(('Cross-Origin-Opener-Policy', 'same-origin'))
|
|
89
|
+
return headers
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def sandbox_page(web: Path, ancestors: str = FRAME_ANCESTORS) -> tuple[bytes, str]:
|
|
93
|
+
"""Returns the page of the sandbox of team workers and its policy, which allows its script.
|
|
94
|
+
|
|
95
|
+
The page inlines `js/presentation/sandbox.js` of the folder `web`, and the policy names the
|
|
96
|
+
digest of that script, so nothing else runs in the sandbox but blob modules it starts itself.
|
|
97
|
+
Every page above the sandbox must be among `ancestors`, so a viewer in the frame of a notebook
|
|
98
|
+
passes the notebooks that may frame it.
|
|
99
|
+
"""
|
|
100
|
+
script = (web / 'js' / 'presentation' / 'sandbox.js').read_text(encoding='utf-8')
|
|
101
|
+
digest = base64.b64encode(hashlib.sha256(script.encode()).digest()).decode()
|
|
102
|
+
page = f'<!doctype html><meta charset="utf-8"><title>sandbox</title><script>{script}</script>'
|
|
103
|
+
return page.encode(), SANDBOX_POLICY.format(hash=f'sha256-{digest}', ancestors=ancestors)
|