Ruby Gem命令行工具

Question

I am trying to build a command line ruby gem . I am using bundler to create the gem and install the gem locally. It generated the needed directories. I also was able to test that if I require my Gem I can use methods inside of it. I am trying to get the command line piece working now and can't seem to get it working. I want to be able to do something like

gemname command

Similar to how rspec works:

rspec test/whatever.rb

Any help on how to be able to execute through the command line would be great.

Answer 1

In order to declared the executables you have to just make a proper line in your yourgem.gemspec :

`git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }

This line, along with an other useful line is generated by bundle gem yourgem command. Just execute it, and then fix the yourgem.gemspec according your needs. Put executables into bin/ folder of your gem, and all libraries, including the version, into lib/ folder.

The next step is to use the binary. When you are installing the gem into a system, the binary folder is automatically included into binary search path. So your gem is avaiable to execute from anywere. But when your gem isn't installed you are still able to simelate the case with a bundler 's exec as follows:

 bundle exec bin/your_exec

It picks the require librarires up from lib/ folder, and the executable will work properly.

To make sure that the executable will work, build the gem with gem build yourgem.gemspec , then install it with gem install yourgem.gem , and try.

Answer 2

I think the problem is that you've not commited your code yet. Check if git ls-files -- bin/* shows you the script you want to execute.

When you commit your file, then git ls-files will return it and the spec will be able to load the script.

Answer 3

Checkout these blog posts: http://robdodson.me/blog/2012/06/14/how-to-write-a-command-line-ruby-gem/ http://rubylearning.com/blog/2011/01/03/how-do-i-make-a-command-line-tool-in-ruby/

I'm not really sure what you've built so far but here are a few points of interest:

1. #!/usr/bin/env ruby for first line in the executable file (in the /bin folder).
2. chmod +x filname to make it executable
3. ARGV[0] Variables passed in are retrieved from ARGV[0]
4. s.executables << 'your_file' Add executable to gemspec

Answer 4

I figured this out at least for my specific issue. I just need to call out the bin command directly instead of that git ls loop. The top one works the bottom one doesn't for some reason.

spec.executables = ["toolshed"]

vs

spec.executables = `git ls-files -- bin/*`.split("\\n").map{ |f| File.basename(f) }