0.10.0

Author: vinifmor

CHANGELOG.md

@@ -4,6 +4,89 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [0.10.0] 2022-03-14
+
+### Features
+- Debian
+  - allowing Debian packages to be managed
+    - required dependencies: **aptitude** 
+    - basic actions supported: **search**, **install**, **uninstall**, **upgrade**
+    - custom actions supported:
+      - **synchronize packages**: synchronize the available packages on the repository (`aptitude update`)
+      - **index applications**: maps runnable installed packages (automatically done during initialization)
+      - **software sources**: launches the application responsible for managing software sources (at the moment only `software-properties-gtk` is supported)
+    - custom package actions supported: 
+      - **purge**: removes the packages and all related configuration files
+    
+    <p align="center">
+          
+    p>
+
+- AppImage
+  - new custom action to self install bauh if it is running as an AppImage
+  
+  <p align="center">
+          
+  p>
+
+- Arch
+  - AUR:
+    - able to filter orphan packages by the new "orphan" category [#236](https://github.com/vinifmor/bauh/issues/236)
+    - able to filter outdated packages by the new "out of date" category [#236](https://github.com/vinifmor/bauh/issues/236)
+
+### Improvements
+- General
+  - minor memory improvements
+  - code refactoring
+  - update checking interval on tray mode is now measured **in minutes** instead of seconds (default: 5)
+
+- Arch
+  - info dialog: 
+    - displaying the "executable" field if the package is recognized as an application
+    - displaying "description" and "version" as primary fields for repository packages
+    - displaying the "out of date" field for AUR packages [#236](https://github.com/vinifmor/bauh/issues/236)
+    - displaying the "orphan" field for AUR packages [#236](https://github.com/vinifmor/bauh/issues/236)
+  - removing the "%U" parameter before launching applications to prevent error messages
+  - minor code refactoring
+
+- Flatpak
+  - cli/tray: removed some unneeded API calls when listing updates [#234](https://github.com/vinifmor/bauh/issues/234)
+
+- UI
+  - search: 
+    - sorting packages by closest match instead of considering installed first
+    - new "Installed" filter
+    <p align="center">
+          
+    p>
+
+  - upgrade summary dialog size
+  - displaying tips for some custom actions (on mouse hover)
+  - screenshots: displaying the current image index as a label in the button bar (e.g: 1/3)
+  - some unneeded cursor icons removed from the apps table
+  - some icons replaced
+
+- Distribution
+  - AppImage: -~9% size reduction (96.32 MB ->  88.16 MB) 
+
+### Fixes
+- General
+  - not accepting blank root passwords [#235](https://github.com/vinifmor/bauh/issues/235)
+  - human-readable sizes (packages, files, updates, ...)
+
+- AppImage
+  - info: displaying attributes related to the installation after the application has been removed (search)
+  - history: not properly sorting releases by version
+
+- Arch:
+  - AUR:
+    - info: exception when trying to retrieve the PKGBUILD of a package without a base defined
+
+- UI
+  - some package icons would not appear if there is no URL associated with them
+  - info: not displaying boolean fields
+  
+
 ## [0.9.28] 2022-02-14
 
 ### Fixes

README.md

@@ -1,6 +1,6 @@
 [![GitHub release](https://img.shields.io/github/release/vinifmor/bauh.svg?label=Release)](https://github.com/vinifmor/bauh/releases/) [![PyPI](https://img.shields.io/pypi/v/bauh?label=PyPI)](https://pypi.org/project/bauh) [![AUR](https://img.shields.io/aur/version/bauh?label=AUR)](https://aur.archlinux.org/packages/bauh) [![AUR-staging](https://img.shields.io/aur/version/bauh-staging?label=AUR-staging)](https://aur.archlinux.org/packages/bauh-staging) [![License](https://img.shields.io/github/license/vinifmor/bauh?label=License)](https://github.com/vinifmor/bauh/blob/master/LICENSE) [![kofi](https://img.shields.io/badge/Ko--Fi-Donate-orange?style=flat&logo=ko-fi)](https://ko-fi.com/vinifmor) [![Follow on Twitter](https://img.shields.io/twitter/follow/bauh4linux?style=social&label=Twitter)](https://twitter.com/bauh4linux)
 
-**bauh** (ba-oo), formerly known as **fpakman**, is a graphical interface for managing your Linux software (packages/applications). It currently supports the following formats: AppImage, ArchLinux repositories/AUR, Flatpak, Snap and Web applications.
+**bauh** (ba-oo), formerly known as **fpakman**, is a graphical interface for managing your Linux software (packages/applications). It currently supports the following formats: AppImage, ArchLinux repositories/AUR, Debian packages, Flatpak, Snap and Web applications.
 
 Key features
 - A management panel where you can: search, install, uninstall, upgrade, downgrade and launch you applications (and more...)
@@ -26,6 +26,7 @@ Key features
 6. [Supported types](#types)
     - [AppImage](#type_appimage)
     - [Arch packages/AUR](#type_arch)
+    - [Debian](#type_deb)
     - [Flatpak](#type_flatpak)
     - [Snap](#type_snap)
     - [Native Web applications](#type_web)
@@ -50,6 +51,7 @@ Key features
 
 ##### Required dependencies
 - `fuse`: the package name may vary from distribution
+- `qt5dxcb-plugin` (or equivalent): the package name may vary from distribution
 
 ##### Steps
 - Download the .AppImage file attached with the latest release from https://github.com/vinifmor/bauh/releases.
@@ -69,6 +71,7 @@ Key features
 
 ##### Optional dependencies (they should be installed with apt-get/apt)
 
+- `aptitude`: Debian package management
 - `timeshift`: system backup
 - `aria2`: multi-threaded downloads
 - `axel`: multi-threaded downloads alternative
@@ -202,6 +205,7 @@ bauh is officially distributed through [PyPi](https://pypi.org/project/bauh) and
     - `Install AppImage file`: allows to install an external AppImage file
     - `Upgrade file`: allows to upgrade a manually installed AppImage file
     - `Update database`: manually synchronize the AppImage database
+    - `Install bauh`: installs bauh if it is running as an AppImage
 
 - Installed applications are store at `~/.local/share/bauh/appimage/installed` (or `/usr/local/share/bauh/installed` for **root**)
 - Desktop entries (menu shortcuts) of the installed applications are stored at `~/.local/share/applications` (or `/usr/share/applications` for **root**). Name pattern: `bauh_appimage_appname.desktop`
@@ -285,6 +289,22 @@ aur_rebuild_detector: true # it checks if packages built with old library versio
 prefer_repository_provider: true  # when there is just one repository provider for a given a dependency and several from AUR, it will be automatically picked.
 ```
 
+##### <a name="type_deb">Debian packages<a>
+- Basic actions supported: **search**, **install**, **uninstall**, **upgrade**
+- Custom actions supported:
+   - **synchronize packages**: synchronize the available packages on the repository (`aptitude update`)
+   - **index applications**: maps runnable installed packages (automatically done during initialization)
+   - **software sources**: launches the application responsible for managing software sources (at the moment only `software-properties-gtk` is supported) 
+- Custom package actions supported: 
+  - **purge**: removes the packages and all related configuration files
+- Files:
+  - runnable applications index: `~/.cache/bauh/debian/apps_idx.json` (or `/var/cache/bauh/debian/apps_idx.json` for **root**)
+  - package suggestions: `~/.cache/bauh/debian/suggestions.txt` (or `/var/cache/bauh/debian/suggestions.txt` for **root**)
+  - configuration: `~/.config/bauh/debian.yml` or `/etc/bauh/debian.yml`
+    - `index_apps.exp`: time period (**in minutes**) in which the installed applications cache is considered up-to-date during startup (default: `1440` -> 24 hours)
+    - `sync_pkgs.time`: time period (**in minutes**) in which the packages synchronization must be done on startup (default: `1440` -> 24 hours)
+    - `suggestions.exp`: it defines the period (**in hours**) in which the suggestions stored in disc will be considered up to date. Use 0 if you always want to update them.
+    - `pkg_sources.app`: it defines the application for managing the software sources. A `null` value detects one of the supported applications automatically.
 
 ##### <a name="type_flatpak">Flatpaka>
 
@@ -409,7 +429,7 @@ ui:
   theme: defines the path to the theme/stylesheet file with a .qss extension (e.g: /path/to/my/theme.qss). For themes provided by bauh, only a string key is needed (e.g: light). Default: light
   system_theme: merges the system's theme/stylesheet with bauh's. Default: false.
 updates:
-  check_interval: 30  # the updates checking interval in SECONDS
+  check_interval: 5  # the updates checking interval in minutes
   ask_for_reboot: true  # if a dialog asking for a system reboot should be displayed after a successful upgrade
 disk:
     trim:

bauh/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '0.9.28'
+__version__ = '0.10.0'
 __app_name__ = 'bauh'
 
 import os

bauh/api/abstract/context.py

@@ -14,7 +14,8 @@ class ApplicationContext:
     def __init__(self, download_icons: bool, http_client: HttpClient, app_root_dir: str, i18n: I18n,
                  cache_factory: MemoryCacheFactory, disk_loader_factory: DiskCacheLoaderFactory,
                  logger: logging.Logger, file_downloader: FileDownloader, distro: str, app_name: str,
-                 internet_checker: InternetChecker, root_user: bool):
+                 app_version: str, internet_checker: InternetChecker, root_user: bool, screen_width: int = -1,
+                 screen_height: int = -1):
         """
         :param download_icons: if packages icons should be downloaded
         :param http_client: a shared instance of http client
@@ -26,7 +27,10 @@ def __init__(self, download_icons: bool, http_client: HttpClient, app_root_dir:
         :param file_downloader
         :param distro
         :param app_name
+        :param app_version
         :param internet_checker
+        :param screen_width
+        :param screen_height
         """
         self.download_icons = download_icons
         self.http_client = http_client
@@ -41,9 +45,12 @@ def __init__(self, download_icons: bool, http_client: HttpClient, app_root_dir:
         self.default_categories = ('AudioVideo', 'Audio', 'Video', 'Development', 'Education', 'Game',
                                    'Graphics', 'Network', 'Office', 'Science', 'Settings', 'System', 'Utility')
         self.app_name = app_name
+        self.app_version = app_version
         self.root_user = root_user
         self.root_password = None
         self.internet_checker = internet_checker
+        self.screen_width = screen_width
+        self.screen_height = screen_height
 
     def is_system_x86_64(self):
         return self.arch_x86_64

bauh/api/abstract/controller.py

@@ -4,7 +4,7 @@
 from abc import ABC, abstractmethod
 from enum import Enum
 from pathlib import Path
-from typing import List, Set, Type, Tuple, Optional, Generator
+from typing import List, Set, Type, Tuple, Optional, Generator, TypeVar
 
 import yaml
 
@@ -15,10 +15,12 @@
     CustomSoftwareAction
 from bauh.api.abstract.view import ViewComponent
 
+P = TypeVar('P', bound=SoftwarePackage)
+
 
 class SearchResult:
 
-    def __init__(self, installed: Optional[List[SoftwarePackage]], new: Optional[List[SoftwarePackage]], total: int):
+    def __init__(self, installed: Optional[List[P]], new: Optional[List[P]], total: int):
         """
         :param installed: already installed packages
         :param new: new packages found
@@ -40,9 +42,19 @@ def update_total(self):
         self.total = total
 
     @classmethod
-    def empty(cls):
+    def empty(cls) -> "SearchResult":
         return cls(installed=[], new=[], total=0)
 
+    def __eq__(self, other):
+        if isinstance(other, SearchResult):
+            if self.installed == other.installed:
+                return self.new == other.new
+
+        return False
+
+    def __hash__(self):
+        return hash(self.installed) + hash(self.new)
+
 
 class UpgradeRequirement:
 
@@ -69,7 +81,7 @@ def sort_by_priority(req: "UpgradeRequirement") -> Tuple[int, str]:
 class UpgradeRequirements:
 
     def __init__(self, to_install: Optional[List[UpgradeRequirement]], to_remove: Optional[List[UpgradeRequirement]],
-                 to_upgrade: List[UpgradeRequirement], cannot_upgrade: Optional[List[UpgradeRequirement]]):
+                 to_upgrade: Optional[List[UpgradeRequirement]], cannot_upgrade: Optional[List[UpgradeRequirement]]):
         """
         :param to_install: additional packages that must be installed with the upgrade
         :param to_remove: non upgrading packages that should be removed due to conflicts with upgrading packages
@@ -143,7 +155,7 @@ def read_installed(self, disk_loader: Optional[DiskCacheLoader], limit: int, onl
         pass
 
     @abstractmethod
-    def downgrade(self, pkg: SoftwarePackage, root_password: str, handler: ProcessWatcher) -> bool:
+    def downgrade(self, pkg: SoftwarePackage, root_password: Optional[str], handler: ProcessWatcher) -> bool:
         """
         downgrades a package version
         :param pkg:
@@ -162,7 +174,7 @@ def clean_cache_for(self, pkg: SoftwarePackage):
         if pkg.supports_disk_cache() and os.path.exists(pkg.get_disk_cache_path()):
             shutil.rmtree(pkg.get_disk_cache_path())
 
-    def get_upgrade_requirements(self, pkgs: List[SoftwarePackage], root_password: str, watcher: ProcessWatcher) -> UpgradeRequirements:
+    def get_upgrade_requirements(self, pkgs: List[SoftwarePackage], root_password: Optional[str], watcher: ProcessWatcher) -> UpgradeRequirements:
         """
         return additional required software that needs to be installed / removed / updated before updating a list of packages
         :param pkgs:
@@ -172,7 +184,7 @@ def get_upgrade_requirements(self, pkgs: List[SoftwarePackage], root_password: s
         return UpgradeRequirements(None, None, [UpgradeRequirement(p) for p in pkgs], None)
 
     @abstractmethod
-    def upgrade(self, requirements: UpgradeRequirements, root_password: str, watcher: ProcessWatcher) -> bool:
+    def upgrade(self, requirements: UpgradeRequirements, root_password: Optional[str], watcher: ProcessWatcher) -> bool:
         """
         :param requirements:
         :param root_password: the root user password (if required)
@@ -182,7 +194,7 @@ def upgrade(self, requirements: UpgradeRequirements, root_password: str, watcher
         pass
 
     @abstractmethod
-    def uninstall(self, pkg: SoftwarePackage, root_password: str, watcher: ProcessWatcher, disk_loader: Optional[DiskCacheLoader]) -> TransactionResult:
+    def uninstall(self, pkg: SoftwarePackage, root_password: Optional[str], watcher: ProcessWatcher, disk_loader: Optional[DiskCacheLoader]) -> TransactionResult:
         """
         :param pkg:
         :param root_password: the root user password (if required)
@@ -217,7 +229,7 @@ def get_history(self, pkg: SoftwarePackage) -> PackageHistory:
         pass
 
     @abstractmethod
-    def install(self, pkg: SoftwarePackage, root_password: str, disk_loader: Optional[DiskCacheLoader], watcher: ProcessWatcher) -> TransactionResult:
+    def install(self, pkg: SoftwarePackage, root_password: Optional[str], disk_loader: Optional[DiskCacheLoader], watcher: ProcessWatcher) -> TransactionResult:
         """
         :param pkg:
         :param root_password: the root user password (if required)
@@ -334,7 +346,7 @@ def list_suggestions(self, limit: int, filter_installed: bool) -> List[PackageSu
         """
         pass
 
-    def execute_custom_action(self, action: CustomSoftwareAction, pkg: SoftwarePackage, root_password: str, watcher: ProcessWatcher) -> bool:
+    def execute_custom_action(self, action: CustomSoftwareAction, pkg: SoftwarePackage, root_password: Optional[str], watcher: ProcessWatcher) -> bool:
         """
         At the moment the GUI implements this action. No need to implement it yourself.
         :param action:
@@ -355,10 +367,9 @@ def is_default_enabled(self) -> bool:
     def launch(self, pkg: SoftwarePackage):
         pass
 
-    @abstractmethod
-    def get_screenshots(self, pkg: SoftwarePackage) -> List[str]:
+    def get_screenshots(self, pkg: SoftwarePackage) -> Generator[str, None, None]:
         """
-        :return: screenshot urls for the given package
+        :return: yields screenshot urls for the given package
         """
         pass
 

bauh/api/abstract/download.py

@@ -1,13 +1,13 @@
 from abc import ABC, abstractmethod
-from typing import Iterable, List, Optional, Tuple
+from typing import Iterable, List, Optional
 
 from bauh.api.abstract.handler import ProcessWatcher
 
 
 class FileDownloader(ABC):
 
     @abstractmethod
-    def download(self, file_url: str, watcher: Optional[ProcessWatcher], output_path: str, cwd: str, root_password: str = None, substatus_prefix: str = None, display_file_size: bool = True, max_threads: int = None, known_size: int = None) -> bool:
+    def download(self, file_url: str, watcher: Optional[ProcessWatcher], output_path: str, cwd: str, root_password: Optional[str] = None, substatus_prefix: str = None, display_file_size: bool = True, max_threads: int = None, known_size: int = None) -> bool:
         """
         :param file_url:
         :param watcher:

bauh/api/abstract/handler.py

@@ -17,9 +17,11 @@ def print(self, msg: str):
         """
         pass
 
-    def request_confirmation(self, title: str, body: Optional[str], components: List[ViewComponent] = None, confirmation_label: str = None,
-                             deny_label: str = None, deny_button: bool = True, window_cancel: bool = False,
-                             confirmation_button: bool = True) -> bool:
+    def request_confirmation(self, title: str, body: Optional[str], components: List[ViewComponent] = None,
+                             confirmation_label: str = None, deny_label: str = None, deny_button: bool = True,
+                             window_cancel: bool = False, confirmation_button: bool = True,
+                             min_width: Optional[int] = None,
+                             min_height: Optional[int] = None) -> bool:
         """
         request a user confirmation. In the current GUI implementation, it shows a popup to the user.
         :param title: popup title
@@ -30,6 +32,8 @@ def request_confirmation(self, title: str, body: Optional[str], components: List
         :param deny_button: if the deny button should be displayed
         :param window_cancel: if the window cancel button should be visible
         :param confirmation_button: if the confirmation button should be displayed
+        :param min_width: minimum width for the confirmation dialog
+        :param min_height: minimum height for the confirmation dialog
         :return: if the request was confirmed by the user
         """
         pass