Giter Club home page Giter Club logo

plis's Introduction

Code Climate Test Coverage Issue Count Made with Love by Icalia Labs

Plis

Helps your development process with Docker Compose by asking nicely :)

Install

On macOS, install it via Homebrew:

brew tap icalialabs/formulae
brew install plis

On other systems you can:

  • Download the executable for your system from the Releases Page
  • Place it on any of the paths reachable in $PATH

Special behaviors:

  • plis start [services-optional]: Starts a docker-compose project, with the following extra functionality:
    • If some or all of the requested project's containers are missing, issues a docker-compose up -d command.
    • If all of the requested project's containers are present, issues a docker-compose start command.
  • plis attach [service_name]: It figures out the given service's container, and attaches the console to it.
  • plis run [service_name] [command]: It runs the given command:
    • If there's a running container for the given service, it executes it issuing a docker exec -ti command.
    • If there are no running containers for the given service, it executes it issuing a docker-compose run --rm command.
# Start a docker-compose project:
plis start

# Restart a service:
plis restart web

# Attach the console to a service:
plis attach web

# Run a command on an existing or new container:
plis run web rails c

# Stop a service:
plis stop web

TODO's:

  • build command to invoke the docker-compose build command.
  • Split up the big plis.go file.
  • check context command to list the files that will pass to the Docker build context.
  • start command with just one service should attach to the container immediately. (i.e.: plis start web starts a rails web container and attaches to it, mimicking the behavior of running rails server on the host)
  • Change the run command to use docker-compose exec instead of docker exec whenever a running container is already available.
  • Copy (from existing templates/examples) or generate blank dotenv files referenced in the Compose file.
  • Install Docker (for Mac/Windows or native for Linux) if it is missing.
  • Make plis start github.com/some_org/some_dockerized_app clone the project and run it.
  • upgrade command that upgrades plis to the newest version.
  • prune command to invoke docker system prune.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.