Metadata-Version: 1.1
Name: pyocker
Version: 0.2.5
Summary: Docker Utils with Python
Home-page: https://github.com/AkihikoITOH/pyocker
Author: ITOH Akihiko
Author-email: UNKNOWN
License: MIT
Description: Pyocker
        =======
        
        |PyPI version| |Build Status| |Dependency Status| |Code Climate|
        
        Description
        -----------
        
        -  Docker images have *Base Images*, and a Base Image also has another
           Base image.
        -  You may want to re-build ImageA before building ImageB which will be
           built based on ImageA.
        
        `Pyocker <https://github.com/AkihikoITOH/pyocker>`__ enables static
        definition of Dockerfile dependencies and selective build/push of docker
        images.
        
        TODO
        ----
        
        -  [ ] Enable use of Dockerfiles in user-selected directories for each
           image
        -  [ ] Integration with ``dockerfile_composer``
        -  [ ] Registry authentication
        -  [ ] Check if actual dependency described in Dockerfiles match
           dependency definitions
        -  [ ] Add comments
        
        Requirements
        ------------
        
        -  Docker
        
        Installation
        ------------
        
        ::
        
            pip install pyocker
        
        Usage
        -----
        
        **Build**
        ~~~~~~~~~
        
        ::
        
            pyocker build --file docker-dependency.yml            # Basic
            pyocker build --file docker-dependency.yml --dry-run  # Dry-Run
        
        Options
        ^^^^^^^
        
        ::
        
            Usage: pyocker build [OPTIONS]
        
            Options:
              --file TEXT          Path to config file [default="docker-dependency.yml"]
              --verbose / --quiet  Make lots of noise or not [default=verbose]
              --dry-run            Dry Run
              -h, --help           Show this message and exit.
        
        Config
        ^^^^^^
        
        ::
        
            # Built-in variables:
            # * $date - current date in format `yyyy.mm.dd`
            ---
            registry:                 # name of public|private registry
            images:                   # Required
              -
                name: fluentd         # Required
                tags:                 # Tags to build with
                  - latest
                  - production
                  - development
                use_cache: yes        # Disable `--no-cache` option  [default: yes]
                build: no
                push: no
              -
                name: my-image
                tags:
                  - $date-dev         # Using a built-in variable
                use_cache: no
                build: yes
                push: yes
                dependencies:         # Images required by `my-image`
                  -
                    name: base-image1
                    tags:
                      - latest
                    use_cache: yes
                    build: yes
                    push: no
                  -
                    name: base-image2
                    tags:
                      - latest
                    use_cache: yes
                    build: yes
                    push: no
        
        **Compose**
        ~~~~~~~~~~~
        
        Upcoming.
        
        .. |PyPI version| image:: https://img.shields.io/pypi/v/pyocker.svg
           :target: https://pypi.python.org/pypi/pyocker
        .. |Build Status| image:: https://travis-ci.org/AkihikoITOH/pyocker.svg?branch=master
           :target: https://travis-ci.org/AkihikoITOH/pyocker
        .. |Dependency Status| image:: https://gemnasium.com/AkihikoITOH/pyocker.svg
           :target: https://gemnasium.com/AkihikoITOH/pyocker
        .. |Code Climate| image:: https://codeclimate.com/github/AkihikoITOH/pyocker/badges/gpa.svg
           :target: https://codeclimate.com/github/AkihikoITOH/pyocker
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
