Chris@0: #!/usr/bin/env ruby
Chris@0: 
Chris@0: # == Synopsis
Chris@0: #
Chris@0: # reposman: manages your repositories with Redmine
Chris@0: #
Chris@0: # == Usage
Chris@0: #
Chris@0: #    reposman [OPTIONS...] -s [DIR] -r [HOST]
Chris@0: #     
Chris@0: #  Examples:
Chris@0: #    reposman --svn-dir=/var/svn --redmine-host=redmine.example.net --scm subversion
Chris@0: #    reposman -s /var/git -r redmine.example.net -u http://svn.example.net --scm git
Chris@0: #
Chris@0: # == Arguments (mandatory)
Chris@0: #
Chris@0: #   -s, --svn-dir=DIR         use DIR as base directory for svn repositories
Chris@0: #   -r, --redmine-host=HOST   assume Redmine is hosted on HOST. Examples:
Chris@0: #                             -r redmine.example.net
Chris@0: #                             -r http://redmine.example.net
Chris@0: #                             -r https://example.net/redmine
Chris@0: #   -k, --key=KEY             use KEY as the Redmine API key
Chris@0: #
Chris@0: # == Options
Chris@0: #
Chris@0: #   -o, --owner=OWNER         owner of the repository. using the rails login
Chris@0: #                             allow user to browse the repository within
Chris@0: #                             Redmine even for private project. If you want to
Chris@0: #                             share repositories through Redmine.pm, you need
Chris@0: #                             to use the apache owner.
Chris@0: #   -g, --group=GROUP         group of the repository. (default: root)
Chris@0: #   --scm=SCM                 the kind of SCM repository you want to create (and
Chris@0: #                             register) in Redmine (default: Subversion).
Chris@0: #                             reposman is able to create Git and Subversion
Chris@0: #                             repositories. For all other kind, you must specify
Chris@0: #                             a --command option
Chris@0: #   -u, --url=URL             the base url Redmine will use to access your
Chris@0: #                             repositories. This option is used to automatically
Chris@0: #                             register the repositories in Redmine. The project
Chris@0: #                             identifier will be appended to this url. Examples:
Chris@0: #                             -u https://example.net/svn
Chris@0: #                             -u file:///var/svn/
Chris@0: #                             if this option isn't set, reposman won't register
Chris@0: #                             the repositories in Redmine
Chris@0: #   -c, --command=COMMAND     use this command instead of "svnadmin create" to
Chris@0: #                             create a repository. This option can be used to
Chris@0: #                             create repositories other than subversion and git
Chris@0: #                             kind.
Chris@0: #                             This command override the default creation for git
Chris@0: #                             and subversion.
Chris@13: #   --http-user=USER          User for HTTP Basic authentication with Redmine WS
Chris@13: #   --http-pass=PASSWORD      Password for Basic authentication with Redmine WS
Chris@0: #   -f, --force               force repository creation even if the project
Chris@0: #                             repository is already declared in Redmine
Chris@0: #   -t, --test                only show what should be done
Chris@0: #   -h, --help                show help and exit
Chris@0: #   -v, --verbose             verbose
Chris@0: #   -V, --version             print version and exit
Chris@0: #   -q, --quiet               no log
Chris@0: #
Chris@0: # == References
Chris@0: # 
Chris@0: # You can find more information on the redmine's wiki : http://www.redmine.org/wiki/redmine/HowTos
Chris@0: 
Chris@0: 
Chris@0: require 'getoptlong'
Chris@0: require 'rdoc/usage'
Chris@0: require 'find'
Chris@0: require 'etc'
Chris@0: 
Chris@0: Version = "1.3"
Chris@0: SUPPORTED_SCM = %w( Subversion Darcs Mercurial Bazaar Git Filesystem )
Chris@0: 
Chris@0: opts = GetoptLong.new(
Chris@0:                       ['--svn-dir',      '-s', GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--redmine-host', '-r', GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--key',          '-k', GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--owner',        '-o', GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--group',        '-g', GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--url',          '-u', GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--command' ,     '-c', GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--scm',                GetoptLong::REQUIRED_ARGUMENT],
Chris@13:                       ['--http-user',          GetoptLong::REQUIRED_ARGUMENT],
Chris@13:                       ['--http-pass',          GetoptLong::REQUIRED_ARGUMENT],
Chris@0:                       ['--test',         '-t', GetoptLong::NO_ARGUMENT],
Chris@0:                       ['--force',        '-f', GetoptLong::NO_ARGUMENT],
Chris@0:                       ['--verbose',      '-v', GetoptLong::NO_ARGUMENT],
Chris@0:                       ['--version',      '-V', GetoptLong::NO_ARGUMENT],
Chris@0:                       ['--help'   ,      '-h', GetoptLong::NO_ARGUMENT],
Chris@0:                       ['--quiet'  ,      '-q', GetoptLong::NO_ARGUMENT]
Chris@0:                       )
Chris@0: 
Chris@0: $verbose      = 0
Chris@0: $quiet        = false
Chris@0: $redmine_host = ''
Chris@0: $repos_base   = ''
Chris@13: $http_user    = ''
Chris@13: $http_pass    = ''
Chris@0: $svn_owner    = 'root'
Chris@0: $svn_group    = 'root'
Chris@0: $use_groupid  = true
Chris@0: $svn_url      = false
Chris@0: $test         = false
Chris@0: $force        = false
Chris@0: $scm          = 'Subversion'
Chris@0: 
Chris@0: def log(text, options={})
Chris@0:   level = options[:level] || 0
Chris@0:   puts text unless $quiet or level > $verbose
Chris@0:   exit 1 if options[:exit]
Chris@0: end
Chris@0: 
Chris@0: def system_or_raise(command)
Chris@0:   raise "\"#{command}\" failed" unless system command
Chris@0: end
Chris@0: 
Chris@0: module SCM
Chris@0: 
Chris@0:   module Subversion
Chris@0:     def self.create(path)
Chris@0:       system_or_raise "svnadmin create #{path}"
Chris@0:     end
Chris@0:   end
Chris@0: 
Chris@0:   module Git
Chris@0:     def self.create(path)
Chris@0:       Dir.mkdir path
Chris@0:       Dir.chdir(path) do
Chris@0:         system_or_raise "git --bare init --shared"
Chris@0:         system_or_raise "git update-server-info"
Chris@0:       end
Chris@0:     end
Chris@0:   end
Chris@0: 
Chris@0: end
Chris@0: 
Chris@0: begin
Chris@0:   opts.each do |opt, arg|
Chris@0:     case opt
Chris@0:     when '--svn-dir';        $repos_base   = arg.dup
Chris@0:     when '--redmine-host';   $redmine_host = arg.dup
Chris@0:     when '--key';            $api_key      = arg.dup
Chris@0:     when '--owner';          $svn_owner    = arg.dup; $use_groupid = false;
Chris@0:     when '--group';          $svn_group    = arg.dup; $use_groupid = false;
Chris@0:     when '--url';            $svn_url      = arg.dup
Chris@0:     when '--scm';            $scm          = arg.dup.capitalize; log("Invalid SCM: #{$scm}", :exit => true) unless SUPPORTED_SCM.include?($scm)
Chris@13:     when '--http-user';      $http_user    = arg.dup
Chris@13:     when '--http-pass';      $http_pass    = arg.dup
Chris@0:     when '--command';        $command =      arg.dup
Chris@0:     when '--verbose';        $verbose += 1
Chris@0:     when '--test';           $test = true
Chris@0:     when '--force';          $force = true
Chris@0:     when '--version';        puts Version; exit
Chris@0:     when '--help';           RDoc::usage
Chris@0:     when '--quiet';          $quiet = true
Chris@0:     end
Chris@0:   end
Chris@0: rescue
Chris@0:   exit 1
Chris@0: end
Chris@0: 
Chris@0: if $test
Chris@0:   log("running in test mode")
Chris@0: end
Chris@0: 
Chris@0: # Make sure command is overridden if SCM vendor is not handled internally (for the moment Subversion and Git)
Chris@0: if $command.nil?
Chris@0:   begin
Chris@0:     scm_module = SCM.const_get($scm)
Chris@0:   rescue
Chris@0:     log("Please use --command option to specify how to create a #{$scm} repository.", :exit => true)
Chris@0:   end
Chris@0: end
Chris@0: 
Chris@0: $svn_url += "/" if $svn_url and not $svn_url.match(/\/$/)
Chris@0: 
Chris@0: if ($redmine_host.empty? or $repos_base.empty?)
Chris@0:   RDoc::usage
Chris@0: end
Chris@0: 
Chris@0: unless File.directory?($repos_base)
Chris@0:   log("directory '#{$repos_base}' doesn't exists", :exit => true)
Chris@0: end
Chris@0: 
Chris@0: begin
Chris@0:   require 'active_resource'
Chris@0: rescue LoadError
Chris@0:   log("This script requires activeresource.\nRun 'gem install activeresource' to install it.", :exit => true)
Chris@0: end
Chris@0: 
chris@37: class Project < ActiveResource::Base
chris@37:   self.headers["User-agent"] = "Redmine repository manager/#{Version}"
chris@37: end
Chris@0: 
Chris@0: log("querying Redmine for projects...", :level => 1);
Chris@0: 
Chris@0: $redmine_host.gsub!(/^/, "http://") unless $redmine_host.match("^https?://")
Chris@0: $redmine_host.gsub!(/\/$/, '')
Chris@0: 
Chris@0: Project.site = "#{$redmine_host}/sys";
Chris@13: Project.user = $http_user;
Chris@13: Project.password = $http_pass;
Chris@0: 
Chris@0: begin
Chris@0:   # Get all active projects that have the Repository module enabled
Chris@0:   projects = Project.find(:all, :params => {:key => $api_key})
Chris@0: rescue => e
Chris@0:   log("Unable to connect to #{Project.site}: #{e}", :exit => true)
Chris@0: end
Chris@0: 
Chris@0: if projects.nil?
Chris@0:   log('no project found, perhaps you forgot to "Enable WS for repository management"', :exit => true)
Chris@0: end
Chris@0: 
Chris@0: log("retrieved #{projects.size} projects", :level => 1)
Chris@0: 
Chris@0: def set_owner_and_rights(project, repos_path, &block)
Chris@0:   if RUBY_PLATFORM =~ /mswin/
Chris@0:     yield if block_given?
Chris@0:   else
Chris@0:     uid, gid = Etc.getpwnam($svn_owner).uid, ($use_groupid ? Etc.getgrnam(project.identifier).gid : Etc.getgrnam($svn_group).gid)
Chris@0:     right = project.is_public ? 0775 : 0770
Chris@0:     yield if block_given?
Chris@0:     Find.find(repos_path) do |f|
Chris@0:       File.chmod right, f
Chris@0:       File.chown uid, gid, f
Chris@0:     end
Chris@0:   end
Chris@0: end
Chris@0: 
Chris@0: def other_read_right?(file)
Chris@0:   (File.stat(file).mode & 0007).zero? ? false : true
Chris@0: end
Chris@0: 
Chris@0: def owner_name(file)
Chris@0:   mswin? ?
Chris@0:     $svn_owner :
Chris@0:     Etc.getpwuid( File.stat(file).uid ).name  
Chris@0: end
Chris@0:   
Chris@0: def mswin?
Chris@0:   (RUBY_PLATFORM =~ /(:?mswin|mingw)/) || (RUBY_PLATFORM == 'java' && (ENV['OS'] || ENV['os']) =~ /windows/i)
Chris@0: end
Chris@0: 
Chris@0: projects.each do |project|
Chris@0:   log("treating project #{project.name}", :level => 1)
Chris@0: 
Chris@0:   if project.identifier.empty?
Chris@0:     log("\tno identifier for project #{project.name}")
Chris@0:     next
Chris@0:   elsif not project.identifier.match(/^[a-z0-9\-]+$/)
Chris@0:     log("\tinvalid identifier for project #{project.name} : #{project.identifier}");
Chris@0:     next;
Chris@0:   end
Chris@0: 
Chris@0:   repos_path = File.join($repos_base, project.identifier).gsub(File::SEPARATOR, File::ALT_SEPARATOR || File::SEPARATOR)
Chris@0: 
Chris@0:   if File.directory?(repos_path)
Chris@0: 
Chris@0:     # we must verify that repository has the good owner and the good
Chris@0:     # rights before leaving
Chris@0:     other_read = other_read_right?(repos_path)
Chris@0:     owner      = owner_name(repos_path)
Chris@0:     next if project.is_public == other_read and owner == $svn_owner
Chris@0: 
Chris@0:     if $test
Chris@0:       log("\tchange mode on #{repos_path}")
Chris@0:       next
Chris@0:     end
Chris@0: 
Chris@0:     begin
Chris@0:       set_owner_and_rights(project, repos_path)
Chris@0:     rescue Errno::EPERM => e
Chris@0:       log("\tunable to change mode on #{repos_path} : #{e}\n")
Chris@0:       next
Chris@0:     end
Chris@0: 
Chris@0:     log("\tmode change on #{repos_path}");
Chris@0: 
Chris@0:   else
Chris@0:     # if repository is already declared in redmine, we don't create
Chris@0:     # unless user use -f with reposman
Chris@0:     if $force == false and project.respond_to?(:repository)
Chris@0:       log("\trepository for project #{project.identifier} already exists in Redmine", :level => 1)
Chris@0:       next
Chris@0:     end
Chris@0: 
Chris@0:     project.is_public ? File.umask(0002) : File.umask(0007)
Chris@0: 
Chris@0:     if $test
Chris@0:       log("\tcreate repository #{repos_path}")
Chris@0:       log("\trepository #{repos_path} registered in Redmine with url #{$svn_url}#{project.identifier}") if $svn_url;
Chris@0:       next
Chris@0:     end
Chris@0: 
Chris@0:     begin
Chris@0:       set_owner_and_rights(project, repos_path) do
Chris@0:         if scm_module.nil?
Chris@0:           system_or_raise "#{$command} #{repos_path}"
Chris@0:         else
Chris@0:           scm_module.create(repos_path)
Chris@0:         end
Chris@0:       end
Chris@0:     rescue => e
Chris@0:       log("\tunable to create #{repos_path} : #{e}\n")
Chris@0:       next
Chris@0:     end
Chris@0: 
Chris@0:     if $svn_url
Chris@0:       begin
Chris@0:         project.post(:repository, :vendor => $scm, :repository => {:url => "#{$svn_url}#{project.identifier}"}, :key => $api_key)
Chris@0:         log("\trepository #{repos_path} registered in Redmine with url #{$svn_url}#{project.identifier}");
Chris@0:       rescue => e
Chris@0:         log("\trepository #{repos_path} not registered in Redmine: #{e.message}");
Chris@0:       end
Chris@0:     end
Chris@0: 
Chris@0:     log("\trepository #{repos_path} created");
Chris@0:   end
Chris@0: 
Chris@0: end
Chris@13: