Installation

https://badge.fury.io/py/papis.svg https://repology.org/badge/vertical-allrepos/papis.svg

Using pip

The easiest way of installing papis is using the PyPi repositories and the package manager pip3, just open a terminal and type in

pip3 install papis

If you are on GNU/Linux like systems you might need to type sudo

sudo pip3 install papis

of if you prefer installing it locally then simply type

pip3 install --user papis

You can also update papis with pip

pip3 install --upgrade papis

Archlinux

The package papis is also found in the archlinux repositories here.

NixOS

If you are running NixOS or you have the nix package manager installed, you can install papis by running:

nix-env -i papis

If you like papis, just clone the repository

git clone git@github.com:papis/papis.git
cd papis

and start hacking it with:

nix-shell --expr 'with import <nixpkgs> {}; papis.overrideDerivation (drv: { src = ./.; })'

This command will provide you a shell with all the dependencies required.

From source

First of all you have to get the code, open a terminal and hit

git clone https://github.com/alejandrogallo/papis.git

or download the zip file.

Go inside of the papis source folder and you can either use the Makefile or install it with python3.

Using the Makefile

If you want to install it globally, just hit

sudo make install

If you want to install it locally:

make install-local

If you want to install it locally and have the development version:

make install-dev-local

And to see the available targets hit:

make help

Using python3

The general command that you have to hit is by using the setup.py script:

python3 setup.py install

Again, if you want to install it locally because you don’t have administrative rights in your computer you can just simply type

python3 setup.py install --user

If you want to develop on the code, you can also alternatively hit

python3 setup.py develop --user

Warning

If you install the package locally, the program papis will be installed by default into your ~/.local/bin direcrtory, so that you will have to set your PATH accordingly.

One way of doing this in bash shells (Linux and the like, also Ubuntu on Windows or cygwin) is by adding the following line to your ~/.bashrc file

export PATH=$PATH:$HOME/.local/bin

Requirements

Papis needs the following packages that are sometimes not installed with the system python3 distribution

python3-setuptools

However if you have a general enough python distribution they should be installed.