mirror of
https://gitlab.com/dslackw/slpkg.git
synced 2025-01-28 19:58:18 +01:00
Switch to Markdown format
This commit is contained in:
Dimitris Zlatanidis
parent
f357fbc4ef
commit
7bea5ef8a8
2 changed files with 244 additions and 236 deletions
244
README.md
Normal file
244
README.md
Normal file
|
|
@ -0,0 +1,244 @@
|
|||
### Table of contents
|
||||
|
||||
1. [About](#About)
|
||||
2. [Screenshots](#Screenshots)
|
||||
3. [Installation](#Installation)
|
||||
4. [Requirements](#Requirements)
|
||||
5. [Recommended](#Recommended)
|
||||
6. [Testing](#Testing)
|
||||
7. [Command Line Tool Usage](#Command Line Tool Usage)
|
||||
8. [How to start](#How to start)
|
||||
9. [Configuration files](#Configuration files)
|
||||
10. [Repositories](#Repositories)
|
||||
11. [Multilib Packages](#Multilib Packages)
|
||||
12. [Issues](#Issues)
|
||||
13. [Donate](#Donate)
|
||||
14. [Support](#Support)
|
||||
15. [Copyright](Copyright)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### About
|
||||
|
||||
Slpkg is a software package manager that installs, updates and removes packages on [Slackware](https://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.
|
||||
|
||||
### Screenshots
|
||||
|
||||
<img src="https://gitlab.com/dslackw/images/raw/master/slpkg/slpkg_install.png" width="700"/>
|
||||
<img src="https://gitlab.com/dslackw/images/raw/master/slpkg/slpkg_remove.png" width="700"/>
|
||||
<img src="https://gitlab.com/dslackw/images/raw/master/slpkg/slpkg_dependees.png" width="700"/>
|
||||
|
||||
|
||||
### Installation
|
||||
|
||||
```
|
||||
$ tar xvf slpkg-4.7.8.tar.gz
|
||||
$ cd slpkg-4.7.8
|
||||
$ ./install.sh
|
||||
```
|
||||
|
||||
### Requirements
|
||||
|
||||
```
|
||||
SQLAlchemy >= 1.4.46
|
||||
pythondialog >= 3.5.3
|
||||
progress >= 1.6
|
||||
```
|
||||
|
||||
### Recommended
|
||||
|
||||
Stay always updated, see my other project SUN [(Slackware Update Notifier)](https://gitlab.com/dslackw/sun)
|
||||
|
||||
|
||||
### Testing
|
||||
|
||||
The majority of trials have been made in Slackware x86_64 'stable' environment.
|
||||
|
||||
|
||||
### Command Line Tool Usage
|
||||
|
||||
```
|
||||
USAGE: slpkg [OPTIONS] [COMMAND] [FILELIST|PACKAGES...]
|
||||
|
||||
DESCRIPTION: Package manager utility for Slackware.
|
||||
|
||||
COMMANDS:
|
||||
-u, update Update the package lists.
|
||||
-U, upgrade Upgrade all the packages.
|
||||
-c, check-updates Check for news on ChangeLog.txt.
|
||||
-I, repo-info Prints the repositories information.
|
||||
-g, configs Edit the configuration file.
|
||||
-L, clean-logs Clean dependencies log tracking.
|
||||
-T, clean-data Clean all the repositories data.
|
||||
-D, clean-tmp Delete 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 packages from the repository.
|
||||
-e, dependees [packages...] Show which packages depend.
|
||||
-t, tracking [packages...] Tracking the packages dependencies.
|
||||
|
||||
OPTIONS:
|
||||
-y, --yes Answer Yes to all questions.
|
||||
-j, --jobs Set it for multicore systems.
|
||||
-o, --resolve-off Turns off dependency resolving.
|
||||
-r, --reinstall Upgrade packages of the same version.
|
||||
-k, --skip-installed Skip installed packages.
|
||||
-E, --full-reverse Full reverse dependency.
|
||||
-S, --search Search packages from the repository.
|
||||
-n, --no-silent Disable silent mode.
|
||||
-p, --pkg-version Print the repository package version.
|
||||
-G, --generate-only Generates only the SLACKBUILDS.TXT file.
|
||||
-B, --bin-repo=[REPO] Set a binary repository.
|
||||
-z, --directory=[PATH] Download files to a specific path.
|
||||
|
||||
-h, --help Show this message and exit.
|
||||
-v, --version Print version and exit.
|
||||
```
|
||||
|
||||
|
||||
### How to start
|
||||
|
||||
If you are going to use only the [SlackBuilds.org](https://slackbuilds.org) repository, you don't need to edit
|
||||
the `/etc/slpkg/repositories.toml` file, otherwise edit the file and set `true` the repositories you want.
|
||||
|
||||
The second step is to update the package lists and install the data to the database, just run:
|
||||
|
||||
|
||||
```
|
||||
$ slpkg update
|
||||
```
|
||||
|
||||
or for binary repositories:
|
||||
|
||||
```
|
||||
$ slpkg update --bin-repo='*'
|
||||
```
|
||||
Now you are ready to start!
|
||||
|
||||
To install a package from the [SlackBuilds.org](https://slackbuilds.org) or [Ponce](https://cgit.ponce.cc/slackbuilds) repository, run:
|
||||
|
||||
```
|
||||
$ slpkg install <package_name>
|
||||
```
|
||||
|
||||
or from a binary repository:
|
||||
|
||||
```
|
||||
$ slpkg install <package_name> --bin-repo=<repo_name>
|
||||
```
|
||||
|
||||
You can install a whole repository with the command:
|
||||
|
||||
```
|
||||
$ slpkg install '*' --bin-repo=<repository_name> --resolve-off
|
||||
```
|
||||
|
||||
Note: Apply the option '--resolve-off' to speed up the process, if the repository has no references to the dependencies.
|
||||
|
||||
To remove a package with the dependencies:
|
||||
|
||||
```
|
||||
$ slpkg remove <package_name>
|
||||
```
|
||||
|
||||
If you want to search a package from all binaries repositories, run:
|
||||
|
||||
```
|
||||
$ slpkg search <package_name> --bin-repo='*'
|
||||
```
|
||||
|
||||
Edit the configuration :code:`/etc/slpkg/slpkg.toml` file:
|
||||
|
||||
```
|
||||
$ slpkg configs
|
||||
```
|
||||
|
||||
For further information, please read the manpage:
|
||||
|
||||
```
|
||||
$ man slpkg
|
||||
```
|
||||
|
||||
|
||||
### Configuration files
|
||||
|
||||
```
|
||||
/etc/slpkg/slpkg.toml
|
||||
General configuration of slpkg
|
||||
|
||||
/etc/slpkg/repositories.toml
|
||||
Repositories configuration
|
||||
|
||||
/etc/slpkg/blacklist.toml
|
||||
Blacklist of packages
|
||||
```
|
||||
|
||||
### Repositories
|
||||
|
||||
Two repositories are supported, please read the config file.
|
||||
|
||||
* [Slackbuilds](https://slackbuilds.org/)
|
||||
* [Ponce](https://cgit.ponce.cc/slackbuilds/)
|
||||
* [Slackware](https://slackware.uk/slackware/slackware64-15.0/)
|
||||
* [Slackware Extra](https://slackware.uk/slackware/slackware64-15.0/extra/)
|
||||
* [Slackware Patches](https://slackware.uk/slackware/slackware64-15.0/patches/)
|
||||
* [Alien](http://slackware.uk/people/alien/sbrepos/15.0/x86_64/)
|
||||
* [Multilib](https://slackware.nl/people/alien/multilib/15.0/)
|
||||
* [Restricted](https://slackware.nl/people/alien/restricted_sbrepos/15.0/x86_64/)
|
||||
* [Gnome](https://reddoglinux.ddns.net/linux/gnome/41.x/x86_64/)
|
||||
* [Msb](https://slackware.uk/msb/15.0/1.26/x86_64/)
|
||||
* [Csb](https://slackware.uk/csb/15.0/x86_64/)
|
||||
* [Conraid](https://slack.conraid.net/repository/slackware64-current/)
|
||||
* [Slackonly](https://packages.slackonly.com/pub/packages/15.0-x86_64/)
|
||||
* [SalixOS](https://download.salixos.org/x86_64/slackware-15.0/)
|
||||
* [SalixOS Extra](https://download.salixos.org/x86_64/slackware-15.0/extra/)
|
||||
* [SalixOS Patches](https://download.salixos.org/x86_64/slackware-15.0/patches/)
|
||||
* [Slackel](http://www.slackel.gr/repo/x86_64/current/)
|
||||
* [Slint](https://slackware.uk/slint/x86_64/slint-15.0/)
|
||||
|
||||
|
||||
### Multilib Packages
|
||||
|
||||
Slackware for x86_64 - multilib packages & install instructions:
|
||||
|
||||
Please read the file [README](https://gitlab.com/dslackw/slpkg/-/raw/master/filelists/multilib/README) you will find in the folder [multlib](https://gitlab.com/dslackw/slpkg/-/tree/master/filelists/multilib)
|
||||
|
||||
|
||||
### Issues
|
||||
|
||||
Please report any bugs in [ISSUES](https://gitlab.com/dslackw/slpkg/issues)
|
||||
|
||||
|
||||
### Donate
|
||||
|
||||
If you feel satisfied with this project and want to thank me, treat me to a coffee ☕ !
|
||||
|
||||
[<img src="https://gitlab.com/dslackw/images/raw/master/donate/paypaldonate.png">](https://www.paypal.me/dslackw)
|
||||
|
||||
|
||||
### Support
|
||||
|
||||
Please support:
|
||||
|
||||
* [Slackware](https://www.patreon.com/slackwarelinux) project.
|
||||
* [SlackBuilds](https://slackbuilds.org/contributors/) repository.
|
||||
* [AlienBob](https://alien.slackbook.org/blog/) Eric Hameleers.
|
||||
|
||||
Thank you all for your support!
|
||||
|
||||
|
||||
### Copyright
|
||||
|
||||
Copyright 2014-2023 © Dimitris Zlatanidis.
|
||||
Slackware® is a Registered Trademark of Patrick Volkerding.
|
||||
Linux is a Registered Trademark of Linus Torvalds.
|
||||
236
README.rst
236
README.rst
|
|
@ -1,236 +0,0 @@
|
|||
.. 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.46
|
||||
pythondialog >= 3.5.3
|
||||
progress >= 1.6
|
||||
|
||||
Install
|
||||
-------
|
||||
|
||||
Install it from the official third-party `SlackBuilds.org <https://slackbuilds.org/repository/15.0/system/slpkg/>`__ repository or directly from source:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ tar xvf slpkg-4.7.8.tar.gz
|
||||
$ cd slpkg-4.7.8
|
||||
$ ./install.sh
|
||||
|
||||
Screenshots
|
||||
-----------
|
||||
|
||||
.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/slpkg_install.png
|
||||
:target: https://gitlab.com/dslackw/slpkg
|
||||
|
||||
.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/slpkg_remove.png
|
||||
:target: https://gitlab.com/dslackw/slpkg
|
||||
|
||||
.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/slpkg_dependees.png
|
||||
:target: https://gitlab.com/dslackw/slpkg
|
||||
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg --help
|
||||
USAGE: slpkg [OPTIONS] [COMMAND] [FILELIST|PACKAGES...]
|
||||
|
||||
DESCRIPTION:
|
||||
Package manager utility for Slackware.
|
||||
|
||||
COMMANDS:
|
||||
-u, update Update the package lists.
|
||||
-U, upgrade Upgrade all the packages.
|
||||
-c, check-updates Check for news on ChangeLog.txt.
|
||||
-I, repo-info Prints the repositories information.
|
||||
-g, configs Edit the configuration file.
|
||||
-L, clean-logs Clean dependencies log tracking.
|
||||
-T, clean-data Clean all the repositories data
|
||||
-D, 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 packages from the repository.
|
||||
-e, dependees [packages...] Show which packages depend.
|
||||
-t, tracking [packages...] Tracking the packages dependencies.
|
||||
|
||||
OPTIONS:
|
||||
-y, --yes Answer Yes to all questions.
|
||||
-j, --jobs Set it for multicore systems.
|
||||
-o, --resolve-off Turns off dependency resolving.
|
||||
-r, --reinstall Upgrade packages of the same version.
|
||||
-k, --skip-installed Skip installed packages.
|
||||
-E, --full-reverse Full reverse dependency.
|
||||
-S, --search Search packages from the repository.
|
||||
-n, --no-silent Disable silent mode.
|
||||
-p, --pkg-version Print the repository package version.
|
||||
-G, --generate-only Generates only the SLACKBUILDS.TXT file.
|
||||
-P, --parallel Download files in parallel.
|
||||
-B, --bin-repo=[REPO] Set a binary repository.
|
||||
-z, --directory=[PATH] Download files to a specific path.
|
||||
|
||||
-h, --help Show this message and exit.
|
||||
-v, --version Print version and exit.
|
||||
|
||||
If you need more information try to use slpkg manpage.
|
||||
Extra help for the commands, use: 'slpkg help [command]'.
|
||||
Edit the config file in the /etc/slpkg/slpkg.toml or 'slpkg configs'.
|
||||
|
||||
|
||||
How to start
|
||||
------------
|
||||
|
||||
If you are going to use only the `SlackBuilds.org <https://slackbuilds.org/>`__ repository, you don't need to edit the
|
||||
:code:`/etc/slpkg/repositories.toml` file, otherwise edit the file and set :code:`true` the repositories you want.
|
||||
|
||||
The second step is to update the package lists and install the data to the database, just run:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg update
|
||||
|
||||
or for binary repositories:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg update --bin-repo='*'
|
||||
|
||||
Now you are ready to start!
|
||||
|
||||
To install a package from the `SlackBuilds.org <https://slackbuilds.org/>`__ or `Ponce <https://cgit.ponce.cc/slackbuilds/>`_ repository, run:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg install <package_name>
|
||||
|
||||
or from a binary repository:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg install <package_name> --bin-repo=<repo_name>
|
||||
|
||||
You can install a whole repository with the command:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg install '*' --bin-repo=<repository_name> --resolve-off
|
||||
|
||||
Note: Apply the option '--resolve-off' to speed up the process, if the repository has no references to the dependencies.
|
||||
|
||||
To remove a package with the dependencies:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg remove <package_name>
|
||||
|
||||
If you wan to search a package from all binaries repositories, run:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg search <package_name> --bin-repo='*'
|
||||
|
||||
Edit the configuration :code:`/etc/slpkg/slpkg.toml` file:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ slpkg configs
|
||||
|
||||
|
||||
For further information, please read the manpage:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ man slpkg
|
||||
|
||||
|
||||
Configuration files
|
||||
-------------------
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
/etc/slpkg/slpkg.toml
|
||||
General configuration of slpkg
|
||||
|
||||
/etc/slpkg/repositories.toml
|
||||
Repositories configurations
|
||||
|
||||
/etc/slpkg/blacklist.toml
|
||||
Blacklist of packages
|
||||
|
||||
|
||||
Repositories
|
||||
------------
|
||||
|
||||
This is the list with the supported repositories, please read the repositories configuration file.
|
||||
|
||||
- `Slackbuilds <https://slackbuilds.org/>`_
|
||||
- `Ponce <https://cgit.ponce.cc/slackbuilds/>`_
|
||||
- `Slackware <https://slackware.uk/slackware/slackware64-15.0/>`__
|
||||
- `Slackware extra <https://slackware.uk/slackware/slackware64-15.0/extra/>`__
|
||||
- `Slackware patches <https://slackware.uk/slackware/slackware64-15.0/patches/>`__
|
||||
- `Alien <http://slackware.uk/people/alien/sbrepos/15.0/x86_64/>`_
|
||||
- `Multilib <https://slackware.nl/people/alien/multilib/15.0/>`_
|
||||
- `Restricted <https://slackware.nl/people/alien/restricted_sbrepos/15.0/x86_64/>`_
|
||||
- `Gnome <https://reddoglinux.ddns.net/linux/gnome/41.x/x86_64/>`_
|
||||
- `Msb <https://slackware.uk/msb/15.0/1.26/x86_64/>`_
|
||||
- `Csb <https://slackware.uk/csb/15.0/x86_64/>`_
|
||||
- `Conraid <https://slack.conraid.net/repository/slackware64-current/>`_
|
||||
- `Slackonly <https://packages.slackonly.com/pub/packages/15.0-x86_64/>`_
|
||||
- `Salix OS <https://download.salixos.org/x86_64/slackware-15.0/>`_
|
||||
- `Salix OS extra <https://download.salixos.org/x86_64/slackware-15.0/extra/>`_
|
||||
- `Salix OS patches <https://download.salixos.org/x86_64/slackware-15.0/patches/>`_
|
||||
- `Slackel OS <http://www.slackel.gr/repo/x86_64/current/>`_
|
||||
- `Slint OS <https://slackware.uk/slint/x86_64/slint-15.0/>`_
|
||||
|
||||
|
||||
Multilib packages
|
||||
-----------------
|
||||
|
||||
Slackware for x86_64 - multilib packages & install instructions:
|
||||
|
||||
- Please read the file `README <https://gitlab.com/dslackw/slpkg/-/raw/master/filelists/multilib/README>`_ you will find in the folder `multlib <https://gitlab.com/dslackw/slpkg/-/tree/master/filelists/multilib>`_.
|
||||
|
||||
Donate
|
||||
------
|
||||
|
||||
If you feel satisfied with this project and want to thank me, treat me to a coffee ☕ !
|
||||
|
||||
.. image:: https://gitlab.com/dslackw/images/raw/master/donate/paypaldonate.png
|
||||
:target: https://www.paypal.me/dslackw
|
||||
|
||||
Report bugs
|
||||
-----------
|
||||
|
||||
Please report any issue here: `Issues <https://gitlab.com/dslackw/slpkg/-/issues>`_
|
||||
|
||||
|
||||
Copyright
|
||||
---------
|
||||
|
||||
- Copyright 2014-2023 © Dimitris Zlatanidis.
|
||||
- Slackware® is a Registered Trademark of Patrick Volkerding.
|
||||
- Linux is a Registered Trademark of Linus Torvalds.
|
||||
Loading…
Add table
Reference in a new issue