shaka-player 3.3.7 → 3.3.8

package/app-engine/shaka-player-demo/README.md

@@ -1,18 +0,0 @@
-# Google App Engine Demo
-
-This folder contains everything necessary to host our demo on
-https://shaka-player-demo.appspot.com/
-
- - app.yaml: App Engine config file.  Defines cache expiration and how specific
-             URLs are mapped to specific files.
-
- - main.py: A catch-all python service to serve any non-static files.  This
-            handles HTTP redirects for the root path (this is the only way to
-            do HTTP redirects in App Engine) and the poster service (which
-            returns special poster images on certain days).
-
- - requirements.txt: Used by App Engine to install the necessary Python server
-                     requirements (Flask).
-
- - time.txt: A static file used for time sync in the client.  Configured with
-             special response headers for cross-origin access.

package/app-engine/shaka-player-demo/app.yaml

@@ -1,61 +0,0 @@
-# Copyright 2016 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-runtime: python39
-default_expiration: 5m
-
-handlers:
-# A static file used for clock sync in the demo app
-- url: /time.txt
-  static_files: time.txt
-  upload: time.txt
-  expiration: 0
-  http_headers:
-    Access-Control-Allow-Origin: "*"
-    Access-Control-Allow-Headers: "If-Modified-Since,Range,Origin"
-    Access-Control-Expose-Headers: "Date"
-    Access-Control-Max-Age: "2592000"
-
-# These used to exist in the repo, but have been generated server-side for many
-# years now.
-- url: /assets/poster.jpg
-  script: auto
-- url: /assets/audioOnly.gif
-  script: auto
-
-# Serve favicon.ico from the demo folder.
-- url: /favicon.ico
-  secure: always
-  static_files: demo/favicon.ico
-  upload: demo/favicon.ico
-
-# For these folders, serve their indexes.
-- url: /docs/api/
-  secure: always
-  static_files: docs/api/index.html
-  upload: docs/api/index.html
-- url: /demo/
-  secure: always
-  static_files: demo/index.html
-  upload: demo/index.html
-- url: /demo/
-  secure: always
-  static_files: demo/index.html
-  upload: demo/index.html
-
-# Serve everything else directly.
-- url: /(.+)
-  secure: always
-  static_files: \1
-  upload: .+

package/app-engine/shaka-player-demo/main.py

@@ -1,95 +0,0 @@
-# Shaka Player Demo - Appspot Entrypoint
-# Copyright 2022 Google LLC
-# SPDX-License-Identifier: Apache-2.0
-
-# Most of the app is served as static content.  Any exceptions go here.
-
-import datetime
-import os
-
-from flask import Flask, make_response, redirect, request, send_file
-
-
-app = Flask(__name__)
-
-
-# Redirect root requests to /demo.
-@app.route('/')
-def root():
-  return redirect('/demo/', code=302)
-
-
-# A Doodle-like service to change the poster on certain days.
-# All posters are chosen based on the current date in PST.
-
-from posters import VIDEO_POSTERS, VIDEO_DEFAULT, AUDIO_POSTERS, AUDIO_DEFAULT
-
-
-# Timezone info for PST.
-# I'm ignoring DST to avoid complicating the code.
-class PST(datetime.tzinfo):
-  def utcoffset(self, dt):
-    return datetime.timedelta(hours=-8)
-
-  def dst(self, dt):
-    return datetime.timedelta(0)
-
-  def tzname(self, dt):
-    return 'PST'
-
-
-def get_poster(poster_map, default_poster):
-  now = datetime.datetime.now(PST())
-  today = (now.month, now.day)
-  today_with_year = (now.month, now.day, now.year)
-  midnight = datetime.datetime(now.year, now.month, now.day, tzinfo=PST())
-  local_expiration = midnight + datetime.timedelta(days=1)
-  max_age = (local_expiration - now).total_seconds()
-
-  # For internal debugging and testing of the poster service, we can override
-  # the date.  To set an override, open /assets/poster.jpg and run this in the
-  # JS console:
-  #   document.cookie="posterdate=10-31"
-  # To clear an override, run:
-  #   document.cookie="posterdate="
-  override = request.cookies.get('posterdate')
-  if override:
-    override_tuple = [int(x) for x in override.split('-')]
-    print('Date override:', repr(override_tuple))
-
-    if len(override_tuple) == 3:
-      # Override includes year.
-      today_with_year = tuple(override_tuple)
-      today = tuple(override_tuple[0:2])
-    elif len(override_tuple) == 2:
-      # Override does not include year, so add the current year.
-      today_with_year = tuple(override_tuple + [now.year])
-      today = tuple(override_tuple)
-    else:
-      # Bad override format.  Ignore the year, but add a response header to
-      # indicate that the override failed.  For internal debugging of the
-      # poster service.
-      print('Bad date override:', override, file=sys.stderr)
-
-  # Prefer a poster for this specific year.
-  name = poster_map.get(today_with_year, poster_map.get(today, default_poster))
-  path = 'posters/%s' % name
-
-  response = make_response(
-      send_file(path, last_modified=midnight, max_age=max_age))
-
-  response.headers['Access-Control-Allow-Origin'] = '*'
-  response.headers['Access-Control-Allow-Headers'] = 'If-Modified-Since,Range'
-  response.headers['Access-Control-Expose-Headers'] = 'Date'
-  response.headers['Access-Control-Max-Age'] = '2592000'
-
-  return response
-
-
-@app.route('/assets/poster.jpg')
-def get_video_poster():
-  return get_poster(VIDEO_POSTERS, VIDEO_DEFAULT)
-
-@app.route('/assets/audioOnly.gif')
-def get_audio_poster():
-  return get_poster(AUDIO_POSTERS, AUDIO_DEFAULT)

package/app-engine/shaka-player-demo/posters/sources.txt

@@ -1,46 +0,0 @@
-Trek poster image derived from:
-  https://commons.wikimedia.org/wiki/File:Leonard_Nimoy_by_Gage_Skidmore_2.jpg
-Author:
-  https://commons.wikimedia.org/wiki/User:Gage
-License:
-  Creative Commons Share-Alike 3.0
-  http://creativecommons.org/licenses/by-sa/3.0/
-
-Zombie poster image derived from:
-  https://www.flickr.com/photos/ofsmallthings/8055153041
-Author:
-  https://www.flickr.com/photos/ofsmallthings/
-License:
-  Creative Commons Share-Alike 2.0
-  https://creativecommons.org/licenses/by-sa/2.0/
-
-Color bars April Fool's image from:
-  http://kittypizzadope.tumblr.com/post/66751567701
-Author:
-  unknown
-License:
-  unknown
-
-Party hat image from:
-  https://pixabay.com/en/party-hat-celebration-birthday-42329/
-Author:
-  unknown
-License:
-  Creative Commons 0 - Public Domain 1.0
-  https://creativecommons.org/publicdomain/zero/1.0/deed.en
-
-Party streamers image from:
-  https://pixabay.com/en/confetti-streamer-party-carnival-1925258/
-Author:
-  Unknown
-License:
-  Creative Commons 0 - Public Domain 1.0
-  https://creativecommons.org/publicdomain/zero/1.0/deed.en
-
-Fireworks image from:
-  https://pixabay.com/illustrations/fireworks-sylvester-pyrotechnics-2248223/
-Author:
-  https://pixabay.com/users/geralt-9301/
-License:
-  Simplified Pixabay License
-  https://pixabay.com/service/license/

package/app-engine/shaka-player-demo/posters.py

@@ -1,110 +0,0 @@
-# Shaka Player Demo - Poster Definitions
-# Copyright 2022 Google LLC
-# SPDX-License-Identifier: Apache-2.0
-
-# A Doodle-like service to change the poster on certain days.
-# All posters are chosen based on the current date in PST.
-
-# Month constants to make specific dates easier to read.
-JANUARY = 1
-FEBRUARY = 2
-MARCH = 3
-APRIL = 4
-MAY = 5
-JUNE = 6
-JULY = 7
-AUGUST = 8
-SEPTEMBER = 9
-OCTOBER = 10
-NOVEMBER = 11
-DECEMBER = 12
-
-# Special posters for certain days.
-VIDEO_POSTERS = {
-  # These are the same every year:
-  # =====
-  (FEBRUARY, 14): 'valentines.png',
-  (APRIL, 1): 'colorbars.gif',
-  (APRIL, 5): 'trek.jpg',  # "First Contact Day": https://bit.ly/2CSXbxw
-  (OCTOBER, 31): 'zombie.jpg',
-  # =====
-
-  # These birthday posters changed each year:
-  (DECEMBER, 19, 2015): '1yo.jpg',
-  (DECEMBER, 19, 2016): '2yo.png',
-  (DECEMBER, 19, 2017): '3yo.png',
-
-  # After this, the birthday poster shows for a whole week:
-  (DECEMBER, 17, 2018): '4yo.png',
-  (DECEMBER, 18, 2018): '4yo.png',
-  (DECEMBER, 19, 2018): '4yo.png',
-  (DECEMBER, 20, 2018): '4yo.png',
-
-  (DECEMBER, 19, 2019): '5yo.png',
-  (DECEMBER, 20, 2019): '5yo.png',
-  (DECEMBER, 21, 2019): '5yo.png',
-  (DECEMBER, 22, 2019): '5yo.png',
-  (DECEMBER, 23, 2019): '5yo.png',
-  (DECEMBER, 24, 2019): '5yo.png',
-  (DECEMBER, 25, 2019): '5yo.png',
-
-  (DECEMBER, 19, 2020): '6yo.png',
-  (DECEMBER, 20, 2020): '6yo.png',
-  (DECEMBER, 21, 2020): '6yo.png',
-  (DECEMBER, 22, 2020): '6yo.png',
-  (DECEMBER, 23, 2020): '6yo.png',
-  (DECEMBER, 24, 2020): '6yo.png',
-  (DECEMBER, 25, 2020): '6yo.png',
-
-  (DECEMBER, 19, 2021): '7yo.png',
-  (DECEMBER, 20, 2021): '7yo.png',
-  (DECEMBER, 21, 2021): '7yo.png',
-  (DECEMBER, 22, 2021): '7yo.png',
-  (DECEMBER, 23, 2021): '7yo.png',
-  (DECEMBER, 24, 2021): '7yo.png',
-  (DECEMBER, 25, 2021): '7yo.png',
-
-  (DECEMBER, 19, 2022): '8yo.png',
-  (DECEMBER, 20, 2022): '8yo.png',
-  (DECEMBER, 21, 2022): '8yo.png',
-  (DECEMBER, 22, 2022): '8yo.png',
-  (DECEMBER, 23, 2022): '8yo.png',
-  (DECEMBER, 24, 2022): '8yo.png',
-  (DECEMBER, 25, 2022): '8yo.png',
-
-  (DECEMBER, 19, 2023): '9yo.png',
-  (DECEMBER, 20, 2023): '9yo.png',
-  (DECEMBER, 21, 2023): '9yo.png',
-  (DECEMBER, 22, 2023): '9yo.png',
-  (DECEMBER, 23, 2023): '9yo.png',
-  (DECEMBER, 24, 2023): '9yo.png',
-  (DECEMBER, 25, 2023): '9yo.png',
-
-  (DECEMBER, 19, 2024): '10yo.png',
-  (DECEMBER, 20, 2024): '10yo.png',
-  (DECEMBER, 21, 2024): '10yo.png',
-  (DECEMBER, 22, 2024): '10yo.png',
-  (DECEMBER, 23, 2024): '10yo.png',
-  (DECEMBER, 24, 2024): '10yo.png',
-  (DECEMBER, 25, 2024): '10yo.png',
-}
-
-# The default poster.
-VIDEO_DEFAULT = 'standard.png'
-
-# Special audio-only posters.
-AUDIO_POSTERS = {
-  # http://discordia.wikia.com/wiki/Chaoflux
-  (FEBRUARY, 19): 'audioRickRoll.gif',
-  # http://discordia.wikia.com/wiki/Discoflux
-  (MAY, 3): 'audioRickRoll.gif',
-  # http://discordia.wikia.com/wiki/Confuflux
-  (JULY, 15): 'audioRickRoll.gif',
-  # http://discordia.wikia.com/wiki/Bureflux
-  (SEPTEMBER, 26): 'audioRickRoll.gif',
-  # http://discordia.wikia.com/wiki/Afflux
-  (DECEMBER, 8): 'audioRickRoll.gif',
-}
-
-# The default audio-only poster.
-AUDIO_DEFAULT = 'audioOnly.gif'

package/app-engine/shaka-player-demo/requirements.txt

@@ -1,5 +0,0 @@
-# Shaka Player Demo - Appspot Python Runtime Requirements
-# Copyright 2022 Google LLC
-# SPDX-License-Identifier: Apache-2.0
-
-Flask==2.0.3

package/app-engine/shaka-player-demo/time.txt

@@ -1 +0,0 @@
-Time is an illusion; lunchtime doubly so.

package/build/README.md

@@ -1,127 +0,0 @@
-This directory contains the scripts used to build and test Shaka Player.  These
-scripts can run on any platform that supports python v2.7 and JRE 8+.
-
-* `all.py` simply runs `gendeps.py`, `check.py`, `docs.py`, and `build.py`.
-  It will forward `--force` to `build.py`.
-* `build.py` builds the compiled library.  This will fail if there are syntax
-  or type errors.
-* `check.py` will check all the files for style violations and will check the
-  tests for type errors (but will not produce any compiled output).
-* `checkversion.py` is used internally as part of our release process.
-* `docs.py` will build the documentation.  The output will be in `docs/api`.
-* `gendeps.py` will create `deps.js` which is required to use the uncompiled
-  library.
-* `shakaBuildHelpers.py` is a utility library used by these scripts.
-* `stats.py` will read the compiled library and source map to get information
-  about the size of the compiled library.
-* `test.py` will run the unit/integration tests.
-
-All the scripts here use two environment variables:
-
-* `PRINT_ARGUMENTS` if set, will print the command-line to subprocesses.
-* `RAISE_INTERRUPT` if set, will raise interrupts rather than swallowing them.
-
-```shell
-$ PRINT_ARGUMENTS=1 build.py
-git -C /path/to/shaka describe --tags --dirty
-Compiling the library...
-java -jar /path/to/shaka/node_modules/.../compiler.jar --language_in ...
-```
-
-## Configurable Build
-
-`build.py` is used to compile the library and can also be used to produce
-customized builds that contain only the features that your app requires.
-`build.py` accepts an optional argument `--name` which will set the name of the
-build, defaulting to `ui`.  All other arguments are treated as commands
-describing what to include in the build.  If nothing is given, it will use
-`+@complete`.
-
-A command is either an addition or a subtraction.  An addition is prefixed with
-a `+`; a subtraction with a `-`.  An addition will add the JavaScript file (or
-build file) to the resulting library while a subtraction will remove it.  After
-the first character, there is either the path to a JavaScript file, or a `@`
-followed by the name of a build file.
-
-Build files are the files found in `build/types/`.  These files are simply a
-newline separated list of commands to execute.  So if the `+@complete` command
-is given, it will open the complete file and run it (which may in turn open
-other build files).  Subtracting a build file will reverse all actions applied
-by the given file.  So `-@networking` will remove all the networking plugins.
-
-```shell
-# Examples:
-build.py +@complete
-build.py +@complete -@networking
-build.py --name custom +@manifests +@networking +../my_plugin.js
-```
-
-## Test
-
-`test.py` accepts some arguments, but mostly will forward them to `karma`.  You
-can run `karma start --help` to get more info about the karma test runner. If
-you don't have karma installed, it will be installed by `npm install` and will
-be found in `node_modules/.bin`.
-
-`test.py` has two arguments that it handles directly.  `--force` will cause
-the build to run even if there are no changes detected to the source code.
-`--no-build` will not build the library even if it does not exist.  Note that
-some integration tests will not run without the compiled library present.
-
-There are also several custom arguments that are handled in JavaScript by
-`karma.conf.js` or the tests themselves (via `getClientArg`).
-These arguments can be passed in using `test.py` or using `karma start`
-directly:
-* `--quick` will only run unit tests, skipping integration tests.
-* `--enable-logging` will enable console logging.  Logs will be printed to
-  the console.  It also accepts a value for the log level `--enable-logging=1`,
-  defaulting to 3.  See [lib/debug/log.js][] for the log levels (you must
-  pass the number).
-* `--external` will run integration tests against external assets.  This will
-  take an extremely long time to run, and requires a fast and reliable internet
-  connection.
-* `--no-drm` will skip integration tests against DRM license servers.  Not
-  specifying this flag requires a connection to the open internet.
-* `--uncompiled` will run integration tests using the uncompiled library instead
-  of the compiled version.
-* `--random` will run the tests in a random order to isolate test dependencies.
-* `--seed` will seed the random test order so that the same order can be
-  reproduced across runs. Specify any value `--seed=xyz`.
-* `--runs` allows running the tests multiple times in succession. This parameter
-  must be specified with a positive integer value, for example `--runs 5`.
-* `--use-xvfb` will launch the browsers in a virtual display (only on Linux).
-* `--filter` is used to filter a specific test or set of tests.  This parameter
-  is specified as a RegExp string `--filter="DataUriPlugin .*\d"`.
-
-The `karma` argument `--browsers` will set the browsers used to run the tests
-(e.g. `--browsers Chrome,Firefox`).  If you don't pass any arguments, `test.py`
-will choose a defaults based on your platform.  However, if you pass any
-arguments to `test.py`, it will not choose browsers and you *must* pass
-`--browsers`.
-
-[lib/debug/log.js]: https://github.com/shaka-project/shaka-player/blob/main/lib/debug/log.js
-
-## Stats
-
-`stats.py` is used to print various stats about the compiled library.  This is
-used internally to determine dependencies and to determine the size of the
-compiled library.
-
-Before running the script, you have to compile it first.  Then you need to pass
-either the name of the build (e.g. `ui`) or the path to the `.map` file.
-You will also need to pass some arguments to determine the output you want.
-You must pass exactly one of the following:
-
-* `-c` or `--class-deps` will print dependencies between classes.
-* `-f` or `--function-deps` will print dependencies between functions.
-* `-s` or `--function-sizes` will print the compiled size of the functions.
-* `-t` or `--all-tokens` will print all the tokens in the source map.
-
-For `--class-deps` and `--function-deps` you can also output in DOT format.
-This format can be used to produce visual graphs of the dependencies.  Passing
-in `-d` or `--dot-format` will output in DOT format.  Then the output can be
-piped into another program to produce the output.  For example using `graphviz`:
-
-```shell
-stats.py -c -d | fdb -Goverlap=prism | neato -n2 -Tsvg > out.svg
-```