re1sid-lib 0.1.0__tar.gz → 0.1.2__tar.gz

re1sid_lib-0.1.2/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.3
+Name: re1sid-lib
+Version: 0.1.2
+Summary: Add your description here
+Author: 09u2h4n
+Author-email: 09u2h4n <09u2h4n.y1lm42@gmail.com>
+License: Apache-2.0 license
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: lxml>=6.1.1
+Requires-Dist: pyaxmlparser>=0.3.31
+Requires-Python: >=3.12
+Project-URL: homepage, https://github.com/09u2h4n/re1sid-lib
+Project-URL: repository, https://github.com/09u2h4n/re1sid-lib
+Project-URL: documentation, https://github.com/09u2h4n/re1sid-lib#readme
+Description-Content-Type: text/markdown
+
+# re1sid-lib
+
+A small Python library for working with ReVanced CLI and patch bundles. It provides helpers to download required ReVanced assets and to patch APK files programmatically.
+
+## Features
+
+- Download the latest ReVanced CLI jar and patches.rvp bundle.
+- List available patches and options using ReVanced CLI output parsing.
+- Patch APK files with enabled/disabled patches and patch options.
+- Preserve multi-line descriptions and compatibility metadata.
+
+## Requirements
+
+- Python 3.9+
+- Java runtime installed and available in `PATH`
+- Python packages:
+  - `httpx`
+  - `lxml`
+  - `pyaxmlparser`
+
+## Installation
+
+1. Clone the repository.
+2. Install Python dependencies:
+
+```bash
+pip install httpx lxml pyaxmlparser
+```
+
+3. Configure paths in `src/re1sid_lib/common.py`:
+
+```python
+PATCHES_PATH = ".revanced_res/patches.rvp"
+CLI_PATH = ".revanced_res/revanced-cli.jar"
+```
+
+## Usage
+
+### Download ReVanced assets
+
+Use the downloader helper to fetch the latest CLI jar and patches bundle.
+
+```python
+from re1sid_lib.downloader import Downloader
+
+downloader = Downloader()
+downloader.download_all()
+```
+
+Or download individual assets:
+
+```python
+from re1sid_lib.downloader import Downloader
+
+downloader = Downloader()
+downloader.download_cli()
+downloader.download_patches_rvp()
+```
+
+### List patches
+
+Use the patcher helper to parse the patch list and inspect options.
+
+```python
+from re1sid_lib.patcher import Patcher
+
+patcher = Patcher()
+patches = patcher.list_patches(package_name="com.spotify.music")
+for patch in patches:
+    print(patch["Name"], patch["Enabled"])
+```
+
+### Patch an APK
+
+Patch an APK file with specific enabled/disabled patches and options.
+
+```python
+from re1sid_lib.patcher import Patcher
+
+patcher = Patcher()
+output = patcher.patch_apk(
+    apk_path="input.apk",
+    output_path="patched.apk",
+    enabled_patches=["remove-ads", 12],
+    disabled_patches=["log-timestamp"],
+    options={"theme": "dark", "ads": False},
+    exclusive=False,
+    force=True,
+    bypass_verification=True,
+    purge=True,
+)
+print(output)
+```
+
+## Notes
+
+- `Downloader.download_all()` removes the `.revanced_res` directory before downloading fresh assets.
+- `Patcher.list_patches()` can also accept an APK path and will read its package name automatically.
+- The library expects the ReVanced CLI jar and patches bundle to exist at the configured paths.
+
+## Project structure
+
+- `src/re1sid_lib/downloader.py` - Download helper for ReVanced CLI and patches.
+- `src/re1sid_lib/patcher.py` - Patch helper and CLI output parser.
+- `src/re1sid_lib/common.py` - Common path configuration.
+
+## License
+
+Use this project according to the appropriate license terms for ReVanced and its dependencies.

re1sid_lib-0.1.2/README.md

@@ -0,0 +1,109 @@
+# re1sid-lib
+
+A small Python library for working with ReVanced CLI and patch bundles. It provides helpers to download required ReVanced assets and to patch APK files programmatically.
+
+## Features
+
+- Download the latest ReVanced CLI jar and patches.rvp bundle.
+- List available patches and options using ReVanced CLI output parsing.
+- Patch APK files with enabled/disabled patches and patch options.
+- Preserve multi-line descriptions and compatibility metadata.
+
+## Requirements
+
+- Python 3.9+
+- Java runtime installed and available in `PATH`
+- Python packages:
+  - `httpx`
+  - `lxml`
+  - `pyaxmlparser`
+
+## Installation
+
+1. Clone the repository.
+2. Install Python dependencies:
+
+```bash
+pip install httpx lxml pyaxmlparser
+```
+
+3. Configure paths in `src/re1sid_lib/common.py`:
+
+```python
+PATCHES_PATH = ".revanced_res/patches.rvp"
+CLI_PATH = ".revanced_res/revanced-cli.jar"
+```
+
+## Usage
+
+### Download ReVanced assets
+
+Use the downloader helper to fetch the latest CLI jar and patches bundle.
+
+```python
+from re1sid_lib.downloader import Downloader
+
+downloader = Downloader()
+downloader.download_all()
+```
+
+Or download individual assets:
+
+```python
+from re1sid_lib.downloader import Downloader
+
+downloader = Downloader()
+downloader.download_cli()
+downloader.download_patches_rvp()
+```
+
+### List patches
+
+Use the patcher helper to parse the patch list and inspect options.
+
+```python
+from re1sid_lib.patcher import Patcher
+
+patcher = Patcher()
+patches = patcher.list_patches(package_name="com.spotify.music")
+for patch in patches:
+    print(patch["Name"], patch["Enabled"])
+```
+
+### Patch an APK
+
+Patch an APK file with specific enabled/disabled patches and options.
+
+```python
+from re1sid_lib.patcher import Patcher
+
+patcher = Patcher()
+output = patcher.patch_apk(
+    apk_path="input.apk",
+    output_path="patched.apk",
+    enabled_patches=["remove-ads", 12],
+    disabled_patches=["log-timestamp"],
+    options={"theme": "dark", "ads": False},
+    exclusive=False,
+    force=True,
+    bypass_verification=True,
+    purge=True,
+)
+print(output)
+```
+
+## Notes
+
+- `Downloader.download_all()` removes the `.revanced_res` directory before downloading fresh assets.
+- `Patcher.list_patches()` can also accept an APK path and will read its package name automatically.
+- The library expects the ReVanced CLI jar and patches bundle to exist at the configured paths.
+
+## Project structure
+
+- `src/re1sid_lib/downloader.py` - Download helper for ReVanced CLI and patches.
+- `src/re1sid_lib/patcher.py` - Patch helper and CLI output parser.
+- `src/re1sid_lib/common.py` - Common path configuration.
+
+## License
+
+Use this project according to the appropriate license terms for ReVanced and its dependencies.

{re1sid_lib-0.1.0 → re1sid_lib-0.1.2}/pyproject.toml

@@ -1,8 +1,9 @@
 [project]
 name = "re1sid-lib"
-version = "0.1.0"
+version = "0.1.2"
 description = "Add your description here"
 readme = "README.md"
+license = { text = "Apache-2.0 license" }
 authors = [
     { name = "09u2h4n", email = "09u2h4n.y1lm42@gmail.com" }
 ]
@@ -12,6 +13,7 @@ dependencies = [
     "lxml>=6.1.1",
     "pyaxmlparser>=0.3.31",
 ]
+urls = { homepage = "https://github.com/09u2h4n/re1sid-lib", repository = "https://github.com/09u2h4n/re1sid-lib", documentation = "https://github.com/09u2h4n/re1sid-lib#readme" }
 
 [project.scripts]
 re1sid-lib = "re1sid_lib:main"

re1sid_lib-0.1.0/PKG-INFO

@@ -1,12 +0,0 @@
-Metadata-Version: 2.3
-Name: re1sid-lib
-Version: 0.1.0
-Summary: Add your description here
-Author: 09u2h4n
-Author-email: 09u2h4n <09u2h4n.y1lm42@gmail.com>
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: lxml>=6.1.1
-Requires-Dist: pyaxmlparser>=0.3.31
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-