Metadata-Version: 2.1
Name: cpix
Version: 1.0.6
Summary: CPIX
Home-page: https://github.com/unifiedstreaming/pycpix
Author: Mark Ogle
Author-email: mark@unified-streaming.com
License: UNKNOWN
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: construct (>=2.9.45)
Requires-Dist: lxml (>=4.2.3)
Requires-Dist: pycryptodome (>=3.6.4)
Requires-Dist: requests (>=2.19.1)
Requires-Dist: isodate (>=0.6.0)

# cpix
Python library for working with CPIX 2.1 (DASH-IF Content Protection Information Exchange) documents

For more details on CPIX see:

* https://dashif.org/guidelines/
* https://dashif.org/wp-content/uploads/2016/11/DASH-IF-CPIX-v2-0.pdf
* https://github.com/Dash-Industry-Forum/CPIX/tree/v2.1-communityreview

## Supported features

* Creation of CPIX documents
* Content keys
* Usage rules
* DRM systems
* Parsing of CPIX documents
* Validation against CPIX XSD

## Not yet implemented

* Validation of document correctness (e.g. kid referenced by usage rule matches a content key)

## Not supported

* Encryption, decryption and signing are not supported.

## Examples

### Scripts

Example scripts which can be used with Widevine and Playready test servers to
get or create keys and produce CPIX documents are available in `example`.

### Simple CPIX

To create a simple CPIX document with a single key:

```python
import cpix

full_cpix = cpix.CPIX(
    content_keys=cpix.ContentKeyList(
        cpix.ContentKey(
            kid="0DC3EC4F-7683-548B-81E7-3C64E582E136",
            cek="WADwG2qCqkq5TVml+U5PXw=="
        )
    ),
    drm_systems=cpix.DRMSystemList(
        cpix.DRMSystem(
            kid="0DC3EC4F-7683-548B-81E7-3C64E582E136",
            system_id="EDEF8BA9-79D6-4ACE-A3C8-27DCD51D21ED",
            pssh=("AAAAxnBzc2gBAAAA7e+LqXnWSs6jyCfc1R0h7QAAAAINw+xPdoNUi4HnPGT"
                  "lguE2FEe37S9mVyu9EwbOfPNhDQAAAIISEBRHt+0vZlcrvRMGznzzYQ0SEF"
                  "rGoR6qL17Vv2aMQByBNMoSEG7hNRbI51h7rp9+zT6Zom4SEPnsEqYaJl1Hj"
                  "4MzTjp40scSEA3D7E92g1SLgec8ZOWC4TYaDXdpZGV2aW5lX3Rlc3QiEXVu"
                  "aWZpZWQtc3RyZWFtaW5nSOPclZsG")
        )
    )
)
```

This can then be printed as a formatted XML document:

```python
print(str(full_cpix.pretty_print(xml_declaration=True), "utf-8'"))
```

```xml
<?xml version='1.0' encoding='utf-8'?>
<CPIX xmlns:pskc="urn:ietf:params:xml:ns:keyprov:pskc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:dashif:org:cpix" xsi:schemaLocation="urn:dashif:org:cpix cpix.xsd">
  <ContentKeyList>
    <ContentKey kid="0dc3ec4f-7683-548b-81e7-3c64e582e136">
      <Data>
        <pskc:Secret>
          <pskc:PlainValue>WADwG2qCqkq5TVml+U5PXw==</pskc:PlainValue>
        </pskc:Secret>
      </Data>
    </ContentKey>
  </ContentKeyList>
  <DRMSystemList>
    <DRMSystem kid="0dc3ec4f-7683-548b-81e7-3c64e582e136" systemId="edef8ba9-79d6-4ace-a3c8-27dcd51d21ed">
      <PSSH>AAAAxnBzc2gBAAAA7e+LqXnWSs6jyCfc1R0h7QAAAAINw+xPdoNUi4HnPGTlguE2FEe37S9mVyu9EwbOfPNhDQAAAIISEBRHt+0vZlcrvRMGznzzYQ0SEFrGoR6qL17Vv2aMQByBNMoSEG7hNRbI51h7rp9+zT6Zom4SEPnsEqYaJl1Hj4MzTjp40scSEA3D7E92g1SLgec8ZOWC4TYaDXdpZGV2aW5lX3Rlc3QiEXVuaWZpZWQtc3RyZWFtaW5nSOPclZsG</PSSH>
    </DRMSystem>
  </DRMSystemList>
</CPIX>
```


