AndroidFridaManager 1.8.6__py3-none-any.whl → 1.8.8__py3-none-any.whl

AndroidFridaManager/FridaManager.py

@@ -80,11 +80,11 @@ class FridaManager():
         Check if ADB is available in the system PATH
         """
         if not shutil.which("adb"):
-            print("Error: ADB (Android Debug Bridge) is not found in your system PATH.")
-            print("Please install Android SDK platform-tools and add it to your PATH:")
-            print("  - Download from: https://developer.android.com/studio/releases/platform-tools")
-            print("  - Or install via package manager (e.g., 'brew install android-platform-tools' on macOS)")
-            print("  - Make sure 'adb' command is accessible from your terminal")
+            self.logger.info("Error: ADB (Android Debug Bridge) is not found in your system PATH.")
+            self.logger.info("Please install Android SDK platform-tools and add it to your PATH:")
+            self.logger.info("  - Download from: https://developer.android.com/studio/releases/platform-tools")
+            self.logger.info("  - Or install via package manager (e.g., 'brew install android-platform-tools' on macOS)")
+            self.logger.info("  - Make sure 'adb' command is accessible from your terminal")
             sys.exit(1)
 
     def run_frida_server(self, frida_server_path="/data/local/tmp/"):
@@ -114,7 +114,7 @@ class FridaManager():
             if process.poll() is not None:
                 stdout, stderr = process.communicate()
                 if "Address already in use" in stderr.decode():
-                    print("[*] frida-server is already running on the device")
+                    self.logger.info("[*] frida-server is already running on the device")
                     return
                 else:
                     self.logger.error(f"Failed to start frida-server: {stderr.decode()}")
@@ -385,9 +385,9 @@ def main():
         if args.is_running:
             afm_obj = FridaManager()
             if afm_obj.is_frida_server_running():
-                print("[*] frida-server is running on Android device")
+                afm_obj.logger.info("[*] frida-server is running on Android device")
             else:
-                print("[*] frida-server is not running on Android device")
+                afm_obj.logger.info("[*] frida-server is not running on Android device")
 
             sys.exit()
 
@@ -398,11 +398,12 @@ def main():
         afm_obj = FridaManager()
 
     afm_obj.install_frida_server()
+    afm_obj.run_frida_server()
     result = afm_obj.is_frida_server_running()
     if result:
-        print("[*] succesfull installed and launched latest frida-server version on Android device")
+        afm_obj.logger.info("[*] succesfull installed and launched latest frida-server version on Android device")
     else:
-        print("[-] unable to run frida-server on Android device")
+        afm_obj.logger.error("[-] unable to run frida-server on Android device")
 
 
 if __name__ == "__main__":

AndroidFridaManager/about.py

@@ -2,4 +2,4 @@
 # -*- coding: utf-8 -*-
 
 __author__ = "Daniel Baier"
-__version__ = "1.8.6"
+__version__ = "1.8.8"

AndroidFridaManager/job.py

@@ -5,6 +5,7 @@
 import threading
 import frida
 import uuid
+import logging
 
 # Define a custom exception for handling frida based exceptions
 class FridaBasedException(Exception):
@@ -21,6 +22,7 @@ class Job:
         self.process_session = process
         self.thread = None
         self.is_script_created = False
+        self.logger = logging.getLogger(__name__)
 
 
     def create_job_script(self):
@@ -45,7 +47,7 @@ class Job:
         self.script.on("message", self.wrap_custom_hooking_handler_with_job_id(self.custom_hooking_handler))
         self.script.load()
         self.state = "running"
-        print("[+] hooks successfully loaded")
+        self.logger.info("[+] hooks successfully loaded")
 
         #if self.is_running_as_thread:
         # Keep the thread alive to handle messages until stop_event is set
@@ -88,7 +90,7 @@ class Job:
         if self.script:
             self.script.unload()
         
-        print(f"Job {self.job_id} stopped")
+        self.logger.info(f"Job {self.job_id} stopped")
 
 
     def get_id(self):

AndroidFridaManager/job_manager.py

@@ -8,6 +8,7 @@ from typing import Optional, Dict, Union
 from .job import Job, FridaBasedException
 import time
 import re
+import logging
 
 class JobManager(object):
     """  A class representing the current Job manager. """
@@ -31,8 +32,24 @@ class JobManager(object):
         self.first_instrumenation_script = None
         self.last_created_job = None
         self.init_last_job = False
+        self.logger = logging.getLogger(__name__)
+        self._ensure_logging_setup()
         atexit.register(self.cleanup)
 
+    def _ensure_logging_setup(self):
+        """
+        Ensure basic logging setup if not already configured.
+        This provides a fallback for when JobManager is used independently.
+        """
+        root_logger = logging.getLogger()
+        if not root_logger.handlers:
+            # Set up basic logging if no handlers exist
+            root_logger.setLevel(logging.INFO)
+            handler = logging.StreamHandler()
+            formatter = logging.Formatter('[%(asctime)s] [%(levelname)-4s] - %(message)s', 
+                                        datefmt='%d-%m-%y %H:%M:%S')
+            handler.setFormatter(formatter)
+            root_logger.addHandler(handler)
 
     def cleanup(self) -> None:
         """
@@ -44,10 +61,10 @@ class JobManager(object):
             :return:
         """
         if len(self.jobs) > 0:
-            print("[*] Program closed. Stopping active jobs...")
+            self.logger.info("[*] Program closed. Stopping active jobs...")
             self.stop_jobs()
 
-        print("\n[*] Have a nice day!")
+        self.logger.info("\n[*] Have a nice day!")
     
 
     def job_list(self):
@@ -62,16 +79,16 @@ class JobManager(object):
     def running_jobs2(self):
         tuple_jobs = [job for job in self.jobs.items()]
         for job_id, job in tuple_jobs:
-            print(f"Job state of Job {job_id} in state {job.state}")
+            self.logger.debug(f"Job state of Job {job_id} in state {job.state}")
         return tuple_jobs
     '''
 
     def spawn(self, target_process):
         self.package_name = target_process
-        print("[*] spawning app: "+ target_process)
+        self.logger.info("[*] spawning app: "+ target_process)
         pid = self.device.spawn(target_process)
         self.process_session = self.device.attach(pid)
-        print(f"Spawned {target_process} with PID {pid}")
+        self.logger.info(f"Spawned {target_process} with PID {pid}")
         return pid
 
 
@@ -128,15 +145,15 @@ class JobManager(object):
         if foreground:
             target_process = self.device.get_frontmost_application()
             if target_process is None or len(target_process.identifier) < 2:
-                print("[-] unable to attach to the frontmost application. Aborting ...")
+                self.logger.error("[-] unable to attach to the frontmost application. Aborting ...")
 
             target_process = target_process.identifier
 
         if isinstance(target_process, int):
-            print(f"[*] attaching to PID: {target_process}")
+            self.logger.info(f"[*] attaching to PID: {target_process}")
             self.process_session = self.device.attach(target_process)
         else:
-            print(f"[*] attaching to app: {target_process}")
+            self.logger.info(f"[*] attaching to app: {target_process}")
             self.process_session = self.device.attach(int(target_process) if target_process.isnumeric() else target_process)
 
              
@@ -163,12 +180,12 @@ class JobManager(object):
                 job = Job(frida_script_name, custom_hooking_handler_name, self.process_session)
                 job.create_job_script()
                 self.init_last_job = True
-                print(f"[*] created job: {job.job_id}")
+                self.logger.info(f"[*] created job: {job.job_id}")
                 self.jobs[job.job_id] = job
                 self.last_created_job = job
 
             else:
-                print("[-] no frida session. Aborting...")
+                self.logger.error("[-] no frida session. Aborting...")
 
         except frida.TransportError as fe:
             raise FridaBasedException(f"Problems while attaching to frida-server: {fe}")
@@ -199,7 +216,7 @@ class JobManager(object):
         try:
             if self.process_session:
                 job = Job(frida_script_name, custom_hooking_handler_name, self.process_session)
-                print(f"[*] created job: {job.job_id}")
+                self.logger.info(f"[*] created job: {job.job_id}")
                 self.jobs[job.job_id] = job
                 self.last_created_job = job
                 job.run_job()
@@ -213,7 +230,7 @@ class JobManager(object):
                 return job
 
             else:
-                print("[-] no frida session. Aborting...")
+                self.logger.error("[-] no frida session. Aborting...")
             
 
         except frida.TransportError as fe:
@@ -233,10 +250,10 @@ class JobManager(object):
         jobs_to_stop = [job_id for job_id, job in self.jobs.items() if job.state == "running"]
         for job_id in jobs_to_stop:
             try:
-                print('[job manager] Job: {0} - Stopping'.format(job_id))
+                self.logger.info('[job manager] Job: {0} - Stopping'.format(job_id))
                 self.stop_job_with_id(job_id)
             except frida.InvalidOperationError:
-                print('[job manager] Job: {0} - An error occurred stopping job. Device may '
+                self.logger.error('[job manager] Job: {0} - An error occurred stopping job. Device may '
                              'no longer be available.'.format(job_id))
     
     
@@ -277,7 +294,7 @@ class JobManager(object):
     def stop_app_with_closing_frida(self, app_package):
         jobs_to_stop = [job_id for job_id, job in self.jobs.items() if job.state == "running"]
         for job_id in jobs_to_stop:
-            print(f"[*] trying to close job: {job_id}")
+            self.logger.info(f"[*] trying to close job: {job_id}")
             self.stop_job_with_id(job_id)
         
         self.detach_from_app()
@@ -298,14 +315,14 @@ class JobManager(object):
 
             # to handle forks
             def on_child_added(child):
-                print(f"Attached to child process with pid {child.pid}")
+                self.logger.info(f"Attached to child process with pid {child.pid}")
                 if callable(self.first_instrumenation_script):
                     self.first_instrumenation_script(device.attach(child.pid))
                 device.resume(child.pid)
 
             # if the target process is starting another process 
             def on_spawn_added(spawn):
-                print(f"Process spawned with pid {spawn.pid}. Name: {spawn.identifier}")
+                self.logger.info(f"Process spawned with pid {spawn.pid}. Name: {spawn.identifier}")
                 if callable(self.first_instrumenation_script):
                     self.first_instrumenation_script(device.attach(spawn.pid))
                 device.resume(spawn.pid)

{androidfridamanager-1.8.6.dist-info → androidfridamanager-1.8.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AndroidFridaManager
-Version: 1.8.6
+Version: 1.8.8
 Summary: A python API in order to install and run the frida-server on an Android device.
 Home-page: https://github.com/fkie-cad/AndroidFridaManager
 Author: Daniel Baier
@@ -33,7 +33,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-![version](https://img.shields.io/badge/version-1.8.6-blue) [![PyPI version](https://badge.fury.io/py/AndroidFridaManager.svg)](https://badge.fury.io/py/AndroidFridaManager) [![Publish status](https://github.com/fkie-cad/friTap/actions/workflows/publish.yml/badge.svg?branch=main)](https://github.com/fkie-cad/AndroidFridaManager/actions/workflows/publish-to-pypi.yml)
+![version](https://img.shields.io/badge/version-1.8.8-blue) [![PyPI version](https://badge.fury.io/py/AndroidFridaManager.svg)](https://badge.fury.io/py/AndroidFridaManager) [![Publish status](https://github.com/fkie-cad/friTap/actions/workflows/publish.yml/badge.svg?branch=main)](https://github.com/fkie-cad/AndroidFridaManager/actions/workflows/publish-to-pypi.yml)
 
 # AndroidFridaManager
 

androidfridamanager-1.8.8.dist-info/RECORD

@@ -0,0 +1,11 @@
+AndroidFridaManager/FridaManager.py,sha256=N00XTg1O0Uj5b5HY7Ir7-PCDhoAYHzGA9p9DU4BTOBA,16268
+AndroidFridaManager/__init__.py,sha256=T6AKtrGSLQ9M5bJoWDQcsRTJbSEbksdgrx3AAAdozRI,171
+AndroidFridaManager/about.py,sha256=2umUwxNgyJgOkE9ed1nVsmszzNOrR4NDigLOIoYcYEE,98
+AndroidFridaManager/job.py,sha256=1NNcfCjkyUtwUkMXSgT4uswA8UStHo3jxbeJwJoWhc8,3352
+AndroidFridaManager/job_manager.py,sha256=E4lNe4E9mvLcWdYCn2z-Rh4_b9fA_Fzv3LOqWE_bsvQ,13264
+androidfridamanager-1.8.8.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+androidfridamanager-1.8.8.dist-info/METADATA,sha256=l5nMXSymNGbEn-MdzZ_8YL7528fFMT6p_rIQ0aiQsbo,5141
+androidfridamanager-1.8.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+androidfridamanager-1.8.8.dist-info/entry_points.txt,sha256=GmNngu2fDNCxUcquFRegBa7GWknPKG1jsM4lvWeyKnY,64
+androidfridamanager-1.8.8.dist-info/top_level.txt,sha256=oH2lVMSRlghmt-_tVrOEUqvY462P9hd5Ktgp5-1qF3o,20
+androidfridamanager-1.8.8.dist-info/RECORD,,

androidfridamanager-1.8.6.dist-info/RECORD

@@ -1,11 +0,0 @@
-AndroidFridaManager/FridaManager.py,sha256=ObPXR4vyyWR6rbvUU4c47fKmBBl1H3JPhSIbWQDNWfw,16114
-AndroidFridaManager/__init__.py,sha256=T6AKtrGSLQ9M5bJoWDQcsRTJbSEbksdgrx3AAAdozRI,171
-AndroidFridaManager/about.py,sha256=9l-wC6pQl7DaMefzQMAlccC5Di5RnLe7VtmITEpG6T4,98
-AndroidFridaManager/job.py,sha256=QTSNjdV7XqawSTV19HQt53aiwoT3UaQeQw2K4AWPxY8,3265
-AndroidFridaManager/job_manager.py,sha256=icdNlfqorEM3XVw4h_83IcoupEFDlkzb29VhEZ6dxrQ,12294
-androidfridamanager-1.8.6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-androidfridamanager-1.8.6.dist-info/METADATA,sha256=RRh7PdeZr2utjTUCBHBTBFawd5bcGELHBOLUaOXE5XI,5141
-androidfridamanager-1.8.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-androidfridamanager-1.8.6.dist-info/entry_points.txt,sha256=GmNngu2fDNCxUcquFRegBa7GWknPKG1jsM4lvWeyKnY,64
-androidfridamanager-1.8.6.dist-info/top_level.txt,sha256=oH2lVMSRlghmt-_tVrOEUqvY462P9hd5Ktgp5-1qF3o,20
-androidfridamanager-1.8.6.dist-info/RECORD,,