linux-browser 0.1.0__tar.gz

linux_browser-0.1.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: linux-browser
+Version: 0.1.0
+Summary: A small Chromium-powered graphical web browser for Linux
+Author: linux-browser contributors
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: PySide6>=6.6
+Requires-Dist: PySide6-WebEngine>=6.6
+
+# Linux Browser
+
+A small graphical browser for Linux, packaged as a normal Python application. It uses Qt WebEngine, which embeds Chromium, so pages are rendered with their real HTML, CSS, JavaScript, images, and network behavior rather than being converted to terminal text.
+
+## Debian 12
+
+Install a display server (a desktop session is fine) and the runtime libraries used by Qt:
+
+```bash
+sudo apt update
+sudo apt install libegl1 libgl1 libnss3 libxkbcommon-x11-0 libxcb-cursor0 \
+	libxcomposite1 libxdamage1 libxrandr2 libasound2 xdg-utils
+```
+
+The PyPI wheels provide the Qt and Chromium components. A working graphical session and graphics driver are still required to show the window. On a headless machine, run it inside a desktop container or an X server such as Xvfb.
+
+## Install and run
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install linux-browser
+.venv/bin/linux-browser
+```
+
+Open a specific page directly:
+
+```bash
+linux-browser https://example.com
+```
+
+The address bar accepts URLs and search terms. Back, forward, reload, and common keyboard shortcuts are available in the toolbar.
+
+## Development
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install -e . pytest build
+.venv/bin/python -m pytest
+```
+
+The WebEngine test loads an in-memory page and checks that CSS and JavaScript execute. It is skipped when PySide6 is not installed, which keeps package metadata checks usable in minimal build environments.
+
+## Build and publish
+
+```bash
+.venv/bin/python -m build
+.venv/bin/python -m pip install twine
+.venv/bin/twine check dist/*
+.venv/bin/twine upload dist/*
+```
+
+Publishing requires a PyPI account and credentials configured for `twine`.

linux_browser-0.1.0/README.md

@@ -0,0 +1,52 @@
+# Linux Browser
+
+A small graphical browser for Linux, packaged as a normal Python application. It uses Qt WebEngine, which embeds Chromium, so pages are rendered with their real HTML, CSS, JavaScript, images, and network behavior rather than being converted to terminal text.
+
+## Debian 12
+
+Install a display server (a desktop session is fine) and the runtime libraries used by Qt:
+
+```bash
+sudo apt update
+sudo apt install libegl1 libgl1 libnss3 libxkbcommon-x11-0 libxcb-cursor0 \
+	libxcomposite1 libxdamage1 libxrandr2 libasound2 xdg-utils
+```
+
+The PyPI wheels provide the Qt and Chromium components. A working graphical session and graphics driver are still required to show the window. On a headless machine, run it inside a desktop container or an X server such as Xvfb.
+
+## Install and run
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install linux-browser
+.venv/bin/linux-browser
+```
+
+Open a specific page directly:
+
+```bash
+linux-browser https://example.com
+```
+
+The address bar accepts URLs and search terms. Back, forward, reload, and common keyboard shortcuts are available in the toolbar.
+
+## Development
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install -e . pytest build
+.venv/bin/python -m pytest
+```
+
+The WebEngine test loads an in-memory page and checks that CSS and JavaScript execute. It is skipped when PySide6 is not installed, which keeps package metadata checks usable in minimal build environments.
+
+## Build and publish
+
+```bash
+.venv/bin/python -m build
+.venv/bin/python -m pip install twine
+.venv/bin/twine check dist/*
+.venv/bin/twine upload dist/*
+```
+
+Publishing requires a PyPI account and credentials configured for `twine`.

linux_browser-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "linux-browser"
+version = "0.1.0"
+description = "A small Chromium-powered graphical web browser for Linux"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "linux-browser contributors" }]
+dependencies = [
+    "PySide6>=6.6",
+    "PySide6-WebEngine>=6.6",
+]
+
+[project.scripts]
+linux-browser = "linux_browser.app:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

linux_browser-0.1.0/setup.cfg

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

linux_browser-0.1.0/src/linux_browser/__init__.py

@@ -0,0 +1,3 @@
+"""A lightweight graphical browser for Linux."""
+
+__version__ = "0.1.0"

linux_browser-0.1.0/src/linux_browser/app.py

@@ -0,0 +1,81 @@
+"""Graphical browser application powered by Qt WebEngine."""
+
+from __future__ import annotations
+
+import sys
+from urllib.parse import quote
+
+from PySide6.QtCore import QUrl
+from PySide6.QtGui import QAction, QKeySequence
+from PySide6.QtWidgets import QApplication, QLineEdit, QMainWindow, QToolBar
+from PySide6.QtWebEngineWidgets import QWebEngineView
+
+
+class BrowserWindow(QMainWindow):
+    """A minimal browser window with real Chromium page rendering."""
+
+    def __init__(self, start_url: str = "https://duckduckgo.com") -> None:
+        super().__init__()
+        self.setWindowTitle("Linux Browser")
+        self.resize(1280, 800)
+
+        toolbar = QToolBar("Navigation")
+        toolbar.setMovable(False)
+        self.addToolBar(toolbar)
+
+        back_action = QAction("Back", self)
+        back_action.setShortcut(QKeySequence("Alt+Left"))
+        back_action.triggered.connect(lambda: self.web_view.back())
+        toolbar.addAction(back_action)
+
+        forward_action = QAction("Forward", self)
+        forward_action.setShortcut(QKeySequence("Alt+Right"))
+        forward_action.triggered.connect(lambda: self.web_view.forward())
+        toolbar.addAction(forward_action)
+
+        reload_action = QAction("Reload", self)
+        reload_action.setShortcut(QKeySequence("Ctrl+R"))
+        reload_action.triggered.connect(lambda: self.web_view.reload())
+        toolbar.addAction(reload_action)
+
+        self.address_bar = QLineEdit()
+        self.address_bar.setPlaceholderText("Enter a web address or search term")
+        self.address_bar.setClearButtonEnabled(True)
+        self.address_bar.returnPressed.connect(self.navigate)
+        toolbar.addWidget(self.address_bar)
+
+        self.web_view = QWebEngineView()
+        self.web_view.urlChanged.connect(self.update_address)
+        self.web_view.titleChanged.connect(self.update_title)
+        self.setCentralWidget(self.web_view)
+        self.navigate(start_url)
+
+    def navigate(self, text: str | None = None) -> None:
+        address = (text if text is not None else self.address_bar.text()).strip()
+        if not address:
+            return
+        if " " in address or "." not in address and not address.startswith(("http://", "https://", "file:", "data:")):
+            address = f"https://duckduckgo.com/?q={quote(address)}"
+        elif not address.startswith(("http://", "https://", "file:", "data:")):
+            address = f"https://{address}"
+        self.web_view.setUrl(QUrl(address))
+
+    def update_address(self, url: QUrl) -> None:
+        self.address_bar.setText(url.toString())
+        self.address_bar.setCursorPosition(0)
+
+    def update_title(self, title: str) -> None:
+        self.setWindowTitle(f"{title} - Linux Browser" if title else "Linux Browser")
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = sys.argv[1:] if argv is None else argv
+    app = QApplication([sys.argv[0], *args])
+    app.setApplicationName("Linux Browser")
+    window = BrowserWindow(args[0] if args else "https://duckduckgo.com")
+    window.show()
+    return app.exec()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

linux_browser-0.1.0/src/linux_browser.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: linux-browser
+Version: 0.1.0
+Summary: A small Chromium-powered graphical web browser for Linux
+Author: linux-browser contributors
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: PySide6>=6.6
+Requires-Dist: PySide6-WebEngine>=6.6
+
+# Linux Browser
+
+A small graphical browser for Linux, packaged as a normal Python application. It uses Qt WebEngine, which embeds Chromium, so pages are rendered with their real HTML, CSS, JavaScript, images, and network behavior rather than being converted to terminal text.
+
+## Debian 12
+
+Install a display server (a desktop session is fine) and the runtime libraries used by Qt:
+
+```bash
+sudo apt update
+sudo apt install libegl1 libgl1 libnss3 libxkbcommon-x11-0 libxcb-cursor0 \
+	libxcomposite1 libxdamage1 libxrandr2 libasound2 xdg-utils
+```
+
+The PyPI wheels provide the Qt and Chromium components. A working graphical session and graphics driver are still required to show the window. On a headless machine, run it inside a desktop container or an X server such as Xvfb.
+
+## Install and run
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install linux-browser
+.venv/bin/linux-browser
+```
+
+Open a specific page directly:
+
+```bash
+linux-browser https://example.com
+```
+
+The address bar accepts URLs and search terms. Back, forward, reload, and common keyboard shortcuts are available in the toolbar.
+
+## Development
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install -e . pytest build
+.venv/bin/python -m pytest
+```
+
+The WebEngine test loads an in-memory page and checks that CSS and JavaScript execute. It is skipped when PySide6 is not installed, which keeps package metadata checks usable in minimal build environments.
+
+## Build and publish
+
+```bash
+.venv/bin/python -m build
+.venv/bin/python -m pip install twine
+.venv/bin/twine check dist/*
+.venv/bin/twine upload dist/*
+```
+
+Publishing requires a PyPI account and credentials configured for `twine`.

linux_browser-0.1.0/src/linux_browser.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/linux_browser/__init__.py
+src/linux_browser/app.py
+src/linux_browser.egg-info/PKG-INFO
+src/linux_browser.egg-info/SOURCES.txt
+src/linux_browser.egg-info/dependency_links.txt
+src/linux_browser.egg-info/entry_points.txt
+src/linux_browser.egg-info/requires.txt
+src/linux_browser.egg-info/top_level.txt
+tests/test_package.py
+tests/test_webengine.py

linux_browser-0.1.0/src/linux_browser.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

linux_browser-0.1.0/src/linux_browser.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+linux-browser = linux_browser.app:main

linux_browser-0.1.0/src/linux_browser.egg-info/requires.txt

@@ -0,0 +1,2 @@
+PySide6>=6.6
+PySide6-WebEngine>=6.6

linux_browser-0.1.0/src/linux_browser.egg-info/top_level.txt

@@ -0,0 +1 @@
+linux_browser

linux_browser-0.1.0/tests/test_package.py

@@ -0,0 +1,8 @@
+import unittest
+
+from linux_browser import __version__
+
+
+class PackageTest(unittest.TestCase):
+    def test_package_has_version(self) -> None:
+        self.assertEqual(__version__, "0.1.0")

linux_browser-0.1.0/tests/test_webengine.py

@@ -0,0 +1,46 @@
+import sys
+import unittest
+
+
+try:
+    from PySide6.QtCore import QEventLoop, QTimer
+    from PySide6.QtWidgets import QApplication
+    from PySide6.QtWebEngineWidgets import QWebEngineView
+except ImportError:
+    QWebEngineView = None
+
+
+@unittest.skipUnless(QWebEngineView, "PySide6-WebEngine is not installed")
+class WebEngineSmokeTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls) -> None:
+        cls.application = QApplication.instance() or QApplication(sys.argv)
+
+    def test_renders_css_and_runs_javascript(self) -> None:
+        view = QWebEngineView()
+        loaded = []
+        view.loadFinished.connect(loaded.append)
+        view.setHtml(
+            "<html><head><style>body { color: rgb(1, 2, 3); }</style></head>"
+            "<body><main id='content'>initial</main>"
+            "<script>document.title = 'Rendered';"
+            "document.querySelector('#content').textContent = 'JavaScript ran';</script>"
+            "</body></html>"
+        )
+
+        loop = QEventLoop()
+        view.loadFinished.connect(loop.quit)
+        QTimer.singleShot(5000, loop.quit)
+        loop.exec()
+        self.assertTrue(loaded and loaded[-1])
+
+        result = []
+        view.page().runJavaScript(
+            "[document.title, document.querySelector('#content').textContent, "
+            "getComputedStyle(document.body).color]",
+            result.append,
+        )
+        QTimer.singleShot(1000, loop.quit)
+        loop.exec()
+        self.assertEqual(result, [["Rendered", "JavaScript ran", "rgb(1, 2, 3)"]])
+        view.deleteLater()