extended_string
Intention for this gem is to follow step by step how to create the very gem from the scratch. It will add one method to standard String class. I intend to put some tests, release couple of versions, and so on…
Preconfig
Install Rails
I do prefer using rvm for this task, but it can be done as it is. If you know how to use rvm, then you will not need any guidance.
gem install rails –no-ri –no-rdoc gem install jeweler
Currently I’m working on version 3.0.1
Configure Git
You need to configure some git settings, before you use jeweler to create first gem.
git config –global github.user m4risU git config –global github.token 227addfh048cgfbbda2060dc8e9233a6 (don’t worry, this is not my key, but you have to use yours) Probably you will find it in here:
github.com/account in Account Admin
Generate the gem project
jeveler enhanced_string
Good. We are here! What can we do next?
Rake tasks
As I already know, rake tasks will be the key to build the gem. so lets try
rake -T
It will give the following
rake build # Build gem rake check_dependencies # Check that runtime and development d… rake check_dependencies:development # Check that development dependencies … rake check_dependencies:runtime # Check that runtime dependencies are … rake clobber_rdoc # Remove rdoc products rake gemcutter:release # Release gem to Gemcutter rake gemspec # Generate and validates gemspec rake gemspec:debug # Display the gemspec for debugging pu… rake gemspec:generate # Generates the gemspec, using version… rake gemspec:validate # Validates the gemspec rake git:release # Tag a release in Git rake github:release # Release Gem to GitHub rake install # Install gem using sudo rake rdoc # Build the rdoc HTML Files rake release # Release gem rake rerdoc # Force a rebuild of the RDOC files rake test # Run tests rake version # Displays the current version rake version:bump:major # Bump the gemspec by a major version. rake version:bump:minor # Bump the gemspec by a minor version. rake version:bump:patch # Bump the gemspec by a patch version. rake version:write # Writes out an explicit version.
Install the gem locally
To do this we need to write the very first version.
rake version:write MAJOR=0 MINOR=1 PATCH=0
and after that
rake install
First issues
After previous line I run into following problem:
“FIXME” or “TODO” is not a description
Oh, yes! I didn’t look carefully on Rakefile file.
There was auot generated line: s.description = %qlonger description of your gem You know how to fix it I hope :)
RVM and system rubies
When using rvm, it is enough, but in other cases, it is possible you will need to use
sudo rake install
Just remember about that.
I’m ready!
You want to get the world amazed with your work? Try this!
rake release
Project do not exist yet on github?
Ok, How to start with it? I simply went to my git account and created project extended_string, then From command line after commits to local repo
git push origin master
Test my work with rvm
>rvm install ree >rvm –create ree@foo
I will not worry about this gemset, but I want to check if I can install my gem from gems.
I got after following > gem install extended_string ERROR: Could not find a valid gem ‘extended_string’ (>= 0) in any repository
References
github.com/technicalpickles/jeweler
Instalation notes
Rails 3.0
in your Gemfile
gem “extended_string”
Usage
“string”.leet will give you “57ring”
Note on Patches/Pull Requests
-
Fork the project.
-
Make your feature addition or bug fix.
-
Add tests for it. This is important so I don’t break it in a future version unintentionally.
-
Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
-
Send me a pull request. Bonus points for topic branches.
Copyright
Copyright © 2010 Mariusz Wyrozębski. See LICENSE for details.