Metadata-Version: 2.1
Name: gimera
Version: 0.3.20
Summary: Handling git submodules and patches.
Home-page: https://github.com/marcwimmer/gimera
Author: Marc-Christian Wimmer
Author-email: marc@itewimmer.de
License: MIT
Description: 
        # Welcome to GIMERA
        
        
        ## How to install:
        
          * pip install gimera
        
        
        
        ## How to use:
        
        Put gimera.yml into your root folder of your project:
        
        ```yaml
        repos:
            # make ordinary git submodule:
            - url: "https://github.com/foo/bar"
              branch: branch1
              path: roles/sub1
              patches: []
              type: submodule
        
        
            # instead of submodule put the content directly in the repository;
            # apply patches from local git repository
            - url: "https://github.com/foo/bar"
              branch: branch1
              path: roles2/sub1
              patches:
                  - 'roles2/sub1_patches'
              type: integrated
        
            # instead of submodule put the content directly in the repository;
            # apply patches from another remote repository
            #
            - url: "https://github.com/foo/bar"
              branch: branch1
              path: roles2/sub1
              remotes:
                  remote2: https://github.com/foo2/bar2
              merges:
                  - remote2 main
                  - origin refs/pull/1/head
              type: integrated
        
        ```
        
        Patches and remote merges may be combined.
        
        Then execute:
        
        `>  gimera apply`
        
        ## How to make a patchfile:
        
        From the example above: 
        
          * edit roles2/sub1/file1.txt
          * `>  gimera apply`
        
        Then a patch file is created as suggestion in roles2/sub1_patches which you may commit and push.
        ## How to fetch only one or more repo:
        
          * `>  gimera apply repo_path repo_path2 repo_path3`
        ## How to fetch latest versions:
        
          * `>  gimera apply --update`
        
        Latest versions are pulled and patches are applied.
        
        ## How to upload new version
          * increase version in setup.py
          * one time: pipenv install twine --dev
          * pipenv shell
          * python3 setup.py upload
        
        ## Contributors
          * Michael Tietz (mtietz@mt-software.de)
          * Walter Saltzmann
        
        
        ## install directly
        
        pip install git+https://github.com/marcwimmer/gimera
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
