gemrepublica 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NjBmMzIzNmVkNzQzZTM5NmY0NjgzYmU1YmJlN2I4Mzk3YWE1ZjNlNQ==
+  data.tar.gz: !binary |-
+    NmE3OWIzZGVjMzc0NjJmNmYzMWZmNGJhZTQwZTYzMTdkOGUyM2NjNA==
+SHA512:
+  metadata.gz: !binary |-
+    MmFiM2RmZTk3MzljODI0MzBhNmMxOWEyZDliN2VlY2M1NDJlZDgwZjNmNGYw
+    NDI3MTczNTlkYWI4NmQ0M2VmM2U0ZDkwOTNjMGE5OWMyNGI3OGY2YmM0NzFl
+    Njc2Y2E0NjY0OWQ3Mjc2MmMzYzUzODJmMWNhMjY1YTg5OGUzNGE=
+  data.tar.gz: !binary |-
+    OTY0YjM0M2NlMDM3ODZkZTkwYTI4ZmJkNzRhYWMyMTlhN2NlNTI0MjNjNjk5
+    NDVjNTJkMjQ5ODA1Y2QyNzBjZjU4YjU1NjM2NjMwODIxZGJhZDNmZDFmZjEx
+    YzViZGY0M2I2YzI0Mjc0MzU4OTFkNzcwM2U2MzRiZGJkODkwNTU=

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Felix Wolfsteller
+
+MIT License
+
+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,66 @@
+# GemRepublica
+
+Ruby gems are great.  The community of developers is nice.  Contributions are welcome and efforts well-received.
+
+With gemrepublica it becomes even easier to clone the code of a given gem and start hacking.
+
+## Installation
+
+Install with:
+
+    $ gem install gemrepublica
+
+## Usage
+
+Currently, gemrepublica ships with a single executable,
+
+  gemrepublica
+
+While `gemrepublica --help` will give you a basic help, you usually want to call it like
+
+  $ gemrepublica <gem name> <location for clone>
+
+This will clone the gems source (if it can be found) to the given location.
+
+For example
+
+  $ gemrepublica gemrepublica /home/fwolfst/dollies/
+
+will create a git clone of this repository in `/home/fwolfst/dollies/gemrepublica`.  It's as easy as that!
+
+## Rationale
+
+You want to get coding in zero seconds.
+
+## Limitations
+
+* Currently, `gemrepublica` only works if the source code link is specified by the maintainer on the rubygems.org homepage and if it points to a github repository.
+
+* Currently, `gemrepublica` will only clone the HEAD of that github repository.
+
+Unfortunately, the source code link on rubygems.org has to be specified via its interface.  I proposed including it in the Gem-Specification, where I hope it will end one day - probably in the 'metadata' (see https://github.com/rubygems/rubygems/issues/1007).
+
+I also proposed to consume this metadata key on the rubygems.org homepage (see https://github.com/rubygems/rubygems.org/issues/718).
+
+## Naming
+
+We are the people and own code!  And create replica of gems easily.
+
+## Roadmap
+
+- fix TODOs indicated in code comments.
+- allow specification of version, check out that tag if existing.
+- consider switching to thor or rake.
+- play well with git repositories that are not on github.
+- allow easy branch creation.
+- play well with other VCS like svn or mercurial/hg.
+- implement --fork switch.
+
+## Contributing
+
+1. Mail me.
+2. Fork it ( https://github.com/[my-github-username]/gemrepublica/fork )
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/gemrepublica

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'gemrepublica'
+
+options = {}
+program_name = File.basename __FILE__
+
+optparse = OptionParser.new do |opts|
+  opts.banner = "Usage: #{program_name} <gem_name> <location_of_clone>"
+end
+
+optparse.parse!
+
+# Check required positional arguments.
+if ARGV.length != 2
+  STDERR.puts "Need to specify gem_name and location_of_clone."
+  STDERR.puts optparse.help
+  exit 1
+end
+
+# Acquire gem info.
+gem_info = Gems.info(ARGV[0])
+if gem_info.nil? || gem_info.empty?
+  STDERR.puts "Could not find anything about '#{ARGV[0]}' at rubygems.org."
+  exit 2
+end
+
+if gem_info['source_code_uri'].nil? || gem_info['source_code_uri'].empty?
+  STDERR.puts "'#{ARGV[0]}' does not have a source_code_uri specified.."
+  exit 3
+  # TODO Now, we could give the user pointers, to
+  # 1) the project owners name
+  # 2) the projects bug tracker to file an issue
+  # 3) the project page
+  # Also, we could check if the project page looks like a github (or other 
+  # repository) uri.
+end
+
+repo_adress = gem_info['source_code_uri']
+if !(repo_adress =~ /github/)
+  STDERR.puts "#{repo_adress} seems not to be a github repository."
+  exit 4
+end
+
+# TODO Check if license is sensible, warn otherwise.
+
+# TODO Create ARGV[1]
+git_repo = Git::clone(repo_adress, gem_info['name'], :path => ARGV[1])
+if git_repo.nil?
+  STDERR.puts "Cloning of github repository #{repo_adress} into #{ARGV[1]} failed."
+  exit 5
+end
+
+puts "Successfully cloned #{repo_adress} into #{ARGV[1]}."
+
+# Be nice, explicitely exit with success.
+exit 0

data/gemrepublica.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gemrepublica/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gemrepublica"
+  spec.version       = GemRepublica::VERSION
+  spec.authors       = ["Felix Wolfsteller"]
+  spec.email         = ["felix.wolfsteller@gmail.com"]
+  spec.summary       = %q{Shortcut to clone a gems code}
+  spec.description   = %q{GemRepublica lets you clone a gems github repository}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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_dependency 'gems', "~> 0.8"
+  spec.add_dependency 'git', "~> 1.2"
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+end

data/lib/gemrepublica.rb

@@ -0,0 +1,7 @@
+require "gemrepublica/version"
+
+require 'gems'
+require 'git'
+
+module GemRepublica
+end

data/lib/gemrepublica/version.rb

@@ -0,0 +1,3 @@
+module GemRepublica
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: gemrepublica
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Felix Wolfsteller
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gems
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !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'
+description: GemRepublica lets you clone a gems github repository
+email:
+- felix.wolfsteller@gmail.com
+executables:
+- gemrepublica
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/gemrepublica
+- gemrepublica.gemspec
+- lib/gemrepublica.rb
+- lib/gemrepublica/version.rb
+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: '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: Shortcut to clone a gems code
+test_files: []