shpkg (shell-scripted package manager)

A Package manager written in bash with a makepkg-like format

Why?

• Because I can
• Because I have free time in my hands
• Because I am bored
• Why not?

Above those are the reasons why i made this script ?

Table of Contents

• shpkg (shell-scripted package manager)
• Why?
• Table of Contents
• Dependencies
  • Optional Dependencies
• Installation
• Features
• Build scripts
• Repositories
• FAQs
• Contributing

Dependencies

• bash 4.0+ - the main dependency
• posix compliant utilities (includes cat, sed, less, rm, awk, etc.) and mktemp which is included in major distributions and macOS as well

Optional Dependencies

These dependencies are needed if you're performing certain tasks.

• curl for source code or content downloading
• git for source code fetching
• unzip if you need to use zip source code
• tar (with gzip/xzip compressor) if you need to use tar source code

these are mainly used for update function as well to download buildscripts and source code from internet sources

Installation

It usually takes less than a minute to install. you may download shpkg script

curl -fsSL https://raw.githubusercontent.com/WMCB-Tech/shpkg/master/shpkg | tee shpkg

Features

Features include:

• Support for tracking dependency needs for a package (this feature is only available in Debian, Arch, Alpine Linux and Fedora)
• Simple and only includes core functionality
• Compilation of programs easily for your convinence
• It's quite similar to portage, homebrew or makepkg
• Portable and supports most operating systems (windows/macOS may have small support)

Build scripts

Build scripts are stored in your home directory which is ~/.shpkg. containing all build script directories

~ $ ls -R ~/.shpkg
bash:
SHPKG_BUILD

hello-world:
SHPKG_BUILD hello_world.c

Sample build script

# package name
shpkg_name="Hello World"

# package build dependencies
shpkg_build_depends="make automake gcc clang"

# package architecture
shpkg_arch_only=('amd64' 'i386')

# package version
shpkg_version="2.9"

# package source code
shpkg_source="https://mirror.ossplanet.net/gnu/hello/hello-${shpkg_version}.tar.gz"

prepare(){
	cd "${SRCDIR}"
	./configure --prefix=/opt/shpkg/gnu-hello
}

build(){
	make -j$(nproc)
}

finish(){
	${SHPKG_SUDO} make install
}

remove(){
	${SHPKG_SUDO} rm -rf /opt/shpkg/gnu-hello
}

See the docs for more information

Repositories

You can also setup repository where build scripts are being downloaded. the repository list location is located at ~/.config/shpkg-repo.list

Example config file:

# this is a comment
https://github.com/foo/bar.git
https://example.com/foo/bar.tar.gz
https://example.com/foo/bar.zip

Your repository root directory (/) should have build scripts directory which shown above. it will download and move all files to ~/shpkg directory which contains all buildscripts

Steps include:

• It fetches URL's depending on their file extension (git or tar archive)
• Extracts contents to temporary directory
• Moves all directories from temporary directory to ~/.shpkg directory

Directory structure for your repository must be used as follows:

• ? root directory (/)
• ? package
  • ?SHPKG_BUILD

FAQs

• Is this a POSIX compliant script?

Yes but quite. this script is almost using POSIX functions but not all of them as this is a bash script that needs certain bash features

• Is windows supported?

Yes but no. Windows is very different amongst POSIX/Unix standards, you can install mingw/cygwin tools which includes bash and common unix tools

however you may try Scoop as an awesome alternative

Contributing

You may contribute. issues and pull requests are welcome! you are also free to fork this repo!
If you have any further questions. you may ask in discussions tab