Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
247 lines (170 sloc) 7.19 KB

Usage

As a simple package manager, Appypi is used to install, remove, upgrade Pypi packages you may need. Here are the ways to do it.

Install a package

Easy peasy:

$ appypi install <package>

It may be a bit long the first time, as it constructs the package list. You can install multiple packages in one line, each one will be installed in an independant virtualenv:

$ appypi install <package1> <package2> ...

Of course, if you try to install a package that is not on Pypi, appypi will gently decline your proposition. Same thing, if you try to install a package that don't have any launcher to be used with, like in a library, appypi will stop the installation. Unhappily, there is no way to know it before going far into the installation process.

Install a list of package

As with pip, you can use a requirements file to install many packages at once:

$ appypi install --requirements=requirements.txt

But contrary to pip, you can not specify the version of a package like django==1.4. You can not install stuff from git or any other VCS as well. Maybe one day...

Note that each package will be installed in an independant virtualenv. They can't be installed in conjunction in a unique one.

Remove a package

Sad, but true:

$ appypi remove <package>

A confirmation for deletion is asked to the user. Again, you can remove multiple packages at the same time:

$ appypi remove <package1> <package2> ...

Upgrade a package

You guessed right:

$ appypi upgrade <package>

The given package is upgraded to the last version available on Pypi.

Upgrade all installed packages

Yes, it's easy:

$ appypi upgrade

All packages are upgraded to their last versions available on Pypi.

Show information about a package

$ appypi show <package>

This prints details found on Pypi about the installed version of the package. The full description is printed, so it may be a bit verbose. For example, for the Projy package:

List installed packages

Obviously:

$ appypi list

The output shows the name, the version and the summary of every installed package. Here is an example output:

appypi - 4 installed packages
------------------------------
Name       - Version - Summary
------------------------------
Projy      - 0.2     - Projy is a template-based skeleton generator.
Fabric     - 1.5.0   - Fabric is a simple, Pythonic tool for remote execution and deployment.
subliminal - 0.6.2   - Subtitles, faster than your thoughts
Glances    - 1.5.1   - CLI curses-based monitoring tool

Update the local list of Pypi packages

You guessed right:

$ appypi update

Note that this update is forced programmatically every 7 days.