dex4java 1.0.0__py3-none-any.whl

dex4java-1.0.0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: dex4java
+Version: 1.0.0
+Summary: A CLI tool to convert Android DEX files into Java JAR packages containing JVM bytecode.
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Assemblers
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# dex4java 🚀
+
+[![PyPI version](https://shields.io)](https://pypi.org)
+[![License: MIT](https://shields.io)](https://opensource.org)
+
+**dex4java** is a lightweight, easy-to-use Command-Line Interface (CLI) tool designed to seamlessly convert Android `.dex` (Dalvik Executable) files into standard Java `.jar` (Java Archive) packages containing valid JVM `.class` bytecode. 
+
+It acts as a modern Python wrapper around proven translation engines, offering a clean syntax for reverse engineers, malware analysts, and Android developers.
+
+---
+
+## ✨ Features
+
+- **Simple CLI Syntax**: No complex arguments, just input and output.
+- **Automated Engine Management**: Automatically downloads and configures the required backend translator on its first run.
+- **Cross-Platform**: Works flawlessly on Windows, Linux, and macOS.
+- **Clean Bytecode Translation**: Produces actual `.class` structures compatible with popular decompilers like JD-GUI or Bytecode Viewer.
+
+---
+
+## 📋 Prerequisites
+
+Before using **dex4java**, please ensure you have the following installed on your system:
+
+1. **Python 3.7+**
+2. **Java (JRE or JDK)**: The underlying translation engine requires Java to be available in your system's PATH.
+
+---
+
+## 🚀 Installation
+
+You can install **dex4java** directly from PyPI:
+
+```bash
+pip install dex4java
+```
+
+---
+
+## 💻 Usage
+
+Once installed, the `dex4java` command becomes available globally in your terminal. Use the following syntax to convert your files:
+
+```bash
+dex4java <input_file.dex> -o <output_file.jar>
+```
+
+### Example:
+
+```bash
+dex4java classes.dex -o classes_output.jar
+```
+
+### Help Command:
+
+To see available arguments and information, run:
+```bash
+dex4java --help
+```
+
+---
+
+## 🛠️ How It Works
+
+1. **Check**: On the first execution, **dex4java** checks for the existence of the translation binaries. If missing, it securely downloads them.
+2. **Translate**: It maps Dalvik opcodes inside the `.dex` file directly into structured Java Virtual Machine (JVM) bytecode instructions.
+3. **Package**: It packs the compiled `.class` files into a single `.jar` archive, ready for analysis or execution.
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

dex4java-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+dex4java.py,sha256=omow4gOSbNhrpmfpuCTDuEaUlgXu4jlTJziZJERvcW0,2636
+dex4java-1.0.0.dist-info/METADATA,sha256=0HSY0Fy7Cg6UtcCApS7G68B-E6Oclz2_rPvAtar3O60,2770
+dex4java-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+dex4java-1.0.0.dist-info/entry_points.txt,sha256=3mfyyVT0WfzEyKtqzxjXgO69IlTtk2NCpdfL1VKLfU8,43
+dex4java-1.0.0.dist-info/top_level.txt,sha256=RQ6v-OOKIO_tHEPA9-Fi7iwaAlTolzzFEn30kNk9GI0,9
+dex4java-1.0.0.dist-info/RECORD,,

dex4java-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dex4java-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dex4java = dex4java:main

dex4java-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dex4java

dex4java.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+import sys
+import argparse
+import os
+import subprocess
+import urllib.request
+import zipfile
+
+ENGINE_URL = "https://github.com"
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+ENGINE_DIR = os.path.join(BASE_DIR, "dex4java_engine")
+
+def download_engine():
+    if os.path.exists(ENGINE_DIR):
+        return
+
+    print("[*] dex4java: Core translation engine is missing, downloading...")
+    zip_path = os.path.join(BASE_DIR, "engine.zip")
+
+    try:
+        urllib.request.urlretrieve(ENGINE_URL, zip_path)
+        with zipfile.ZipFile(zip_path, 'r') as zip_ref:
+            zip_ref.extractall(ENGINE_DIR)
+        os.remove(zip_path)
+        print("[+] dex4java: Engine installed successfully.")
+    except Exception as e:
+        print(f"[-] dex4java Error: Failed to download engine: {e}", file=sys.stderr)
+        sys.exit(1)
+
+def convert_dex_to_jar(dex_path, jar_path):
+    download_engine()
+
+    print(f"[*] dex4java: Converting '{dex_path}' to JVM Bytecode (.class)...")
+
+    subfolders = [d for d in os.listdir(ENGINE_DIR) if os.path.isdir(os.path.join(ENGINE_DIR, d))]
+    if not subfolders:
+        print("[-] dex4java Error: Engine directory is empty or corrupted.", file=sys.stderr)
+        return
+
+    engine_bin = os.path.join(ENGINE_DIR, subfolders[0])
+
+    if os.name == 'nt':
+        cmd_script = os.path.join(engine_bin, "d2j-dex2jar.bat")
+    else:
+        cmd_script = os.path.join(engine_bin, "d2j-dex2jar.sh")
+        subprocess.run(["chmod", "+x", cmd_script], stdout=subprocess.DEVNULL)
+
+    cmd = [cmd_script, dex_path, "-o", jar_path, "--force"]
+
+    try:
+        result = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+        if result.returncode == 0:
+            print(f"[+] dex4java: Success! JAR file created -> {jar_path}")
+        else:
+            print(f"[-] dex4java Error: Conversion failed:\n{result.stderr}", file=sys.stderr)
+    except FileNotFoundError:
+        print("[-] dex4java Error: Java (JRE/JDK) was not found on this system. Please install Java.", file=sys.stderr)
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="dex4java: Convert Android .dex files to standard Java .jar files.",
+        usage="dex4java file_name.dex -o file_name.jar"
+    )
+    parser.add_argument("input_file", help="Path to the input .dex file")
+    parser.add_argument("-o", "--output", required=True, help="Path to the output .jar file")
+
+    args = parser.parse_args()
+    convert_dex_to_jar(args.input_file, args.output)
+
+if __name__ == "__main__":
+    main()