slpkg/README.md
Dimitris Zlatanidis 1cdff902d4 Convert to markdown format
Signed-off-by: Dimitris Zlatanidis <d.zlatanidis@gmail.com>
2019-01-18 21:25:08 +01:00

14 KiB

Title: Slpkg Date: 2019-1-18 08:21 Authors: dslackw Category: Home Slug: home

alt text

alt text

About

Slpkg is a powerful software package manager that installs, updates, and removes packages on Slackware based systems. It automatically computes dependencies and figures out what things should occur to install packages. Slpkg makes it easier to maintain groups of machines without having to manually update. Slpkg works in accordance with the standards of the organization slackbuilds.org to builds packages. Also uses the Slackware Linux instructions for installation, upgrading or removing packages. What makes slpkg to distinguish it from the other tools; The user friendliness it's a primary target as well as easy to understand and use, also use colors to highlight packages and display warning messages, etc.

Features
  • Dependency resolution
  • Dependencies visualizations
  • Multiple options
  • Multiple repositories
  • Easy configuration
  • Fully configurable
  • Adaptability
  • Powerful options
  • Source builder
  • Faster process
  • Better Security
Installation

Download the latest release

(Required root privileges)

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

Installed as Slackware package

Uninstall:

$ slpkg -r slpkg

or

$ removepkg slpkg

Using pip:

$ pip install https://gitlab.com/dslackw/slpkg/-/archive/3.3.8/slpkg-3.3.8.tar.gz

Uninstall:

$ pip uninstall slpkg

Data remove run from source code:

$ python clean.py
Requirements

(See requirements.txt{:target="_blank"} file)

Upgrade

Since the version 2.1.4 you can update slpkg itself with the command slpkg update slpkg. In each slpkg upgrade you will have to keep track of changes to the configuration files in the directory /etc/slpkg.

Stay updated, see SUN (Slackware Update Notifier){:target="_blank"}

Optional dependencies
  • python2-pythondialog{:target="_blank"} for dialog box interface
  • pygraphviz{:target="_blank"} for drawing dependencies diagram
  • graph-easy{:target="_blank"} for drawing ascii dependencies diagram
  • httpie alternative downloader
  • aria2{:target="_blank"} alternative downloader
Demonstration

{:target="_blank"}

Youtube Asciicasts

Playlist Tutorials{:target="_blank"}

Repositories

Default available Repositories:

  • SBo{:target="_blank"} Arch: {x86, x86_64} Versions: {13.1, 13.37, 14.0, 14.1, 14.2}
  • Slack{:target="_blank"} Arch: {x86, x86_64} Versions: {3.3, 8.1, 9.0, 9.1, 10.0, 10.1, 10.2, 11.0, 12.0, 12.2, 13.0, 13.37, 14.0, 14.1, 14.2, current}
  • Alien's{:target="_blank"} Arch: {x86, x86_64} Versions: {13.0, 13.1, 13.37, 14.0, 14.1, 14.2, current}
  • Slacky{:target="_blank"} Arch: {x86, x86_64} Versions: {11.0, 12.0, 12.1, 12.2, 13.0, 13.1, 13.37, 14.0, 14.1, 14.2}
  • Robby's{:target="_blank"} Arch: {x86, x86_64} Versions: {11.0, 12.0, 12.1, 12.2, 13.0, 13.1, 13.37, 14.0, 14.1, 14,2}
  • Conraid's{:target="_blank"} Arch: {x86_64} Versions: {current}
  • Slackonly{:target="_blank"} Arch: {x86, x86_64} Versions: {14.1, 14.2}
  • Alien's ktown{:target="_blank"} Arch: {x86, x86_64} Versions: {13.37, 14.0, 14.1, 14.2, current}
  • Alien's multi{:target="_blank"} Arch: {x86_64} Versions: {13.0, 13.1, 13.37, 14.0, 14.1, 14.2, current}
  • Slacke E17 and E18{:target="_blank"} Arch: {x86, x86_64, arm} Versions: {14.1}
  • SalixOS{:target="_blank"} Arch: {x86, x86_64} Versions: {13.0, 13.1, 13.37, 14.0, 14.1, 14.2}
  • Slackel{:target="_blank"} Arch: {x86, x86_64} Versions: {current}
  • Restricted{:target="_blank"} Arch: {x86, x86_64} Versions: {11.0, 12.0, 12.1, 12.2, 13.0, 13.1, 13.37, 14.0, 14,1, 14.2, current}
  • MATE Desktop Environment{:target="_blank"} Arch: {x86, x86_64} Versions: {14.0, 14,1, 14.2, current}
  • Cinnamon Desktop Environment{:target="_blank"} Arch: {x86, x86_64} Versions: {14,1, 14.2, current}
  • Connochaetos (Slack-n-Free){:target="_blank"} Arch: {x86, x86_64} Versions: {14,1, 14.2}
  • Microlinux mles{:target="_blank"} Arch: {x86, x86_64} Versions: {14,1, 14.2}

Choose default repositories you need to work from the file /etc/slpkg/repositories.conf defaults are slack and sbo repositories and please read the REPOSITORIES file for each of the particularities. If a repository is not in the above list, manage the custom repositories with the commands repo-add and repo-remove.

Issues

Please report any bugs in ISSUES{:target="_blank"}

Testing

The majority of trials have been made in an environment Slackware x86_64 'stable'.

Slackware Current

For Slackware 'current' users must to change the variable VERSION in /etc/slpkg/slpkg.conf file.

$ slpkg -g edit
Slackware ARM

Must you use only two repositories currently there are 'slack' and 'sbo'.

Slackware Mirrors Slpkg uses the central mirror "http://mirrors.slackware.com/slackware/" to find the nearest one. If however for some reason this troublesome please edit the file in /etc/slpkg/slackware-mirrors.

Slpkg configuration

It is important to read the configuration file /etc/slpkg/slpkg.conf. You will find many useful options to configure the program so as you need it.

Configuration files
  • /tmp/slpkg
    • Slpkg temponary donwloaded files and build packages
  • /etc/slpkg/slpkg.conf
    • General configuration of slpkg
  • /etc/slpkg/repositories.conf
    • Configuration file for repositories
  • /etc/slpkg/blacklist
    • List of packages to skip
  • /etc/slpkg/slackware-mirrors
    • List of Slackware Mirrors
  • /etc/slpkg/default-repositories
    • List of default repositories
  • /etc/slpkg/custom-repositories
    • List of custom repositories
  • /etc/slpkg/pkg_security
    • List of packages for security reasons
  • /var/log/slpkg
    • ChangeLog.txt repositories files
    • SlackBuilds logs and dependencies files
  • /var/lib/slpkg
    • PACKAGES.TXT files
    • SLACKBUILDS.TXT files
    • CHECKSUMS.md5 files
    • FILELIST.TXT files
Command Line Tool Usage
Slpkg is a user-friendly package manager for Slackware installations

Usage: slpkg [COMMANDS|OPTIONS] {repository|package...}
                                                   _       _
                                               ___| |_ __ | | ____ _
                                              / __| | '_ \| |/ / _` |
                                              \__ \ | |_) |   < (_| |
                                              |___/_| .__/|_|\_\__, |
                                                    |_|        |___/

                                             _Slackware package manager_______
Commands:
   update, --only=[...]                      Run this command to update all
                                             the packages list.

   upgrade, --only=[...]                     Delete and recreate all packages
                                             lists.

   repo-add [repository name] [URL]          Add custom repository.

   repo-remove [repository]                  Remove custom repository.

   repo-enable                               Enable or disable default
                                             repositories via dialog utility.

   repo-list                                 Print a list of all the
                                             repositories.

   repo-info [repository]                    Get information about a
                                             repository.

   update slpkg                              Upgrade the program directly from
                                             repository.

   health, --silent                          Health check installed packages.

   deps-status, --tree, --graph=[type]       Print dependencies status used by
                                             packages or drawing dependencies
                                             diagram.

   new-config                                Manage .new configuration files.

Optional arguments:
  -h | --help                                Print this help message and exit.

  -v | --version                             Print program version and exit.

  -a | --autobuild, [script] [source...]     Auto build SBo packages.
                                             If you already have downloaded the
                                             script and the source code you can
                                             build a new package with this
                                             command.

  -b | --blacklist, [package...] --add,      Manage packages in the blacklist.
       --remove, list                        Add or remove packages and print
                                             the list. Each package is added
                                             here will not be accessible by the
                                             program.

  -q | --queue, [package...] --add,          Manage SBo packages in the queue.
       --remove, list, build, install,       Add or remove and print the list
       build-install                         of packages. Build and then
                                             install the packages from the
                                             queue.

  -g | --config, print, edit, reset          Configuration file management.
                                             Print, edit the configuration file
                                             or reset in the default values.

  -l | --list, [repository], --index,        Print a list of all available
       --installed, --name                   packages from repository, index or
                                             print only packages installed on
                                             the system.

  -c | --check, [repository], --upgrade,     Check for updated packages from
       --skip=[...], --resolve--off          the repositories and upgrade or
       --checklist                           install with all dependencies.

  -s | --sync, [repository] [package...],    Sync packages. Install packages
       --rebuild, --reinstall,               directly from remote repositories
       --resolve-off, --download-only,       with all dependencies.
       --directory-prefix=[dir],
       --case-ins, --patches

  -t | --tracking, [repository] [package],   Tracking package dependencies and
       --check-deps, --graph=[type],         print package dependencies tree
       --case-ins                            with highlight if packages is
                                             installed. Also check if
                                             dependencies used or drawing
                                             dependencies diagram.

  -p | --desc, [repository] [package],       Print description of a package
       --color=[]                            directly from the repository and
                                             change color text.

  -n | --network, [package], --checklist,    View a standard of SBo page in
       --case-ins                            terminal and manage multiple
                                             options like reading, downloading,
                                             building, installation, etc.

  -F | --FIND, [package...], --case-ins      Find packages from each enabled
                                             repository and view results.

  -f | --find, [package...], --case-ins,     Find and print installed packages
       --third-party                         reporting the size and the sum.

  -i | --installpkg, [options] [package...]  Installs single or multiple .tgz
       options=[--warn, --md5sum, --root,    (or .tbz, .tlz, .txz) Slackware
       --infobox, --menu, --terse, --ask,    binary packages designed for use
       --priority, --tagfile]                with the Slackware Linux
                                             distribution onto your system.

  -u | --upgradepkg, [options] [package...]  Upgrade single or multiple
       options=[--dry-run, --install-new,    Slackware binary packages from
       --reinstall, --verbose]               an older version to a newer one.

  -r | --removepkg, [options] [package...],  Removes a previously installed
       --deps, --check-deps, --tag,          Slackware binary packages,
       --checklist, --third-party            while writing a progress report
       options=[-warn, -preserve, -copy,     to the standard output.
       -keep]                                Use only package name.

  -d | --display, [package...]               Display the contents of installed
                                             packages and file list
Donate

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

{:target="_blank"}

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