Ma_Sys.ma Artifact Script | Ma

Name

maartifact – download and extract archive files.

Synopsis

maartifact download ARTIFACT [-b BRANCH] DEFINITION
maartifact require  ARTIFACT [-b BRANCH] DEFINITION
maartifact extract  ARTIFACT DESTDIR [-b BRANCH] [DEFINITION]

Description

The absolute minimum of an artifact management system. This script is intended to automatically download and extract various forms of sources, i.e. debian packages, git repositories and compressed tarfiles.

Options

Commands

download: Download the given artifact even if it might already be present.
require: Download the given artifact if it is not present.
extract: Download the given artifact if it is not present and extract its contents to DESTDIR afterwards.

Parameters

`ARTIFACT`	Identifier for this artifact, e.g. `ial_in_....deb`
`DESTDIR`	Directory to extract the artifact’s contents to.
`DEFINITION`	String identifying this artifact (see next section)
`BRANCH`	Optionally specify a git branch to checkout.

Definitions

packagename: If ARTIFACT ends on .deb, try to download it from this Debian package. Note that this syntax invokes aptitude download which means that command must be available on the system and that the outcome depends on whether the user is running stable, testing or unstable.
GIT: Clone Git repository. For this to work, the artifact name needs to end on .git. Optionally specify parameter -b to select a specific branch. Submodules are included automatically.
URL: Download artifact from URL (default)

Examples

./maartifact.pl extract rxvt_unicode.deb sub rxvt-unicode

This downloads the rxvt-unicode package and extracts it to a directory sub.

Files

All downloads are stored under ../x-artifacts relative to the script’s directory.

Dependencies

External Programs: (GNU) tar, 7z, aptitude, git
Perl Modules (Debian package names): libfile-copy-recursive-perl, libwww-perl, libgit-repository-perl

License

Ma_Sys.ma Artifact Script, Copyright (c) 2019, 2020, 2022 Ma_Sys.ma.
For further info send an e-mail to Ma_Sys.ma@web.de.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Ma_Sys.ma Website 5 (1.0.2) – no Flash, no JavaScript, no Webfont, no Copy Protection, no Mobile First. No bullshit. No GUI needed. Works with any browser.

Created: 2019/11/14 20:46:34 | Revised: 2022/09/18 21:16:35 | Tags: mdvlci, maartifact.pl | SRC (Pandoc MD) | GPL

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.