/dgit

dgit adds decentralized ownership to git - powered by Tupelo DLT and Public Portals

Primary LanguageGoMIT LicenseMIT

License Contributor Covenant


Logo

decentragit

decentragit is an open-source project built by Quorum Control which combines the power of
git, the Tupelo DLT and Public Portals from ScPrime.
decentragit uses decentralized ownership and storage to make it trivial to create a decentralized, shareable git remote of your project.
decentragit accomplishes this without changing your GitHub workflow except that you can keep collaborating when it goes down.

Getting Started

With three simple steps you can create a decentralized mirror of your existing github project. All changes will be automatically propogated to the mirror version and the git services you depend on will be there when you need them.

Installation

A quick install using brew gets you started:

brew tap quorumcontrol/dgit && brew install dgit

Or if you don't have homebrew check out our simple manual installation instructions.

Usage

Next you will need to initialize each repo you want to make decentralized:

git dg init

This command does three things.

  1. decentragit sets the appropriate remote urls in your repo's .git/config file.
  2. decentragit creates a ChainTree which gets signed by the Tupelo DLT to specify ownership of the decentralized repo.
  3. decentragit stores that repo on Public Portals, the decentralized storage solution from ScPrime.

From there you can proceed with normal git commands.

If you ever want to pull from the mirror you can specify the mirror with a "dg:".
As an example: git clone dg://your_username/repo_name

If you want to keep your decentralized, shareable git remote in sync with your GitHub repo adding a simple github action as illustrated in dgit-github-action is all it takes. Once completed your decentragit decentralized shareable remote will always be up to date and ready when you need it.

Collaborators

You can manage your repo's team of collaborators with the git gd team command:

  • git dg team add [collaborator usernames]
  • git dg team list
  • git dg team remove [usernames]

Anyone on the team will be allowed to push to the repo in the current directory.

Configuration

  • Username can be set any of the following ways:
    • DG_USERNAME=[username] env var
    • git config --global decentragit.username [username] sets it in ~/.gitconfig
    • git config decentragit.username [username] sets it in ./.git/config

FAQ

You can find answers to some of the most frequently asked questions on the wiki.

Built With

Building

  • Clone this repo.
  • Run make. Generates ./git-dg in top level dir.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

If you have any questions or concerns please hop into our developer chat on gitter and we will be glad to help.

Project Link: https://github.com/quorumcontrol/dgit