bdalabb 0.20__tar.gz

bdalabb-0.20/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: bdalabb
+Version: 0.20
+Summary: QuickPad-style hotkey overlay for Hadoop lab programs
+Classifier: Environment :: X11 Applications
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: python-xlib>=0.33; platform_system == "Linux"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+
+# BDA Lab
+
+BDA Lab keeps Hadoop lab programs and their related source, commands, and input
+files together in a small desktop overlay. The window and file previews use a
+black theme.
+
+## Ubuntu
+
+The application runs in an Ubuntu desktop session. Install Tk and virtual
+environment support, then install BDA Lab in a dedicated virtual environment:
+
+```bash
+sudo apt update
+sudo apt install python3-tk python3-venv
+python3 -m venv "$HOME/.local/share/bdalabb/venv"
+"$HOME/.local/share/bdalabb/venv/bin/pip" install --upgrade bdalabb
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" install
+```
+
+The service installer adds a systemd **user** service and a desktop autostart
+entry. It starts the overlay when the desktop session starts, restarts it after
+an unexpected failure, and stops it when that session ends or the computer
+shuts down. Locking the screen does not end the session. To inspect or stop it:
+
+```bash
+systemctl --user status bdalabb.service
+journalctl --user -u bdalabb.service -f
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" stop
+```
+
+To remove the service and its autostart entry:
+
+```bash
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" uninstall
+```
+
+Global Numpad Minus show/hide and pin shortcuts are supported in Ubuntu Xorg
+sessions. Wayland restricts applications from capturing global keystrokes; in a
+Wayland session BDA Lab opens visibly and remains usable as a normal window. To
+enable the overlay hotkey, choose **Ubuntu on Xorg** from the login-screen
+session menu.
+
+Hold Numpad Minus to peek at the overlay; tap it three times quickly to pin or
+unpin. Press **Ctrl+Shift+Q** to exit. Closing the window hides it so the
+background service can keep running.
+
+## Windows
+
+On Windows, install Python 3.10 or later with Tcl/Tk and run:
+
+```powershell
+py -m pip install --upgrade bdalabb
+bdalabb
+```
+
+The same Numpad Minus and Ctrl+Shift+Q shortcuts are available.
+
+## Included program files
+
+The package includes the Matrix Multiplication MapReduce lab with its Java
+source, run commands, and two input files. Use **Add program folder** to add
+other complete programs; imported files are copied into the per-user data
+directory and the originals are left unchanged.
+
+## Development
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install --upgrade pip build
+python -m pip install -e ".[dev]"
+python -m unittest discover -s tests -v
+python -m build
+```

bdalabb-0.20/README.md

@@ -0,0 +1,74 @@
+# BDA Lab
+
+BDA Lab keeps Hadoop lab programs and their related source, commands, and input
+files together in a small desktop overlay. The window and file previews use a
+black theme.
+
+## Ubuntu
+
+The application runs in an Ubuntu desktop session. Install Tk and virtual
+environment support, then install BDA Lab in a dedicated virtual environment:
+
+```bash
+sudo apt update
+sudo apt install python3-tk python3-venv
+python3 -m venv "$HOME/.local/share/bdalabb/venv"
+"$HOME/.local/share/bdalabb/venv/bin/pip" install --upgrade bdalabb
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" install
+```
+
+The service installer adds a systemd **user** service and a desktop autostart
+entry. It starts the overlay when the desktop session starts, restarts it after
+an unexpected failure, and stops it when that session ends or the computer
+shuts down. Locking the screen does not end the session. To inspect or stop it:
+
+```bash
+systemctl --user status bdalabb.service
+journalctl --user -u bdalabb.service -f
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" stop
+```
+
+To remove the service and its autostart entry:
+
+```bash
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" uninstall
+```
+
+Global Numpad Minus show/hide and pin shortcuts are supported in Ubuntu Xorg
+sessions. Wayland restricts applications from capturing global keystrokes; in a
+Wayland session BDA Lab opens visibly and remains usable as a normal window. To
+enable the overlay hotkey, choose **Ubuntu on Xorg** from the login-screen
+session menu.
+
+Hold Numpad Minus to peek at the overlay; tap it three times quickly to pin or
+unpin. Press **Ctrl+Shift+Q** to exit. Closing the window hides it so the
+background service can keep running.
+
+## Windows
+
+On Windows, install Python 3.10 or later with Tcl/Tk and run:
+
+```powershell
+py -m pip install --upgrade bdalabb
+bdalabb
+```
+
+The same Numpad Minus and Ctrl+Shift+Q shortcuts are available.
+
+## Included program files
+
+The package includes the Matrix Multiplication MapReduce lab with its Java
+source, run commands, and two input files. Use **Add program folder** to add
+other complete programs; imported files are copied into the per-user data
+directory and the originals are left unchanged.
+
+## Development
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install --upgrade pip build
+python -m pip install -e ".[dev]"
+python -m unittest discover -s tests -v
+python -m build
+```

bdalabb-0.20/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bdalabb"
+version = "0.20"
+description = "QuickPad-style hotkey overlay for Hadoop lab programs"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "python-xlib>=0.33; platform_system == 'Linux'",
+]
+classifiers = [
+    "Environment :: X11 Applications",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+]
+
+[project.optional-dependencies]
+dev = ["build>=1.2"]
+
+[project.gui-scripts]
+bdalabb = "labprograms.app:main"
+
+[project.scripts]
+bdalabb-service = "labprograms.service:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+labprograms = ["programs/**/*"]

bdalabb-0.20/setup.cfg

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

bdalabb-0.20/src/bdalabb.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: bdalabb
+Version: 0.20
+Summary: QuickPad-style hotkey overlay for Hadoop lab programs
+Classifier: Environment :: X11 Applications
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: python-xlib>=0.33; platform_system == "Linux"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+
+# BDA Lab
+
+BDA Lab keeps Hadoop lab programs and their related source, commands, and input
+files together in a small desktop overlay. The window and file previews use a
+black theme.
+
+## Ubuntu
+
+The application runs in an Ubuntu desktop session. Install Tk and virtual
+environment support, then install BDA Lab in a dedicated virtual environment:
+
+```bash
+sudo apt update
+sudo apt install python3-tk python3-venv
+python3 -m venv "$HOME/.local/share/bdalabb/venv"
+"$HOME/.local/share/bdalabb/venv/bin/pip" install --upgrade bdalabb
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" install
+```
+
+The service installer adds a systemd **user** service and a desktop autostart
+entry. It starts the overlay when the desktop session starts, restarts it after
+an unexpected failure, and stops it when that session ends or the computer
+shuts down. Locking the screen does not end the session. To inspect or stop it:
+
+```bash
+systemctl --user status bdalabb.service
+journalctl --user -u bdalabb.service -f
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" stop
+```
+
+To remove the service and its autostart entry:
+
+```bash
+"$HOME/.local/share/bdalabb/venv/bin/bdalabb-service" uninstall
+```
+
+Global Numpad Minus show/hide and pin shortcuts are supported in Ubuntu Xorg
+sessions. Wayland restricts applications from capturing global keystrokes; in a
+Wayland session BDA Lab opens visibly and remains usable as a normal window. To
+enable the overlay hotkey, choose **Ubuntu on Xorg** from the login-screen
+session menu.
+
+Hold Numpad Minus to peek at the overlay; tap it three times quickly to pin or
+unpin. Press **Ctrl+Shift+Q** to exit. Closing the window hides it so the
+background service can keep running.
+
+## Windows
+
+On Windows, install Python 3.10 or later with Tcl/Tk and run:
+
+```powershell
+py -m pip install --upgrade bdalabb
+bdalabb
+```
+
+The same Numpad Minus and Ctrl+Shift+Q shortcuts are available.
+
+## Included program files
+
+The package includes the Matrix Multiplication MapReduce lab with its Java
+source, run commands, and two input files. Use **Add program folder** to add
+other complete programs; imported files are copied into the per-user data
+directory and the originals are left unchanged.
+
+## Development
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install --upgrade pip build
+python -m pip install -e ".[dev]"
+python -m unittest discover -s tests -v
+python -m build
+```

bdalabb-0.20/src/bdalabb.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+README.md
+pyproject.toml
+src/bdalabb.egg-info/PKG-INFO
+src/bdalabb.egg-info/SOURCES.txt
+src/bdalabb.egg-info/dependency_links.txt
+src/bdalabb.egg-info/entry_points.txt
+src/bdalabb.egg-info/requires.txt
+src/bdalabb.egg-info/top_level.txt
+src/labprograms/__init__.py
+src/labprograms/__main__.py
+src/labprograms/app.py
+src/labprograms/catalog.py
+src/labprograms/hotkeys.py
+src/labprograms/preview.py
+src/labprograms/service.py
+src/labprograms/programs/program1-matrix-multiplication/MatrixMulti.java
+src/labprograms/programs/program1-matrix-multiplication/RUN_COMMANDS.txt
+src/labprograms/programs/program1-matrix-multiplication/input1.txt
+src/labprograms/programs/program1-matrix-multiplication/input2.txt
+src/labprograms/programs/program1-matrix-multiplication/program.json
+tests/test_catalog.py
+tests/test_hotkeys.py
+tests/test_service.py

bdalabb-0.20/src/bdalabb.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bdalabb-0.20/src/bdalabb.egg-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+bdalabb-service = labprograms.service:main
+
+[gui_scripts]
+bdalabb = labprograms.app:main

bdalabb-0.20/src/bdalabb.egg-info/requires.txt

@@ -0,0 +1,6 @@
+
+[:platform_system == "Linux"]
+python-xlib>=0.33
+
+[dev]
+build>=1.2

bdalabb-0.20/src/bdalabb.egg-info/top_level.txt

@@ -0,0 +1 @@
+labprograms

bdalabb-0.20/src/labprograms/__init__.py

@@ -0,0 +1,3 @@
+"""Lab Program Library desktop package."""
+
+__version__ = "0.1.0"

bdalabb-0.20/src/labprograms/__main__.py

@@ -0,0 +1,5 @@
+from .app import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())