Mirror-Tools
/
shaka-packager
mirror of https://github.com/shaka-project/shaka-packager.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update pssh-box.py to remove external dependencies 

With the update, the script needs to be launched from
out/{Debug,Release} directory.

Also updated docs to make it clear how to use the tool.

Fixes #538.

Change-Id: I37b71afc33e3b73ff5232e43d79c52ffa5859d57
This commit is contained in:
KongQun Yang 2018-12-19 17:48:11 -08:00
parent 22af5533b1
commit 72c4797a59
4 changed files with 127 additions and 76 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
packager/packager.gyp
View File

@ -151,6 +151,20 @@
}],
'dependencies': ['packager'],
},
{
'target_name': 'pssh_box_py',
'type': 'none',
'copies': [{
'destination': '<(PRODUCT_DIR)',
'files': [
'tools/pssh/pssh-box.py',
],
}],
'dependencies': [
'media/base/media_base.gyp:widevine_pssh_data_proto',
'third_party/protobuf/protobuf.gyp:py_proto',
],
},
{
'target_name': 'status',
'type': '<(component)',

67
packager/third_party/protobuf/protobuf.gyp vendored
View File

@ -464,13 +464,6 @@
'python/google/protobuf/symbol_database.py',
'python/google/protobuf/text_encoding.py',
'python/google/protobuf/text_format.py',
# TODO(ncarter): protoc's python generator treats
# descriptor.proto specially, but only when the input path is
# exactly "google/protobuf/descriptor.proto". I'm not sure how
# to execute a rule from a different directory. For now, use a
# manually-generated copy of descriptor_pb2.py.
'python/google/protobuf/descriptor_pb2.py',
],
},
{
@ -491,39 +484,33 @@
],
},
],
# # We can't generate a proper descriptor_pb2.py -- see earlier comment.
# 'rules': [
# {
# 'rule_name': 'genproto',
# 'extension': 'proto',
# 'inputs': [
# '<(PRODUCT_DIR)/<(EXECUTABLE_PREFIX)protoc<(EXECUTABLE_SUFFIX)',
# ],
# 'variables': {
# # The protoc compiler requires a proto_path argument with the
# # directory containing the .proto file.
# 'rule_input_relpath': 'src/google/protobuf',
# },
# 'outputs': [
# '<(PRODUCT_DIR)/pyproto/google/protobuf/<(RULE_INPUT_ROOT)_pb2.py',
# ],
# 'action': [
# '<(PRODUCT_DIR)/<(EXECUTABLE_PREFIX)protoc<(EXECUTABLE_SUFFIX)',
# '-I./src',
# '-I.',
# '--python_out=<(PRODUCT_DIR)/pyproto/google/protobuf',
# 'google/protobuf/descriptor.proto',
# ],
# 'message': 'Generating Python code from <(RULE_INPUT_PATH)',
# },
# ],
# 'dependencies': [
# 'protoc#host',
# ],
# 'sources': [
# 'src/google/protobuf/descriptor.proto',
# ],
},
# Generate descriptor_pb2.py.
'rules': [
{
'rule_name': 'genproto',
'extension': 'proto',
'inputs': [
'<(PRODUCT_DIR)/<(EXECUTABLE_PREFIX)protoc<(EXECUTABLE_SUFFIX)',
],
'outputs': [
'<(PRODUCT_DIR)/pyproto/google/protobuf/<(RULE_INPUT_ROOT)_pb2.py',
],
'action': [
'<(PRODUCT_DIR)/<(EXECUTABLE_PREFIX)protoc<(EXECUTABLE_SUFFIX)',
'-Isrc',
'--python_out=<(PRODUCT_DIR)/pyproto',
'src/google/protobuf/descriptor.proto',
],
'message': 'Generating Python code from <(RULE_INPUT_PATH)',
},
],
'dependencies': [
'protoc#host',
],
'sources': [
'src/google/protobuf/descriptor.proto',
],
},
],
}, { # use_system_protobuf==1
'targets': [

95
packager/tools/pssh/README.md
View File

@ -1,29 +1,86 @@
pssh-box - Utility to generate and print PSSH boxes
pssh-box - Utility to parse and generate PSSH boxes
===================================================
## Installation
## Prerequisite
To use this script you must first install the Python ProtoBuf library. If you
have it installed already, you can just use the script directly. These
instructions describe how to compile the ProtoBuf library so this script can
run. This will not install ProtoBuf globally; it will only compile it.
- Python 2.6 or newer.
1) You need Python 2.6 or newer.
## Build the utility using Shaka Packager build setup
2) Install `setuptools`. This is installed by default when you
install `pip`. If you don't have it, when you run `setup.py` it will install
it locally. If you want to install manually, see:
The utility needs to be built before being used, i.e. do not use the script in
`packager/tools/pssh/pssh_box.py` directly.
```
https://packaging.python.org/en/latest/installing.html#setup-for-installing-packages
```
If you have not set up the build environment for Shaka Packager, see
https://github.com/google/shaka-packager/blob/master/docs/source/build_instructions.md.
3) Build the packager, which will build `protoc` in `out/{Debug,Release}`.
4) Run `setup.py`. You will need to have `protoc` in PATH, which was build in
the previous step:
With the build environment set up, use `ninja` to build the utility:
```bash
cd packager/third_party/protobuf/python
PATH=../../../../out/{Debug,Release}/:"$PATH" python setup.py build
$ ninja -C out/Release pssh_box_py
```
Then you can use the built utility in `out/Release/pssh_box.py`. You can add
`out/Release` to your `PATH` so you can run it from anywhere.
## Usage
All examples below assume that that `pssh-box.py` is in the `PATH` variable of
the executing shell.
### PSSH box generation
The utility can be used to generate one or more PSSH boxes.
An example to generate a Widevine PSSH with content-id 1234:
```bash
$ pssh-box.py --widevine-system-id --content-id 1234
```
It can be also be used to generate PSSH box from PSSH data (base64), e.g.
```bash
$ pssh-box.py --widevine-system-id --pssh-data AAAABCICEjQ=
```
The output can be in base64 form (`--base64`), in hex form (`--hex`) or in human
readable form (`--human`). Human readable form is the default.
An example to generate a Widevine PSSH with content-id 1234 in hex:
```bash
$ pssh-box.py --widevine-system-id --content-id 1234 --hex
```
Multiple boxes can be generated by separating boxes with `--`.
An example to generate concatenated PSSHs with a Widevine PSSH with content-id
1234 and a common PSSH with key-id 31323334353637383930313233343536 (hex form).
```bash
$ pssh-box.py \
--widevine-system-id --content-id 1234 -- \
--common-system-id --key-id 31323334353637383930313233343536
```
### PSSH box parsing
The utility can be used to parse a single PSSH box or multiple concatenated PSSH
boxes. The input can be in hex or in base64.
```bash
$ pssh-box.py --from-hex \
000000247073736800000000EDEF8BA979D64ACEA3C827DCD51D21ED0000000422021234
```
```bash
$ pssh-box.py --from-base64 AAAAJHBzc2gAAAAA7e+LqXnWSs6jyCfc1R0h7QAAAAQiAhI0
```
### More options
Run the utility with no arguments to see the full list of options.
```bash
$ pssh-box.py
```

27
packager/tools/pssh/pssh-box.py
View File

@ -14,24 +14,17 @@ import os
import struct
import sys
# Append the local protobuf location. Use a path relative to the tools/pssh
# folder where this file should be found. This allows the file to be executed
# from any directory.
_pssh_dir = os.path.dirname(os.path.realpath(__file__))
sys.path.insert(0, os.path.join(_pssh_dir, '../../third_party/protobuf/python'))
# Import the widevine protobuf. Use either Release or Debug.
_proto_path_format = os.path.join(
_pssh_dir, '../../../out/%s/pyproto/packager/media/base')
if os.path.isdir(_proto_path_format % 'Release'):
sys.path.insert(0, _proto_path_format % 'Release')
else:
sys.path.insert(0, _proto_path_format % 'Debug')
try:
import widevine_pssh_data_pb2 # pylint: disable=g-import-not-at-top
except ImportError:
print >> sys.stderr, 'Cannot find proto file, make sure to build first'
raise
_script_dir = os.path.dirname(os.path.realpath(__file__))
_proto_path = os.path.join(_script_dir, 'pyproto')
_widevine_proto_path = os.path.join(_proto_path, 'packager/media/base')
assert os.path.exists(_proto_path), (
'Please run from output directory, e.g. out/Debug/pssh-box.py')
sys.path.insert(0, _proto_path)
sys.path.insert(0, _widevine_proto_path)
import widevine_pssh_data_pb2 # pylint: disable=g-import-not-at-top
COMMON_SYSTEM_ID = base64.b16decode('1077EFECC0B24D02ACE33C1E52E2FB4B')
WIDEVINE_SYSTEM_ID = base64.b16decode('EDEF8BA979D64ACEA3C827DCD51D21ED')