Metadata-Version: 2.4
Name: bonboneka
Version: 0.1.65
Summary: Bundle HTML/CSS/JS into an Android WebView app
Home-page: https://github.com/yourusername/bonboneka
Author: Brickboss
Author-email: "robert19066(Brickboss)" <andronic.robert12@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/robert19066/Bonboneka
Project-URL: Bug Reports, https://github.com/robert19066/Bonboneka/issues
Project-URL: Source Code, https://github.com/robert19066/Bonboneka
Keywords: android,webview,app,builder,html,css,javascript
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=10.0.0
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

[![20260310-2134-Image-Generation-simple-compose-01kkckwg2fe99angdtynps6sv9.png](https://i.postimg.cc/8PsQC0NB/20260310-2134-Image-Generation-simple-compose-01kkckwg2fe99angdtynps6sv9.png)](https://postimg.cc/SJ0tTVXJ)
# 🍬 Bonboneka (bomk)

Bonboneka allows you to bundle your HTML, CSS, and JS assets into a native Android WebView app with a single command(yea its that cool). 
Why did i do this? Because its REALLY hard to convert a website into an (android) app, and i wanted to make it easier for everyone.(yeah its really straightforward), JUST 1 COMMAND.

# Features
- **Automatic Inlining**: Converts external CSS and JS into a single, self-contained HTML file.
- **Asset Encoding**: Automatically converts images into Base64 data URIs.
- **Multi-Bundle Support**: Define multiple entry points and bundles using a simple naming convention.

# Requirements
- Python: 3.10+
- Git(of course you need git)
- Android SDK + Java: Necessary for...I don't know, BUILDING THE APP?!

# 🛠 Installation

There are 2 ways to install:
- 1. **[RECOMANDED]** Running `pip install bonboneka`, as it's avabile on PiPy
- 2. Dowloading the latest release and running `pip install -e .`


# Usage
```bash
bomk create <path/to/folder> [options]
```
### Options
- `/s`	Silent mode: Suppress all terminal output.
- `/verbose`	Verbose mode: Show detailed build logs.
- `-o <dir>`	Output: Specify the directory for the generated APK.
- `--icon <path>`   Icon: Set a custom icon for the app.

# File Naming Convention

To define which bundle a file belongs to, tag the filename with _$<N> before the extension.

Example Structure:
```plaintext

my_app/
├── index_$1.html          ← Main entry point (Group 1)
├── styles_$1.css          ← Styles for Group 1
├── script_$1.js           ← Logic for Group 1
├── start_$2.html          ← Secondary page (Group 2)
├── styleofstart_$2.css    ← Styles for Group 2
└── backend_$2.js          ← Logic for Group 2
```

### NOTE!
Group $1 is always treated as the app's primary entry point.
All assets in a group are bundled into one self-contained HTML file.
----
# ⚙️ Configuration
Customize your build environment by editing bomk/config.py:
```python
# The repository used as the Android project scaffold
TEMPLATE_REPO      = "https://github.com/YourUser/Example-Android-WV-App.git"
# Relative paths within the template
ASSETS_REL_PATH    = "app/src/main/assets"
MAIN_JAVA_REL_PATH = "app/src/main/java/exampleWV/app/Main.java"
```

# 🌐 Encased Mode
#### Bonboneka can create a wrapper for an website
```bash
bomk create --encased <url> [options]
```
#### Example:
```bash
bomk create --encased https://example.com -o ./dist /verbose
```
Bonboneka will:
- Generate an html file
- Take the url
- Add an `iframe`
- Add the website to the `iframe`
- Generate a WebView Android project
- Build the APK automatically

# `bomk doctor` - Troubleshooting advisor
The `bomk doctor` command will troubleshoot any **valid** Bonboneka projects.
Usage:
```bash
bomk doctor <path-to-project>
```
This command will check for common issues such as:
- Missing or misnamed files
- Incorrect file naming conventions
- etc etc.

# **[BETA]** Gitlink
Gitlink is a feature that lets you link a template to an existing GitHub repo. In other words overiding the default template's github remote with your own. By using the `--behaviour` flag, you can specify if you want to commit automaticly(per build) or if you want to commit manualy (`bomk gitlink --commit`).
List of comands:
- `bomk gitlink --behaviour <commit-per-build/manual-commit>`
- `bomk gitlink --url/--set <url>`
- `bomk gitlink --commit/--push(or you can put both)`
#### To note: Gitlink is in BETA and has not undergone rigorous testing, it might break/not work.

# Version: .
- Github: 0.1.6 "Antoneta" `cli.py` version patch, Toml and README Patch.
- PiPy package version: 0.1.6 "Antoneta" `cli.py` version patch, Toml and README Patch.
