marcopolo

https://github.com/nlamirault/marcopolo.git

git clone 'git://github.com/nlamirault/marcopolo.git'


---

marcopolo

marcopolo provides : * a REST client to the Docker registry / Hub API

Name comes from the CMA CGM Marco Polo container ship

Installation

The recommended way to install marcopolo is via MELPA:

M-x package-install marcopolo

or Cask:

(depends-on "marcopolo")

Usage

• Configure marcopolo in Elisp :

  (setq marcopolo-registry-host "https://docker.foobar.com"
        marcopolo-registry-username "xxx"
        marcopolo-registry-password "yyy"
        marcopolo-hub-username "aaa"
        marcopolo-hub-password "bbb")
  

• Or using environment variables :

  $ export DOCKER_REGISTRY_HOST="https://docker.foobar.com"
  $ export DOCKER_REGISTRY_USERNAME="xxx"
  $ export DOCKER_REGISTRY_PASSWORD="yyy"
  $ export DOCKER_HUB_USERNAME="aaa"
  $ export DOCKER_HUB_PASSWORD="bbb"
  

• The API :

  M-x marcopolo-hub-search
  
  M-x marcopolo-registry-search
  

• Keybindings in the marcopolo-mode:

Keybinding | Description ———————|———————————————————— n | Go to next repository p | Go to previous repository q | Kill marcopolo buffer

• Some screenshots are available in img directory.

Development

Cask

marcopolo use Cask for dependencies management. Install it and retrieve dependencies :

$ curl -fsSkL https://raw.github.com/cask/cask/master/go | python
$ export PATH="$HOME/.cask/bin:$PATH"
$ cask

Tests

• Launch unit tests from shell:

  $ make clean test
  

• You could use Overseer to launch unit tests from Emacs

Support / Contribute

See here

Changelog

A changelog is available here.

License

See LICENSE.

Contact

Nicolas Lamirault <nicolas.lamirault@gmail.com>