From b89fe4f423d47cef639782104b4cbad0f2dc616b Mon Sep 17 00:00:00 2001 From: Mykyta Solomko Date: Fri, 21 May 2021 21:56:06 +0300 Subject: [PATCH 1/5] Added documentation --- slapt_get.py | 97 +++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 96 insertions(+), 1 deletion(-) diff --git a/slapt_get.py b/slapt_get.py index a6531b1..c8891dc 100644 --- a/slapt_get.py +++ b/slapt_get.py @@ -1,7 +1,7 @@ #!/usr/bin/python # -*- coding: utf-8 -*- -# (c) 2017, Mykyta Solomko +# (c) 2017-2021, Mykyta Solomko # Written by Mykyta Solomko # # This module is free software: you can redistribute it and/or modify @@ -20,6 +20,101 @@ DOCUMENTATION = ''' --- +module: slackpkg +short_description: APT-like package manager for Slackware >= 10.0 +description: + - Manage binary packages for Slackware using 'slapt-get' which + is available in versions starting 10.0. +version_added: "1.0" +options: + name: + description: + - name of package to install/remove + required: false + type: 'list' + default: None + + state: + description: + - state of the package, you can use "installed" as an alias for C(present) and removed as one for C(absent). + choices: ['absent', 'present', 'installed', 'removed', 'latest'] + required: false + default: present + + upgrade: + description: + - upgrade installed packages + choices: ['yes', 'no', 'dist'] + required: false + type: 'str' + default: 'no' + + install_set: + description: + - install Slackware's package sets, such as 'a', 'tex', 'kde', etc. + required: false + type: 'bool' + default: False + + suggested: + description: + - install suggested packages + required: false + type: 'bool' + default: False + + add_keys: + description: + - update/add GPG keys + required: false + type: 'bool' + default: False + + update_cache: + description: + - update package cache from repos + required: false + type: 'bool' + default: False + + clean_cache: + description: + - remove downloaded packages from cache + required: false + choices: ['all', 'yes', 'old', 'no'] + type: 'str' + default: 'no' + + gpg_check: + description: + - enable/disable GPG check + required: false + type: 'bool' + default: False + + ignore_excludes: + description: + - ignore excluded packages + required: false + type: 'bool' + default: False + + ignore_deps: + description: + - ignore dependencies for package(s) + required: false + type: 'bool' + default: False + + ignore_checksum: + description: + - ignore checksum verification for package(s) + required: false + type: 'bool' + default: False + +author: Mykyta Solomko +requirements: [ "Slackware >= 10.0" ] ''' EXAMPLES = ''' -- 2.17.6 From bac766cf12b5a7545baa71bcfd13d714a5701e46 Mon Sep 17 00:00:00 2001 From: Mykyta Solomko Date: Fri, 21 May 2021 22:01:47 +0300 Subject: [PATCH 2/5] Added examples --- slapt_get.py | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/slapt_get.py b/slapt_get.py index c8891dc..9d0cd68 100644 --- a/slapt_get.py +++ b/slapt_get.py @@ -118,6 +118,21 @@ requirements: [ "Slackware >= 10.0" ] ''' EXAMPLES = ''' +# Upgrade all installed packages +- slapt_get: + upgrade: yes + update_cache: yes + clean_cache: yes + +# Install packages +- slapt_get: + name: [ iptables, ipset ] + clean: yes + +# Install set of packages +- slapt_get: + install_set: kde + clean: yes ''' import os -- 2.17.6 From 1ef2b985241ca8db85c2491e9eb3e513eb4cef9f Mon Sep 17 00:00:00 2001 From: Mykyta Solomko Date: Fri, 21 May 2021 22:04:48 +0300 Subject: [PATCH 3/5] Update README --- README.md | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 09f3890..e2c3534 100644 --- a/README.md +++ b/README.md @@ -1 +1,24 @@ -Ansible modules for slapt-get repository manager +Ansible module for [slapt-get](https://software.jaos.org/) repository manager + +## Usage +```yaml +# Upgrade all installed packages +- slapt_get: + upgrade: yes + update_cache: yes + clean_cache: yes +``` + +```yaml +# Install packages +- slapt_get: + name: [ iptables, ipset ] + clean: yes +``` + +```yaml +# Install set of packages +- slapt_get: + install_set: kde + clean: yes +``` -- 2.17.6 From e2d2a4d1ae8a0fdb84552073d7eaf0838efeb139 Mon Sep 17 00:00:00 2001 From: Mykyta Solomko Date: Fri, 21 May 2021 22:05:39 +0300 Subject: [PATCH 4/5] Updated README --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e2c3534..fe10324 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ -Ansible module for [slapt-get](https://software.jaos.org/) repository manager +# Ansible module +Module for [slapt-get](https://software.jaos.org/) repository manager ## Usage ```yaml -- 2.17.6 From ef10adc9d610639ddbc0f0e6dcb935f62f79974d Mon Sep 17 00:00:00 2001 From: Mykyta Solomko Date: Fri, 21 May 2021 22:06:55 +0300 Subject: [PATCH 5/5] Updated desc --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index fe10324..4c93a8b 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ # Ansible module -Module for [slapt-get](https://software.jaos.org/) repository manager +Module for [slapt-get](https://software.jaos.org/), the unofficial Slackware's repository manager ## Usage ```yaml -- 2.17.6