efibootdude 0.0__tar.gz

efibootdude-0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Joe D
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

efibootdude-0.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.1
+Name: efibootdude
+Version: 0.0
+Summary: A visual wrapper for efibootmgr
+Author-email: Joe Defen <joedef@google.com>
+License: MIT
+Project-URL: Homepage, https://github.com/joedefen/efibootdude
+Project-URL: Bug Tracker, https://github.com/joedefen/efibootdude/issues
+Keywords: app,installer,manager,appimages
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: importlib-metadata; python_version < "3.8"
+Requires-Dist: psutil>=5.9
+
+# EfiBootDude
+`efibootdude` presents a visual (curses) interface to `efibootmgr` which allows editing the bios
+boot menu and parameters while running Linux.
+
+* Install `efibootdude` using `pipx install efibootdude`, or however you do so.
+* Prerequisites: install [rhboot/efibootmgr](https://github.com/rhboot/efibootmgr)
+  * For example, on a Debian derived distro, use `sudo apt install efibootmgr`.
+
+
+`efibootdude` covers only the most commonly used capabilities of `efibootmgr` including:
+* reordering boot entries,
+* removing boot entries,
+* setting the boot entry for the next boot only,
+* setting boot entries active or inactive, and
+* setting the boot menu timeout value (until it boots the default entry).
+
+To be sure, there are many other esoteric uses of `efibootmanager`.
+  
+## Usage
+After running `efibootdude`, you'll see a screen like this:
+![efibootdude-screenshot](https://github.com/joedefen/efibootdude/blob/main/images/efibootdude-screenshot.png?raw=true).
+At this point
+* The current line starts with `>` and is highlighted.
+* The top line shows actions for the current line.
+* Enter `?` for a more complete explanation of the keys, navigation keys, etc.
+* With this current line, we can:
+  * Use `u` or `d` to move it up or down in the boot order.
+  * Use `t` to relabel the boot entry.
+  * Use `r` to remove it.
+  * And so forth.
+* When ready to write the changes to the BIOS, enter 'w'.
+* When writing the changes, `efibootdude` drops out of menu mode so you can
+  verify the underlying commands, error codes, and error messages.
+
+## Caveats
+* Some operations may not work permanently even though there is no indication from `efibootmgr`
+  (e.g., on my desktop, I cannot re-label boot entries).
+* Some operations may only work (again) after re-booting (e.g., you might find activating
+  an entry does not work, but it does so after a reboot).
+
+## About this Project
+This project was inspired by [Elinvention/efiboots](https://github.com/Elinvention/efiboots). Relative to that project, the aims of `efibootdude` are:
+* to be easier to install especially when not in your distro's repos.
+* to clearly present the partition of the boot entries (as a mount point if mounted and, otherwise, the device pathname).
+* to show the underlying commands being run for education, for verification, and for help on investigating issues.

efibootdude-0.0/README.md

@@ -0,0 +1,45 @@
+# EfiBootDude
+`efibootdude` presents a visual (curses) interface to `efibootmgr` which allows editing the bios
+boot menu and parameters while running Linux.
+
+* Install `efibootdude` using `pipx install efibootdude`, or however you do so.
+* Prerequisites: install [rhboot/efibootmgr](https://github.com/rhboot/efibootmgr)
+  * For example, on a Debian derived distro, use `sudo apt install efibootmgr`.
+
+
+`efibootdude` covers only the most commonly used capabilities of `efibootmgr` including:
+* reordering boot entries,
+* removing boot entries,
+* setting the boot entry for the next boot only,
+* setting boot entries active or inactive, and
+* setting the boot menu timeout value (until it boots the default entry).
+
+To be sure, there are many other esoteric uses of `efibootmanager`.
+  
+## Usage
+After running `efibootdude`, you'll see a screen like this:
+![efibootdude-screenshot](https://github.com/joedefen/efibootdude/blob/main/images/efibootdude-screenshot.png?raw=true).
+At this point
+* The current line starts with `>` and is highlighted.
+* The top line shows actions for the current line.
+* Enter `?` for a more complete explanation of the keys, navigation keys, etc.
+* With this current line, we can:
+  * Use `u` or `d` to move it up or down in the boot order.
+  * Use `t` to relabel the boot entry.
+  * Use `r` to remove it.
+  * And so forth.
+* When ready to write the changes to the BIOS, enter 'w'.
+* When writing the changes, `efibootdude` drops out of menu mode so you can
+  verify the underlying commands, error codes, and error messages.
+
+## Caveats
+* Some operations may not work permanently even though there is no indication from `efibootmgr`
+  (e.g., on my desktop, I cannot re-label boot entries).
+* Some operations may only work (again) after re-booting (e.g., you might find activating
+  an entry does not work, but it does so after a reboot).
+
+## About this Project
+This project was inspired by [Elinvention/efiboots](https://github.com/Elinvention/efiboots). Relative to that project, the aims of `efibootdude` are:
+* to be easier to install especially when not in your distro's repos.
+* to clearly present the partition of the boot entries (as a mount point if mounted and, otherwise, the device pathname).
+* to show the underlying commands being run for education, for verification, and for help on investigating issues.

efibootdude-0.0/pyproject.toml

@@ -0,0 +1,97 @@
+# HOW TO DEVELOP
+
+#
+# Prep Work (ensure need modules are up-to-date):
+#   sudo apt install python3-pip
+#   sudo apt install python3-pip-whl
+#   pip install build --break-system-packages
+#   sudo apt install twine
+#   -- antiquated way
+#      sudo pacman -Syu python-pip
+#      sudo pacman -Syu python-build
+#      sudo pacman -Syu python-twine
+#   -- antiquated way
+#      python3 -m pip install --upgrade pip
+#      python3 -m pip install --upgrade build
+#      python3 -m pip install --upgrade twine
+#
+# Optionally, `python3 -m venv venv`, and then
+#   - source env/bin/activate # to activate
+#   - deactivate # to deactivate
+# 
+# rm -rf ./dist && python3 -m build && pip install -e . --break-system-packages
+# pip-tray
+#
+#    -OR-
+# python3 -m efibootdude.main
+#
+#    -OR-
+# cd src/efibootdude && ./main.py
+#
+#    -OR-
+# src/efibootdude/main.py
+
+# HOW TO PUBLISH...
+# PUBLIC Build and deploy (from project directory):
+#   ## BUMP the version (below in [project])
+#   rm -rf dist; python3 -m build; ls dist/.
+#   python3 -m twine upload dist/*     # keyring --disable # may be required
+#     ## Enter __token__ and the saved TOKEN (in bitwarden)
+#   pipx upgrade pwr-tray || pipx install pwr-tray # >= python3.11
+#   --OR-- sudo python3 -m pip install pwr-tray # <= python3.10
+#   ## VISIT  https://pypi.org/project/pwr-tray and delete old versions
+#
+# TEST Build and test (from project directory):
+#   ## BUMP the version (below in [project])
+#   rm -r dist; python3 -m build
+#   python3 -m twine upload --repository testpypi dist/* # keyring --disable # may be required
+#     ## Enter __token__ and the saved TOKEN (in bitwarden)
+#   sudo python3 -m pip install --upgrade --index-url https://test.pypi.org/simple/ --no-deps --break-system-packages my-sna
+#   ## VISIT  https://test.pypi.org/project/pwr-tray and delete old versions
+
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "efibootdude"
+version = "0.0"
+description = "A visual wrapper for efibootmgr"
+authors = [
+    { name = "Joe Defen", email = "joedef@google.com" }
+]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+
+keywords = ["app", "installer", "manager", "appimages", ]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux"
+]
+dependencies = [
+    'importlib-metadata; python_version<"3.8"',
+    'psutil>=5.9',
+]
+
+[project.urls]
+"Homepage" = "https://github.com/joedefen/efibootdude"
+"Bug Tracker" = "https://github.com/joedefen/efibootdude/issues"
+
+[project.scripts]
+efibootdude = "efibootdude.main:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+
+exclude = [
+    "__pycache__",
+]
+

efibootdude-0.0/setup.cfg

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