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,408 @@
|
|
|
1
|
+
# Copyright 2026 The cuju Authors
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
|
|
4
|
+
"""The launchers of the app window, `cuju render app --install` and `--uninstall`.
|
|
5
|
+
|
|
6
|
+
A launcher runs `cuju render app` with the Python of this install, so it opens the app window by
|
|
7
|
+
the same routes. Windows gets a shortcut `Cuju.lnk` in the Start menu and on the desktop, Linux an
|
|
8
|
+
entry `cuju.desktop` of the applications menu in `~/.local/share/applications`, and macOS an app
|
|
9
|
+
`Cuju.app` in `~/Applications`, each named Cuju and with the icon of the page. The launchers go
|
|
10
|
+
only into the person's own folders, and only on the explicit command. The folder `app` of the home
|
|
11
|
+
folder keeps the icon files and `launchers.json`, the list of what the install made, so
|
|
12
|
+
`--uninstall` removes exactly that and leaves alone any file of the same name that the install did
|
|
13
|
+
not make. Installs before the name Cuju made `cuju.lnk` and `cuju.app`, which uninstall still
|
|
14
|
+
removes and a new install replaces.
|
|
15
|
+
"""
|
|
16
|
+
|
|
17
|
+
from __future__ import annotations
|
|
18
|
+
|
|
19
|
+
import json
|
|
20
|
+
import os
|
|
21
|
+
import plistlib
|
|
22
|
+
import re
|
|
23
|
+
import shlex
|
|
24
|
+
import shutil
|
|
25
|
+
import struct
|
|
26
|
+
import subprocess
|
|
27
|
+
import sys
|
|
28
|
+
from collections.abc import Callable
|
|
29
|
+
from pathlib import Path
|
|
30
|
+
from typing import Any
|
|
31
|
+
|
|
32
|
+
from cuju.errors import Error
|
|
33
|
+
|
|
34
|
+
from .._store import home as _home
|
|
35
|
+
from . import window as _window
|
|
36
|
+
|
|
37
|
+
RECORD = 'launchers.json'
|
|
38
|
+
# The name of the files that people never read, the icons, the entry of Linux and the program of
|
|
39
|
+
# the app of macOS.
|
|
40
|
+
NAME = 'cuju'
|
|
41
|
+
# The name that people read, which the shortcut of Windows and the app of macOS show as their file
|
|
42
|
+
# name.
|
|
43
|
+
DISPLAY_NAME = _window.DISPLAY_NAME
|
|
44
|
+
SHORTCUT = f'{DISPLAY_NAME}.lnk'
|
|
45
|
+
BUNDLE = f'{DISPLAY_NAME}.app'
|
|
46
|
+
ENTRY = f'{NAME}.desktop'
|
|
47
|
+
# The bundle identifier of the app of macOS, which uninstall checks before it removes the bundle.
|
|
48
|
+
BUNDLE_ID = 'io.github.andrekoraleski.cuju-render'
|
|
49
|
+
# The names of the launchers that installs before the name Cuju made.
|
|
50
|
+
OLD_NAMES = {f'{NAME}.lnk', f'{NAME}.app'}
|
|
51
|
+
# The names of what an install makes, now or before, the only names that uninstall removes.
|
|
52
|
+
MADE_NAMES = {SHORTCUT, BUNDLE, ENTRY, f'{NAME}.ico', f'{NAME}.png'} | OLD_NAMES
|
|
53
|
+
COMMENT = "Watch, play and run tournaments of Cuju's football matches, served from this computer."
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
def launcher_command(
|
|
57
|
+
home: Path,
|
|
58
|
+
platform: str | None = None,
|
|
59
|
+
route: str = 'auto',
|
|
60
|
+
browser: str | None = None,
|
|
61
|
+
python: str | None = None,
|
|
62
|
+
) -> list[str]:
|
|
63
|
+
"""Returns the command of a launcher, the Python of this install running `cuju render app`.
|
|
64
|
+
|
|
65
|
+
Windows takes `pythonw.exe` beside the Python, which opens no console. A home folder other than
|
|
66
|
+
the default one, a route and a browser go along as options.
|
|
67
|
+
"""
|
|
68
|
+
platform = sys.platform if platform is None else platform
|
|
69
|
+
program = Path(python or sys.executable)
|
|
70
|
+
if platform == 'win32':
|
|
71
|
+
windowed = program.with_name('pythonw.exe')
|
|
72
|
+
if windowed.exists():
|
|
73
|
+
program = windowed
|
|
74
|
+
command = [str(program)]
|
|
75
|
+
if sys.version_info >= (3, 11):
|
|
76
|
+
command.append('-P')
|
|
77
|
+
command += ['-m', 'cuju.render']
|
|
78
|
+
default = Path.home() / '.cuju' / 'render'
|
|
79
|
+
if home.resolve() != default.resolve():
|
|
80
|
+
command += ['--home', str(home)]
|
|
81
|
+
command.append('app')
|
|
82
|
+
if route != 'auto':
|
|
83
|
+
command += ['--route', route]
|
|
84
|
+
if browser:
|
|
85
|
+
command += ['--browser', browser]
|
|
86
|
+
return command
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
def _known_folder(csidl: int) -> Path | None:
|
|
90
|
+
"""Returns a folder of the Windows shell by its CSIDL number, or `None`."""
|
|
91
|
+
try:
|
|
92
|
+
import ctypes
|
|
93
|
+
|
|
94
|
+
buffer = ctypes.create_unicode_buffer(260)
|
|
95
|
+
if ctypes.windll.shell32.SHGetFolderPathW(None, csidl, None, 0, buffer) == 0:
|
|
96
|
+
return Path(buffer.value)
|
|
97
|
+
except (AttributeError, OSError):
|
|
98
|
+
pass
|
|
99
|
+
return None
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
def user_folders(
|
|
103
|
+
platform: str | None = None, environ: dict[str, str] | None = None
|
|
104
|
+
) -> dict[str, Path]:
|
|
105
|
+
"""Returns the person's own folders that the launchers go into, by their role.
|
|
106
|
+
|
|
107
|
+
Windows has `start`, the programs of the Start menu, and `desktop`. Linux and others have
|
|
108
|
+
`applications`, the folder of the applications menu, and macOS has `applications`, the
|
|
109
|
+
folder `~/Applications`.
|
|
110
|
+
"""
|
|
111
|
+
platform = sys.platform if platform is None else platform
|
|
112
|
+
environ = os.environ if environ is None else environ
|
|
113
|
+
user = Path(environ.get('USERPROFILE') or environ.get('HOME') or Path.home())
|
|
114
|
+
if platform == 'win32':
|
|
115
|
+
# Windows: CSIDL_PROGRAMS is 0x02 and CSIDL_DESKTOPDIRECTORY 0x10.
|
|
116
|
+
appdata = Path(environ.get('APPDATA') or user / 'AppData' / 'Roaming')
|
|
117
|
+
start = _known_folder(0x02) or appdata / 'Microsoft' / 'Windows' / 'Start Menu' / 'Programs'
|
|
118
|
+
return {'start': start, 'desktop': _known_folder(0x10) or user / 'Desktop'}
|
|
119
|
+
if platform == 'darwin':
|
|
120
|
+
return {'applications': user / 'Applications'}
|
|
121
|
+
data = Path(environ.get('XDG_DATA_HOME') or user / '.local' / 'share')
|
|
122
|
+
return {'applications': data / 'applications'}
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def ico(images: list[bytes]) -> bytes:
|
|
126
|
+
"""Returns an icon file of Windows that holds the PNG images `images`."""
|
|
127
|
+
header = struct.pack('<HHH', 0, 1, len(images))
|
|
128
|
+
entries = b''
|
|
129
|
+
offset = 6 + 16 * len(images)
|
|
130
|
+
for data in images:
|
|
131
|
+
width, height = struct.unpack('>II', data[16:24])
|
|
132
|
+
size = (width if width < 256 else 0, height if height < 256 else 0)
|
|
133
|
+
entries += struct.pack('<BBBBHHII', *size, 0, 0, 1, 32, len(data), offset)
|
|
134
|
+
offset += len(data)
|
|
135
|
+
return header + entries + b''.join(images)
|
|
136
|
+
|
|
137
|
+
|
|
138
|
+
def icns(png512: bytes) -> bytes:
|
|
139
|
+
"""Returns an icon file of macOS that holds a PNG image of 512 pixels."""
|
|
140
|
+
chunk = b'ic09' + struct.pack('>I', 8 + len(png512)) + png512
|
|
141
|
+
return b'icns' + struct.pack('>I', 8 + len(chunk)) + chunk
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
def desktop_exec(command: list[str]) -> str:
|
|
145
|
+
"""Returns `command` as the Exec value of a desktop entry, quoted as its specification asks."""
|
|
146
|
+
parts = []
|
|
147
|
+
for argument in command:
|
|
148
|
+
argument = argument.replace('%', '%%')
|
|
149
|
+
if re.search(r'[\s"\'\\><~|&;$*?#()`]', argument):
|
|
150
|
+
argument = '"' + re.sub(r'(["`$\\])', r'\\\1', argument) + '"'
|
|
151
|
+
parts.append(argument)
|
|
152
|
+
# The string rules of the file come after the quoting, so each backslash is doubled.
|
|
153
|
+
return ' '.join(parts).replace('\\', '\\\\')
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
def desktop_entry(command: list[str], icon_path: Path, comments: dict[str, str]) -> str:
|
|
157
|
+
"""Returns the desktop entry of Linux that runs `command`."""
|
|
158
|
+
lines = [
|
|
159
|
+
'[Desktop Entry]',
|
|
160
|
+
'Type=Application',
|
|
161
|
+
'Version=1.0',
|
|
162
|
+
f'Name={DISPLAY_NAME}',
|
|
163
|
+
f'Comment={COMMENT}',
|
|
164
|
+
*(f'Comment[{code}]={text}' for code, text in sorted(comments.items())),
|
|
165
|
+
f'Exec={desktop_exec(command)}',
|
|
166
|
+
f'Icon={icon_path}',
|
|
167
|
+
'Terminal=false',
|
|
168
|
+
'Categories=Game;SportsGame;',
|
|
169
|
+
'StartupWMClass=cuju',
|
|
170
|
+
]
|
|
171
|
+
return '\n'.join(lines) + '\n'
|
|
172
|
+
|
|
173
|
+
|
|
174
|
+
def write_shortcut(link: Path, command: list[str], icon_path: Path, folder: Path) -> None:
|
|
175
|
+
"""Writes a shortcut of Windows through the shell of Windows itself, WScript.Shell.
|
|
176
|
+
|
|
177
|
+
The values go to PowerShell as variables of its environment, so no quoting reaches its script,
|
|
178
|
+
and PowerShell writes its errors in UTF-8, the encoding they are read in.
|
|
179
|
+
"""
|
|
180
|
+
script = (
|
|
181
|
+
'[Console]::OutputEncoding = [Text.Encoding]::UTF8; '
|
|
182
|
+
'$s =(New-Object -ComObject WScript.Shell).CreateShortcut($env:CUJU_LINK); '
|
|
183
|
+
'$s.TargetPath = $env:CUJU_TARGET; $s.Arguments = $env:CUJU_ARGUMENTS; '
|
|
184
|
+
"$s.WorkingDirectory = $env:CUJU_FOLDER; $s.IconLocation = $env:CUJU_ICON + ',0'; "
|
|
185
|
+
'$s.Description = $env:CUJU_COMMENT; $s.Save()'
|
|
186
|
+
)
|
|
187
|
+
root = os.environ.get('SystemRoot', r'C:\Windows')
|
|
188
|
+
shell = Path(root, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe')
|
|
189
|
+
environment = {
|
|
190
|
+
**os.environ,
|
|
191
|
+
'CUJU_LINK': str(link),
|
|
192
|
+
'CUJU_TARGET': command[0],
|
|
193
|
+
'CUJU_ARGUMENTS': subprocess.list2cmdline(command[1:]),
|
|
194
|
+
'CUJU_FOLDER': str(folder),
|
|
195
|
+
'CUJU_ICON': str(icon_path),
|
|
196
|
+
'CUJU_COMMENT': COMMENT,
|
|
197
|
+
}
|
|
198
|
+
program = str(shell) if shell.exists() else 'powershell'
|
|
199
|
+
result = subprocess.run(
|
|
200
|
+
[program, '-NoProfile', '-NonInteractive', '-Command', script],
|
|
201
|
+
env=environment,
|
|
202
|
+
capture_output=True,
|
|
203
|
+
text=True,
|
|
204
|
+
encoding='utf-8',
|
|
205
|
+
errors='replace',
|
|
206
|
+
timeout=60,
|
|
207
|
+
creationflags=0x08000000 if sys.platform == 'win32' else 0,
|
|
208
|
+
)
|
|
209
|
+
if result.returncode != 0 or not link.exists():
|
|
210
|
+
tail = (result.stderr or result.stdout).strip().splitlines()
|
|
211
|
+
raise Error(f'the shortcut {link} was not made' + (f', {tail[-1]}' if tail else ''))
|
|
212
|
+
|
|
213
|
+
|
|
214
|
+
def _record_path(home: Path) -> Path:
|
|
215
|
+
return home / _window.APP_FOLDER / RECORD
|
|
216
|
+
|
|
217
|
+
|
|
218
|
+
def installed_paths(home: Path) -> list[Path]:
|
|
219
|
+
"""Returns what an earlier install made, from `launchers.json` of the home folder."""
|
|
220
|
+
try:
|
|
221
|
+
entry = json.loads(_record_path(home).read_text(encoding='utf-8'))
|
|
222
|
+
return [Path(path) for path in entry['created'] if isinstance(path, str)]
|
|
223
|
+
except (OSError, ValueError, TypeError, KeyError):
|
|
224
|
+
return []
|
|
225
|
+
|
|
226
|
+
|
|
227
|
+
def _bundle_is_ours(bundle: Path) -> bool:
|
|
228
|
+
try:
|
|
229
|
+
with (bundle / 'Contents' / 'Info.plist').open('rb') as stream:
|
|
230
|
+
return plistlib.load(stream).get('CFBundleIdentifier') == BUNDLE_ID
|
|
231
|
+
except (OSError, ValueError, plistlib.InvalidFileException):
|
|
232
|
+
return False
|
|
233
|
+
|
|
234
|
+
|
|
235
|
+
def _comments() -> dict[str, str]:
|
|
236
|
+
"""Returns the comment of the launcher in each usable language other than English."""
|
|
237
|
+
from .._text import languages as _languages
|
|
238
|
+
|
|
239
|
+
out = {}
|
|
240
|
+
try:
|
|
241
|
+
entries = [e for e in _languages.listing() if e['code'] != 'en' and e['usable']]
|
|
242
|
+
except Exception:
|
|
243
|
+
entries = []
|
|
244
|
+
for entry in entries:
|
|
245
|
+
locale = str(entry['locale']).replace('-', '_')
|
|
246
|
+
try:
|
|
247
|
+
text = _languages.read(entry['code']).get('pwa.manifest.description')
|
|
248
|
+
except Exception:
|
|
249
|
+
text = None
|
|
250
|
+
if isinstance(text, str) and text.strip():
|
|
251
|
+
out[locale] = text.strip()
|
|
252
|
+
return out
|
|
253
|
+
|
|
254
|
+
|
|
255
|
+
def install(
|
|
256
|
+
home: Path | None = None,
|
|
257
|
+
platform: str | None = None,
|
|
258
|
+
folders: dict[str, Path] | None = None,
|
|
259
|
+
command: list[str] | None = None,
|
|
260
|
+
shortcut: Callable[[Path, list[str], Path, Path], None] = write_shortcut,
|
|
261
|
+
) -> list[Path]:
|
|
262
|
+
"""Makes the launchers of the app window and returns what it made.
|
|
263
|
+
|
|
264
|
+
Args:
|
|
265
|
+
home: The home folder, by default the one in use.
|
|
266
|
+
platform: The system whose launchers it makes, `win32`, `darwin` or another.
|
|
267
|
+
folders: The folders of the launchers by role, by default `user_folders`. Tests name
|
|
268
|
+
folders of their own.
|
|
269
|
+
command: The command of the launchers, by default `launcher_command`.
|
|
270
|
+
shortcut: The writer of a shortcut of Windows.
|
|
271
|
+
|
|
272
|
+
Raises:
|
|
273
|
+
Error: If a launcher of the same name that no install of cuju made is in the way.
|
|
274
|
+
"""
|
|
275
|
+
platform = sys.platform if platform is None else platform
|
|
276
|
+
home = _home.home() if home is None else home
|
|
277
|
+
folders = user_folders(platform) if folders is None else folders
|
|
278
|
+
command = launcher_command(home, platform) if command is None else command
|
|
279
|
+
folder = home / _window.APP_FOLDER
|
|
280
|
+
folder.mkdir(parents=True, exist_ok=True)
|
|
281
|
+
before = set(installed_paths(home))
|
|
282
|
+
if platform == 'win32':
|
|
283
|
+
targets = [folders['start'] / SHORTCUT, folders['desktop'] / SHORTCUT]
|
|
284
|
+
elif platform == 'darwin':
|
|
285
|
+
targets = [folders['applications'] / BUNDLE]
|
|
286
|
+
else:
|
|
287
|
+
targets = [folders['applications'] / ENTRY]
|
|
288
|
+
for target in targets:
|
|
289
|
+
if os.path.lexists(target) and not any(_same_name(target, path) for path in before):
|
|
290
|
+
raise Error(f'{target} is in the way and no install of cuju made it, remove it first')
|
|
291
|
+
# A launcher of an earlier install under the old name goes, so the new name takes its place.
|
|
292
|
+
for path in before:
|
|
293
|
+
if path.name in OLD_NAMES and path.name not in {target.name for target in targets}:
|
|
294
|
+
_remove(path)
|
|
295
|
+
made: list[Path] = []
|
|
296
|
+
if platform == 'win32':
|
|
297
|
+
icon_path = folder / f'{NAME}.ico'
|
|
298
|
+
icon_path.write_bytes(ico([_window.icon(192).read_bytes(), _window.icon(512).read_bytes()]))
|
|
299
|
+
made.append(icon_path)
|
|
300
|
+
for target in targets:
|
|
301
|
+
target.parent.mkdir(parents=True, exist_ok=True)
|
|
302
|
+
shortcut(target, command, icon_path, _home.process_folder())
|
|
303
|
+
made.append(target)
|
|
304
|
+
elif platform == 'darwin':
|
|
305
|
+
made += _write_bundle(targets[0], command)
|
|
306
|
+
else:
|
|
307
|
+
icon_path = folder / f'{NAME}.png'
|
|
308
|
+
shutil.copyfile(_window.icon(512), icon_path)
|
|
309
|
+
made.append(icon_path)
|
|
310
|
+
target = targets[0]
|
|
311
|
+
target.parent.mkdir(parents=True, exist_ok=True)
|
|
312
|
+
target.write_text(desktop_entry(command, icon_path, _comments()), encoding='utf-8')
|
|
313
|
+
target.chmod(0o755)
|
|
314
|
+
made.append(target)
|
|
315
|
+
_record_path(home).write_text(
|
|
316
|
+
json.dumps({'created': [str(path) for path in made]}, indent=1), encoding='utf-8'
|
|
317
|
+
)
|
|
318
|
+
return made
|
|
319
|
+
|
|
320
|
+
|
|
321
|
+
def _same_name(target: Path, path: Path) -> bool:
|
|
322
|
+
"""Tells whether `path` names `target` on a system that ignores the case of names."""
|
|
323
|
+
return path.parent == target.parent and path.name.casefold() == target.name.casefold()
|
|
324
|
+
|
|
325
|
+
|
|
326
|
+
def _write_bundle(bundle: Path, command: list[str]) -> list[Path]:
|
|
327
|
+
"""Writes the app `Cuju.app` of macOS, whose program is a script that runs `command`."""
|
|
328
|
+
from .._version import __version__
|
|
329
|
+
|
|
330
|
+
if bundle.exists():
|
|
331
|
+
shutil.rmtree(bundle)
|
|
332
|
+
contents = bundle / 'Contents'
|
|
333
|
+
(contents / 'MacOS').mkdir(parents=True)
|
|
334
|
+
(contents / 'Resources').mkdir()
|
|
335
|
+
info: dict[str, Any] = {
|
|
336
|
+
'CFBundleName': DISPLAY_NAME,
|
|
337
|
+
'CFBundleDisplayName': DISPLAY_NAME,
|
|
338
|
+
'CFBundleIdentifier': BUNDLE_ID,
|
|
339
|
+
'CFBundleExecutable': NAME,
|
|
340
|
+
'CFBundleIconFile': NAME,
|
|
341
|
+
'CFBundlePackageType': 'APPL',
|
|
342
|
+
'CFBundleShortVersionString': __version__,
|
|
343
|
+
'CFBundleVersion': __version__,
|
|
344
|
+
'NSHighResolutionCapable': True,
|
|
345
|
+
}
|
|
346
|
+
with (contents / 'Info.plist').open('wb') as stream:
|
|
347
|
+
plistlib.dump(info, stream)
|
|
348
|
+
program = contents / 'MacOS' / NAME
|
|
349
|
+
program.write_text(
|
|
350
|
+
'#!/bin/sh\nexec ' + ' '.join(map(shlex.quote, command)) + '\n',
|
|
351
|
+
encoding='utf-8',
|
|
352
|
+
newline='\n',
|
|
353
|
+
)
|
|
354
|
+
program.chmod(0o755)
|
|
355
|
+
(contents / 'Resources' / f'{NAME}.icns').write_bytes(icns(_window.icon(512).read_bytes()))
|
|
356
|
+
return [bundle]
|
|
357
|
+
|
|
358
|
+
|
|
359
|
+
def _remove(path: Path) -> bool:
|
|
360
|
+
"""Removes one path of a record and tells whether it went.
|
|
361
|
+
|
|
362
|
+
Only the names that an install makes go, a bundle of macOS only while its identifier is cuju's,
|
|
363
|
+
and every other path only while it is a file.
|
|
364
|
+
"""
|
|
365
|
+
if path.name not in MADE_NAMES:
|
|
366
|
+
return False
|
|
367
|
+
if path.is_dir() and not path.is_symlink():
|
|
368
|
+
if path.suffix == '.app' and _bundle_is_ours(path):
|
|
369
|
+
shutil.rmtree(path)
|
|
370
|
+
return True
|
|
371
|
+
return False
|
|
372
|
+
if path.is_file():
|
|
373
|
+
path.unlink()
|
|
374
|
+
return True
|
|
375
|
+
return False
|
|
376
|
+
|
|
377
|
+
|
|
378
|
+
def uninstall(home: Path | None = None) -> list[Path]:
|
|
379
|
+
"""Removes what an earlier install made and returns what it removed.
|
|
380
|
+
|
|
381
|
+
Only the names that an install makes go, a bundle of macOS only while its identifier is cuju's,
|
|
382
|
+
and every other path only while it is a file.
|
|
383
|
+
"""
|
|
384
|
+
home = _home.home() if home is None else home
|
|
385
|
+
removed = [path for path in installed_paths(home) if _remove(path)]
|
|
386
|
+
record = _record_path(home)
|
|
387
|
+
if record.exists():
|
|
388
|
+
record.unlink()
|
|
389
|
+
return removed
|
|
390
|
+
|
|
391
|
+
|
|
392
|
+
def run(install_it: bool, route: str = 'auto', browser: str | None = None) -> int:
|
|
393
|
+
"""Runs `cuju render app --install` or `--uninstall` and says what changed."""
|
|
394
|
+
home = _home.home()
|
|
395
|
+
if not install_it:
|
|
396
|
+
removed = uninstall(home)
|
|
397
|
+
if not removed:
|
|
398
|
+
print('cuju render: no launcher of the app was found to remove')
|
|
399
|
+
for path in removed:
|
|
400
|
+
print(f'removed {path}')
|
|
401
|
+
return 0
|
|
402
|
+
if route not in _window.ROUTES:
|
|
403
|
+
raise Error(f'expected a route among {", ".join(_window.ROUTES)}, found {route!r}')
|
|
404
|
+
made = install(home, sys.platform, command=launcher_command(home, sys.platform, route, browser))
|
|
405
|
+
for path in made:
|
|
406
|
+
print(f'made {path}')
|
|
407
|
+
print('cuju render app opens from the launcher, and cuju render app --uninstall removes it')
|
|
408
|
+
return 0
|
cuju/render/_http/pwa.py
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
# Copyright 2026 The cuju Authors
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
|
|
4
|
+
"""The build of the page, which the service worker of the installable page names its cache after.
|
|
5
|
+
|
|
6
|
+
The build is a short digest of cuju's version and of the name, size and modification time of
|
|
7
|
+
every file of the page's folder, so a new version, or any edit of a file of the page, makes a new
|
|
8
|
+
build. The page registers `sw.js?build=<build>`, so a new build brings a new worker, and the worker
|
|
9
|
+
compares its own build with the server's on each navigation. `GET /api/help/app` returns
|
|
10
|
+
`app_info`.
|
|
11
|
+
|
|
12
|
+
The server writes into `sw.js` the SHA-256 of every file of the page as it serves them, and the
|
|
13
|
+
worker answers from its cache only with an entry whose bytes have that digest, so an entry that
|
|
14
|
+
anything else put into the cache never reaches the page.
|
|
15
|
+
|
|
16
|
+
The manifest of the installable page, `manifest.webmanifest`, comes in the page's language when
|
|
17
|
+
the page asks for it with `?lang=<code>`, as it does for any language but English, so an install
|
|
18
|
+
names its description and shortcuts in that language.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
from __future__ import annotations
|
|
22
|
+
|
|
23
|
+
import hashlib
|
|
24
|
+
import json
|
|
25
|
+
import threading
|
|
26
|
+
import time
|
|
27
|
+
from pathlib import Path
|
|
28
|
+
from typing import Any
|
|
29
|
+
|
|
30
|
+
from cuju import __version__
|
|
31
|
+
|
|
32
|
+
from .. import _version
|
|
33
|
+
|
|
34
|
+
_WEB = Path(__file__).parents[1] / 'web'
|
|
35
|
+
# A build stands this many seconds before the files are looked at again.
|
|
36
|
+
_FRESH_SECONDS = 1.0
|
|
37
|
+
_HELD: dict[str, Any] = {'at': -_FRESH_SECONDS, 'build': '', 'digests': None, 'of': None}
|
|
38
|
+
_LOCK = threading.Lock()
|
|
39
|
+
# The line of `sw.js` that the server fills with the digests of the page's files.
|
|
40
|
+
_DIGESTS_SLOT = b'const DIGESTS = null;'
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def _digest() -> str:
|
|
44
|
+
digest = hashlib.sha256(f'cuju-render {_version.__version__} cuju {__version__}\n'.encode())
|
|
45
|
+
for path in sorted(_WEB.rglob('*')):
|
|
46
|
+
if path.is_file():
|
|
47
|
+
stat = path.stat()
|
|
48
|
+
name = path.relative_to(_WEB).as_posix()
|
|
49
|
+
digest.update(f'{name} {stat.st_size} {stat.st_mtime_ns}\n'.encode())
|
|
50
|
+
return digest.hexdigest()[:16]
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def build() -> str:
|
|
54
|
+
"""Returns the build of the page as it stands, looked at again at most once a second."""
|
|
55
|
+
with _LOCK:
|
|
56
|
+
now = time.monotonic()
|
|
57
|
+
if now - _HELD['at'] >= _FRESH_SECONDS:
|
|
58
|
+
_HELD['build'] = _digest()
|
|
59
|
+
_HELD['at'] = now
|
|
60
|
+
return _HELD['build']
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
def digests() -> dict[str, str]:
|
|
64
|
+
"""Returns the SHA-256 of every file of the page as the server serves it, by its path.
|
|
65
|
+
|
|
66
|
+
The page itself, and the page of a clean feed, carry the shipped languages as the server
|
|
67
|
+
inlines them. The digests are made once a build.
|
|
68
|
+
"""
|
|
69
|
+
from .._text import languages as _languages
|
|
70
|
+
|
|
71
|
+
current = build()
|
|
72
|
+
with _LOCK:
|
|
73
|
+
if _HELD['of'] == current and _HELD['digests'] is not None:
|
|
74
|
+
return _HELD['digests']
|
|
75
|
+
out = {}
|
|
76
|
+
for path in sorted(_WEB.rglob('*')):
|
|
77
|
+
if not path.is_file():
|
|
78
|
+
continue
|
|
79
|
+
name = path.relative_to(_WEB).as_posix()
|
|
80
|
+
data = path.read_bytes()
|
|
81
|
+
if name in ('index.html', 'feed.html'):
|
|
82
|
+
data = _languages.inline(data)
|
|
83
|
+
out[name] = hashlib.sha256(data).hexdigest()
|
|
84
|
+
with _LOCK:
|
|
85
|
+
_HELD.update(digests=out, of=current)
|
|
86
|
+
return out
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
def worker(data: bytes) -> bytes:
|
|
90
|
+
"""Returns the service worker `sw.js` with the digests of the page's files written into it."""
|
|
91
|
+
filled = json.dumps(digests(), sort_keys=True, separators=(',', ':')).encode()
|
|
92
|
+
return data.replace(_DIGESTS_SLOT, b'const DIGESTS = ' + filled + b';', 1)
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
# The messages of the manifest's texts, the description and the name of each shortcut by page.
|
|
96
|
+
_MANIFEST_DESCRIPTION = 'pwa.manifest.description'
|
|
97
|
+
_MANIFEST_SHORTCUT = 'pwa.manifest.shortcut.'
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def manifest(data: bytes, code: str | None) -> bytes:
|
|
101
|
+
"""Returns the manifest `data` with its texts in the language `code`, as they are without one.
|
|
102
|
+
|
|
103
|
+
A text that the language lacks, or a language that is unknown, keeps the English of the file.
|
|
104
|
+
"""
|
|
105
|
+
if not code or code == 'en':
|
|
106
|
+
return data
|
|
107
|
+
from .._text import languages as _languages
|
|
108
|
+
|
|
109
|
+
try:
|
|
110
|
+
messages = _languages.read(code)
|
|
111
|
+
except Exception:
|
|
112
|
+
return data
|
|
113
|
+
document = json.loads(data)
|
|
114
|
+
text = messages.get(_MANIFEST_DESCRIPTION)
|
|
115
|
+
if isinstance(text, str) and text.strip():
|
|
116
|
+
document['description'] = text
|
|
117
|
+
for shortcut in document.get('shortcuts') or ():
|
|
118
|
+
page = str(shortcut.get('url', '')).rpartition('page=')[2]
|
|
119
|
+
name = messages.get(_MANIFEST_SHORTCUT + page)
|
|
120
|
+
if isinstance(name, str) and name.strip():
|
|
121
|
+
shortcut['name'] = name
|
|
122
|
+
document['lang'] = code
|
|
123
|
+
return json.dumps(document, ensure_ascii=False, indent=4).encode('utf-8')
|
|
124
|
+
|
|
125
|
+
|
|
126
|
+
def app_info() -> dict[str, str]:
|
|
127
|
+
"""Returns the version of cuju-render and the build of the page."""
|
|
128
|
+
return {'version': _version.__version__, 'build': build()}
|