jordanl2/softwareinstaller

Description

Software installer to provide single interface for multiple software sources: distro repository, flatpak etc.

Supported Sources

Sources currently supported:

• Flatpak
• Pacman
• Zypper
• Yay (AUR)

Installation

sudo pip3 install .

Usage

Remote Search

usage: si search [-h] [--source [{flatpak,pacman,yay} ...]] [--status [{N,I,U} ...]] [--column [{STATUS,SOURCE,REF,NAME,AVAILABLE,INSTALLED} ...]] [--csv] [--noheader] TERM [TERM ...]

positional arguments:
  TERM                  terms to search for

options:
  -h, --help            show this help message and exit
  --source [{flatpak,pacman,yay} ...]
                        sources to search
  --status [{N,I,U} ...]
                        filter results on installation status: [N]ot installed, [I]nstalled, [U]pdate available
  --column [{STATUS,SOURCE,REF,NAME,AVAILABLE,INSTALLED} ...]
                        choose the columns in results table
  --csv                 output table in CSV format
  --noheader            suppress outputting the header row

Local Search

usage: si local [-h] [--source [{flatpak,pacman,yay} ...]] [--status [{N,I,U} ...]] [--column [{STATUS,SOURCE,REF,NAME,AVAILABLE,INSTALLED} ...]] [--csv] [--noheader] [TERM ...]

positional arguments:
  TERM                  terms to search for

options:
  -h, --help            show this help message and exit
  --source [{flatpak,pacman,yay} ...]
                        sources to search
  --status [{N,I,U} ...]
                        filter results on installation status: [N]ot installed, [I]nstalled, [U]pdate available
  --column [{STATUS,SOURCE,REF,NAME,AVAILABLE,INSTALLED} ...]
                        choose the columns in results table
  --csv                 output table in CSV format
  --noheader            suppress outputting the header row

Show Package Info

usage: si info [-h] REF

positional arguments:
  REF         package reference

options:
  -h, --help  show this help message and exit

Install Package

usage: si install [-h] REF

positional arguments:
  REF         package reference

options:
  -h, --help  show this help message and exit

Remove Package

usage: si remove [-h] REF

positional arguments:
  REF         package reference

options:
  -h, --help  show this help message and exit

Update Packages

usage: si update [-h] [--source [{flatpak,pacman,yay} ...]] [--noconfirm] [--force] [REF ...]

positional arguments:
  REF                   package reference

options:
  -h, --help            show this help message and exit
  --source [{flatpak,pacman,yay} ...]
                        sources to update
  --noconfirm           update without asking for confirmation
  --force               run pre/post tasks even if there are no updates available

Configuration

Optionally, you can configure the tool with a config file placed at

~/.config/softwareinstaller/config

Each line is a KEY=VALUE pair.

Configuration options

apps.ref.delimiter=<DELIMITER>

Default: :

Determines the delimiter in application references.

sources.autodetect=true|false

Default: true

Automatically detects available sources by checking for installed tools.

sources.<SOURCE_ID>.enable=true|false

Explicitly enables or disables a given source.

install.tasks.pre=<COMMAND>
install.tasks.post=<COMMAND>
remove.tasks.pre=<COMMAND>
remove.tasks.post=<COMMAND>
update.tasks.pre=<COMMAND>
update.tasks.post=<COMMAND>

Adds a script or command to be run before or after an install, remove or update run. Can be a shell command. These options can each be given as many times as needed, and will run each task in the order given.

softwareinstaller's Issues

Update - option to force run

Option to force an update run even if there are no updates to apply, to force the running of pre/post tasks.

--force

Performance

Speed up slow code, especially flatpak installed apps loading.

Argument to enable/disable log output

--silent - disables log output which is enabled by default

Config file option:
logs.console.enabled=true|false (default true)

When console logging is enabled, source output is routed to console.

Remove user from app property

Make part of flatpak ref.

Update pre/post scripts

Requires config file support.

update.tasks.pre=/path/to/script
update.tasks.post=/path/to/script

Options are arrays, so you can add as many "update.tasks.pre" options for example as you want and it'll append to an array.

Runs tasks either before or after an update, in number order.

Flatpak - system mode

Fix remote info so it works with system remotes/apps.
Test all functionality works.

Flatpak - config to default to user mode

sources.flatpak.defaultmode=user|system (default system)

Flatpak getapp - needs to use remote

Otherwise it will return the same app installed from a different remote

sources.<SOURCE_ID>.enable = false disables a source

If autodetect is true, it should be possible to disable sources with this option.

Config file

Looks in $XDG_CONFIG_HOME/softwareinstaller/ for a file called "config"

Is a key=value list

Options:
sources.autodetect=true|false (default true)
sources.<SOURCE>.enable=true|false (default false)

Config option for ref delimiter

ref.delimiter

defaults to % possibly