PyCriCodecsEx 0.0.4__cp312-cp312-macosx_11_0_arm64.whl → 0.0.5__cp312-cp312-macosx_11_0_arm64.whl

PyCriCodecsEx/__init__.py

@@ -1 +1 @@
-__version__ = "0.0.4"
+__version__ = "0.0.5"

PyCriCodecsEx/acb.py

@@ -188,10 +188,17 @@ class ACB(UTF):
         """Returns the AWB object associated with the ACB."""
         return AWB(self.view.AwbFile)
 
-    def get_waveforms(self) -> List[HCACodec | ADXCodec | Tuple[AcbEncodeTypes, int, int, int,  bytes]]:
+    def get_waveforms(self, **kwargs) -> List[HCACodec | ADXCodec | Tuple[AcbEncodeTypes, int, int, int,  bytes]]:
         """Returns a list of decoded waveforms.
 
         Item may be a codec (if known), or a tuple of (Codec ID, Channel Count, Sample Count, Sample Rate, Raw data).
+
+        Additional keyword arguments are passed to the codec constructors. e.g. for encrypted HCA payloads,
+        you may do the following:
+        ```python
+        get_waveforms(key=..., subkey=...)
+        ```
+        See also the respective docs (ADXCodec, HCACodec) for more details.
         """
         CODEC_TABLE = {
             AcbEncodeTypes.ADX: ADXCodec,
@@ -204,7 +211,7 @@ class ACB(UTF):
             encode = AcbEncodeTypes(wav.EncodeType)
             codec = (CODEC_TABLE.get(encode, None))
             if codec:
-                wavs.append(codec(awb.get_file_at(wav.MemoryAwbId)))
+                wavs.append(codec(awb.get_file_at(wav.MemoryAwbId), **kwargs))
             else:
                 wavs.append((encode, wav.NumChannels, wav.NumSamples, wav.SamplingRate, awb.get_file_at(wav.MemoryAwbId)))
         return wavs
@@ -214,7 +221,7 @@ class ACB(UTF):
 
         Input item may be a codec (if known), or a tuple of (Codec ID, Channel Count, Sample Count, Sample Rate, Raw data).
 
-        NOTE: Cue duration is not set. You need to change that manually.
+        NOTE: Cue duration is not set. You need to change that manually - this is usually unecessary as the player will just play until the end of the waveform.
         """
         WAVEFORM = self.view.WaveformTable[0]._payload.copy()
         encoded = []

PyCriCodecsEx/adx.py

@@ -57,7 +57,7 @@ class ADXCodec(ADX):
 
         Args:
             stream (str | bytes): Path to the ADX or WAV file, or a BinaryIO stream. WAV files will be automatically encoded with the given settings first.
-            filename (str, optional): Output filename. Defaults to "default.adx".
+            filename (str, optional): Filename, used by USMBuilder. Defaults to "default.adx".
             bitdepth (int, optional): Audio bit depth within [2,15]. Defaults to 4.
         """
         if type(stream) == str:

PyCriCodecsEx/hca.py

@@ -332,7 +332,7 @@ class HCACodec(HCA):
 
         Args:
             stream (str | bytes): Path to the HCA or WAV file, or a BinaryIO stream. WAV files will be automatically encoded with the given settings first.
-            filename (str, optional): USM filename. Defaults to "default.hca".
+            filename (str, optional): Filename, used by USMBuilder. Defaults to "default.hca".
             quality (CriHcaQuality, optional): Encoding quality. Defaults to CriHcaQuality.High.
             key (int, optional): HCA key. Defaults to 0.
             subkey (int, optional): HCA subkey. Defaults to 0.

PyCriCodecsEx/usm.py

@@ -13,11 +13,7 @@ except ImportError:
 import tempfile
 
 # Big thanks and credit for k0lb3 and 9th helping me write this specific code.
-# Also credit for the original C++ code from Nyagamon/bnnm.
-
-# Apparently there is an older USM format called SofDec? This is for SofDec2 though.
-# Extraction working only for now, although check https://github.com/donmai-me/WannaCRI/
-# code for a complete breakdown of the USM format.
+# Also credit for the original C++ code from Nyagamon/bnnm and https://github.com/donmai-me/WannaCRI/
 
 class USMCrypt:
     """USM related crypto functions"""

{pycricodecsex-0.0.4.dist-info → pycricodecsex-0.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyCriCodecsEx
-Version: 0.0.4
+Version: 0.0.5
 Summary: Criware formats library for Python
 Home-page: https://mos9527.github.io/PyCriCodecsEx/
 Classifier: Programming Language :: Python :: 3

pycricodecsex-0.0.5.dist-info/RECORD

@@ -0,0 +1,15 @@
+CriCodecsEx.cpython-312-darwin.so,sha256=Vp_vL3BpFPOneK6ZI5MJyI1q0-ngYivKzEC2WEtNjmk,134944
+pycricodecsex-0.0.5.dist-info/RECORD,,
+pycricodecsex-0.0.5.dist-info/WHEEL,sha256=CltXN3lQvXbHxKDtiDwW0RNzF8s2WyBuPbOAX_ZeQlA,109
+pycricodecsex-0.0.5.dist-info/top_level.txt,sha256=mSrrEse9hT0s6nl-sWAQWAhNRuZ6jo98pbFoN3L2MXk,26
+pycricodecsex-0.0.5.dist-info/METADATA,sha256=DU7M5Yv8bs7WE_UafvxP6omoUqJ6E0Xi1jC-a3O_RoQ,1256
+pycricodecsex-0.0.5.dist-info/licenses/LICENSE,sha256=GyZb4dzF2tM3LU5I_tJXpHtUDz8297zeUuCJ5qz8io0,1063
+PyCriCodecsEx/adx.py,sha256=RFW9NmayPLMcLZXmKVQvaQqt9lj8wS89N8n-nbB137c,5972
+PyCriCodecsEx/__init__.py,sha256=S7u1lbuWmM3A3ajykBialmPoJUK6Jg-WmNqM-9OZFdk,22
+PyCriCodecsEx/chunk.py,sha256=ZYyeqqcBK6dDDj12YvrhpZDzW0iyOhysRlYuCD3rgQ8,2719
+PyCriCodecsEx/hca.py,sha256=O88_qqtXLhekbg_UjqLKYYdBIeddrzZ3Iyyq6xvX2mY,19149
+PyCriCodecsEx/cpk.py,sha256=cBZDLowGG7GCSJ8caPbj26t0inYGZ92Iwz_hL0hgOmU,37383
+PyCriCodecsEx/usm.py,sha256=87p6NMnJQlJ9s5PS3QyHoSANuHr5hWsFMe_Xp_tQvF0,36172
+PyCriCodecsEx/acb.py,sha256=qDJrwhSZCIEZzPV1kzqXf5KFqEID-S6ZrL2D-jMDdeU,11650
+PyCriCodecsEx/awb.py,sha256=Y9MOTuW76ZdFEnW2e8MC-Hi9vdHJ7WFBsCRwqdpt3Jg,6231
+PyCriCodecsEx/utf.py,sha256=ORSoyRrgBbdaGP6cQQejWfqkdWz6vEGG_sTo_fbO48Y,27555

pycricodecsex-0.0.4.dist-info/RECORD

@@ -1,15 +0,0 @@
-CriCodecsEx.cpython-312-darwin.so,sha256=9XoZj_5oum7Lken8WyUrRpIz5QWa89SQqq2tosJd0v0,134720
-pycricodecsex-0.0.4.dist-info/RECORD,,
-pycricodecsex-0.0.4.dist-info/WHEEL,sha256=CltXN3lQvXbHxKDtiDwW0RNzF8s2WyBuPbOAX_ZeQlA,109
-pycricodecsex-0.0.4.dist-info/top_level.txt,sha256=mSrrEse9hT0s6nl-sWAQWAhNRuZ6jo98pbFoN3L2MXk,26
-pycricodecsex-0.0.4.dist-info/METADATA,sha256=z0Ofc7e4w_HYrIORaKSU2PHYeTIb-1bnEFmbEBvX-Vg,1256
-pycricodecsex-0.0.4.dist-info/licenses/LICENSE,sha256=GyZb4dzF2tM3LU5I_tJXpHtUDz8297zeUuCJ5qz8io0,1063
-PyCriCodecsEx/adx.py,sha256=tAEd2A2NbE0BJ_ARAN7gGFkN8XfFmGOSZy7aZpEKRCs,5959
-PyCriCodecsEx/__init__.py,sha256=1mptEzQihbdyqqzMgdns_j5ZGK9gz7hR2bsgA_TnjO4,22
-PyCriCodecsEx/chunk.py,sha256=ZYyeqqcBK6dDDj12YvrhpZDzW0iyOhysRlYuCD3rgQ8,2719
-PyCriCodecsEx/hca.py,sha256=9A6hmL0EBFyrgf-Agr2K039HqX9cJoWr54Jm27XaDqA,19133
-PyCriCodecsEx/cpk.py,sha256=cBZDLowGG7GCSJ8caPbj26t0inYGZ92Iwz_hL0hgOmU,37383
-PyCriCodecsEx/usm.py,sha256=HKX0E33dtqBGZeNg6wZu9HPUj1rlaAVm3Ns9z0tAWxw,36356
-PyCriCodecsEx/acb.py,sha256=Y0Tjq24uUlb0RJfmodxjkezk5BFQP2K3ZcDXNKxBhZg,11250
-PyCriCodecsEx/awb.py,sha256=Y9MOTuW76ZdFEnW2e8MC-Hi9vdHJ7WFBsCRwqdpt3Jg,6231
-PyCriCodecsEx/utf.py,sha256=ORSoyRrgBbdaGP6cQQejWfqkdWz6vEGG_sTo_fbO48Y,27555