vorx 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: dcf0bb2488590441bb3ba4d319508b19352afff8f12051e0b0a171d5283b5ed5
+  data.tar.gz: e8daafe69c2cdb6fa9b9dc19e2c0fa8dcd72575c3fc65b0b42288ff7866f979e
+SHA512:
+  metadata.gz: 97f867eb985367a279327f75049605261653cf316bcfede5c91127d9dc14a63472d78c12d34043adb72722cc1d1d9b7d44721dcb391e91978940cf6dfec95a1a
+  data.tar.gz: 2fac650cccb6c318584a687a30c84135aefff0f6f498f3df71147fcf292de7f9a56f2872c99c7da2e9afde2e97a9955d24fa4c12e77a3aa6c87587917c03cc94

data/.github/workflows/ruby.yml

@@ -0,0 +1,50 @@
+name: Ruby
+
+on: [push, workflow_dispatch]
+
+jobs:
+  build:
+    runs-on: ubuntu-16.04
+    strategy:
+      matrix:
+        ruby: [ '2.5', '2.6', '2.7' ]
+    name: Ruby ${{ matrix.ruby }}
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Setup Code Climate test-reporter
+        run: |
+          curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+          chmod +x ./cc-test-reporter
+          ./cc-test-reporter before-build
+
+      - name: Build
+        run: |
+          docker-compose -p vorx_ruby_${{ matrix.ruby }} build --build-arg ${{ matrix.ruby }} app
+
+      - name: Run tests
+        run: |
+          docker-compose -p vorx_ruby_${{ matrix.ruby }} run --rm app rspec
+        env:
+          TMP_TEST_FILE_FOLDER: '/tmp'
+
+      - name: Publish code coverage
+        run: |
+          # TODO: Move to script
+          docker-compose -p vorx_ruby_${{ matrix.ruby }} run --rm app 'export GIT_BRANCH="${GITHUB_REF/refs\/heads\//}" && ./cc-test-reporter after-build -r ${{secrets.CC_TEST_REPORTER_ID}}'
+
+  lint:
+    runs-on: ubuntu-16.04
+    name: Lint
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '2.6'
+      - name: Install Gems
+        run: |
+          gem install bundler
+          bundle install --jobs 4 --retry 3
+      - name: Rubocop
+        run: bundle exec rubocop
+

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+.byebug_history

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,18 @@
+AllCops:
+  NewCops: enable
+
+Style/Documentation:
+  Enabled: false
+
+Style/BlockDelimiters:
+  Exclude:
+    - spec/**/*
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*
+    - djin.gemspec
+
+Style/RescueModifier:
+  Exclude:
+    - spec/**/*

data/Dockerfile

@@ -0,0 +1,52 @@
+ARG RUBY_VERSION
+FROM ruby:${RUBY_VERSION:-2.6.6}-alpine AS builder
+
+ENV BUILD_PACKAGES build-base git
+ENV DEV_PACKAGES bash
+
+RUN mkdir /bundle
+
+RUN apk update && \
+    apk upgrade && \
+    apk add $BUILD_PACKAGES && \
+    rm -rf /var/cache/apk/*
+
+COPY vorx.gemspec Gemfile Gemfile.lock ./
+
+COPY lib/vorx/version.rb lib/vorx/version.rb
+
+RUN gem install bundler -v 2.1.4
+
+RUN bundle install
+
+FROM builder AS dev
+
+RUN apk add $DEV_PACKAGES && \
+    rm -rf /var/cache/apk/*
+
+WORKDIR /usr/src/vorx
+
+COPY . .
+
+FROM ruby:2.6.5-alpine
+
+WORKDIR /usr/src/vorx
+
+COPY --from=builder /usr/local/bundle/ /usr/local/bundle
+
+RUN gem install bundler -v 2.1.4
+
+ENV DEPENDENCIES git
+
+RUN apk update && \
+    apk upgrade && \
+    apk add $DEPENDENCIES && \
+    rm -rf /var/cache/apk/*
+
+COPY . .
+
+RUN rake install
+
+WORKDIR /usr/src/project
+
+ENTRYPOINT ["/usr/src/vorx/docker-entrypoint.sh"]

data/Gemfile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in vorx.gemspec
+gemspec
+
+gem 'rake', '~> 12.0'
+gem 'rspec', '~> 3.0'

data/Gemfile.lock

@@ -0,0 +1,100 @@
+PATH
+  remote: .
+  specs:
+    vorx (0.1.0)
+      dry-cli (~> 0.6.0)
+      dry-equalizer (~> 0.3.0)
+      dry-struct (~> 1.3.0)
+      git (~> 1.8.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    byebug (11.1.3)
+    concurrent-ruby (1.1.8)
+    diff-lcs (1.4.4)
+    docile (1.3.5)
+    dry-cli (0.6.0)
+      concurrent-ruby (~> 1.0)
+    dry-configurable (0.12.1)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 0.5, >= 0.5.0)
+    dry-container (0.7.2)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 0.1, >= 0.1.3)
+    dry-core (0.5.0)
+      concurrent-ruby (~> 1.0)
+    dry-equalizer (0.3.0)
+    dry-inflector (0.2.0)
+    dry-logic (1.1.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 0.5, >= 0.5)
+    dry-struct (1.3.0)
+      dry-core (~> 0.4, >= 0.4.4)
+      dry-equalizer (~> 0.3)
+      dry-types (~> 1.3)
+      ice_nine (~> 0.11)
+    dry-types (1.5.1)
+      concurrent-ruby (~> 1.0)
+      dry-container (~> 0.3)
+      dry-core (~> 0.5, >= 0.5)
+      dry-inflector (~> 0.1, >= 0.1.2)
+      dry-logic (~> 1.0, >= 1.0.2)
+    git (1.8.1)
+      rchardet (~> 1.8)
+    ice_nine (0.11.2)
+    json (2.5.1)
+    parallel (1.20.1)
+    parser (3.0.0.0)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (12.3.3)
+    rchardet (1.8.0)
+    regexp_parser (2.1.1)
+    rexml (3.2.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    rubocop (1.11.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.2.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.4.1)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.11.0)
+    simplecov (0.17.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    unicode-display_width (2.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  byebug
+  rake (~> 12.0)
+  rspec (~> 3.0)
+  rubocop
+  simplecov (~> 0.17.0)
+  vorx!
+
+BUNDLED WITH
+   2.1.4

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Carlos Atkinson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,75 @@
+# Vorx
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/vorx`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'vorx'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install vorx
+
+## Usage
+
+```ruby
+  require 'vorx'
+
+  store = Vorx::Store.new
+
+  store.fetch('catks/docker-ruby') # Git clone or git fetch and pull https://github.com/catks/docker-ruby on master branch
+
+  store.fetch('catks/docker-ruby:1.0.0') # Git clone or git fetch and pull https://github.com/catks/docker-ruby on 1.0.0
+
+  store.fetch('github:catks/docker-ruby:1.0.0') # Git clone or git fetch and pull https://github.com/catks/docker-ruby on version 1.0.0
+
+  store.fetch('bitbucket:catks/docker-ruby') # Git clone or git fetch and pull https://bitbucket.org/catks/docker-ruby on master branch
+
+  store.fetch('gitlab:catks/docker-ruby') # Git clone or git fetch and pull https://gitlab.com/catks/docker-ruby on master branch
+
+  # You can customize the folder to clone the repositories (default to ~/vorx/store), the store file (default to vorx_store.yml) and the stderr
+
+  stderr_output = StringIO.new
+  store = Vorx::Store.new('~/my_repos', store_file: 'my_store.yml', stderr: stderr_output)
+
+  store.add('catks/docker-ruby') # Adds git repository reference but not clone
+  store.add('catks/docker-go') # Adds git repository reference but not clone
+
+  store.fetch_all # Clone ou Update every repository
+
+  store.delete('catks/docker-ruby') # Delete git repository reference and folder if cloned
+
+  store.delete_all # Deletes all git repositories references and folders
+
+  # Repository Prefix
+
+  store = Vorx::Store.new(repository_prefix: 'vorx-')
+
+  store.fetch('catks/docker-ruby') # Git clone or git fetch and pull https://github.com/catks/vorx-docker-ruby on master branch
+
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/vorx.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/Vertofile

@@ -0,0 +1,38 @@
+verto_version '0.10.0'
+
+config {
+  version.prefix = 'v' # Adds a version_prefix
+  git.pull_before_tag_creation = true
+  git.push_after_tag_creation = true
+}
+
+context(branch('master')) {
+  before_command_tag_up {
+    command_options.add(filter: 'release_only')
+  }
+
+  before_tag_creation {
+    update_changelog(with: :merged_pull_requests_with_bracketed_labels,
+                     confirmation: true,
+                     filename: 'CHANGELOG.md')
+
+    git!('add CHANGELOG.md')
+
+    files_to_change_version_once = %w[lib/vorx/version.rb]
+
+    files_to_change_version_once.each do |filename|
+      file(filename).replace(latest_version.to_s, new_version.to_s)
+    end
+
+    file('README.md').replace_all(latest_version.to_s, new_version.to_s)
+
+    git!("add #{files_to_change_version_once.join(' ')} README.md")
+
+    sh!('bundle install')
+    sh!('rake install')
+    git!('add Gemfile.lock')
+
+    git!('commit -m "Bumps Version"')
+  }
+}
+

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'vorx'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/djin.yml

@@ -0,0 +1,46 @@
+djin_version: '0.11.6'
+
+_default_run_options: &default_run_options
+  options: "--rm --entrypoint=''"
+
+tasks:
+  test:
+    description: Runs Specs
+    docker-compose:
+      service: app
+      run:
+        commands: "rspec {{args}}"
+        <<: *default_run_options
+    aliases:
+      - rspec
+
+  lint:
+    description: Lint
+    docker-compose:
+      service: app
+      run:
+        commands: "rubocop {{args}}"
+        <<: *default_run_options
+    aliases:
+      - rubocop
+
+  sh:
+    description: Enter app service shell
+    docker-compose:
+      service: app
+      run:
+        commands: "sh"
+        <<: *default_run_options
+  run:
+    docker-compose:
+      service: app
+      run:
+        commands: "sh -c '{{args}}'"
+        <<: *default_run_options
+
+  release:
+    local:
+      run:
+        - (source ~/.zshrc || true)
+        - verto tag up {{args}}
+        - bundle exec rake release

data/docker-compose.yml

@@ -0,0 +1,20 @@
+version: "3.9"
+
+services:
+  app:
+    build:
+      context: .
+      target: dev
+    entrypoint: 'sh docker-entrypoint.sh'
+    command: 'djin'
+    tty: true
+    stdin_open: true
+    volumes:
+      - .:/usr/src/vorx
+    depends_on:
+      - gitserver
+
+  gitserver:
+    image: catks/gitserver-http:0.1.0
+    volumes:
+      - ./docker/git_server/repos/:/var/lib/initial/

data/docker-entrypoint.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+set -e
+
+bundle check || bundle install
+
+./wait-for-it.sh gitserver:80 -t 10
+
+exec bundle exec "$@"

data/docker/git_server/repos/myrepo/test.yml

@@ -0,0 +1,12 @@
+djin_version: '0.10.0'
+
+_default_run_options: &default_run_options
+  options: "--rm --entrypoint=''"
+
+tasks:
+  "{{namespace}}unit":
+    docker-compose:
+      service: app
+      run:
+        commands: "cd /usr/src/djin && rspec {{args}}"
+        <<: *default_run_options

data/docker/git_server/repos/myrepo2/another_test.yml

@@ -0,0 +1,12 @@
+djin_version: '0.10.0'
+
+_default_run_options: &default_run_options
+  options: "--rm --entrypoint=''"
+
+tasks:
+  "{{namespace}}integration":
+    docker-compose:
+      service: app
+      run:
+        commands: "cd /usr/src/djin && cucumber {{args}}"
+        <<: *default_run_options

data/lib/vorx.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'dry-struct'
+require 'git'
+
+require 'vorx/version'
+require 'vorx/types'
+require 'vorx/git_repository'
+require 'vorx/git_reference'
+require 'vorx/store'
+
+module Vorx
+  class Error < StandardError; end
+
+  def self.root_path
+    Pathname.new File.expand_path("#{__dir__}/..")
+  end
+end

data/lib/vorx/git_reference.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Vorx
+  class GitReference
+    GIT_URI_REGEXP = Regexp.new('(\w+://)(.+@)*([\w\d\.]+)(:[\d]+){0,1}/*(.*)')
+    PROVIDERS = {
+      'github' => 'https://github.com',
+      'gitlab' => 'https://gitlab.com',
+      'bitbucket' => 'https://bitbucket.org',
+      nil => 'https://github.com'
+    }.freeze
+
+    class << self
+      def resolve(git_reference, prefix: '')
+        git_uri = git_reference if GIT_URI_REGEXP.match?(git_reference)
+
+        provider, reference, version = extract_params(git_reference) unless git_uri
+
+        # TODO: Improve
+        raise 'Invalid git uri or git reference' if !reference && !git_uri
+
+        git_uri ||= "#{PROVIDERS[provider]}/#{with_prefix(reference, prefix)}.git"
+        version ||= 'master'
+
+        GitRepository.new(
+          git: git_uri,
+          version: version
+        )
+      end
+
+      private
+
+      def extract_params(git_reference)
+        provider, reference, version = %r{([[:alnum:]]+:)?([[[:alnum:]]|/]+)(:\S+)?}.match(git_reference).captures
+
+        provider&.tr!(':', '')
+        version&.tr!(':', '')
+
+        [provider, reference, version]
+      end
+
+      def with_prefix(reference, prefix)
+        git_user, git_repo = reference.split('/')
+
+        "#{git_user}/#{prefix}#{git_repo}"
+      end
+    end
+  end
+end

data/lib/vorx/git_repository.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Vorx
+  class GitRepository < Dry::Struct
+    attribute :git, Types::String
+    attribute :version, Types::String.default('master')
+    attribute :cloned, Types::Bool.optional.default(nil)
+
+    include Dry::Equalizer(:git, :version)
+
+    def self.by_reference(git_reference)
+      GitReference.resolve(git_reference)
+    end
+
+    def folder_name
+      @folder_name ||= "#{git.split('/').last.chomp('.git')}@#{version}"
+    end
+
+    def cloned?
+      !!cloned
+    end
+
+    def to_s
+      "git: #{git} version: #{version}"
+    end
+
+    def update(**params)
+      self.class.new(to_h.merge(**params))
+    end
+  end
+end

data/lib/vorx/store.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require 'yaml/store'
+
+module Vorx
+  class Store
+    def initialize(base_path = '~/.vorx/store', stderr: $stderr, store_file: 'vorx_store.yml', repository_prefix: '')
+      @base_path = Pathname.new(base_path.to_s)
+      @stderr = stderr
+      @repository_prefix = repository_prefix
+
+      @base_path.mkpath
+
+      @store = YAML::Store.new(@base_path.join(store_file).to_s)
+      @store.transaction { @store[:repositories] ||= Set.new }
+    end
+
+    def fetch(git_reference)
+      git_repository = find(git_reference) || add(git_reference)
+
+      git_fetch_references(git_repository)
+
+      update_repository(git_repository, cloned: true)
+    end
+
+    def fetch_all
+      all.each do |repo|
+        fetch(repo)
+      end
+    end
+
+    def add(git_reference)
+      git_repository = resolve_git_reference(git_reference)
+
+      @store.transaction { @store[:repositories] << git_repository }
+
+      git_repository
+    end
+
+    def find(git_reference)
+      git_repository = resolve_git_reference(git_reference)
+
+      git_repositories.detect do |gr|
+        gr == git_repository
+      end
+    end
+
+    def delete(git_reference)
+      git_repository = resolve_git_reference(git_reference)
+
+      `rm -rf #{git_folder(git_repository)}`
+
+      @store.transaction { @store[:repositories].delete(git_repository) }
+    end
+
+    def delete_all
+      all.each do |repo|
+        delete(repo)
+      end
+    end
+
+    def all
+      @store.transaction { @store[:repositories] }
+    end
+
+    def reload
+      @store.transaction do
+        repos = @store[:repositories]
+
+        repos.select { |r| git_folder(r).exist? }.each do |repo|
+          repos.delete(repo)
+          repos << repo.update(cloned: true)
+        end
+      end
+    end
+
+    private
+
+    def resolve_git_reference(git_reference)
+      return git_reference if git_reference.is_a?(GitRepository)
+
+      GitReference.resolve(git_reference, prefix: @repository_prefix)
+    end
+
+    def update_repository(git_repository, **params)
+      @store.transaction do
+        repos = @store[:repositories]
+
+        repos.delete(git_repository)
+        repos << git_repository.update(**params)
+      end
+    end
+
+    attr_accessor :stderr, :base_path
+
+    def git_repositories
+      @store.transaction { @store[:repositories] }
+    end
+
+    def git_fetch_references(git_repository)
+      return git_clone(git_repository) unless git_repository.cloned?
+
+      git_fetch(git_repository)
+      git_pull(git_repository)
+    end
+
+    def git_clone(git_repository)
+      Git.clone(git_repository.git.to_s, git_folder(git_repository), branch: git_repository.version)
+    end
+
+    def git_fetch(git_repository)
+      git_repo = Git.open(git_folder(git_repository))
+      git_repo.fetch
+    end
+
+    def git_pull(git_repository)
+      git_repo = Git.open(git_folder(git_repository))
+
+      git_repo.pull
+    end
+
+    def git_folder(git_repository)
+      @base_path.join(git_repository.folder_name)
+    end
+  end
+end

data/lib/vorx/types.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Vorx
+  module Types
+    include Dry.Types()
+  end
+end

data/lib/vorx/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Vorx
+  VERSION = '0.1.0'
+end

data/vorx.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative 'lib/vorx/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'vorx'
+  spec.version       = Vorx::VERSION
+  spec.authors       = ['Carlos Atkinson']
+  spec.email         = ['carlos.atkinson@vagas.com.br']
+
+  spec.summary       = 'Vorx let you manage multiple git repositories'
+  # spec.description   = %q{TODO: Write a longer description or delete this line.}
+  # spec.homepage      = "TODO: Put your gem's website or public repo URL here."
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.5.0')
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+
+  # spec.metadata["homepage_uri"] = spec.homepage
+  # spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'dry-cli', '~> 0.6.0'
+  spec.add_dependency 'dry-equalizer', '~> 0.3.0'
+  spec.add_dependency 'dry-struct', '~> 1.3.0'
+  spec.add_dependency 'git', '~> 1.8.1'
+
+  spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'simplecov', '~> 0.17.0'
+end

data/wait-for-it.sh

@@ -0,0 +1,183 @@
+#!/usr/bin/env bash
+# Use this script to test if a given TCP host/port are available
+# Credits: https://github.com/vishnubob/wait-for-it
+
+WAITFORIT_cmdname=${0##*/}
+
+echoerr() { if [[ $WAITFORIT_QUIET -ne 1 ]]; then echo "$@" 1>&2; fi }
+
+usage()
+{
+    cat << USAGE >&2
+Usage:
+    $WAITFORIT_cmdname host:port [-s] [-t timeout] [-- command args]
+    -h HOST | --host=HOST       Host or IP under test
+    -p PORT | --port=PORT       TCP port under test
+                                Alternatively, you specify the host and port as host:port
+    -s | --strict               Only execute subcommand if the test succeeds
+    -q | --quiet                Don't output any status messages
+    -t TIMEOUT | --timeout=TIMEOUT
+                                Timeout in seconds, zero for no timeout
+    -- COMMAND ARGS             Execute command with args after the test finishes
+USAGE
+    exit 1
+}
+
+wait_for()
+{
+    if [[ $WAITFORIT_TIMEOUT -gt 0 ]]; then
+        echoerr "$WAITFORIT_cmdname: waiting $WAITFORIT_TIMEOUT seconds for $WAITFORIT_HOST:$WAITFORIT_PORT"
+    else
+        echoerr "$WAITFORIT_cmdname: waiting for $WAITFORIT_HOST:$WAITFORIT_PORT without a timeout"
+    fi
+    WAITFORIT_start_ts=$(date +%s)
+    while :
+    do
+        if [[ $WAITFORIT_ISBUSY -eq 1 ]]; then
+            nc -z $WAITFORIT_HOST $WAITFORIT_PORT
+            WAITFORIT_result=$?
+        else
+            (echo -n > /dev/tcp/$WAITFORIT_HOST/$WAITFORIT_PORT) >/dev/null 2>&1
+            WAITFORIT_result=$?
+        fi
+        if [[ $WAITFORIT_result -eq 0 ]]; then
+            WAITFORIT_end_ts=$(date +%s)
+            echoerr "$WAITFORIT_cmdname: $WAITFORIT_HOST:$WAITFORIT_PORT is available after $((WAITFORIT_end_ts - WAITFORIT_start_ts)) seconds"
+            break
+        fi
+        sleep 1
+    done
+    return $WAITFORIT_result
+}
+
+wait_for_wrapper()
+{
+    # In order to support SIGINT during timeout: http://unix.stackexchange.com/a/57692
+    if [[ $WAITFORIT_QUIET -eq 1 ]]; then
+        timeout $WAITFORIT_BUSYTIMEFLAG $WAITFORIT_TIMEOUT $0 --quiet --child --host=$WAITFORIT_HOST --port=$WAITFORIT_PORT --timeout=$WAITFORIT_TIMEOUT &
+    else
+        timeout $WAITFORIT_BUSYTIMEFLAG $WAITFORIT_TIMEOUT $0 --child --host=$WAITFORIT_HOST --port=$WAITFORIT_PORT --timeout=$WAITFORIT_TIMEOUT &
+    fi
+    WAITFORIT_PID=$!
+    trap "kill -INT -$WAITFORIT_PID" INT
+    wait $WAITFORIT_PID
+    WAITFORIT_RESULT=$?
+    if [[ $WAITFORIT_RESULT -ne 0 ]]; then
+        echoerr "$WAITFORIT_cmdname: timeout occurred after waiting $WAITFORIT_TIMEOUT seconds for $WAITFORIT_HOST:$WAITFORIT_PORT"
+    fi
+    return $WAITFORIT_RESULT
+}
+
+# process arguments
+while [[ $# -gt 0 ]]
+do
+    case "$1" in
+        *:* )
+        WAITFORIT_hostport=(${1//:/ })
+        WAITFORIT_HOST=${WAITFORIT_hostport[0]}
+        WAITFORIT_PORT=${WAITFORIT_hostport[1]}
+        shift 1
+        ;;
+        --child)
+        WAITFORIT_CHILD=1
+        shift 1
+        ;;
+        -q | --quiet)
+        WAITFORIT_QUIET=1
+        shift 1
+        ;;
+        -s | --strict)
+        WAITFORIT_STRICT=1
+        shift 1
+        ;;
+        -h)
+        WAITFORIT_HOST="$2"
+        if [[ $WAITFORIT_HOST == "" ]]; then break; fi
+        shift 2
+        ;;
+        --host=*)
+        WAITFORIT_HOST="${1#*=}"
+        shift 1
+        ;;
+        -p)
+        WAITFORIT_PORT="$2"
+        if [[ $WAITFORIT_PORT == "" ]]; then break; fi
+        shift 2
+        ;;
+        --port=*)
+        WAITFORIT_PORT="${1#*=}"
+        shift 1
+        ;;
+        -t)
+        WAITFORIT_TIMEOUT="$2"
+        if [[ $WAITFORIT_TIMEOUT == "" ]]; then break; fi
+        shift 2
+        ;;
+        --timeout=*)
+        WAITFORIT_TIMEOUT="${1#*=}"
+        shift 1
+        ;;
+        --)
+        shift
+        WAITFORIT_CLI=("$@")
+        break
+        ;;
+        --help)
+        usage
+        ;;
+        *)
+        echoerr "Unknown argument: $1"
+        usage
+        ;;
+    esac
+done
+
+if [[ "$WAITFORIT_HOST" == "" || "$WAITFORIT_PORT" == "" ]]; then
+    echoerr "Error: you need to provide a host and port to test."
+    usage
+fi
+
+WAITFORIT_TIMEOUT=${WAITFORIT_TIMEOUT:-15}
+WAITFORIT_STRICT=${WAITFORIT_STRICT:-0}
+WAITFORIT_CHILD=${WAITFORIT_CHILD:-0}
+WAITFORIT_QUIET=${WAITFORIT_QUIET:-0}
+
+# Check to see if timeout is from busybox?
+WAITFORIT_TIMEOUT_PATH=$(type -p timeout)
+WAITFORIT_TIMEOUT_PATH=$(realpath $WAITFORIT_TIMEOUT_PATH 2>/dev/null || readlink -f $WAITFORIT_TIMEOUT_PATH)
+
+WAITFORIT_BUSYTIMEFLAG=""
+if [[ $WAITFORIT_TIMEOUT_PATH =~ "busybox" ]]; then
+    WAITFORIT_ISBUSY=1
+    # Check if busybox timeout uses -t flag
+    # (recent Alpine versions don't support -t anymore)
+    if timeout &>/dev/stdout | grep -q -e '-t '; then
+        WAITFORIT_BUSYTIMEFLAG="-t"
+    fi
+else
+    WAITFORIT_ISBUSY=0
+fi
+
+if [[ $WAITFORIT_CHILD -gt 0 ]]; then
+    wait_for
+    WAITFORIT_RESULT=$?
+    exit $WAITFORIT_RESULT
+else
+    if [[ $WAITFORIT_TIMEOUT -gt 0 ]]; then
+        wait_for_wrapper
+        WAITFORIT_RESULT=$?
+    else
+        wait_for
+        WAITFORIT_RESULT=$?
+    fi
+fi
+
+if [[ $WAITFORIT_CLI != "" ]]; then
+    if [[ $WAITFORIT_RESULT -ne 0 && $WAITFORIT_STRICT -eq 1 ]]; then
+        echoerr "$WAITFORIT_cmdname: strict mode, refusing to execute subprocess"
+        exit $WAITFORIT_RESULT
+    fi
+    exec "${WAITFORIT_CLI[@]}"
+else
+    exit $WAITFORIT_RESULT
+fi

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: vorx
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Carlos Atkinson
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2021-03-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: dry-equalizer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+- !ruby/object:Gem::Dependency
+  name: dry-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.1
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.0
+description: 
+email:
+- carlos.atkinson@vagas.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ruby.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Dockerfile
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- Vertofile
+- bin/console
+- bin/setup
+- djin.yml
+- docker-compose.yml
+- docker-entrypoint.sh
+- docker/git_server/repos/myrepo/test.yml
+- docker/git_server/repos/myrepo2/another_test.yml
+- lib/vorx.rb
+- lib/vorx/git_reference.rb
+- lib/vorx/git_repository.rb
+- lib/vorx/store.rb
+- lib/vorx/types.rb
+- lib/vorx/version.rb
+- vorx.gemspec
+- wait-for-it.sh
+homepage: 
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Vorx let you manage multiple git repositories
+test_files: []