github.com/jgrancell/metasync@v0.0.0-20220105143315-c43793d9d9c1/README.md (about)

     1  # Metasync
     2  
     3  Metasync provides a convenient way to quickly sync commonly used and repeated files between multiple repositories, and keep changes in sync.
     4  
     5  [![metasync](https://img.shields.io/travis/com/jgrancell/metasync?style=for-the-badge&logo=travis)](https://travis-ci.com/github/jgrancell/metasync)
     6  [![coverage](https://img.shields.io/codecov/c/github/jgrancell/metasync?color=65187a&style=for-the-badge&token=p8NQJsRPDX)](https://codecov.io/gh/jgrancell/metasync/)
     7  
     8  [![releases](https://img.shields.io/github/v/release/jgrancell/metasync?style=for-the-badge)](https://github.com/jgrancell/metasync/releases)
     9  [![GitHub license](https://img.shields.io/github/license/jgrancell/metasync?color=333333&style=for-the-badge)](https://github.com/jgrancell/metasync/blob/main/LICENSE)
    10  
    11  ## Objectives
    12  
    13  It gets extremely time consuming maintaining significant numbers of repositories, especially when you use similar CI/CD tools throughout and have a number of meta or helper files in each repository.
    14  
    15  Rather than having to go into each repository individually to make file changes, metasync provides a straightforward way to sync your metafiles with a master template repository.
    16  
    17  Metasync allows you to keep your metafiles in sync, and even version them against specific template repository tags, branches, or individual refs.
    18  
    19  ## Examples of Use
    20  
    21  | Command | Explanation | Minimum Version |
    22  | :-----: | :---------: | :-------------: |
    23  | `metasync sync` | Syncs the local repository with a remote source defined in a local `.metasync.yml` files | ------- |
    24  | `metasync sync -dryrun` | Shows required changes between the local repo and source templates, without making changes. | ------- |
    25  | `metasync sync -diff` | Shows inline diffs of changes between the remote source template and the local files. | ------- |