gitosis_easy_conf 0.0.3

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rvmrc

@@ -0,0 +1 @@
+rvm use --create ruby-1.9.2-p180@gitosiseasyconf

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Gerrit Riessen
+
+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.rdoc

@@ -0,0 +1,72 @@
+= gitosis_easy_conf
+
+== Work in Progress
+
+This is still work in progress and the author makes no guarantee that it
+will ever be completed.
+
+== Description
+
+Because we're using Redmine and Gitosis and are aiming to have a workflow similar to
+github, i.e. fork, commit, push, pull-request, we need a repo for each developer for
+every project. I.e. 2 rails apps, 3 developers would mean that we have 8 repos.
+Having 8 repos, each with their own permissions and naming gets confusing using a gitosis
+config, hence this gem.
+
+Scenario:
+
+Four developers and 3 rails applications. Two developers (dev1 & dev2) are owners can can
+push commits to the master repositories, the other two developers can't deploy and commit
+to the master repositories. There are also two servers to which all the applications can
+be deployed to.
+
+The following config.rb is an example:
+
+        Gitosis.config do
+          fork_naming_convention do |repo, forker|
+            "#{forker}_#{repo}"
+          end
+          filename "gitosis.readme.conf"
+        end
+
+        Gitosis.forkers do
+          developer1 'dev.one'
+          developer2 'dev.two'
+          developer3 'dev.three'
+          developer4 'dev.four'
+        end
+
+        Gitosis.groups do
+          admins         Forker[:developer1], Forker[:developer2]
+          developers     Forker[:developer3], Forker[:developer4]
+          deployers      'app1.deploy', 'app2.deploy'
+          all_developers :admins, :developers
+        end
+
+        Gitosis.repositories do
+          with_base_configuration( :writable => :admins,
+                                   :readable => [:all_developers, :deployers],
+                                   :forks    => :all ) do
+            rails_app_one
+            rails_app_two
+            rails_app_three
+          end
+        end
+
+The result of this configuration can be found in the examples directory.
+
+== Contributing to gitosis_easy_conf
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Gerrit Riessen. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,62 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "gitosis_easy_conf"
+  gem.homepage = "https://github.com/gorenje/gitosis_easy_conf"
+  gem.license = "MIT"
+  gem.summary = %Q{Make writing a gitosis configuration easier}
+  gem.description = %Q{Easy gitosis configuration}
+  gem.email = "gerrit.riessen@gmail.com"
+  gem.authors = ["Gerrit Riessen"]
+
+  gem.add_development_dependency "shoulda", ">= 0"
+  gem.add_development_dependency "rake", ">= 0"
+  gem.add_development_dependency "jeweler", ">= 0"
+  gem.add_development_dependency "inifile", ">= 0"
+  gem.add_development_dependency "rdoc", ">= 0"
+  gem.add_development_dependency "rcov", ">= 0"
+  gem.add_development_dependency "rr", ">= 0"
+
+  gem.add_runtime_dependency "inifile", ">= 0"
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+  test.rcov_opts << '--exclude "gems/*"'
+end
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "gitosis_easy_conf #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.3

data/examples/Rakefile

@@ -0,0 +1,179 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'inifile'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'gitosis_easy_conf'
+
+namespace :gitosis_easy_conf do
+  namespace :examples do
+
+    desc <<-EOF
+      Concise example.
+    EOF
+    task :concise do
+      Gitosis.setup("gitosis.concise.conf") do
+        config do
+          fork_naming_convention do |repo,forker|
+            "#{repo}_been_forked_by_#{forker}"
+          end
+        end
+
+        forkers do
+          dev1 "dev.one"
+          dev2 "dev.two"
+        end
+
+        repositories do
+          test_one :writable => Forker[:dev1], :forks => :dev2, :readable => Forker[:dev2]
+        end
+      end
+    end
+
+    desc <<-EOF
+      From the readme.
+
+      Four developers, three rails application and two servers to which the applications
+      are deployed. Developers One and Two are committers and can push to master repositories,
+      developers Three and Four each have their own forks of all three rails application.
+    EOF
+    task :readme do
+      Gitosis.config do
+        fork_naming_convention do |repo, forker|
+          "#{forker}_#{repo}"
+        end
+        filename "gitosis.readme.conf"
+      end
+
+      Gitosis.forkers do
+        developer1 'dev.one'
+        developer2 'dev.two'
+        developer3 'dev.three'
+        developer4 'dev.four'
+      end
+
+      Gitosis.groups do
+        admins         Forker[:developer1], Forker[:developer2]
+        developers     Forker[:developer3], Forker[:developer4]
+        deployers      'app1.deploy', 'app2.deploy'
+        all_developers :admins, :developers
+      end
+
+      Gitosis.repositories do
+        with_base_configuration( :writable => :admins,
+                                 :readable => [:all_developers, :deployers],
+                                 :forks    => :all ) do
+          rails_app_one
+          rails_app_two
+          rails_app_three
+        end
+      end
+    end
+
+    desc <<-EOF
+      Complex example.
+
+      Following setup:
+       - 3 application repos: blog_app, www_app, api_app
+       - 1 repo for common db configuration: db_config
+       - 1 repo with common gem used across all rails apps: common_gem
+       - 2 admin repos: chef, gitosis-admin
+
+      Team consists of a cto, lead developer, 4 developers and one unix admin. What we
+      want is that each developer has a fork of the rails applications on which they
+      are working but only the cto and lead developer can commit to the master repositories
+      of the rails applicatoins. The cto does not have a fork repo but the leader developer
+      as a fork of all three rails applications.
+
+      The four developers can fork and access the common_gem and can commit to the master
+      repositoty of the common_gem.
+
+      Only the cto and lead developer can commit to the db_config repo. Also only the deployers
+      can read the db_config repo (the deployers are the deploy users on the servers and
+      not physical people). The developers can't read nor write to db_config. (db_config
+      contains the production configuration for databases and API keys.)
+
+      The unix admin, cto and lead developer can commit to the chef and gitosis-admin repos.
+      The developers can read them but don't have a fork of either.
+
+      We'll end up with the following 17 repositories:
+               blog_app
+               dev_fours_fork_of_blog_app
+               dev_threes_fork_of_blog_app
+               dev_lead_devs_fork_of_blog_app
+               www_app
+               dev_fours_fork_of_www_app
+               dev_twos_fork_of_www_app
+               dev_lead_devs_fork_of_www_app
+               api_app
+               dev_ones_fork_of_api_app
+               dev_threes_fork_of_api_app
+               dev_twos_fork_of_api_app
+               dev_lead_devs_fork_of_api_app
+               common_gem
+               chef
+               gitosis-admin
+               db_config
+    EOF
+    task :complex do
+      Gitosis.config do
+        filename "gitosis.complex.conf"
+        fork_naming_convention do |repo, forker|
+          "#{forker}s_fork_of_#{repo}"
+        end
+      end
+
+      Gitosis.forkers do
+        dev_cto      'dev_cto.key'
+        dev_lead_dev 'dev_lead_dev.key'
+
+        dev_one   'dev_one.key'
+        dev_two   'dev_two.key'
+        dev_three 'dev_three.key'
+        dev_four  'dev_four.key'
+      end
+
+      Gitosis.roles do
+        committers Forker[:dev_cto], Forker[:dev_lead_dev]
+        admins 'unix.admin', :committers
+
+        blog_developers Forker[:dev_four], Forker[:dev_three]
+        www_developers Forker[:dev_four], Forker[:dev_two]
+        api_developers Forker[:dev_one], Forker[:dev_three], Forker[:dev_two]
+
+        all_developers :blog_developers, :committers, :www_developers, :api_developers
+        deployers 'app1.deploy', 'app2.deploy', 'app3.deploy'
+      end
+
+      Gitosis.repositories do
+        # rails applications (blog, www and api) and common gem.
+        with_base_configuration(:writable => :committers,
+                                :readable => [:all_developers, :deployers]) do
+          blog_app :forks => [:dev_four, :dev_three, :dev_lead_dev]
+          www_app :forks => [:dev_four, :dev_two, :dev_lead_dev]
+          api_app :forks => [:dev_one, :dev_three, :dev_two, :dev_lead_dev]
+          common_gem :writable => :all_developers
+        end
+
+        # chef and gitosis-admin. Note there are no forks these repos, only master.
+        with_base_configuration(:writable => :admins,
+                                :readable => :all_developers) do
+          chef
+          gitosis_admin :name => 'gitosis-admin'
+        end
+
+        # production database configuration
+        db_config :writable => :committers, :readable => :deployers
+      end
+    end
+  end
+end

data/examples/gitosis.complex.conf

@@ -0,0 +1,138 @@
+[gitosis]
+
+[group blog_app.writable]
+members = dev_cto.key dev_lead_dev.key
+writable = blog_app
+
+[group blog_app.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = blog_app
+
+[group fork.blog_app.dev_four.writable]
+members = dev_four.key
+writable = dev_fours_fork_of_blog_app
+
+[group fork.blog_app.dev_four.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_fours_fork_of_blog_app
+
+[group fork.blog_app.dev_three.writable]
+members = dev_three.key
+writable = dev_threes_fork_of_blog_app
+
+[group fork.blog_app.dev_three.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_threes_fork_of_blog_app
+
+[group fork.blog_app.dev_lead_dev.writable]
+members = dev_lead_dev.key
+writable = dev_lead_devs_fork_of_blog_app
+
+[group fork.blog_app.dev_lead_dev.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_lead_devs_fork_of_blog_app
+
+[group www_app.writable]
+members = dev_cto.key dev_lead_dev.key
+writable = www_app
+
+[group www_app.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = www_app
+
+[group fork.www_app.dev_four.writable]
+members = dev_four.key
+writable = dev_fours_fork_of_www_app
+
+[group fork.www_app.dev_four.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_fours_fork_of_www_app
+
+[group fork.www_app.dev_two.writable]
+members = dev_two.key
+writable = dev_twos_fork_of_www_app
+
+[group fork.www_app.dev_two.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_twos_fork_of_www_app
+
+[group fork.www_app.dev_lead_dev.writable]
+members = dev_lead_dev.key
+writable = dev_lead_devs_fork_of_www_app
+
+[group fork.www_app.dev_lead_dev.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_lead_devs_fork_of_www_app
+
+[group api_app.writable]
+members = dev_cto.key dev_lead_dev.key
+writable = api_app
+
+[group api_app.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = api_app
+
+[group fork.api_app.dev_one.writable]
+members = dev_one.key
+writable = dev_ones_fork_of_api_app
+
+[group fork.api_app.dev_one.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_ones_fork_of_api_app
+
+[group fork.api_app.dev_three.writable]
+members = dev_three.key
+writable = dev_threes_fork_of_api_app
+
+[group fork.api_app.dev_three.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_threes_fork_of_api_app
+
+[group fork.api_app.dev_two.writable]
+members = dev_two.key
+writable = dev_twos_fork_of_api_app
+
+[group fork.api_app.dev_two.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_twos_fork_of_api_app
+
+[group fork.api_app.dev_lead_dev.writable]
+members = dev_lead_dev.key
+writable = dev_lead_devs_fork_of_api_app
+
+[group fork.api_app.dev_lead_dev.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = dev_lead_devs_fork_of_api_app
+
+[group common_gem.writable]
+members = dev_cto.key dev_lead_dev.key dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key
+writable = common_gem
+
+[group common_gem.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key app1.deploy app2.deploy app3.deploy
+readonly = common_gem
+
+[group chef.writable]
+members = unix.admin dev_cto.key dev_lead_dev.key
+writable = chef
+
+[group chef.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key
+readonly = chef
+
+[group gitosis-admin.writable]
+members = unix.admin dev_cto.key dev_lead_dev.key
+writable = gitosis-admin
+
+[group gitosis-admin.readonly]
+members = dev_four.key dev_three.key dev_cto.key dev_lead_dev.key dev_two.key dev_one.key
+readonly = gitosis-admin
+
+[group db_config.writable]
+members = dev_cto.key dev_lead_dev.key
+writable = db_config
+
+[group db_config.readonly]
+members = app1.deploy app2.deploy app3.deploy
+readonly = db_config
+

data/examples/gitosis.concise.conf

@@ -0,0 +1,18 @@
+[gitosis]
+
+[group test_one.writable]
+members = dev.one
+writable = test_one
+
+[group test_one.readonly]
+members = dev.two
+readonly = test_one
+
+[group fork.test_one.dev2.writable]
+members = dev.two
+writable = test_one_been_forked_by_dev2
+
+[group fork.test_one.dev2.readonly]
+members = dev.two
+readonly = test_one_been_forked_by_dev2
+

data/examples/gitosis.readme.conf

@@ -0,0 +1,122 @@
+[gitosis]
+
+[group rails_app_one.writable]
+members = dev.one dev.two
+writable = rails_app_one
+
+[group rails_app_one.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = rails_app_one
+
+[group fork.rails_app_one.developer1.writable]
+members = dev.one
+writable = developer1_rails_app_one
+
+[group fork.rails_app_one.developer1.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer1_rails_app_one
+
+[group fork.rails_app_one.developer2.writable]
+members = dev.two
+writable = developer2_rails_app_one
+
+[group fork.rails_app_one.developer2.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer2_rails_app_one
+
+[group fork.rails_app_one.developer3.writable]
+members = dev.three
+writable = developer3_rails_app_one
+
+[group fork.rails_app_one.developer3.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer3_rails_app_one
+
+[group fork.rails_app_one.developer4.writable]
+members = dev.four
+writable = developer4_rails_app_one
+
+[group fork.rails_app_one.developer4.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer4_rails_app_one
+
+[group rails_app_two.writable]
+members = dev.one dev.two
+writable = rails_app_two
+
+[group rails_app_two.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = rails_app_two
+
+[group fork.rails_app_two.developer1.writable]
+members = dev.one
+writable = developer1_rails_app_two
+
+[group fork.rails_app_two.developer1.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer1_rails_app_two
+
+[group fork.rails_app_two.developer2.writable]
+members = dev.two
+writable = developer2_rails_app_two
+
+[group fork.rails_app_two.developer2.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer2_rails_app_two
+
+[group fork.rails_app_two.developer3.writable]
+members = dev.three
+writable = developer3_rails_app_two
+
+[group fork.rails_app_two.developer3.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer3_rails_app_two
+
+[group fork.rails_app_two.developer4.writable]
+members = dev.four
+writable = developer4_rails_app_two
+
+[group fork.rails_app_two.developer4.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer4_rails_app_two
+
+[group rails_app_three.writable]
+members = dev.one dev.two
+writable = rails_app_three
+
+[group rails_app_three.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = rails_app_three
+
+[group fork.rails_app_three.developer1.writable]
+members = dev.one
+writable = developer1_rails_app_three
+
+[group fork.rails_app_three.developer1.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer1_rails_app_three
+
+[group fork.rails_app_three.developer2.writable]
+members = dev.two
+writable = developer2_rails_app_three
+
+[group fork.rails_app_three.developer2.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer2_rails_app_three
+
+[group fork.rails_app_three.developer3.writable]
+members = dev.three
+writable = developer3_rails_app_three
+
+[group fork.rails_app_three.developer3.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer3_rails_app_three
+
+[group fork.rails_app_three.developer4.writable]
+members = dev.four
+writable = developer4_rails_app_three
+
+[group fork.rails_app_three.developer4.readonly]
+members = dev.one dev.two dev.three dev.four app1.deploy app2.deploy
+readonly = developer4_rails_app_three
+