Redmine

#!/usr/bin/env ruby

# == Synopsis

#

# reposman: manages your repositories with Redmine

#

# == Usage

#

#    reposman [OPTIONS...] -s [DIR] -r [HOST]

#     

#  Examples:

#    reposman --svn-dir=/var/svn --redmine-host=redmine.example.net --scm subversion

#    reposman -s /var/git -r redmine.example.net -u http://svn.example.net --scm git

#

# == Arguments (mandatory)

#

#   -s, --svn-dir=DIR         use DIR as base directory for svn repositories

#   -r, --redmine-host=HOST   assume Redmine is hosted on HOST. Examples:

#                             -r redmine.example.net

#                             -r http://redmine.example.net

#                             -r https://example.net/redmine

#   -k, --key=KEY             use KEY as the Redmine API key

#

# == Options

#

#   -o, --owner=OWNER         owner of the repository. using the rails login

#                             allow user to browse the repository within

#                             Redmine even for private project. If you want to

#                             share repositories through Redmine.pm, you need

#                             to use the apache owner.

#   -g, --group=GROUP         group of the repository. (default: root)

#   --scm=SCM                 the kind of SCM repository you want to create (and

#                             register) in Redmine (default: Subversion).

#                             reposman is able to create Git and Subversion

#                             repositories. For all other kind, you must specify

#                             a --command option

#   -u, --url=URL             the base url Redmine will use to access your

#                             repositories. This option is used to automatically

#                             register the repositories in Redmine. The project

#                             identifier will be appended to this url. Examples:

#                             -u https://example.net/svn

#                             -u file:///var/svn/

#                             if this option isn't set, reposman won't register

#                             the repositories in Redmine

#   -c, --command=COMMAND     use this command instead of "svnadmin create" to

#                             create a repository. This option can be used to

#                             create repositories other than subversion and git

#                             kind.

#                             This command override the default creation for git

#                             and subversion.

#   -f, --force               force repository creation even if the project

#                             repository is already declared in Redmine

#   -t, --test                only show what should be done

#   -h, --help                show help and exit

#   -v, --verbose             verbose

#   -V, --version             print version and exit

#   -q, --quiet               no log

#

# == References

# 

# You can find more information on the redmine's wiki : http://www.redmine.org/wiki/redmine/HowTos

require 'getoptlong'

require 'rdoc/usage'

require 'find'

require 'etc'

require 'uri'

Version = "1.3"

SUPPORTED_SCM = %w( Subversion Subversion_mirror Darcs Mercurial Bazaar Git Filesystem )

opts = GetoptLong.new(

                      ['--svn-dir',      '-s', GetoptLong::REQUIRED_ARGUMENT],

                      ['--redmine-host', '-r', GetoptLong::REQUIRED_ARGUMENT],

                      ['--key',          '-k', GetoptLong::REQUIRED_ARGUMENT],

                      ['--owner',        '-o', GetoptLong::REQUIRED_ARGUMENT],

                      ['--group',        '-g', GetoptLong::REQUIRED_ARGUMENT],

                      ['--url',          '-u', GetoptLong::REQUIRED_ARGUMENT],

                      ['--command' ,     '-c', GetoptLong::REQUIRED_ARGUMENT],

                      ['--scm',                GetoptLong::REQUIRED_ARGUMENT],

                      ['--test',         '-t', GetoptLong::NO_ARGUMENT],

                      ['--force',        '-f', GetoptLong::NO_ARGUMENT],

                      ['--verbose',      '-v', GetoptLong::NO_ARGUMENT],

                      ['--version',      '-V', GetoptLong::NO_ARGUMENT],

                      ['--help'   ,      '-h', GetoptLong::NO_ARGUMENT],

                      ['--quiet'  ,      '-q', GetoptLong::NO_ARGUMENT]

                      )

$verbose      = 0

$quiet        = false

$redmine_host = ''

$repos_base   = ''

$svn_owner    = 'root'

$svn_group    = 'root'

$use_groupid  = true

$svn_url      = false

$test         = false

$force        = false

$scm          = 'Subversion'

$identifier   = false

def log(text, options={})

  level = options[:level] || 0

  puts text unless $quiet or level > $verbose

  exit 1 if options[:exit]

end

def system_or_raise(command)

  raise "\"#{command}\" failed" unless system command

end

module SCM

  module Subversion

    def self.create(path)

      system_or_raise "svnadmin create #{path}"

    end

    def self.disregard_registration?

      false

    end

  end

  module Subversion_mirror

    def self.create(path)

      # Create the repository

      system_or_raise "svnadmin create #{path}"

      # enable pre-revprop-change

      if mswin? 

        revprop_file = File.join(path,"hooks","pre-revprop-change.bat")

      else

        revprop_file = File.join(path,"hooks","pre-revprop-change")        

      end

      File.new(revprop_file, "w+")

      File.chmod(0755, revprop_file)

      # Switch the slashes if on Windows.        

      if mswin?

        normalpath=path.gsub("\\","/")

      else

        normalpath=path

      end

      # initialize the sync

      file_url = "file://#{normalpath}"

      system_or_raise "svnsync init #{file_url} #{$svn_url}#{$identifier}"       

    end

    def self.disregard_registration?

      true

    end

    def self.validate_opts

      log("Subversion_mirror requires --url option", :exit => true) if not $svn_url

    end

  end

  module Git

    def self.create(path)

      Dir.mkdir path

      Dir.chdir(path) do

        system_or_raise "git --bare init --shared"

        system_or_raise "git update-server-info"

      end

    end

    def self.disregard_registration?

      false

    end

  end

end

begin

  opts.each do |opt, arg|

    case opt

    when '--svn-dir';        $repos_base   = arg.dup

    when '--redmine-host';   $redmine_host = arg.dup

    when '--key';            $api_key      = arg.dup

    when '--owner';          $svn_owner    = arg.dup; $use_groupid = false;

    when '--group';          $svn_group    = arg.dup; $use_groupid = false;

    when '--url';            $svn_url      = arg.dup

    when '--scm';            $scm          = arg.dup.capitalize; log("Invalid SCM: #{$scm}", :exit => true) unless SUPPORTED_SCM.include?($scm)

    when '--command';        $command =      arg.dup

    when '--verbose';        $verbose += 1

    when '--test';           $test = true

    when '--force';          $force = true

    when '--version';        puts Version; exit

    when '--help';           RDoc::usage

    when '--quiet';          $quiet = true

    end

  end

rescue

  exit 1

end

if $test

  log("running in test mode")

end

# Make sure command is overridden if SCM vendor is not handled internally (for the moment Subversion and Git)

if $command.nil?

  begin

    scm_module = SCM.const_get($scm)

  rescue

    log("Please use --command option to specify how to create a #{$scm} repository.", :exit => true)

  end

end

$svn_url += "/" if $svn_url and not $svn_url.match(/\/$/)

if ($redmine_host.empty? or $repos_base.empty?)

  RDoc::usage

end

unless File.directory?($repos_base)

  log("directory '#{$repos_base}' doesn't exist", :exit => true)

end

# Perform SCM-specific option validation

if (not scm_module.nil? and scm_module.respond_to?("validate_opts"))

  scm_module.validate_opts

end

begin

  require 'active_resource'

rescue LoadError

  log("This script requires activeresource.\nRun 'gem install activeresource' to install it.", :exit => true)

end

class Project < ActiveResource::Base; end

log("querying Redmine for projects...", :level => 1);

$redmine_host.gsub!(/^/, "http://") unless $redmine_host.match("^https?://")

$redmine_host.gsub!(/\/$/, '')

Project.site = "#{$redmine_host}/sys";

begin

  # Get all active projects that have the Repository module enabled

  projects = Project.find(:all, :params => {:key => $api_key})

rescue => e

  log("Unable to connect to #{Project.site}: #{e}", :exit => true)

end

if projects.nil?

  log('no project found, perhaps you forgot to "Enable WS for repository management"', :exit => true)

end

log("retrieved #{projects.size} projects", :level => 1)

def set_owner_and_rights(project, repos_path, &block)

  if mswin?

    yield if block_given?

  else

    uid, gid = Etc.getpwnam($svn_owner).uid, ($use_groupid ? Etc.getgrnam(project.identifier).gid : Etc.getgrnam($svn_group).gid)

    right = project.is_public ? 0775 : 0770

    yield if block_given?

    Find.find(repos_path) do |f|

      File.chmod right, f

      File.chown uid, gid, f

    end

  end

end

def other_read_right?(file)

  (File.stat(file).mode & 0007).zero? ? false : true

end

def owner_name(file)

  mswin? ?

    $svn_owner :

    Etc.getpwuid( File.stat(file).uid ).name  

end

def mswin?

  (RUBY_PLATFORM =~ /(:?mswin|mingw)/) || (RUBY_PLATFORM == 'java' && (ENV['OS'] || ENV['os']) =~ /windows/i)

end

projects.each do |project|

  log("treating project #{project.name}", :level => 1)

  if project.identifier.empty?

    log("\tno identifier for project #{project.name}")

    next

  elsif not project.identifier.match(/^[a-z0-9\-]+$/)

    log("\tinvalid identifier for project #{project.name} : #{project.identifier}");

    next;

  end

  if project.respond_to?(:repository) and not project.repository.nil?

    url_pieces = URI.split(project.repository.url)

    path_pieces = File.split(url_pieces[5])

    $identifier = path_pieces[1]

  else

    $identifier = project.identifier

  end

  repos_path = File.join($repos_base, $identifier).gsub(File::SEPARATOR, File::ALT_SEPARATOR || File::SEPARATOR)

  if File.directory?(repos_path)

    # we must verify that repository has the good owner and the good

    # rights before leaving

    other_read = other_read_right?(repos_path)

    owner      = owner_name(repos_path)

    next if project.is_public == other_read and owner == $svn_owner

    if $test

      log("\tchange mode on #{repos_path}")

      next

    end

    begin

      set_owner_and_rights(project, repos_path)

    rescue Errno::EPERM => e

      log("\tunable to change mode on #{repos_path} : #{e}\n")

      next

    end

    log("\tmode change on #{repos_path}");

  else

    # if there's an SCM module defined, check to see if it disregards 

    # registration of a project in Redmine. (if there's no scm module defined,

    # value should be false)

    disregard_registration = ((not scm_module.nil?) and scm_module.disregard_registration?)

    # if repository is already declared in redmine, we don't create

    # unless user use -f with reposman, or the SCM module specifies that 

    # the Redmine registration is disregarded.

    if (($force == false) and ((not disregard_registration) and project.respond_to?(:repository)))

      log("\trepository for project #{project.identifier} already exists in Redmine", :level => 1)

      next

    end

    project.is_public ? File.umask(0002) : File.umask(0007)

    if $test

      log("\tcreate repository #{repos_path}")

      log("\trepository #{repos_path} registered in Redmine with url #{$svn_url}#{project.identifier}") if $svn_url and not disregard_registration;

      next

    end

    begin

      set_owner_and_rights(project, repos_path) do

        if scm_module.nil?

          system_or_raise "#{$command} #{repos_path}"

        else

          scm_module.create(repos_path)

        end

      end

    rescue => e

      log("\tunable to create #{repos_path} : #{e}\n")

      next

    end

    if $svn_url and not disregard_registration

      begin

        project.post(:repository, :vendor => $scm, :repository => {:url => "#{$svn_url}#{project.identifier}"}, :key => $api_key)

        log("\trepository #{repos_path} registered in Redmine with url #{$svn_url}#{project.identifier}");

      rescue => e

        log("\trepository #{repos_path} not registered in Redmine: #{e.message}");

      end

    end

    log("\trepository #{repos_path} created");

  end

end