vpm

Vosje's package manager

This is my package manager written in bash. you can use it to download my programs from my github.
To add a repository, use the vpmfile from the repository's owner. Ask them if they did not provide one.

installation

automatic (recommended)
bash -c "$(curl -sS http://vosjedev.pii.at/vpm/install.sh)"
or manual:
mkdir ~/.vosjedev && cd ~/.vosjedev && git clone https://github.com/vosjedev/packager
and make sure wget is installed.
you can use mkdir -p "~/.local/bin" && ln -s ~/.vosjedev/packager/run.sh ~/.local/bin/vpm to make a symlink for vpm.
make sure ~/.local/bin is in your PATH.

writing my own repofile.

This is a guide on writing your own repofile. After each line is an explanation.
! a program will later be provided to do this for you.
Make sure the filename does not contain any spaces.
file: my-repo.vpmfile

/# this is a comment. it wil be skipped when reading the file.
type    = repo
/# make sure this is anywhere in the file. it will be used to define if the file is a repo, or a program.
/# for a repo, set it to 'repo'.
name    = the repo's name
/# this can be anything you want.
id      = 
/# this is the repo's name without spaces. !! this is currently not checked, so make sure the id does not contain spaces to make sure there are no errors!
url     = URL
/# this is the url to download the repolist from. a format is given later.
/# the repofiles file wil be downloaded from URL.
format  = http/zip
/# currently the option's are:
/# http/zip : downloads and extracts the file into the repo's directory. make sure it is a regular zip file with the repolist file's in its root.
/# ________ : after download it wil download a checksum from URL.checksum to match with the checksum of the local copy. this is a sha256sum generated checksum.
/# ________ : this means if your url is https://example.com/repo/vpm/repofiles.zip, the checksum wil be downloaded from https://example.com/repo/vpm/repofiles.zip.checksum.
/# git      : clone URL using git clone command. no sha256sum support
/# this option is disabled as only zip is currently supported for repos.
/#

this file can be as short as:

type    = repo
name    = my repo
id      = my-repo
url     = http://mywebsite.com/repos/repofiles.zip
format  = http/zip

the repolist:

A repolist is a bunch of files containing information about your program.
The files look like this:
file: my-program.vpmfile

type    = program
/# tell vpm this is a program and not a repo
name    = my program
/# the name of your program
id      = my-program
/# the name of your program without spaces. !! this is currently not checked, so make sure the id does not contain spaces to make sure there are no errors!
/# !! when using format 'git', this needs to be the same as the directory 'git clone URL' clones it to.
url     = URL
/# the url to download/clone
format  = git
/# current format's are:
/# git : clone the program using git.
info    = a short desciption about my program
/# tell us something about your program. keep it short!
readme  = README.md
/# the file to display if a user wants a long desciption.
/#

the short version:

type    = program
name    = my program
id      = my-program
url     = URL
format  = git
info    = a short desciption about my program
readme  = README.md

! a program will later be provided to write these file's.
to autorun a script at startup, write an install.vpmscript (docs coming later.) and put

R file_to_run

in it.

thanks for using vpm! if you find a bug, or have a feature request, make a new issue on github.

[ github || new issue ]