slpkg/README.rst

.. image:: https://img.shields.io/github/release/dslackw/slpkg.svg
    :target: https://github.com/dslackw/slpkg/releases
.. image:: https://travis-ci.org/dslackw/slpkg.svg?branch=master
    :target: https://travis-ci.org/dslackw/slpkg
.. image:: https://landscape.io/github/dslackw/slpkg/master/landscape.png
    :target: https://landscape.io/github/dslackw/slpkg/master
.. image:: https://img.shields.io/codacy/6464ba0bd1e342e28388c71a34b3a5e8.svg
    :target: https://www.codacy.com/public/dzlatanidis/slpkg/dashboard
.. image:: https://img.shields.io/pypi/dm/slpkg.svg
    :target: https://pypi.python.org/pypi/slpkg
.. image:: https://img.shields.io/sourceforge/dt/slpkg.svg
    :target: https://sourceforge.net/projects/slpkg/
.. image:: https://img.shields.io/badge/license-GPLv3-blue.svg
    :target: https://github.com/dslackw/slpkg
.. image:: https://img.shields.io/github/stars/dslackw/slpkg.svg
    :target: https://github.com/dslackw/slpkg
.. image:: https://img.shields.io/github/forks/dslackw/slpkg.svg
    :target: https://github.com/dslackw/slpkg
.. image:: https://img.shields.io/github/issues/dslackw/slpkg.svg
    :target: https://github.com/dslackw/slpkg/issues
 
|

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

|

.. image:: https://raw.githubusercontent.com/dslackw/images/master/slpkg/poweredbyslack.gif
    :target: http://www.slackware.com/
|

.. contents:: Table of Contents:


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 occurto 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 other tools; The user friendliness is its primary 
target as well as easy to understand and use, also use color to highlight packages and 
display warning messages, etc.

Also you can install official packages of your favorite distribution directly from the 
official repositories of Slackware. Even you can check for the official updates and install them.


Repositories
------------

Default available Repositories:

- `SBo <http://slackbuilds.org/>`_
  Arch: {x86, x86_64}
  Versions: {13.1, 13.37, 14.0, 14.1}
- `Slack <http://www.slackware.com/>`_
  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, current}
- `Alien's <http://www.slackware.com/~alien/slackbuilds/>`_
  Arch: {x86, x86_64}
  Versions: {11.0, 12.0, 12.1, 12.2, 13.0, 13.1, 13.37, 14.0, 14.1, current}
- `Slacky <http://repository.slacky.eu/>`_
  Arch: {x86, x86_64}
  Versions: {11.0, 12.0, 12.1, 12.2, 13.0, 13.1, 13.37, 14.0, 14.1}
- `Robby's <http://rlworkman.net/pkgs/>`_
  Arch: {x86, x86_64}
  Versions: {11.0, 12.0, 12.1, 12.2, 13.0, 13.1, 13.37, 14.0, 14.1}
- `Studioware <http://studioware.org/packages>`_
  Arch: {x86, x86_64}
  Versions: {13.37, 14.0, 14.1}
- `Slackers <http://www.slackers.it/repository/>`_
  Arch: {x86_64}
  Versions: {current}
- `Slackonly <https://slackonly.com/>`_
  Arch: {x86, x86_64}
  Versions: {14.1}
- `Alien's ktown <http://alien.slackbook.org/ktown/>`_
  Arch: {x86, x86_64}
  Versions: {13.37, 14.0, 14.1, current}
- `Alien's multi <http://www.slackware.com/~alien/multilib/>`_
  Arch: {x86_64}
  Versions: {13.0, 13.1, 13.37, 14.0, 14.1, current}
- `Slacke E17 and E18 <http://ngc891.blogdns.net/pub/>`_
  Arch: {x86, x86_64, arm}
  Versions: {14.1}
- `SalixOS <http://download.salixos.org/>`_
  Arch: {x86, x86_64}
  Versions: {13.0, 13.1, 13.37, 14.0, 14.1}
- `Slackel <http://www.slackel.gr/repo/>`_
  Arch: {x86, x86_64}
  Versions: {current}
- `Restricted <http://taper.alienbase.nl/mirrors/people/alien/restricted_slackbuilds/>`_
  Arch: {x86, x86_64}
  Versions: {11.0, 12.0, 12.1, 12.2, 13.0, 13.1, 13.37, 14.0, 14,1, current}


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


Usage
-----

Need to run '$ slpkg update' for the first time to synchronize the list of packages,
also every time you add a new repository.
To add or remove repositories must edit the file '/etc/slpkg/slpkg.conf'.

Add custom repositories with the command '$ slpkg add-repo <repository name> <URL>' and after
run '$ slpkg update' to update package list.

View list of repositories with command '$ slpkg repo-list' or get repository information with
command '$ slpkg repo-info <repository>.

If you have already downloaded the script and the source code you can build the package with 
the command '$ slpkg <script.tar.gz> <sources>'.

Manage packages in the black list with the command '$ slpkg -b <packages> --add or --remove'.

Add SBo packages to queue with command '$ slpkg -q <packages> --add or --remove' and manage as 
build, install or build and install with command '$ slpkg build or install or build-install'.
This is very useful if you want to install multiple packages together suffice to add in the right 
order if there are dependent packages.

View list of packages from specific repository with command '$ slpkg -l <repository>'.
Combine with the command 'grep' to catch the results you want.

Check and upgrade the distribution of your upgrade your packages with command '$ slpkg -c <repository> 
--upgrade'. Don't forget to update packages list before (for 'slack' repository don't is necessary).
This command except upgrade packages will fix packages with broken dependencies. Switch  off automatic
resolve dependensies with additional option '--resolve-off'.

The most famous command is "$ slpkg -s <repository> <packages>" , this command downloads and 
installs packages with resolve all the dependencies or switch of resolve with additional option
'--resolve-off'.

Watch the dependencies of a package with command '$ slpkg -t <repository> <package>'.
Displays a package dependency tree and also tells you which ones are installed on your system events.

Get information description of a package with command '$ slpkg -p <repository> <package>' and change
color text with additional flag '--color=[]'.

View a page SBo package on your terminal with command '$ slpkg -n <package>' and then manage multiple 
choices such read, download, build, install etc.

If you want to find packages from all repositories, this command will solve your hands '$ slpkg -F 
<packages>'. It will search in all enabled repositories will find the configuration file 
'/etc/slpkg/slpkg.conf' will print all the packages that match the description that you enter.

If you want to see if any packages are installed on your system enter the command '$ slpkg -f <packages>'.
The surprise in the end is the reporting of packages sum and size found.

The next four commands '$ slpkg -i, -u, -o, -r <packages>' install, upgrade, reinstall, or remove 
packages from your system events.
Notable mention must give the command '$ slpkg -r <packages>' which can remove a packages with all 
dependencies together after editing configuration file '/etc/slpkg/slpkg.conf' (default is disable).

The last command is useful to print the entire contents of a package installed on the system with the
command '$ slpkg -d <packages>'.

Some examples you will see below.


Issues
------

Please report any bugs in `ISSUES <https://github.com/dslackw/slpkg/issues>`_


Testing
-------

The majority of trials have been made in an environment Slackware x86_64 'stable' 
and x86 'current' version 14.1.


Features
--------

- Build third party packages from source with all dependencies
- Grabs packages from repositories in real time
- Find and Download packages from repositories 
- Automatic tool build and install packages
- Check if your distribution is up to date
- Remove packages with all dependencies
- Display the contents of the packages
- Install-upgrade Slackware packages
- Build and install all in a command
- Find packages from repositories
- Checking for updated packages
- List all installed packages
- Support MD5SUM file check
- Find installed package
- Read SlackBuilds files
- Τracking dependencies
- Build log file
- Sum build time

It's a quick and easy way to manage your packages in `Slackware <http://www.slackware.com/>`_
to a command.

Tutorial
--------

.. image:: https://raw.githubusercontent.com/dslackw/images/master/slpkg/screenshot-1.png
    :target: https://asciinema.org/a/16251


Installation
------------

Untar the archive and run install.sh script:

.. code-block:: bash
    
    $ tar xvf slpkg-<version>.tar.gz
    $ cd slpkg-<version>
    $ ./install.sh

Using pip:

.. code-block:: bash
    
    $ pip install slpkg --upgrade
    
    Uninstall:

    $ pip uninstall slpkg

    and clean data run clean.py from source code:

    $ python clean.py

Bbinary packages:

Slackware: `slpkg-2.4.3-i486-1_dsw.txz <https://github.com/dslackw/slpkg/releases/download/v2.4.3/slpkg-2.4.3-i486-1_dsw.txz>`_

Slackware64: `slpkg-2.4.3-x86_64-1_dsw.txz <https://github.com/dslackw/slpkg/releases/download/v2.4.3/slpkg-2.4.3-x86_64-1_dsw.txz>`_


Upgrade
-------

From version '2.1.4' you can update slpkg itself with '# slpkg update slpkg'.
In each slpkg upgrade should track the configuration files in the folder '/etc/slpkg' 
for changes.


Slackware Current
-----------------

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

.. code-block:: bash

    $ slpkg -g config=nano


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'.


Configuration Files
-------------------

.. code-block:: bash

    /tmp/slpkg
         Slpkg temponary donwloaded files and build packages

    /etc/slpkg/slpkg.conf
         General configuration of slpkg

    /etc/slpkg/blacklist
         List of packages to skip

    /etc/slpkg/slackware-mirrors
         List of Slackware Mirrors

    /etc/slpkg/custom-repositories
         List of custom repositories

    /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

    /etc/slpkg/slackware-changelogs-mirror
         Slackware changelogs mirror

     
Command Line Tool Usage
-----------------------

.. code-block:: bash
    
    Slpkg is a user-friendly package manager for Slackware installations
                                                     _       _
                                                 ___| |_ __ | | ____ _
                                                / __| | "_ \| |/ / _` |
                                                \__ \ | |_) |   < (_| |
                                                |___/_| .__/|_|\_\__, |
                                                      |_|        |___/

    Commands:
       update                                   Run this command to update all
                                                the packages list.
       upgrade                                  Delete and recreate all packages
                                                lists.
       repo-add [repository name] [URL]         Add custom repository.
       repo-remove [repository]                 Remove custom repository.
       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.

    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=[editor]        Configuration file management.
                                                Print the configuration file or
                                                edit.
      -l, --list, [repository], --index,        Print a list of all available
          --installed                           packages repository, index or print
                                                only packages installed on the
                                                system.
      -c, --check, [repository] --upgrade,      Check, view and install updated
          --skip=[] --resolve-off               packages from repositories.
      -s, --sync, [repository] [package...],    Sync packages. Install packages
          --resolve-off                         directly from remote repositories
                                                with all dependencies.
      -t, --tracking, [repository] [package]    Tracking package dependencies and
                                                print package dependenies tree with
                                                highlight if packages is installed.
      -p, --print, [repository] [package],      Print description of a package
          --color=[]                            directly from the repository and
                                                change color text.
      -n, --network, [package]                  View a standard of SBo page in
                                                terminal and manage multiple options
                                                like reading, downloading, building
                                                installation, etc.
      -F, --FIND, [package...]                  Find packages from repositories and
                                                search at each enabled repository
                                                and prints results.
      -f, --find, [package...]                  Find and print installed packages
                                                reporting the size and the sum.
      -i, --install, [package...]               Installs single or multiple
                                                Slackware binary packages.
      -u, --upgrade, [package...]               Upgrade single or multiple Slackware
                                                binary packages from a older to a
                                                newer one.
      -o, --reinstall, [package...]             Reinstall signle or multiple
                                                Slackware binary packages with the
                                                same packages if the exact.
      -r, --remove, [package...]                Removes a previously installed
                                                Slackware binary packages.
      -d, --display, [package...]               Display the installed packages 
                                                contents and file list.

Slpkg Examples
--------------


If you use slpkg for the first time will have to create and update the package 
list. This command must be executed to update the package lists:

.. code-block:: bash

    $ slpkg update

    Update repository slack .......................Done
    Update repository sbo .............Done
    Update repository alien ...Done
    Update repository slacky .....................................Done
    Update repository studio ...................Done
    Update repository slackr .............................................Done
    Update repository slonly ...Done
    Update repository ktown ...Done
    Update repository salix ..................Done
    Update repository slacke ...Done
    Update repository slackl ...Done
    Update repository multi ...Done


Add and remove custom repositories:

.. code-block:: bash

    $ slpkg repo-add ponce http://ponce.cc/slackware/slackware64-14.1/packages/

    Repository 'ponce' successfully added


    $ slpkg repo-remove ponce

    Repository 'ponce' successfully removed

    
View information about the repositories:
    
.. code-block:: bash

    $ slpkg repo-list
    
    +==============================================================================
    | Repo id  Repo URL                                            Default   Status
    +==============================================================================
      alien    http://www.slackware.com/~alien/slackbuilds/        yes     disabled
      ktown    http://alien.slackbook.org/ktown/                   yes     disabled
      multi    http://www.slackware.com/~alien/multilib/           yes     disabled
      ponce    http://ponce.cc/slackware/slackware64-14.1/packa~   no       enabled
      rested   http://taper.alienbase.nl/mirrors/people/alien/r~   yes     disabled
      rlw      http://rlworkman.net/pkgs/                          yes     disabled
      salix    http://download.salixos.org/                        yes     disabled
      sbo      http://slackbuilds.org/slackbuilds/                 yes      enabled
      slack    http://ftp.cc.uoc.gr/mirrors/linux/slackware/       yes      enabled
      slacke   http://ngc891.blogdns.net/pub/                      yes     disabled
      slackl   http://www.slackel.gr/repo/                         yes     disabled
      slackr   http://www.slackers.it/repository/                  yes     disabled
      slacky   http://repository.slacky.eu/                        yes     disabled
      slonly   https://slackonly.com/pub/packages/                 yes     disabled
      studio   http://studioware.org/files/packages/               yes     disabled

    For enable or disable default repositories edit '/etc/slpkg/slpkg.conf' file

    $ slpkg repo-info alien

    Default: yes
    Last updated: Tue Dec 23 11:48:31 UTC 2014
    Number of packages: 3149
    Repo id: alien
    Repo url: http://www.slackware.com/~alien/slackbuilds/
    Status: enabled
    Total compressed packages: 9.3 Gb
    Total uncompressed packages: 36.31 Gb


Installing packages from the repositories (supporting multi packages):

.. code-block:: bash
    
    $ slpkg -s sbo brasero
    Reading package lists .....Done
    Resolving dependencies ....Done

    The following packages will be automatically installed or upgraded 
    with new version:

    +==============================================================================
    | Package                 Version            Arch    Build  Repos          Size
    +==============================================================================
    Installing: 
     brasero                  3.12.0             x86_64         SBo           
    Installing for dependencies:
     orc                      0.4.22             x86_64         SBo           
     gstreamer1               1.4.1              x86_64         SBo           
     gst1-plugins-base        1.4.1              x86_64         SBo           
     gst1-plugins-bad         1.4.1              x86_64         SBo           
     libunique                1.1.6              x86_64         SBo           
    
    Installing summary
    ===============================================================================
    Total 6 packages.
    4 packages will be installed, 2 allready installed and 0 package
    will be upgraded.

    Would you like to continue [Y/n]?

    
    Example install multi packages:
    
    $ slpkg -s sbo brasero pylint bitfighter
    Reading package lists ..........Done
    Resolving dependencies ......Done

    The following packages will be automatically installed or upgraded 
    with new version:

    +==============================================================================
    | Package                 Version            Arch    Build  Repos          Size
    +==============================================================================
    Installing: 
     brasero                  3.12.0             x86_64         SBo           
     pylint                   1.3.1              x86_64         SBo           
     bitfighter               019d               x86_64         SBo           
    Installing for dependencies:
     libmodplug               0.8.8.5            x86_64         SBo           
     speex                    1.2rc1             x86_64         SBo           
     SDL2                     2.0.3              x86_64         SBo           
     OpenAL                   1.16.0             x86_64         SBo           
     six                      1.8.0              x86_64         SBo           
     logilab-common           0.63.2             x86_64         SBo           
     pysetuptools             7.0                x86_64         SBo           
     astroid                  1.3.4              x86_64         SBo           
     orc                      0.4.22             x86_64         SBo           
     gstreamer1               1.4.1              x86_64         SBo           
     gst1-plugins-base        1.4.1              x86_64         SBo           
     gst1-plugins-bad         1.4.1              x86_64         SBo           
     libunique                1.1.6              x86_64         SBo           

    Installing summary
    ===============================================================================
    Total 16 packages.
    4 packages will be installed, 12 allready installed and 0 package
    will be upgraded.

    Would you like to continue [Y/n]?


    Example from 'alien' repository:

    $ slpkg -s alien atkmm
    Reading package lists .....Done
    Resolving dependencies .........Done

    +==============================================================================
    | Package                 Version            Arch    Build  Repos          Size
    +==============================================================================
    Installing:
     atkmm                    2.22.6             x86_64  1      alien         124 K
    Installing for dependencies:
     libsigc++                2.2.10             x86_64  2      alien         128 K
     glibmm                   2.32.1             x86_64  1      alien        1012 K
     cairomm                  1.10.0             x86_64  2      alien         124 K
     pangomm                  2.28.4             x86_64  1      alien         124 K

    Installing summary
    ===============================================================================
    Total 5 packages.
    5 packages will be installed, 0 will be upgraded and 0 will be reinstalled.
    Need to get 124 Kb of archives.
    After this process, 620 Kb of additional disk space will be used.

    Would you like to continue [Y/n]?

    
    You can create a file with the extension '.pkg' with the names of the packages you 
    want to manage and use it instead of [package...] like:

    $ echo "brasero
    > atkmm
    > Flask
    > pylint" > foo.pkg

    $ cat foo.pkg
    brasero
    atkmm
    Flask
    pylint

    $ slpkg -s sbo foo.pkg
    Reading package lists .........Done
    Resolving dependencies .......Done

    The following packages will be automatically installed or upgraded 
    with new version:

    +==============================================================================
    | Package                 Version            Arch    Build  Repos          Size
    +==============================================================================
    Installing:
     brasero                  3.12.0             x86_64         SBo           
     atkmm                    2.22.7             x86_64         SBo           
     Flask                    0.10.1             x86_64         SBo           
     pylint                   1.3.1              x86_64         SBo           
    Installing for dependencies:
     six                      1.8.0              x86_64         SBo           
     logilab-common           0.63.2             x86_64         SBo           
     pysetuptools             7.0                x86_64         SBo           
     astroid                  1.3.4              x86_64         SBo           
     MarkupSafe               0.23               x86_64         SBo           
     itsdangerous             0.24               x86_64         SBo           
     Jinja2                   2.7.3              x86_64         SBo           
     werkzeug                 0.9.4              x86_64         SBo           
     libsigc++                2.2.11             x86_64         SBo           
     glibmm                   2.36.2             x86_64         SBo           
     cairomm                  1.10.0             x86_64         SBo           
     pangomm                  2.34.0             x86_64         SBo           
     orc                      0.4.22             x86_64         SBo           
     gstreamer1               1.4.1              x86_64         SBo           
     gst1-plugins-base        1.4.1              x86_64         SBo           
     gst1-plugins-bad         1.4.1              x86_64         SBo           
     libunique                1.1.6              x86_64         SBo           

    Installing summary
    ===============================================================================
    Total 21 packages.
    15 packages will be installed, 6 allready installed and 0 package
    will be upgraded.

    Would you like to continue [Y/n]?    


Build packages and passing variables to the script:

.. code-block:: bash

    First export variable(s) like:
    
    $ export FFMPEG_ASS=yes FFMPEG_X264=yes
    
    
    And then run as you know:

    $ slpkg -s sbo ffmpeg

    or

    $ slpkg -n ffmpeg

    or

    $ slpkg -a ffmpeg.tar.gz ffmpeg-2.1.5.tar.bz2

    
Tracking all dependencies of packages,
and also displays installed packages:

.. code-block:: bash

    $ slpkg -t sbo brasero
    Reading package lists ......Done

    +=========================
    | brasero dependencies   :
    +=========================
    \ 
     +---[ Tree of dependencies ]
     |
     +--1 orc
     |
     +--2 gstreamer1
     |
     +--3 gst1-plugins-base
     |
     +--4 gst1-plugins-bad
     |
     +--5 libunique


Check if your packages is up to date:

.. code-block:: bash

    $ slpkg -c sbo --upgrade
    Checking ...................Done
    Reading package lists ......Done
    Resolving dependencies ...Done

    The following packages will be automatically installed or upgraded 
    with new version:

    +==============================================================================
    | Package                 Version            Arch    Build  Repos          Size
    +==============================================================================
    Upgrading:
     astroid                  1.3.4              x86_64         SBo           
     jdk                      8u31               x86_64         SBo           
    Installing for dependencies:
     six                      1.8.0              x86_64         SBo           
     logilab-common           0.63.2             x86_64         SBo           
     pysetuptools             7.0                x86_64         SBo           

    Installing summary
    ===============================================================================
    Total 5 packages.
    0 package will be installed, 2 allready installed and 3 packages
    will be upgraded.

    Would you like to continue [Y/n]?


    $ slpkg -c slacky --upgrade
    Checking ........................Done
    Reading package lists ....Done
    Resolving dependencies ..........Done

    +==============================================================================
    | Package                 Version            Arch    Build  Repos          Size
    +==============================================================================
    Upgrading:
     gstreamer1               1.4.4              x86_64  1      slacky       1563 K

    Installing summary
    ===============================================================================
    Total 1 package.
    0 package will be installed, 1 will be upgraded and 0 will be reinstalled.
    Need to get 1.53 Mb of archives.
    After this process, 14.55 Mb of additional disk space will be used.

    Would you like to continue [Y/n]? 


Check if your Slackware distribution is up to date.
This option works independently of the others i.e not need before updating the list of
packages by choosing "# slpkg update", works directly with the official repository and
why always you can have updated your system:

.. code-block:: bash

    $ slpkg -c slack --upgrade
    Reading package lists .......Done

    These packages need upgrading:
    
    +==============================================================================
    | Package                   Version          Arch     Build  Repos         Size
    +==============================================================================
    Upgrading:
     dhcpcd                     6.0.5            x86_64   3      Slack         92 K
     samba                      4.1.11           x86_64   1      Slack       9928 K
     xscreensaver               5.29             x86_64   1      Slack       3896 K

    Installing summary
    ===============================================================================
    Total 3 package will be upgrading and 0 will be installed.
    Need to get 13.58 Mb of archives.
    After this process, 76.10 Mb of additional disk space will be used.
    
    Would you like to continue [Y/n]?


Skip packages when upgrading:

.. code-block:: bash

    $ slpkg -c sbo --upgrade --skip=pip,jdk
    Checking ...................Done
    Reading package lists ......Done
    Resolving dependencies ...Done

    The following packages will be automatically installed or upgraded 
    with new version:

    +==============================================================================
    | Package                 Version            Arch    Build  Repos          Size
    +==============================================================================
    Upgrading:
     cffi                     1.1.0              x86_64         SBo
    Installing for dependencies:
     pysetuptools             17.0               x86_64         SBo
     pycparser                2.13               x86_64         SBo

    Installing summary
    ===============================================================================
    Total 3 packages.
    0 package will be installed, 1 allready installed and 2 packages
    will be upgraded.

    Would you like to continue [Y/n]?

    
View complete slackbuilds.org site in your terminal.
Read fies, download, build or install:

.. code-block:: bash

    $ slpkg -n bitfighter
    Reading package lists ...Done
    
    +===============================================================================
    | Package bitfighter --> http://slackbuilds.org/repository/14.1/games/bitfighter/
    +===============================================================================
    | Description : multi-player combat game
    | SlackBuild : bitfighter.tar.gz
    | Sources : bitfighter-019c.tar.gz, classic_level_pack.zip 
    | Requirements : OpenAL, SDL2, speex, libmodplug
    +===============================================================================
     README               View the README file
     SlackBuild           View the SlackBuild file
     Info                 View the Info file
     Download             Download this package
     Build                Download and build this package
     Install              Download/Build/Install
     Quit                 Quit
     
     Choose an option: _

     
Auto tool to build package:

.. code-block:: bash

    Two files termcolor.tar.gz and termcolor-1.1.0.tar.gz
    must be in the same directory.
    (slackbuild script & source code or extra sources if needed)

    $ slpkg -a termcolor.tar.gz termcolor-1.1.0.tar.gz

    termcolor/
    termcolor/slack-desc
    termcolor/termcolor.info
    termcolor/README
    termcolor/termcolor.SlackBuild
    termcolor-1.1.0/
    termcolor-1.1.0/CHANGES.rst
    termcolor-1.1.0/COPYING.txt
    termcolor-1.1.0/README.rst
    termcolor-1.1.0/setup.py
    termcolor-1.1.0/termcolor.py
    termcolor-1.1.0/PKG-INFO
    running install
    running build
    running build_py
    creating build
    creating build/lib
    copying termcolor.py -> build/lib
    running install_lib
    creating /tmp/SBo/package-termcolor/usr
    creating /tmp/SBo/package-termcolor/usr/lib64
    creating /tmp/SBo/package-termcolor/usr/lib64/python2.7
    creating /tmp/SBo/package-termcolor/usr/lib64/python2.7/site-packages
    copying build/lib/termcolor.py -> 
    /tmp/SBo/package-termcolor/usr/lib64/python2.7/site-packages
    byte-compiling /tmp/SBo/package-termcolor/usr/lib64/python2.7/site-packages/termcolor.py 
    to termcolor.pyc
    running install_egg_info
    Writing 
    /tmp/SBo/package-termcolor/usr/lib64/python2.7/site-packages/termcolor-1.1.0-py2.7.egg-info

    Slackware package maker, version 3.14159.

    Searching for symbolic links:

    No symbolic links were found, so we wont make an installation script.
    You can make your own later in ./install/doinst.sh and rebuild the
    package if you like.

    This next step is optional - you can set the directories in your package
    to some sane permissions. If any of the directories in your package have
    special permissions, then DO NOT reset them here!

    Would you like to reset all directory permissions to 755 (drwxr-xr-x) and
    directory ownerships to root.root ([y]es, [n]o)? n

    Creating Slackware package:  /tmp/termcolor-1.1.0-x86_64-1_SBo.tgz

    ./
    usr/
    usr/lib64/
    usr/lib64/python2.7/
    usr/lib64/python2.7/site-packages/
    usr/lib64/python2.7/site-packages/termcolor.py
    usr/lib64/python2.7/site-packages/termcolor.pyc
    usr/lib64/python2.7/site-packages/termcolor-1.1.0-py2.7.egg-info
    usr/doc/
    usr/doc/termcolor-1.1.0/
    usr/doc/termcolor-1.1.0/termcolor.SlackBuild
    usr/doc/termcolor-1.1.0/README.rst
    usr/doc/termcolor-1.1.0/CHANGES.rst
    usr/doc/termcolor-1.1.0/PKG-INFO
    usr/doc/termcolor-1.1.0/COPYING.txt
    install/
    install/slack-desc

    Slackware package /tmp/termcolor-1.1.0-x86_64-1_SBo.tgz created.

    Total build time for package termcolor : 1 Sec


Upgrade, install packages like Slackware command '# upgradepkg --install-new':

.. code-block:: bash

    $ slpkg -u /tmp/termcolor-1.1.0-x86_64-1_SBo.tgz

    +==============================================================================
    | Installing new package ./termcolor-1.1.0-x86_64-1_SBo.tgz
    +==============================================================================

    Verifying package termcolor-1.1.0-x86_64-1_SBo.tgz.
    Installing package termcolor-1.1.0-x86_64-1_SBo.tgz:
    PACKAGE DESCRIPTION:
    # termcolor (ANSII Color formatting for output in terminal)
    #
    # termcolor allows you to format your output in terminal.
    #
    # Project URL: https://pypi.python.org/pypi/termcolor
    #
    Package termcolor-1.1.0-x86_64-1_SBo.tgz installed.

Install mass-packages:

.. code-block:: bash

    $ slpkg -u *.t?z
    
    or 

    $ slpkg -i *.t?z

    or use .pkg file like:

    # cat foo.pkg
    /tmp/x264-20131101-x86_64-1_SBo.tgz
    /tmp/xtermcolor-1.3-x86_64-1_SBo.tgz
    /tmp/python-urllib3-1.9.1-x86_64-1_SBo.tgz

    $ slpkg -u foo.pkg


Search and find packages from repositories are enabled:

.. code-block:: bash
   
    $ slpkg -F aria2

    Packages with name matching [ aria2 ]

    +==============================================================================
    | Repository  Package                                                      Size
    +==============================================================================
      sbo         aria2-1.18.10                                                 0 K
      slonly      aria2-1.18.10-x86_64-1_slack.txz                           1124 K
      salix       aria2-1.18.1-x86_64-1rl.txz                                1052 K
      slackr      aria2-1.18.10-x86_64-1cf.txz                               1140 K
    
    Total found 4 packages in 4 repositories.

    
Find installed packages:

.. code-block:: bash

    $ slpkg -f apr

    Packages with matching name [ apr ] 
    
    [ installed ] - apr-1.5.0-x86_64-1_slack14.1
    [ installed ] - apr-util-1.5.3-x86_64-1_slack14.1
    [ installed ] - xf86dgaproto-2.1-noarch-1
    [ installed ] - xineramaproto-1.2.1-noarch-1

    Total found 4 matcing packages
    Size of installed packages 1.61 Mb

    
    Example view all sbo installed packages:

    $ slpkg -f _SBo

    from foo.pkg file

    $ cat foo.pkg
    brasero
    atkmm
    Flask
    pylint

    $ slpkg -f foo.pkg
    
    Packages with matching name [ brasero, atkmm, Flask, pylint ]

    [ installed ] - pylint-1.3.1-x86_64-1_SBo

    Total found 1 matching packages.
    Size of installed packages 1.8 Mb.


Display the contents of the packages:

.. code-block:: bash

    $ slpkg -d termcolor lua

    PACKAGE NAME:     termcolor-1.1.0-x86_64-1_SBo
    COMPRESSED PACKAGE SIZE:     8.0K
    UNCOMPRESSED PACKAGE SIZE:     60K
    PACKAGE LOCATION: ./termcolor-1.1.0-x86_64-1_SBo.tgz
    PACKAGE DESCRIPTION:
    termcolor: termcolor (ANSII Color formatting for output in terminal)
    termcolor:
    termcolor: termcolor allows you to format your output in terminal.
    termcolor:
    termcolor:
    termcolor: Project URL: https://pypi.python.org/pypi/termcolor
    termcolor:
    termcolor:
    termcolor:
    termcolor:
    FILE LIST:
    ./
    usr/
    usr/lib64/
    usr/lib64/python2.7/
    usr/lib64/python2.7/site-packages/
    usr/lib64/python2.7/site-packages/termcolor.py
    usr/lib64/python2.7/site-packages/termcolor.pyc
    usr/lib64/python2.7/site-packages/termcolor-1.1.0-py2.7.egg-info
    usr/lib64/python3.3/
    usr/lib64/python3.3/site-packages/
    usr/lib64/python3.3/site-packages/termcolor-1.1.0-py3.3.egg-info
    usr/lib64/python3.3/site-packages/__pycache__/
    usr/lib64/python3.3/site-packages/__pycache__/termcolor.cpython-33.pyc
    usr/lib64/python3.3/site-packages/termcolor.py
    usr/doc/
    usr/doc/termcolor-1.1.0/
    usr/doc/termcolor-1.1.0/termcolor.SlackBuild
    usr/doc/termcolor-1.1.0/README.rst
    usr/doc/termcolor-1.1.0/CHANGES.rst
    usr/doc/termcolor-1.1.0/PKG-INFO
    usr/doc/termcolor-1.1.0/COPYING.txt
    install/
    install/slack-desc
    
    No such package lua: Cant find


Remove packages:

.. code-block:: bash

    $ slpkg -r termcolor
    
    Packages with name matching [ termcolor ]
    
    [ delete ] --> termcolor-1.1.0-x86_64-1_SBo

    Are you sure to remove 1 package(s) [Y/n]? y

    Package: termcolor-1.1.0-x86_64-1_SBo
        Removing... 

    Removing package /var/log/packages/termcolor-1.1.0-x86_64-1_SBo...
        Removing files:
    --> Deleting /usr/doc/termcolor-1.1.0/CHANGES.rst
    --> Deleting /usr/doc/termcolor-1.1.0/COPYING.txt
    --> Deleting /usr/doc/termcolor-1.1.0/PKG-INFO
    --> Deleting /usr/doc/termcolor-1.1.0/README.rst
    --> Deleting /usr/doc/termcolor-1.1.0/termcolor.SlackBuild
    --> Deleting /usr/lib64/python2.7/site-packages/termcolor-1.1.0-py2.7.egg-info
    --> Deleting /usr/lib64/python2.7/site-packages/termcolor.py
    --> Deleting /usr/lib64/python2.7/site-packages/termcolor.pyc
    --> Deleting /usr/lib64/python3.3/site-packages/__pycache__/termcolor.cpython-33.pyc
    --> Deleting /usr/lib64/python3.3/site-packages/termcolor-1.1.0-py3.3.egg-info
    --> Deleting /usr/lib64/python3.3/site-packages/termcolor.py
    --> Deleting empty directory /usr/lib64/python3.3/site-packages/__pycache__/
    WARNING: Unique directory /usr/lib64/python3.3/site-packages/ contains new files
    WARNING: Unique directory /usr/lib64/python3.3/ contains new files
    --> Deleting empty directory /usr/doc/termcolor-1.1.0/

    +==============================================================================
    | Package: termcolor removed
    +==============================================================================


Remove packages with all dependencies:
(presupposes facility with the option 'slpkg -s <repository> <package>)

.. code-block:: bash

    $ slpkg -r Flask

    Packages with name matching [ Flask ]

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

    Are you sure to remove 1 package [Y/n]? y

    +==============================================================================
    | Found dependencies for package Flask:
    +==============================================================================
    | pysetuptools
    | MarkupSafe
    | itsdangerous
    | Jinja2
    | werkzeug
    +==============================================================================

    Remove dependencies (maybe used by other packages) [Y/n]? y
    .
    .
    .
    +==============================================================================
    | Package Flask removed
    | Package pysetuptools removed
    | Package MarkupSafe removed
    | Package itsdangerous removed
    | Package Jinja2 removed
    | Package werkzeug removed
    +==============================================================================

    Use list from file foo.pkg like:

    $ cat foo.pkg
    brasero
    atkmm
    Flask
    pylint

    $ slpkg -r foo.pkg

    Packages with name matching [ brasero, atkmm, Flask, pylint ]

    No such package brasero: Cant remove
    No such package atkmm: Cant remove
    No such package Flask: Cant remove
    [ delete ] --> pylint-1.3.1-x86_64-1_SBo

    Are you sure to remove 1 package [Y/n]?

Build and install packages that have added to the queue:

.. code-block:: bash

    $ slpkg -q roxterm SDL2 CEGUI --add
    
    Add packages in queue:

    roxterm
    SDL2
    CEGUI

    
    $ slpkg -q roxterm --remove (or 'slpkg -q all --remove' remove all packages from queue)
    
    Remove packages from queue:

    roxterm

    
    $ slpkg -q list

    Packages in queue:

    SDL2
    CEGUI
    
    
    $ slpkg -q build (build only packages from queue)

    $ slpkg -q install (install packages from queue)

    $ slpkg -q build-install (build and install)


Add packages in blacklist file manually from 
/etc/slpkg/blacklist or with the following options:

.. code-block:: bash
    
    $ slpkg -b live555 speex faac --add

    Add packages in blacklist: 

    live555
    speex
    faac


    $ slpkg -b speex --remove

    Remove packages from blacklist:

    speex


    $ slpkg -b list

    Packages in blacklist:

    live555
    faac

    
Print package description:

.. code-block:: bash

    $ slpkg -p alien vlc --color=green

    vlc (multimedia player for various audio and video formats)

    VLC media player is a highly portable multimedia player for various
    audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, mp3, ogg, ...)
    as well as DVDs, VCDs, and various streaming protocols.
    It can also be used as a server to stream in unicast or multicast in
    IPv4 or IPv6 on a high-bandwidth network.


    vlc home: http://www.videolan.org/vlc/


Man page it is available for full support:

.. code-block:: bash

    $ man slpkg


Donate
------
If you feel satisfied with this project and want to thank me go
to `Slackware <https://store.slackware.com/cgi-bin/store/slackdonation>`_ and make a donation or 
visit the `store <https://store.slackware.com/cgi-bin/store>`_.


Copyright 
---------

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