pyaxmlparser

0.3.31 verified Mon Apr 27 auth: no python

Python3 parser for Android binary XML files (e.g., AndroidManifest.xml). Provides easy extraction of application name, package, permissions, and other manifest attributes without relying on Androguard. Active development on GitHub by Appknox.

pip install pyaxmlparser

Common errors

error ModuleNotFoundError: No module named 'pyaxmlparser' ↓

cause Library not installed in the current Python environment.

fix

Run: pip install pyaxmlparser

error FileNotFoundError: [Errno 2] No such file or directory: 'sample.apk' ↓

cause Incorrect path or missing file; pyaxmlparser does not download or validate the APK automatically.

fix

Provide the absolute or correct relative path to the APK file.

error AttributeError: 'NoneType' object has no attribute 'get' ↓

cause APK object's 'application' property is None because the manifest lacks an <application> tag.

fix

Check if apk.application is not None before accessing methods on it.

error zipfile.BadZipFile: File is not a zip file ↓

cause The provided file is not a valid APK/Zip archive.

fix

Ensure the file is a genuine APK (ZIP format).

Warnings

gotcha APK file path must be valid; the library does not provide detailed error messages for malformed APKs. ↓

fix Ensure the APK file is not corrupted and is a valid ZIP archive.

gotcha pyaxmlparser is not thread-safe; do not share AXMLParser instances across threads without locks. ↓

fix Use separate instances or protect with threading.Lock.

gotcha The library may raise 'SystemError: unknown type' on certain edge-case XML nodes. This is not a user error but a parser limitation. ↓

fix Wrap parsing in a try/except block or use an alternative like androguard for complex files.

gotcha APK object properties (e.g., .application) may return None if the manifest is missing expected tags. ↓

fix Always check for None before accessing nested attributes.

Imports

AXMLParser
```
from pyaxmlparser import AXMLParser
```
Main class for parsing Android binary XML files.
APK
```
from pyaxmlparser import APK
```
High-level APK representation, parses manifest, resources, and dex.

Quickstart

Open an APK file and extract basic info: package name, application label, and permissions.

from pyaxmlparser import APK

apk = APK('sample.apk')
print(apk.package)
print(apk.application)
print(apk.permissions)