Pywayne ADB Logcat Reader

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

Quick Start

python

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)

code


# Stop and cleanup
reader.stop()

Initialization

python

# 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.

python

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

Properties

Property	Description
`backend`	'cpp' or 'python'
`running`	Whether logcat process is running

Methods

Method	Description
`start()`	Start adb logcat process
`read()`	Generator yielding log lines
`stop()`	Stop logcat process
`get_backend()`	Get active backend type

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