Pywayne ADB Logcat Reader

This module provides real-time Android device log reading capabilities via the adb logcat command.

Quick Start

from pywayne.adb.logcat_reader import AdbLogcatReader

# Create reader (default C++ backend)
reader = AdbLogcatReader()

# Start log capture and read
reader.start()
for line in reader.read():
    print(line)

Use Python backend (alternative)

reader = AdbLogcatReader(backend='python')

reader.start()

for line in reader.read():

print(line)

# Stop and cleanup
reader.stop()

Initialization

# C++ backend (default, faster)
reader = AdbLogcatReader()

# Python backend (alternative, may be more compatible)
reader = AdbLogcatReader(backend='python')

Reading Logs

The read() method yields log lines incrementally as a generator, suitable for processing large logs or real-time monitoring.

# Process logs as they arrive
for line in reader.read():
    # Filter, parse, store...

Properties

Methods

Backends

C++ Backend (Default)

• Uses native C++ implementation
• Faster performance for real-time streaming
• Better compatibility with adb logcat

Python Backend (Alternative)

• Uses Python subprocess to call adb
• More compatible across different environments
• Easier debugging and integration

Notes

• C++ backend is faster and recommended for production
• Python backend may be useful during development
• stop() terminates adb logcat; use Ctrl+C to send interrupt signal
• Logs are cleared automatically when process stops