Skip to content

abusque/dockeb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dockeb

PyPI

Documentation aussi disponible en français

dockeb, the Keb Docker wrapper.

dockeb can be used as a drop-in replacement for the Docker command-line.

The difference between docker and dockeb is name generation. While docker generates names of the form adjective_surname for containers, dockeb generates a random Keb name.

If you give an explicit name to a container, using the --name flag, it will be left unchanged.

Requirements

To run dockeb, you will need Python ≥ 3.4, as well as Docker.

For installing, we recommend using the pip package manager.

Installing

To install dockeb system-wide, run:

sudo pip3 install dockeb

To install dockeb manually from source, the steps are as follows:

git clone [email protected]:abusque/dockeb.git
cd dockeb
sudo ./setup.py install

Using

Once installed, you can use dockeb by running the following command:

dockeb

For a more interesting command, try:

dockeb run hello-world
dockeb ps -a

You will notice that the container was given a Keb name when created.

To automatically use dockeb instead of docker, consider defining an alias in your shell configuration:

alias docker='dockeb'
# To preserve auto-completions if using Zsh:
setopt complete_aliases

Development

For local development of dockeb, you may use pipenv. Use pipenv install --dev to generate a virtual environment into which the dependencies will be installed. You may then use pipenv shell to activate that environment.

For publishing releases to PyPI, we recommend using Twine.

See Also

  • qng, the Queb name generator.

About

The Keb Docker wrapper

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages