bundle gem
<GEM_NAME> [OPTIONS]
Generates a directory named GEM_NAME
with a Rakefile
, GEM_NAME.gemspec
,
and other supporting files and directories that can be used to develop a
rubygem with that name.
Run rake -T
in the resulting project for a list of Rake tasks that can be used
to test and publish the gem to rubygems.org.
The generated project skeleton can be customized with OPTIONS, as explained below. Note that these options can also be specified via Bundler's global configuration file using the following names:
gem.coc
gem.mit
gem.test
-
--exe
or-b
or--bin
: Specify that Bundler should create a binary executable (asexe/GEM_NAME
) in the generated rubygem project. This binary will also be added to theGEM_NAME.gemspec
manifest. This behavior is disabled by default. -
--no-exe
: Do not create a binary (overrides--exe
specified in the global config). -
--coc
: Add aCODE_OF_CONDUCT.md
file to the root of the generated project. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler's global config for futurebundle gem
use. -
--no-coc
: Do not create aCODE_OF_CONDUCT.md
(overrides--coc
specified in the global config). -
--ext
: Add boilerplate for C extension code to the generated project. This behavior is disabled by default. -
--no-ext
: Do not add C extension code (overrides--ext
specified in the global config). -
--mit
: Add an MIT license to aLICENSE.txt
file in the root of the generated project. Your name from the global git config is used for the copyright statement. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler's global config for futurebundle gem
use. -
--no-mit
: Do not create aLICENSE.txt
(overrides--mit
specified in the global config). -
-t
,--test=minitest
,--test=rspec
: Specify the test framework that Bundler should use when generating the project. Acceptable values areminitest
andrspec
. TheGEM_NAME.gemspec
will be configured and a skeleton test/spec directory will be created based on this option. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler's global config for futurebundle gem
use. If no option is specified, the default testing framework is RSpec. -
-e
,--edit[=EDITOR]
: Open the resulting GEM_NAME.gemspec in EDITOR, or the default editor if not specified. The default is$BUNDLER_EDITOR
,$VISUAL
, or$EDITOR
.