.. contents:: Table of Contents:


About
-----

Slpkg is a software package manager that installs, updates and removes packages on `Slackware <http://www.slackware.com/>`_-based systems.
It automatically calculates dependencies and figures out what things need to happen to install packages. 
Slpkg makes it easier to manage groups of machines without the need for manual updates.

Slpkg works in accordance with the standards of the `SlackBuilds.org <https://www.slackbuilds.org>`_ organization to build packages. 
It also uses the Slackware Linux instructions for installing, upgrading or removing packages.

.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/slpkg_package.png
    :target: https://gitlab.com/dslackw/slpkg


Requirements
------------

.. code-block:: bash

    SQLAlchemy >= 1.4.36
    pythondialog >= 3.5.3
    toml >= 0.10.2

Install
-------

Install from the official third-party `SBo repository <https://slackbuilds.org/repository/15.0/system/slpkg/>`_ or directly from source:

.. code-block:: bash

    $ tar xvf slpkg-4.4.4.tar.gz
    $ cd slpkg-4.4.4
    $ ./install.sh

Screenshots
-----------

.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/configs.png
    :target: https://gitlab.com/dslackw/slpkg

.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/install.png
    :target: https://gitlab.com/dslackw/slpkg

.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/install_next.png
    :target: https://gitlab.com/dslackw/slpkg

.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/dependees_next.png
    :target: https://gitlab.com/dslackw/slpkg

.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/view_next.png
    :target: https://gitlab.com/dslackw/slpkg

.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/remove_next.png
    :target: https://gitlab.com/dslackw/slpkg


Usage
-----

.. code-block:: bash

    $ slpkg --help
      USAGE: slpkg [OPTIONS] [COMMAND] <packages>

      DESCRIPTION:
        Packaging tool that interacts with the SBo repository.

      COMMANDS:
        update                        Update the package lists.
        upgrade                       Upgrade all the packages.
        check-updates                 Check for news on ChangeLog.txt.
        configs                       Edit the configuration file.
        clean-logs                    Clean dependencies log tracking.
        clean-tmp                     Deletes all the downloaded sources.
        -b, build <packages>          Build only the packages.
        -i, install <packages>        Build and install the packages.
        -d, download <packages>       Download only the scripts and sources.
        -r, remove <packages>         Remove installed packages.
        -f, find <packages>           Find installed packages.
        -w, view <packages>           View packages from the repository.
        -s, search <packages>         Search and print packages from the repository.
        -e, dependees <packages>      Show which packages depend.
        -t, tracking <packages>       Tracking the packages dependencies.

      OPTIONS:
        --yes                         Answer Yes to all questions.
        --jobs                        Set it for multicore systems.
        --resolve-off                 Turns off dependency resolving.
        --reinstall                   Upgrade packages of the same version.
        --skip-installed              Skip installed packages.
        --full-reverse                Full reverse dependency.                        │
        --search                      Search packages from the repository.

        -h, --help                    Show this message and exit.
        -v, --version                 Print version and exit.

      If you need more information try to use slpkg manpage.


    $ slpkg install Flask
      The following packages will be installed or upgraded:

      [ install ] -> Flask-2.1.2

      Dependencies:
      [ install ] -> python-zipp-3.8.0
      [ install ] -> python-importlib_metadata-4.10.1
      [ install ] -> click-8.1.3
      [ install ] -> python3-itsdangerous-2.1.2
      [ install ] -> werkzeug-2.1.2

      Total 6 packages will be installed and 0 will be upgraded.

      Do you want to continue (y/N)?:


    $ slpkg remove Flask
      The following packages will be removed:

      [ delete ] -> Flask-2.1.2-x86_64-1_SBo

      Dependencies:
      [ delete ] -> python-zipp-3.8.0-x86_64-2_SBo
      [ delete ] -> python-importlib_metadata-4.10.1-x86_64-1_SBo
      [ delete ] -> click-8.1.3-x86_64-1_SBo
      [ delete ] -> python3-itsdangerous-2.1.2-x86_64-1_SBo
      [ delete ] -> werkzeug-2.1.2-x86_64-1_SBo

      Total 6 packages will be removed.

      Do you want to continue (y/N)?:


    $ slpkg dependees vlc --full-reverse
      The list below shows the packages that dependees 'vlc' files:

      Collecting the data...

      vlc
       └─kaffeine
           ├─ vlc
         obs-studio
           ├─ faac luajit rtmpdump x264 jack libfdk-aac mbedtls vlc
         vlsub
           ├─ vlc
         sopcast-player
           └─ sopcast vlc

      4 dependees for vlc


    $ slpkg tracking Flask python3-pylint slpkg
      The list below shows the packages with dependencies:

      slpkg
       └─ greenlet python-toml SQLAlchemy

      3 dependencies for slpkg

      python3-pylint
       └─ python3-wrapt python3-lazy-object-proxy python3-platformdirs python3-tomlkit python3-dill python3-mccabe python3-isort python3-astroid python-toml

      9 dependencies for python3-pylint

      Flask
       └─ python-zipp python-importlib_metadata click python3-itsdangerous werkzeug

      5 dependencies for Flask


Configuration files
-------------------

.. code-block:: bash

    /etc/slpkg/slpkg.toml
        General configuration of slpkg

    /etc/slpkg/blacklist.toml
        Blacklist of packages

Donate
------

If you feel satisfied with this project and want to thanks me make a donation.

.. image:: https://gitlab.com/dslackw/images/raw/master/donate/paypaldonate.png
   :target: https://www.paypal.me/dslackw


Copyright
---------

- Copyright 2014-2022 © Dimitris Zlatanidis.
- Slackware® is a Registered Trademark of Patrick Volkerding. 
- Linux is a Registered Trademark of Linus Torvalds.