androj 0.1.0__tar.gz

androj-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 andro contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

androj-0.1.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: androj
+Version: 0.1.0
+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.

androj-0.1.0/README.md

@@ -0,0 +1,52 @@
+# 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.

androj-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "androj"
+version = "0.1.0"
+description = "Export Android Java and XML practical examples"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "Andro contributors"}]
+keywords = ["android", "java", "xml", "practical", "intent", "sqlite"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+  "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+androj = ["examples/**/*"]

androj-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

androj-0.1.0/src/androj/__init__.py

@@ -0,0 +1,82 @@
+"""
+androj: Export Android Java/XML practical examples into your current project folder.
+
+Each public example function creates:
+    ./andro_examples/<example-name>/
+
+and copies the matching Java/XML source files there.
+"""
+
+from pathlib import Path
+from shutil import copy2
+from importlib.resources import files
+
+__version__ = "0.1.0"
+
+_EXAMPLES = {
+    "airplane": "Listen for the Airplane Mode changed system broadcast.",
+    "alarm": "Basic AlarmManager and BroadcastReceiver example.",
+    "alert": "AlertDialog example.",
+    "battery_low": "Listen for the system battery-low broadcast.",
+    "context_menu": "Context menu example for changing a background color.",
+    "date_time": "Display date and time in different formats.",
+    "explicit_intents": "Three-activity example using explicit intents and extras.",
+    "library_database": "SQLite library-management example.",
+    "listview_gridview": "SQLite product list using ListView and GridView.",
+    "options_menu": "Options menu example.",
+    "radio_checkbox": "RadioButton and CheckBox example.",
+    "sms_email_call": "Implicit intents for SMS, email, and phone dialer.",
+    "two_activities": "Navigate between two activities using an explicit intent.",
+}
+
+def _export_example(name: str) -> Path:
+    """Copy one example's bundled source files into ./andro_examples/<name>/."""
+    if name not in _EXAMPLES:
+        raise ValueError(f"Unknown example: {name}")
+
+    destination = Path.cwd() / "andro_examples" / name
+    destination.mkdir(parents=True, exist_ok=True)
+
+    source_folder = files("androj").joinpath("examples", name)
+    for item in source_folder.iterdir():
+        if item.is_file():
+            with item.open("rb") as source, (destination / item.name).open("wb") as target:
+                target.write(source.read())
+
+    print(f"Downloaded/exported '{name}' example to: {destination}")
+    return destination
+
+def help() -> str:
+    """Print the available androj functions and return the same help text."""
+    lines = [
+        "androj - Android practical source exporter",
+        "",
+        "Available functions:",
+    ]
+    for name, description in _EXAMPLES.items():
+        lines.append(f"  androj.{name}()")
+        lines.append(f"      {description}")
+    lines += [
+        "",
+        "Each function exports its source files to:",
+        "  ./andro_examples/<example-name>/",
+    ]
+    message = "\n".join(lines)
+    print(message)
+    return message
+
+def airplane(): return _export_example("airplane")
+def alarm(): return _export_example("alarm")
+def alert(): return _export_example("alert")
+def battery_low(): return _export_example("battery_low")
+def context_menu(): return _export_example("context_menu")
+def date_time(): return _export_example("date_time")
+def explicit_intents(): return _export_example("explicit_intents")
+def library_database(): return _export_example("library_database")
+def listview_gridview(): return _export_example("listview_gridview")
+def options_menu(): return _export_example("options_menu")
+def radio_checkbox(): return _export_example("radio_checkbox")
+def sms_email_call(): return _export_example("sms_email_call")
+def two_activities(): return _export_example("two_activities")
+
+__all__ = ["help", *_EXAMPLES.keys()]

androj-0.1.0/src/androj/examples/airplane/AirplaneModeReceiver.java

@@ -0,0 +1,29 @@
+package com.example.myapp; // Keep your own package name
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.widget.Toast;
+
+public class AirplaneModeReceiver extends BroadcastReceiver {
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+
+        if (Intent.ACTION_AIRPLANE_MODE_CHANGED.equals(intent.getAction())) {
+
+            boolean isAirplaneModeOn =
+                    intent.getBooleanExtra("state", false);
+
+            String message;
+
+            if (isAirplaneModeOn) {
+                message = "Airplane Mode is ON";
+            } else {
+                message = "Airplane Mode is OFF";
+            }
+
+            Toast.makeText(context, message, Toast.LENGTH_LONG).show();
+        }
+    }
+}

androj-0.1.0/src/androj/examples/airplane/AndroidManifest.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="true"
+        android:label="Airplane Mode App"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.MyApplication">
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+
+        </activity>
+
+    </application>
+
+</manifest>

androj-0.1.0/src/androj/examples/airplane/FILES.txt

@@ -0,0 +1,8 @@
+Example: Airplane
+
+Files included:
+- MainActivity.java
+- AirplaneModeReceiver.java
+- AndroidManifest.xml
+
+These are the source snippets supplied for this example. You may need to add or adapt layout resources, package names, theme names, and manifest entries in Android Studio.

androj-0.1.0/src/androj/examples/airplane/MainActivity.java

@@ -0,0 +1,35 @@
+package com.example.myapp; // Keep your own package name
+
+import android.content.IntentFilter;
+import android.os.Bundle;
+import android.widget.TextView;
+
+import androidx.appcompat.app.AppCompatActivity;
+
+public class MainActivity extends AppCompatActivity {
+
+    TextView tvStatus;
+    AirplaneModeReceiver receiver;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        tvStatus = findViewById(R.id.tvStatus);
+        receiver = new AirplaneModeReceiver();
+
+        IntentFilter filter =
+                new IntentFilter("android.intent.action.AIRPLANE_MODE");
+
+        registerReceiver(receiver, filter);
+
+        tvStatus.setText("Receiver registered. Change Airplane Mode to test.");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        unregisterReceiver(receiver);
+    }
+}

androj-0.1.0/src/androj/examples/alarm/AlarmReceiver.java

@@ -0,0 +1,15 @@
+package com.example.myapp; // Keep your own package name
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.widget.Toast;
+
+public class AlarmReceiver extends BroadcastReceiver {
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        Toast.makeText(context, "Alarm! Time to wake up!", 
+                Toast.LENGTH_LONG).show();
+    }
+}

androj-0.1.0/src/androj/examples/alarm/AndroidManifest.xml

@@ -0,0 +1,29 @@
+<uses-permission
+        android:name="android.permission.SCHEDULE_EXACT_ALARM" />
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="Alarm Clock"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.MyApplication">
+
+        <receiver
+            android:name=".AlarmReceiver"
+            android:enabled="true"
+            android:exported="false" />
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+
+        </activity>
+
+    </application>

androj-0.1.0/src/androj/examples/alarm/FILES.txt

@@ -0,0 +1,8 @@
+Example: Alarm
+
+Files included:
+- MainActivity.java
+- AlarmReceiver.java
+- AndroidManifest.xml
+
+These are the source snippets supplied for this example. You may need to add or adapt layout resources, package names, theme names, and manifest entries in Android Studio.

androj-0.1.0/src/androj/examples/alarm/MainActivity.java

@@ -0,0 +1,76 @@
+package com.example.myapp;
+
+import android.app.AlarmManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+import android.widget.Button;
+import android.widget.TimePicker;
+import android.widget.Toast;
+
+import androidx.appcompat.app.AppCompatActivity;
+
+import java.util.Calendar;
+
+public class MainActivity extends AppCompatActivity {
+
+    TimePicker timePicker;
+    Button btnSetAlarm, btnCancelAlarm;
+    AlarmManager alarmManager;
+    PendingIntent pendingIntent;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        timePicker = findViewById(R.id.timePicker);
+        btnSetAlarm = findViewById(R.id.btnSetAlarm);
+        btnCancelAlarm = findViewById(R.id.btnCancelAlarm);
+
+        alarmManager = (AlarmManager) getSystemService(Context.ALARM_SERVICE);
+
+        Intent intent = new Intent(this, AlarmReceiver.class);
+
+        pendingIntent = PendingIntent.getBroadcast(
+                this,
+                0,
+                intent,
+                PendingIntent.FLAG_UPDATE_CURRENT |
+                        PendingIntent.FLAG_IMMUTABLE
+        );
+
+        btnSetAlarm.setOnClickListener(v -> setAlarm());
+
+        btnCancelAlarm.setOnClickListener(v -> cancelAlarm());
+    }
+
+    private void setAlarm() {
+        int hour = timePicker.getHour();
+        int minute = timePicker.getMinute();
+
+        Calendar calendar = Calendar.getInstance();
+        calendar.set(Calendar.HOUR_OF_DAY, hour);
+        calendar.set(Calendar.MINUTE, minute);
+        calendar.set(Calendar.SECOND, 0);
+
+        // If the selected time has already passed, schedule it for tomorrow
+        if (calendar.getTimeInMillis() <= System.currentTimeMillis()) {
+            calendar.add(Calendar.DAY_OF_YEAR, 1);
+        }
+
+        alarmManager.setExact(
+                AlarmManager.RTC_WAKEUP,
+                calendar.getTimeInMillis(),
+                pendingIntent
+        );
+
+        Toast.makeText(this, "Alarm set!", Toast.LENGTH_SHORT).show();
+    }
+
+    private void cancelAlarm() {
+        alarmManager.cancel(pendingIntent);
+        Toast.makeText(this, "Alarm cancelled", Toast.LENGTH_SHORT).show();
+    }
+}

androj-0.1.0/src/androj/examples/alert/FILES.txt

@@ -0,0 +1,6 @@
+Example: Alert
+
+Files included:
+- MainActivity.java
+
+These are the source snippets supplied for this example. You may need to add or adapt layout resources, package names, theme names, and manifest entries in Android Studio.

androj-0.1.0/src/androj/examples/alert/MainActivity.java

@@ -0,0 +1,48 @@
+package com.example.alertapp;
+
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.Toast;
+
+import androidx.activity.EdgeToEdge;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+
+public class MainActivity extends AppCompatActivity {
+    Button btn;
+    EditText et;
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        EdgeToEdge.enable(this);
+        setContentView(R.layout.activity_main);
+        btn=findViewById(R.id.btn);
+        et=findViewById(R.id.et);
+        btn.setOnClickListener(v -> showAlert());
+
+    }
+    public void showAlert() {
+        String st = et.getText().toString();
+        AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
+
+        builder.setTitle("Alert");
+        builder.setMessage(st);
+
+        builder.setPositiveButton("Yes", (dialog, which) -> {
+            Toast.makeText(MainActivity.this,
+                    "You clicked Yes", Toast.LENGTH_SHORT).show();
+        });
+
+        builder.setNegativeButton("No", (dialog, which) -> {
+            Toast.makeText(MainActivity.this,
+                    "You clicked No", Toast.LENGTH_SHORT).show();
+        });
+
+        builder.show();
+    }
+}

androj-0.1.0/src/androj/examples/battery_low/AndroidManifest.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="true"
+        android:label="Battery Low App"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.MyApplication">
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+
+        </activity>
+
+    </application>
+
+</manifest>

androj-0.1.0/src/androj/examples/battery_low/BatteryLowReceiver.java

@@ -0,0 +1,21 @@
+package com.example.myapp; // Keep your own package name
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.widget.Toast;
+
+public class BatteryLowReceiver extends BroadcastReceiver {
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+
+        if (Intent.ACTION_BATTERY_LOW.equals(intent.getAction())) {
+            Toast.makeText(
+                    context,
+                    "Battery is low!",
+                    Toast.LENGTH_LONG
+            ).show();
+        }
+    }
+}

androj-0.1.0/src/androj/examples/battery_low/FILES.txt

@@ -0,0 +1,8 @@
+Example: Battery Low
+
+Files included:
+- MainActivity.java
+- BatteryLowReceiver.java
+- AndroidManifest.xml
+
+These are the source snippets supplied for this example. You may need to add or adapt layout resources, package names, theme names, and manifest entries in Android Studio.

androj-0.1.0/src/androj/examples/battery_low/MainActivity.java

@@ -0,0 +1,36 @@
+package com.example.myapp; // Keep your own package name
+
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.os.Bundle;
+import android.widget.TextView;
+
+import androidx.appcompat.app.AppCompatActivity;
+
+public class MainActivity extends AppCompatActivity {
+
+    TextView tvStatus;
+    BatteryLowReceiver receiver;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        tvStatus = findViewById(R.id.tvStatus);
+        receiver = new BatteryLowReceiver();
+
+        IntentFilter filter =
+                new IntentFilter(Intent.ACTION_BATTERY_LOW);
+
+        registerReceiver(receiver, filter);
+
+        tvStatus.setText("Receiver registered. Waiting for low battery...");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        unregisterReceiver(receiver);
+    }
+}

androj-0.1.0/src/androj/examples/context_menu/FILES.txt

@@ -0,0 +1,7 @@
+Example: Context Menu
+
+Files included:
+- MainActivity.java
+- activity_main.xml
+
+These are the source snippets supplied for this example. You may need to add or adapt layout resources, package names, theme names, and manifest entries in Android Studio.