Mapm. Max's Package Manager.

What is Mapm?

Mapm is a package manager (written in Kotlin) for, you know, managing packages. So far it's VERY early in development. Mapm is designed to run on the JVM, while using Linux system (as the packages are only compiled for Linux at present).

Why?

No reason. :)

Setup

Make sure Java 17 or later is installed! Mapm is built targeting 17 or later, so it will not run on older versions!

Express

Run the command curl https://maxwellj.xyz/mapm/mapm.sh | bash. This will run an express setup script.

Manual

Make directories /usr/mapm and /usr/mapm/tmp. Add /usr/mapm to path. Download the files and make sure Gradle is installed. Run gradle distTar to compile a Tar file with all the needed Jars in it, including mapm. Untar the archive in build/distributions. Run ./(where tar extracted to)/bin/mapm.

Usage

Mapm has a few options for the command line. So far these are:

g: Grab a package from the internet.
r: Remove a package from your system. (work in progress)
c: Make a checksum that Mapm can reproduce and recognise.
m: Automatically make a Mapm package (work in progress)
h: Get help.

Some example commands:

mapm g mash: Grab the package mash and install it.
mapm r mash: Remove the package mash from your computer.
mapm c mash-0.0.2.tar.xz: Generate a checksum for the file mash-0.0.2.tar.xz

Making a mapm package

To make a mapm package, go to https://git.maxwellj.xyz/mapm/stable and submit a pull request. Add your package's name as the file name, and the link to where your package is stored as the contents. Don't add anything more or you'll confuse mapm. Make sure the link points to a .tar.xz archive. The file structure should be like this:

├── (packagename) (Your executable)
└── (packagename).d
    └── Any other files your package needs

Zip all that up into a .tar.xz file and upload it to your own server. After creating the .tar.xz, use Mapm to create a checksum for the file. Run mapm c (file name to get the checksum. For now, there is no polished system for package processing, so for now send an email to max AT maxwellj.xyz with the package link, hash and all dependencies required to run your program.

Note: If your package requires an update, make sure to email an updated link and hash, otherwise Mapm will reject your package when it is being installed.

Making your own repo

For now, this isn't a thing, but you'll be able to when configuration is a thing.

FAQ's

What is mapm?

Mapm is a package manager, intended for UNIX-based/like OSes, running on the JVM. Mapm packages are organised neatly in /usr/mapm. When built around Mapm, packages have both their executables and config files inside one directory, with one symbolic link or launch script in /usr/mapm.

Is Mapm any good?

For now, Mapm doesn't have support for dependencies, meaning if your program requires another library, Mapm won't be able to provide those yet. Mapm also hasn't got very many packages right now, as it is still very experimental.

3.0 KiB Raw Blame History