gem_with_extension_example
gem_with_extension_example is a functioning Ruby Gem that uses C to speed
up the inner workings. Please let me know if you find a way to make this better.
Cheers,
Sean Vikoren
Clues to making a Ruby Gem:
- You will need an account on github.com.
- You will also need an account on rubygems.org.
-
To generate your rubygems.org key:
curl -u rubygems_username https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials
-
Get your files all in the right spot:
gem install "gem_with_extension_example"
Rename to your gem name. -
cd new_gem_name
-
git init
-
git commit -a -m "first commit"
-
git remote add origin git@github.com:yourgithubid/your_gem_name.git
-
git push -u origin master
At this point make some changes to the gem and test that it works. Don't forget to update the version!
Local update after changing .gemspec
bundle update
Get it up to github.com
git rm <any removed files>
git commit -a -m "updated version"
git push
Get it up to RubyGems.org
gem build your_gem_name.gemspec
gem push your_gem_name-1.0.0.gem
Misc Additional Clues
Build Gem
gem build geocoder-simplified.gemspec
Install Gem
gem install gem_with_extension_example-0.0.0.gem
Verify Installation
gem list | grep gem_with_extension_example
Locate Installation Directory
gem env
Local publish
gem 'my_gem', :git => 'http://myserver.com/git/my_gem'
###There were many sources used to get this working, but here are a few:
### README.md format
The '.md' stands for markdown, or in this case, github-flavored-markdown.