WHAT?

Pakku - A Package Manager for Raku.

WHY?

TMTOWTDI

WHEN?

Pakku is now at version pupa and growing towards version adult. Currently Pakku can do many things like adding, removing, listing and downloading distributions.

INSTALLATION

Requires git, curl and tar be available in $PATH

git clone https://github.com/hythm7/Pakku.git

cd Pakku

# install to home directory
./tools/install-pakku.raku

# or to different destination
# ./tools/install-pakku.raku --dest=/path/to/pakku

Overview

• Pakku is a simple package manager for Raku, with many options and customizations that can be configured in pakku.cnf file or via command line options.

• Pakku command result is either:

  • -Ofun - Desired operation completed successfully
  • Nofun - Desired operation did not complete successfully

• Pakku verbosity levels:

  • 0 (silent) - No output what so ever
  • 1 (trace) 🤓 - If you want to see everything
  • 2 (debug) 🐞 - To debug some issue
  • 3 (info ) 🦋 - Camelia delivers important things
  • 4 (warn ) 🔔 - Only when some warnings happen
  • 5 (error) ❌ - When errors are what you care about
  • 6 (fatal) 💀 - You probably don't like to see that when running Pakku, me neither!

• Pakku output meaning:

🦋 PRC: ｢ ... ｣ → Start processing...
🐞 SPC: ｢ ... ｣ → Processing spec
🐞 MTA: ｢ ... ｣ → Processing meta
🤓 FTC: ｢ ... ｣ → Fetch URL
🐞 BLD: ｢ ... ｣ → Start building dist
🦋 BLT: ｢ ... ｣ → Built dist successfully
🐞 TST: ｢ ... ｣ → Start testing dist
🦋 TST: ｢ ... ｣ → Tested dist successfully
🦋 ADD: ｢ ... ｣ → Added dist successfully
🔔 TOT: ｢ ... ｣ → Timed out
💀 MTA: ｢ ... ｣ → No valid meta obtained for spec
💀 BLD: ｢ ... ｣ → Bulding dist failed
💀 TST: ｢ ... ｣ → Testing dist failed
💀 CNF: ｢ ... ｣ → Config file error
💀 CMD: ｢ ... ｣ → Could not understand command

• Pakku uses Pakku::RecMan recommendation manager to obtain distributions META info and archives.

USAGE

Add distribution

pakku add MyModule
pakku add nodeps MyModule
pakku add notest MyModule
pakku add to     /opt/MyApp MyModule
pakku add force  to   home  MyModule1 MyModule2


Options: - Specific to add command

deps            → add dependencies
nodeps          → no dependencies
deps runtime    → add runtime dependencies
deps test       → add test    dependencies
deps build      → add build dependencies
deps requires   → only required dependencies
deps recommends → required and recommended dependencies as well
deps suggests   → required, recommended and suggested dependencies
deps only       → dont add the distribution, only it's dependencies
build           → build distribution
nobuild         → bypass build
test            → test distribution
notest          → bypass test
force           → force add distribution even if installed
noforce         → no force
to < repo >     → add distribution to repo < home site vendor core /path/to/MyApp >

Remove distribution

pakku remove MyModule


Options: - Specific to remove command

from < repo > → remove distribution from provided repo only

List distribution

pakku list
pakku list MyModule
pakku list local   MyModule
pakku list remote  MyModule
pakku list details MyModule
pakku list repo home
pakku list repo /opt/MyApp MyModule


Options: - Specific to list command

local                 → list local installed dist
remote                → list remote recman's available dists
details               → list details of dist
repo < name-or-path > → list dists installed in specific repo

Build distribution

pakku build MyModule
pakku build .

Test distribution

pakku test MyModule
pakku test ./MyModule

Checkout (download) distribution

pakku checkout MyModule

Pakku Options

pakku dont     add MyModule
pakku nopretty add MyModule
pakku yolo     add MyFailedModule MyModule
pakku pretty   please remove MyModule


Options: - Global options control general Pakku behavior and placed before Pakku commands < add remove ... >

pretty            → colors
nopretty          → no colors
dont              → do everything but dont do it (dry run)
verbose < level > → verbosity < silent trace debug info warn error fatal >
please            → be nice to butterflies
yolo              → dont stop on errors, useful when need to proceed after error (e.g. Test Faliure)

Print Help

pakku
pakku add
pakku help
pakku help list
pakku help help

Feeling Rakuish Today?

Most of Pakku commands and options can be written in shorter form, for example:

add       → a     yolo    → y     nopretty → np     silent → «S 0»
remove    → r     pretty  → p     nodeps   → nd     trace  → «T 1»
list      → l     only    → o     noforce  → nf     debug  → «D 2»
build     → b     verbose → v     noforce  → nf     info   → «I 3»
test      → t     verbose → v     details  →  d     warn   → «W 4»
checkout  → c     deps    → d     local    →  l     error  → «E 5»
help      → h     force   → f     remote   →  r     fatal  → «F 6»

So this is a valid Pakku command:

pakku y a f MyModule

Did I mention that the below are Pakku commands as well?

pakku 𝛒 ↓ 🔗 🔨 MyModule
pakku 👓 🦋 ↑ MyModule
pakku ↪ 🌎
pakku ❓

Can you guess what they do? A full list is here,you can add you favourite ones too if you like.

CONFIGURATION

All options can be set in command line or in the config file pakku.cnf ｢~/.pakku/pakku.cnf｣. The only needed config is <recman> source, otherwise you will be able to install local distributions only.

Config file example:

### pakku Config

# < pakku >
  # pretty           # colors
  # verbose info     # < 0 1 2 3 4 5 6 >
  # dont             # dont do it (dry run)

# < add >
  # deps       # add deps as well < deps nodeps >
  # build      # build            < build nobuild >
  # test       # test             < test notest >
  # force      # force install    < force noforce >
  # to  home   # add to specific repo < home site vendor core /custom/repo/path >

# < remove >
  # from home  # remove from specific repo

# < list >
  # local   # local  installed dists
  # remote  # remote recman's dists
  # details # list   details of dists

## Customize verbosity levels symbols and colors
# < log >
  # trace name T:
  # debug name D:
  # info  name I:
  # warn  name W:
  # error name E:
  # fatal name F:

  # trace color reset
  # debug color green
  # info  color blue
  # warn  color yellow
  # error color magenta
  # fatal color red

< recman >
recman.pakku.org

CAVEATS

Currently Pakku runs on Linux, more operating systems will be supported in the future.

CREDITS

Thanks to Panda and Zef for Pakku inspiration. also Thanks to the nice #raku community.

MOTTO

Light like a 🦋, Colorful like a 🦋

AUTHOR

Haytham Elganiny elganiny.haytham at gmail.com

COPYRIGHT AND LICENSE

Copyright 2019 Haytham Elganiny

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.