androj 0.1.0__py3-none-any.whl

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

androj/examples/context_menu/MainActivity.java

@@ -0,0 +1,54 @@
+package com.example.contextmenuapp;
+
+import android.os.Bundle;
+import android.view.ContextMenu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.LinearLayout;
+
+import androidx.appcompat.app.AppCompatActivity;
+
+public class MainActivity extends AppCompatActivity {
+
+    LinearLayout layout;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        layout = findViewById(R.id.layout);
+
+        registerForContextMenu(layout);
+    }
+
+    @Override
+    public void onCreateContextMenu(ContextMenu menu, View v,
+                                    ContextMenu.ContextMenuInfo menuInfo) {
+        super.onCreateContextMenu(menu, v, menuInfo);
+
+        menu.setHeaderTitle("Choose Background Color");
+
+        menu.add(0, 1, 0, "Red");
+        menu.add(0, 2, 1, "Green");
+        menu.add(0, 3, 2, "Blue");
+    }
+
+    @Override
+    public boolean onContextItemSelected(MenuItem item) {
+        int id = item.getItemId();
+
+        if (id == 1) {
+            layout.setBackgroundColor(android.graphics.Color.RED);
+            return true;
+        } else if (id == 2) {
+            layout.setBackgroundColor(android.graphics.Color.GREEN);
+            return true;
+        } else if (id == 3) {
+            layout.setBackgroundColor(android.graphics.Color.BLUE);
+            return true;
+        }
+
+        return super.onContextItemSelected(item);
+    }
+}

androj/examples/context_menu/activity_main.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:id="@+id/layout"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:gravity="center">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Long press to change color"
+        android:textSize="22sp" />
+
+</LinearLayout>

androj/examples/date_time/FILES.txt

@@ -0,0 +1,6 @@
+Example: Date Time
+
+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/examples/date_time/MainActivity.java

@@ -0,0 +1,42 @@
+package com.example.dateapp;
+
+import android.os.Bundle;
+import android.widget.TextView;
+
+import androidx.activity.EdgeToEdge;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+
+public class MainActivity extends AppCompatActivity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        EdgeToEdge.enable(this);
+        setContentView(R.layout.activity_main);
+        TextView tv1=findViewById(R.id.tv2);
+        TextView tv2=findViewById(R.id.tv3);
+        TextView tv3=findViewById(R.id.tv4);
+        TextView tv4=findViewById(R.id.tv5);
+        TextView tv5=findViewById(R.id.tv6);
+
+        Date cur=new Date();
+
+        SimpleDateFormat f1=new SimpleDateFormat("dd/MM/yyyy", Locale.getDefault());
+        SimpleDateFormat f2=new SimpleDateFormat("EEE, MMMM dd,yyyy", Locale.getDefault());
+        SimpleDateFormat f3=new SimpleDateFormat("hh:mm:ss: a", Locale.getDefault());
+        SimpleDateFormat f4=new SimpleDateFormat("HH:mm:ss", Locale.getDefault());
+
+        tv1.setText(f1.format(cur));
+        tv2.setText(f2.format(cur));
+        tv3.setText(f3.format(cur));
+        tv4.setText(f4.format(cur));
+
+    }
+}

androj/examples/explicit_intents/ConfirmActivity.java

@@ -0,0 +1,37 @@
+package com.example.intentapp;
+
+import android.content.Intent;
+import android.os.Bundle;
+import android.widget.TextView;
+
+import androidx.activity.EdgeToEdge;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+
+public class ConfirmActivity extends AppCompatActivity {
+
+    TextView tvConfirmation;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_confirm);
+
+        tvConfirmation = findViewById(R.id.tvConfirmation);
+
+        Intent intent = getIntent();
+
+        String name = intent.getStringExtra("name");
+        String course = intent.getStringExtra("course");
+        String facilities = intent.getStringExtra("facilities");
+
+        tvConfirmation.setText(
+                "Registration Successful!\n\n"
+                        + "Name: " + name
+                        + "\nCourse: " + course
+                        + "\nFacilities: " + facilities
+        );
+    }
+}