shaka-player 4.0.3 → 4.0.4

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
-```

package/build/all.py

@@ -1,150 +0,0 @@
-#!/usr/bin/env python
-#
-# 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.
-
-"""Builds the dependencies, runs the checks, and compiles the library."""
-
-import argparse
-
-import apps
-import build
-import check
-import compiler
-import docs
-import gendeps
-import generateLocalizations
-import shakaBuildHelpers
-
-import os
-import re
-
-def compile_less(path_name, main_file_name, parsed_args):
-  match = re.compile(r'.*\.less$')
-  base = shakaBuildHelpers.get_source_base()
-  main_less_src = os.path.join(base, path_name, main_file_name + '.less')
-  all_less_srcs = shakaBuildHelpers.get_all_files(
-      os.path.join(base, path_name), match)
-  output = os.path.join(base, 'dist', main_file_name + '.css')
-
-  less = compiler.Less(main_less_src, all_less_srcs, output)
-  return less.compile(parsed_args.force)
-
-def main(args):
-  parser = argparse.ArgumentParser(
-      description='User facing build script for building the Shaka'
-                  ' Player Project.')
-
-  parser.add_argument(
-      '--locales',
-      type=str,
-      nargs='+',
-      default=generateLocalizations.DEFAULT_LOCALES,
-      help='The list of locales to compile in (default %(default)r)')
-
-  parser.add_argument(
-      '--fix',
-      help='Automatically fix style violations.',
-      action='store_true')
-
-  parser.add_argument(
-      '--force',
-      '-f',
-      help='Force building the library even if no files have changed.',
-      action='store_true')
-
-  parser.add_argument(
-      '--debug',
-      help='Limit which build types to build. Will at least build the debug '
-           'version.',
-      action='store_true')
-
-  parser.add_argument(
-      '--release',
-      help='Limit which build types to build. Will at least build the '
-           'release version.',
-      action='store_true')
-
-  parsed_args = parser.parse_args(args)
-
-  # Make the dist/ folder, ignore errors.
-  base = shakaBuildHelpers.get_source_base()
-  try:
-    os.mkdir(os.path.join(base, 'dist'))
-  except OSError:
-    pass
-
-  # Generate localizations before running gendeps, so the output is available
-  # to the deps system.
-  # TODO(#1858): It might be time to look at a third-party build system.
-  localizations = compiler.GenerateLocalizations(parsed_args.locales)
-  if not localizations.generate(parsed_args.force):
-    return 1
-
-  if gendeps.main([]) != 0:
-    return 1
-
-  check_args = []
-  if parsed_args.fix:
-    check_args += ['--fix']
-  if parsed_args.force:
-    check_args += ['--force']
-  if check.main(check_args) != 0:
-    return 1
-
-  docs_args = []
-  if parsed_args.force:
-    docs_args += ['--force']
-  if docs.main(docs_args) != 0:
-    return 1
-
-  if not compile_less('ui', 'controls', parsed_args):
-    return 1;
-  if not compile_less('demo', 'demo', parsed_args):
-    return 1
-
-  build_args_with_ui = ['--name', 'ui', '+@complete']
-  build_args_with_ui += ['--locales'] + parsed_args.locales
-  build_args_without_ui = ['--name', 'compiled', '+@complete', '-@ui']
-
-  if parsed_args.force:
-    build_args_with_ui += ['--force']
-    build_args_without_ui += ['--force']
-
-  # Create the list of build modes to build with. If the list is empty
-  # by the end, then populate it with every mode.
-  modes = []
-  modes += ['debug'] if parsed_args.debug else []
-  modes += ['release'] if parsed_args.release else []
-
-  # If --debug or --release are not given, build with everything.
-  if not modes:
-    modes += ['debug', 'release']
-
-  for mode in modes:
-    # Complete build includes the UI library, but it is optional and player lib
-    # should build and work without it as well.
-    # First, build the full build (UI included) and then build excluding UI.
-    for build_args in [build_args_with_ui, build_args_without_ui]:
-      if build.main(build_args + ['--mode', mode]) != 0:
-        return 1
-
-    is_debug = mode == 'debug'
-    if not apps.build_all(parsed_args.force, is_debug):
-      return 1
-
-  return 0
-
-if __name__ == '__main__':
-  shakaBuildHelpers.run_main(main)

package/build/apps.py

@@ -1,186 +0,0 @@
-#!/usr/bin/env python
-#
-# 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.
-
-"""Build our various applications."""
-
-import argparse
-import logging
-import os
-import re
-
-import build
-import compiler
-import shakaBuildHelpers
-
-
-def compile_demo(force, is_debug):
-  """Compile the demo application.
-
-  Args:
-    force: True to rebuild, False to ignore if no changes are detected.
-    is_debug: True to compile for debugging, false for release.
-
-  Returns:
-    True on success, False on failure.
-  """
-  logging.info('Compiling the demo app (%s)...',
-               'debug' if is_debug else 'release')
-
-  base = shakaBuildHelpers.get_source_base()
-  closure_base_js = shakaBuildHelpers.get_closure_base_js_path()
-  get = shakaBuildHelpers.get_all_js_files
-  cast_receiver = set(get('demo', 'cast_receiver'))
-  files = set(
-      get('demo') +
-      get('externs') +
-      get('ui', 'externs') +
-      [closure_base_js]) - cast_receiver
-
-  # Make sure we don't compile in load.js, which will be used to bootstrap
-  # everything else.  If we build that into the output, we will get an
-  # infinite loop of scripts adding themselves.
-  files.remove(os.path.join(base, 'demo', 'load.js'))
-  # Remove service_worker.js as well.  This executes in a different context.
-  files.remove(os.path.join(base, 'demo', 'service_worker.js'))
-  # Don't compile in the uncompiled require file.
-  files.remove(os.path.join(base, 'demo', 'demo_uncompiled.js'))
-  # Add lib/debug/asserts.js, which is required for goog.assert.
-  files.add(os.path.join(base, 'lib', 'debug', 'asserts.js'))
-
-  # Add in the generated externs, so that the demo compilation knows the
-  # definitions of the library APIs.
-  externs = ('shaka-player.ui.debug.externs.js' if is_debug
-             else 'shaka-player.ui.externs.js')
-
-  files.add(os.path.join(base, 'dist', externs))
-
-  name = 'demo.compiled' + ('.debug' if is_debug else '')
-
-  # TODO: Why do we always use debug_closure_opts?  Nobody remembers.
-  closure_opts = build.common_closure_opts + build.debug_closure_opts
-  closure_opts += [
-      # Ignore missing goog.require since we assume the whole library is
-      # already included.
-      '--jscomp_off=missingRequire',
-      '-D', 'COMPILED=true',
-  ]
-
-  closure = compiler.ClosureCompiler(files, name)
-  # The output wrapper is only designed for the library.  It can't be used
-  # for apps.  TODO: Should we add a simple function wrapper for apps?
-  closure.add_wrapper = False
-  if not closure.compile(closure_opts, force):
-    return False
-
-  return True
-
-
-def compile_receiver(force, is_debug):
-  """Compile the cast receiver application.
-
-  Args:
-    force: True to rebuild, False to ignore if no changes are detected.
-    is_debug: True to compile for debugging, false for release.
-
-  Returns:
-    True on success, False on failure.
-  """
-  logging.info('Compiling the receiver app (%s)...',
-               'debug' if is_debug else 'release')
-
-  base = shakaBuildHelpers.get_source_base()
-  closure_base_js = shakaBuildHelpers.get_closure_base_js_path()
-  get = shakaBuildHelpers.get_all_js_files
-  files = set(get('demo', 'common') +
-              get('demo', 'cast_receiver') +
-              get('externs') +
-              get('ui', 'externs') +
-              [closure_base_js])
-
-  # Add in the generated externs, so that the receiver compilation knows the
-  # definitions of the library APIs.
-  externs = ('shaka-player.ui.debug.externs.js' if is_debug
-             else 'shaka-player.ui.externs.js')
-
-  files.add(os.path.join(base, 'dist', externs))
-  files.add(os.path.join(base, 'lib', 'debug', 'asserts.js'))
-
-  name = 'receiver.compiled' + ('.debug' if is_debug else '')
-
-  # TODO: Why do we always use debug_closure_opts?  Nobody remembers.
-  closure_opts = build.common_closure_opts + build.debug_closure_opts
-  closure_opts += [
-      # Ignore missing goog.require since we assume the whole library is
-      # already included.
-      '--jscomp_off=missingRequire',
-      '-D', 'COMPILED=true',
-  ]
-
-  closure = compiler.ClosureCompiler(files, name)
-  # The output wrapper is only designed for the library.  It can't be used
-  # for apps.  TODO: Should we add a simple function wrapper for apps?
-  closure.add_wrapper = False
-  if not closure.compile(closure_opts, force):
-    return False
-
-  return True
-
-
-def build_all(force, is_debug):
-  if not compile_demo(force, is_debug):
-    return False
-
-  if not compile_receiver(force, is_debug):
-    return False
-
-  return True
-
-
-def main(args):
-  parser = argparse.ArgumentParser(
-      description=__doc__,
-      formatter_class=argparse.RawDescriptionHelpFormatter)
-
-  parser.add_argument(
-      '--force',
-      '-f',
-      help='Force building the library even if no files have changed.',
-      action='store_true')
-
-  parsed_args = parser.parse_args(args)
-
-  # Make the dist/ folder, ignore errors.
-  base = shakaBuildHelpers.get_source_base()
-  try:
-    os.mkdir(os.path.join(base, 'dist'))
-  except OSError:
-    pass
-
-  force = parsed_args.force
-
-  # Update node modules if needed.
-  if not shakaBuildHelpers.update_node_modules():
-    return 1
-
-  for is_debug in [True, False]:
-    if not build_all(force, is_debug):
-      return 1
-
-  return 0
-
-
-if __name__ == '__main__':
-  shakaBuildHelpers.run_main(main)