Metadata-Version: 2.4
Name: androj
Version: 0.1.1
Summary: Export Android Java and XML practical examples
Author: Andro contributors
License: MIT
Keywords: android,java,xml,practical,intent,sqlite
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# androj

`androj` is a small Python package that exports Android Java/XML practical source examples into your current working directory.

> This package does not build or run Android apps. It copies the bundled source snippets so you can open them in Android Studio and adapt them to your project.

## Install

```bash
pip install androj
```

## Usage

```python
import androj

androj.help()       # list all available functions
androj.alarm()      # export alarm example
androj.airplane()   # export Airplane Mode receiver example
androj.sms_email_call()
```

Each function creates a folder under:

```text
./andro_examples/<example-name>/
```

For example, `androj.alarm()` exports the files to `andro_examples/alarm/` and returns that folder's `pathlib.Path`.

## Available functions

- `androj.airplane()`
- `androj.alarm()`
- `androj.alert()`
- `androj.battery_low()`
- `androj.context_menu()`
- `androj.date_time()`
- `androj.explicit_intents()`
- `androj.library_database()`
- `androj.listview_gridview()`
- `androj.options_menu()`
- `androj.radio_checkbox()`
- `androj.sms_email_call()`
- `androj.two_activities()`

## Important

The package includes the source snippets supplied for these practicals. Some examples do not include every Android resource (for example, every layout XML or Gradle file). You may need to create missing resources, update package names, and adjust theme/manifest entries in Android Studio.

The exported files are source code, not executable Python modules.
