complete refactoring

Author: barnabedikartola2

.gitignore

@@ -0,0 +1,11 @@
+**/__pycache__/
+*.old
+*/*.old
+*.bkp
+*/*.bkp
+**/old
+.venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+PLANNING.md

LICENSE

@@ -0,0 +1,142 @@
+<h1 align="center">BigLinux Browser Selector</h1>
+<img width="1050" height="830" alt="image" src="https://github.com/user-attachments/assets/d8c7452c-f876-4a03-9544-58e5e8af78f0" />
+
+<p align="center">
+  <a href="#features">Features</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#project-structure">Project Structure</a> •
+  <a href="#contributing">Contributing</a> •
+  <a href="#license">License</a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/GTK-4-blue?logo=gnome&logoColor=white" alt="GTK4">
+  <img src="https://img.shields.io/badge/Python-3.10%2B-yellow?logo=python&logoColor=white" alt="Python 3.10+">
+  <img src="https://img.shields.io/badge/Adwaita-libadwaita-purple" alt="Adwaita">
+  <img src="https://img.shields.io/badge/license-GPL-green" alt="License GPL">
+</p>
+
+---
+
+## About
+
+**BigLinux Browser Selector** is a modern, GTK4-based application for [BigLinux](https://www.biglinux.com.br) that allows users to choose and install their preferred web browser with an intuitive interface. It features real-time installation progress, integrated installer support, and accessibility for screen readers.
+
+## Features
+
+- **Modern GTK4/libadwaita interface** — Clean, native look and feel
+- **Browser selection & install** — Choose from 10 supported browsers; install missing ones with real-time progress display
+- **Real-time installation feedback** — Live log output during browser installation
+- **Set default browser** — Configure your chosen browser as the system default
+- **Accessibility support** — Screen reader compatible with ARIA roles and focus indicators
+- **Multiple installation sources** — Supports both native packages and Flatpak installations
+
+## Installation
+
+### From BigLinux repositories (recommended)
+
+```bash
+sudo pacman -S biglinux-browser-selector
+```
+
+### Manual build (Arch-based distros)
+
+```bash
+cd pkgbuild
+makepkg -si
+```
+
+### Dependencies
+
+| Package        | Purpose                    |
+|----------------|----------------------------|
+| `gtk4`         | UI toolkit                 |
+| `python`       | Runtime (≥ 3.10)           |
+| `python-yaml`  | YAML page configuration    |
+| `python-gobject`| GTK4 Python bindings      |
+| `polkit`       | Privilege elevation        |
+| `zenity`       | Auxiliary dialogs          |
+
+## Project Structure
+
+```
+biglinux-browser-selector/
+├── usr/
+│   ├── bin/
+│   │   └── biglinux-browser-selector     # launcher script
+│   ├── share/
+│   │   ├── applications/
+│   │   │   └── org.biglinux.browser-selector.desktop
+│   │   ├── browser_selector/
+│   │   │   ├── main.py                   # entry point
+│   │   │   ├── app.py                    # Adw.Application + CSS
+│   │   │   ├── window.py                 # main window & browser logic
+│   │   │   ├── widgets.py                # custom GTK4 widgets (BrowserCard, InstallPanel)
+│   │   │   ├── utils.py                  # shared utilities
+│   │   │   ├── style.css                 # Adwaita-based styles
+│   │   │   ├── pages.yaml                # browser configuration
+│   │   │   └── scripts/
+│   │   │       ├── browser.sh            # browser management script
+│   │   │       └── browserInstall.sh     # installation script (runs as root)
+│   │   └── icons/hicolor/scalable/apps/
+│   │       └── biglinux-browser-selector.svg
+├── pkgbuild/
+│   ├── PKGBUILD                          # Arch package build
+├── README.md
+└── LICENSE
+```
+
+## Supported Browsers
+
+- Brave
+- Chromium
+- Chrome (Google)
+- Falkon
+- Firefox
+- Librewolf
+- Opera
+- Vivaldi
+- Edge (Microsoft)
+- Zen Browser
+
+Each browser supports both native package installation and Flatpak variants where available.
+
+## Development
+
+### Running locally
+
+```bash
+cd usr/share/biglinux/browser_selector
+python main.py
+```
+
+### Code quality
+
+```bash
+pip install ruff
+ruff check usr/share/biglinux/browser_selector/
+ruff format usr/share/biglinux/browser_selector/
+```
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Make your changes
+4. Run tests and code quality checks
+5. Commit and push
+6. Open a Pull Request
+
+## Community
+
+- 🌐 **Website:** [biglinux.com.br](https://www.biglinux.com.br)
+- 💬 **Forum:** [forum.biglinux.com.br](https://forum.biglinux.com.br)
+- 📺 **YouTube:** [@BigLinuxx](https://www.youtube.com/@BigLinuxx)
+- ✈️ **Telegram:** [t.me/biglinux](https://t.me/biglinux)
+- ❤️ **Donate:** [biglinux.com.br/doacao-financeira](https://www.biglinux.com.br/doacao-financeira/)
+
+## License
+
+This project is licensed under the **GPL** license. See the [PKGBUILD](pkgbuild/PKGBUILD) for details.

README.md

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+import sys
+import yaml
+import argparse
+from pathlib import Path
+
+# The keys in the YAML file whose string values should be translated.
+TRANSLATABLE_KEYS = {"title", "subtitle", "label"}
+
+HEADER = """# -*- coding: utf-8 -*-
+#
+# DO NOT EDIT THIS FILE MANUALLY.
+#
+# This file is automatically generated by the 'generate_strings.py' script
+# from the content of a YAML file. It is used by gettext to extract
+# translatable strings from data files.
+#
+import gettext
+_ = gettext.gettext
+
+# --- Strings from data file ---
+"""
+
+
+def extract_strings_from_data(data):
+    """
+    Recursively finds all strings from the data structure
+    that have a key present in TRANSLATABLE_KEYS.
+    """
+    strings = set()
+    if isinstance(data, dict):
+        for key, value in data.items():
+            if key in TRANSLATABLE_KEYS and isinstance(value, str):
+                strings.add(value)
+            else:
+                strings.update(extract_strings_from_data(value))
+    elif isinstance(data, list):
+        for item in data:
+            strings.update(extract_strings_from_data(item))
+    return strings
+
+
+def main():
+    """Main function to generate the translatable strings file."""
+    parser = argparse.ArgumentParser(
+        description="Extract translatable strings from a YAML file into a Python file for gettext."
+    )
+    parser.add_argument("input_yaml", type=Path, help="Path to the input YAML file.")
+    parser.add_argument("output_py", type=Path, help="Path for the output Python file.")
+    args = parser.parse_args()
+
+    input_file: Path = args.input_yaml
+    output_file: Path = args.output_py
+
+    if not input_file.is_file():
+        print(f"Error: Input file not found at {input_file}")
+        sys.exit(1)
+
+    print(f"Reading strings from: {input_file}")
+    with open(input_file, "r", encoding="utf-8") as f:
+        try:
+            data = yaml.safe_load(f)
+        except yaml.YAMLError as e:
+            print(f"Error parsing YAML file: {e}")
+            sys.exit(1)
+
+    translatable_strings = extract_strings_from_data(data)
+
+    if not translatable_strings:
+        print("Warning: No translatable strings found.")
+        # Still create the file so the build process doesn't fail
+        with open(output_file, "w", encoding="utf-8") as f:
+            f.write(HEADER)
+        return
+
+    # Sort for deterministic output, which is good for version control
+    sorted_strings = sorted(list(translatable_strings))
+
+    print(f"Writing {len(sorted_strings)} strings to: {output_file}")
+    with open(output_file, "w", encoding="utf-8") as f:
+        f.write(HEADER)
+        for s in sorted_strings:
+            # Use repr() to correctly handle quotes and special characters
+            f.write(f"_({repr(s)})\n")
+
+    print("Done.")
+
+
+if __name__ == "__main__":
+    main()