mkghrepo 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 61e3ebd4a68bfd47ba4e22e662fd79cd7bc2924b
+  data.tar.gz: 28333abba470929e76d353b0f2c466535b9a65f2
+SHA512:
+  metadata.gz: ceb2dd85a69cbab50aea37804b2e9bba17505f905765dc9da980e92a5bd55968707c1f6b67db2e6c88e61ecad3378ea5ba53c8bedf46994c208db1cb6c3b17ad
+  data.tar.gz: aa9ef45714c0ba23c6d3dc49b39808f870145773116b91fe0c59588579e6fe0acf27a2e72ba78d71f726a3f5ea216561bcf8e229cd64d145191763a110e78dfe

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.test-file

data/.ruby-version

@@ -0,0 +1 @@
+2.1.4

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mkghrepo.gemspec
+gemspec

data/README.md

@@ -0,0 +1,32 @@
+# Mkghrepo
+Quick and dirty tool to mass create repositories on Github.
+
+To install: `gem install mkghrepo`
+
+Help:
+
+```
+Usage: mkghrepo [options] [<filename>]
+
+Repository options:
+    -p, --private      make the repository private
+    -t, --create-team  creates a team called "<foo>-write", default is false
+    --token            sets github token, defaults from GITHUB_TOKEN
+
+Other options:
+    -h, --help         print this help
+    -v, --version      print the version
+```
+
+`mkghrepo` accepts one repository per line as input, either stored in a file or passed through STDIN, the formats supported are:
+
+`<org>/<repo> [<user1> <user2> ... <userN>]`
+
+or
+
+`<repo>`
+
+If users are listed and the `-t` flag has been specified in the run, a team called `<repo>-write` will be created and those users added to it. The users must already be part of the organization or they will be skipped (a warning will be displayed).
+
+## Troubleshooting
+By default, debug events are not logged, to see them, set `MKGHREPO_LOG` to `DEBUG` in your shell environment.

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/bin/mkghrepo

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+require 'mkghrepo'
+
+# Instantiate new cli object.
+cli = Mkghrepo::CLI.new
+
+# Parse CLI options.
+opts = cli.parse_options
+
+# Log into Github and get a client
+client = Mkghrepo::Repo.new(opts[:token])
+
+# Main entrypoint into the actual program.
+if opts.arguments.length < 1
+  # If no file arguments, start processing standard input.
+  cli.process_stdin(client, opts)
+else
+  # If file argument is present, take the first one and parse it.
+  cli.process_file(opts.arguments[0], client, opts)
+end

data/lib/mkghrepo/cli.rb

@@ -0,0 +1,184 @@
+# encoding: UTF-8
+require 'logger'
+require 'slop'
+
+module Mkghrepo
+  # CLI Class takes care of all the plubing related to the CLI commands and
+  # option parsing, consuming other classes to operate against Github Repos.
+  #
+  # Disabling ClassLength cop due to parse_options inflating the line numbers.
+  class CLI # rubocop:disable Metrics/ClassLength
+    def setup_logging(level)
+      start = Time.now
+      @logger = Logger.new(STDOUT)
+      @logger.level = level
+      @logger.datetime_format = '%Y-%m-%d %H:%M:%S'
+      @logger.formatter = proc do |severity, _datetime, _progname, msg|
+        now = Time.now
+        "[#{severity}][#{(now - start).round}] #{msg}\n"
+      end
+    end
+
+    def initialize
+      if ENV['MKGHREPO_LOG'].nil?
+        setup_logging(Logger::INFO)
+      else
+        setup_logging(Logger.const_get(ENV['MKGHREPO_LOG'].upcase))
+      end
+    end
+
+    # Parse CLI options with 'slop', disabling the MethodLength cop for this
+    # particular method as we can't really make it shorter.
+    def parse_options # rubocop:disable Metrics/MethodLength
+      opts = Slop.parse do |o|
+        o.banner = 'Usage: mkghrepo [options] <filename>'
+        o.separator ''
+        o.separator 'Repository options:'
+        o.bool '-p',
+               '--private',
+               'make the repository private',
+               default: false
+        o.bool '-t',
+               '--create-team',
+               'creates a team called "<foo>-write", default is false',
+               default: false
+        o.string '--token',
+                 'sets github token, defaults from GITHUB_TOKEN',
+                 default: ENV['GITHUB_TOKEN']
+        o.separator ''
+        o.separator 'Other options:'
+        o.bool '-h', '--help', 'print this help'
+        o.on '-v', '--version', 'print the version' do
+          puts VERSION
+          exit
+        end
+      end
+
+      input_sanitization(opts)
+
+      opts
+    end
+
+    def input_sanitization(opts)
+      @logger.debug("Options: #{opts.to_hash} Arguments: #{opts.arguments}")
+
+      # if help is required, just print it and exit
+      if opts.help?
+        puts opts
+        exit
+      end
+
+      return unless opts[:token].nil?
+
+      # Fail if token is not available
+      @logger.fatal('Token is required')
+      puts opts
+      exit 1
+    end
+
+    def process_file(file, client, opts)
+      # We received one or more file arguments, let's open up the first one and
+      # start reading it.
+      @logger.debug("Opening #{file} for parsing...")
+      unless File.exist?(file)
+        # File not found, no point in continuing
+        @logger.fatal("File #{file} not found")
+        exit 1
+      end
+      File.open(file, 'r') do |f|
+        f.each_line do |a|
+          # Treat each line as a separate repo
+          process_lines(a, client, opts[:private], opts[:create_team])
+        end
+      end
+    end
+
+    def process_stdin(client, opts)
+      # We have no file arguments, start reading from STDIN and treat every line
+      # as a separate repo.
+      @logger.warn('No file arguments, reading from stdin...')
+      begin
+        STDIN.read.split("\n").each do |a|
+          # Treat each line as a separate repo
+          process_lines(a, client, opts[:private], opts[:create_team])
+        end
+      rescue Interrupt
+        # Trap a CTRL+C event and exit gracefully
+        @logger.warn('Exiting...')
+        exit 130
+      end
+    end
+
+    def process_lines(line, client, private, create_team)
+      # Split the line using space as delimiter, format is:
+      # <org>/<repo> <user1> <user2> ... <userN>
+      #  or
+      # <repo>
+      @logger.debug("processing #{line.strip}")
+      matches = line.split(' ')
+      repo = matches[0]
+      create_repo(client, repo, private)
+
+      # If no users are specified or create_team was not enabled
+      return if matches.length < 2 || create_team == false
+      # create team and whatever
+      if repo.include? '/'
+        process_team(client, repo, matches[1..matches.count])
+      else
+        @logger.warn("Not creating Team for #{repo}, only orgs support teams")
+      end
+    end
+
+    def process_team(client, repo, users)
+      team = create_team(client, repo)
+      users.each do |user|
+        add_user_to_team(client, user, team.id)
+      end
+    end
+
+    def parse_error(object, e)
+      case
+      when !e.errors.first[:message].nil?
+        # Print a human readable error and carry on.
+        @logger.error("Can't process #{object}: #{e.errors.first[:message]}")
+      when e.errors.length > 0
+        # Can't find a human readable error, just dump the error hash and be
+        # done with it.
+        @logger.error("Can't process #{object}: #{e.errors}")
+      else
+        # Apparently some errors are not correctly formatted so we just dump
+        # the whole ugly message to screen.
+        @logger.error("Can't process #{object}: #{e.message}")
+      end
+    end
+
+    def create_repo(client, repo, private)
+      @logger.debug("Creating repo named: #{repo}")
+      client.create_repo(repo, private)
+    rescue Octokit::Error => e
+      parse_error(repo, e)
+    else
+      @logger.info("Succesfully created repository: #{repo}")
+    end
+
+    def create_team(client, repo)
+      team_name = repo.rpartition('/').last + '-write'
+      @logger.debug("Creating team named: #{team_name}")
+      team = client.create_team(repo, team_name, 'push')
+    rescue Octokit::Error => e
+      parse_error(team_name, e)
+    else
+      @logger.info("Succesfully created team '#{team_name}' for: #{repo}")
+      team
+    end
+
+    def add_user_to_team(client, user, team_id)
+      @logger.debug("Adding user #{user} to team id: #{team_id}")
+      client.add_user_to_team(user, team_id)
+    rescue Octokit::Error => e
+      parse_error(user, e)
+    else
+      @logger.info("Succesfully added user '#{user}' on team id: #{team_id}")
+    end
+  end
+end

data/lib/mkghrepo/repo.rb

@@ -0,0 +1,42 @@
+# encoding: UTF-8
+require 'octokit'
+
+module Mkghrepo
+  # Repo provides an interface to github repos
+  class Repo
+    def initialize(token)
+      # stack = Faraday::RackBuilder.new do |builder|
+      #   builder.response :logger
+      #   builder.use Octokit::Response::RaiseError
+      #   builder.adapter Faraday.default_adapter
+      # end
+      # Octokit.middleware = stack
+      @client = Octokit::Client.new(access_token: token)
+    end
+
+    def create_repo(repo, private = false)
+      if repo.include? '/'
+        organization = repo.rpartition('/').first
+        repo = repo.rpartition('/').last
+        @client.create_repository(repo,
+                                  private: private,
+                                  organization: organization)
+      else
+        @client.create_repository(repo,
+                                  private: private)
+      end
+    end
+
+    def create_team(repo, team_name, permissions)
+      organization = repo.rpartition('/').first
+      @client.create_team(organization,
+                          name: team_name,
+                          repo_names: [repo],
+                          permission: permissions)
+    end
+
+    def add_user_to_team(user, team_id)
+      @client.add_team_member(team_id, user)
+    end
+  end
+end

data/lib/mkghrepo/version.rb

@@ -0,0 +1,5 @@
+# encoding: UTF-8
+# Set version for the Gem
+module Mkghrepo
+  VERSION = '0.0.1'
+end

data/lib/mkghrepo.rb

@@ -0,0 +1,4 @@
+# encoding: UTF-8
+require 'mkghrepo/cli'
+require 'mkghrepo/repo'
+require 'mkghrepo/version'

data/mkghrepo.gemspec

@@ -0,0 +1,28 @@
+# encoding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mkghrepo/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = 'mkghrepo'
+  spec.version     = Mkghrepo::VERSION
+  spec.executables << 'mkghrepo'
+  spec.authors     = ['Fabio Rapposelli']
+  spec.email       = ['fabio@rapposelli.org']
+  spec.description = 'mkghrepo is a tool to facilitate mass repository creation'
+  spec.summary     = 'mkghrepo is a tool to facilitate mass repository creation'
+  spec.homepage    = 'https://github.com/frapposelli/mkghrepo'
+  spec.license     = 'APL2'
+
+  spec.files         = `git ls-files`.split($RS)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'octokit', '~> 4.0'
+  spec.add_runtime_dependency 'slop', '~> 4.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rubocop'
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: mkghrepo
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Fabio Rapposelli
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: slop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+description: mkghrepo is a tool to facilitate mass repository creation
+email:
+- fabio@rapposelli.org
+executables:
+- mkghrepo
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- Gemfile
+- README.md
+- Rakefile
+- bin/mkghrepo
+- lib/mkghrepo.rb
+- lib/mkghrepo/cli.rb
+- lib/mkghrepo/repo.rb
+- lib/mkghrepo/version.rb
+- mkghrepo.gemspec
+homepage: https://github.com/frapposelli/mkghrepo
+licenses:
+- APL2
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: mkghrepo is a tool to facilitate mass repository creation
+test_files: []