The Fluffy, Multipurpose Package Manager :3

Woah, a package manager! This is mostly just a fun project to play around, though I will likely use myself to simplify installations.

Right now it's lacking a lot of features: uninstall, modify, upgrade, etc... but these should be coming soon!

I run Debian, and that is where my testing is done. If you encounter any errors, feel free to file issues or pull requests!

Simply clone (or download) the repo and link the python script to your path:

For example:

(cd into the folder you want to install the source into)
git clone https://github.com/Thawnyrose/fluffpkg
ln -s ~/Applications/fluffpkg/fluffpkg.py ~/.local/bin/fluffpkg
(If you want fluffpkg packages to be executable)
echo 'export PATH="~/.fluffpkg/bin":$PATH' >> ~/.bashrc

To uninstall, delete the symlink at ~/.local/bin/fluffpkg, remove the folder you installed the source into, and undo the path export. It is HIGHLY recommended to first uninstall all packages installed by fluffpkg first, otherwise dangling files or symlinks may be left such as broken launcher files, etc... that could prove difficult to manually find and cleanup

To update, simply go to the source folder and run git fetch to pull the newest source

No sources are provided by default. Instead, use the fluffpkg source-add <source> command to add remote (nyi) or local sources. Some modules (such as the github-appimage) provide commands to easily add packages to the local source and install them, but for some that is not possible.

Usage: install [--nolauncher] [--version = ] <packages...>

Searches through local sources for packages to install them.

Usage: fluffpkg list [--installed]

Lists packages found in sources, or packages that are installed. Note that these come from different databases, and there's no guarantee an installed package is in the sources, or the other way round.

Usage: upgrade [--force] [packages...]

If the package is installed, checks for upgrades and applies them

Usage: fluffpkg remove <packages...>

If the package is installed, uninstalls it

Usage: modify <package> <attribute> ...
Attributes:
  add-launcher           Add a launcher entry for the package
  remove-launcher        Remove the launcher entry for the package
  add-categories         Add categories to the launcher entry
  remove-categories      Remove categories from the launcher entry

Applies the given modification

Usage: fluffpkg versions <package>

Lists all versions available for installation

add-github-appimage <owner/repo...>

Adds the given repo to the local sources

install-github-appimage <owner/repo...>

Adds the given repo to the local sources, and installs it

Uses Github's API to find the most recent release (not pre-release), then searches through the assets to find an appimage. If there are multiple, it tries to filter by system architecture.

Example:

moduleLib.register(
    "github-appimage",
    {
        "install": install,
        "remove": remove,
        "upgrade": upgrade,
        "versions": versions,
        "commands": [
            (
                Command(
                    "add-github-appimage",
                    "Adds installation candidates for github appimages",
                    [PosArgs("owner/repo")],
                ),
                add_cmd,
            ),
            (
                Command(
                    "install-github-appimage",
                    "Adds and installs github appimages",
                    [
                        FlagArg("-l", "--nolauncher", "Don't install .desktop files"),
                        ValueArg("-v", "--version", "Specify a version for installation"),
                        PosArgs("owner/repo"),
                    ],
                ),
                add_install_cmd,
            ),
        ],
    },
)

install(candidate: Candidate, cmd_args: dict)
remove(installation: Installation, cmd_args: dict)
upgrade(installation: Installation, cmd_args: dict)
versions(installation: Installation, cmd_args: dict)

add_cmd(cmd_args: dict)
remove_cmd(cmd_args: dict)
add_install_cmd(cmd_args: dict)

• versions [--show <amount>] option

• lowercase those random API things in the github appimage module

• prevent adding integer named sources, just in case....

• Externalize system stuff like 'picking synonyms for a system architecture' to a library

• github deb source

• tab autocomplete in terminal

• Show file size in download display - and progress bar?

• Add command to show what updates are available: perhaps a status in the list? Merge with [L]?

• Change list default to --installed?

• bug: ./fluffpkg.py show rapidraw categories causes an error

• Upgrade asks for filter selection twice

• work on show command's flexibility

• autoapplying filters in github appimage isn't removable? Now you can choose to ignore!

• .deb sources

• Add remote source

• Remove/update remote source

• Maybe: Case sensitive categories

• Support path in appimage

• get-exec-path command

• Fix help for advanced show and modify commands

• user_pick to general

• appimage source filtering

• Remove unused 'categories' column from 'installs' table

• Better docs (marginally, at least...)

• If the source is manual and you manipulate categories, you should also do so for their installation candidates for updates

• Add modify target for 'list-categories'?

• Better format help

• Better argument system

• Fix new argument system to also support module

• List versions of a file

• Install specific version

• Version lock

• Dynamic Modules

• Databases instead of json!