2018-11-02 19:07:56 -04:00
|
|
|
BUNDLE-GEM(1) BUNDLE-GEM(1)
|
|
|
|
|
|
|
|
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
NAME
|
|
|
|
bundle-gem - Generate a project skeleton for creating a rubygem
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
SYNOPSIS
|
|
|
|
bundle gem GEM_NAME OPTIONS
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
DESCRIPTION
|
|
|
|
Generates a directory named GEM_NAME with a Rakefile, GEM_NAME.gemspec,
|
2018-11-02 19:07:56 -04:00
|
|
|
and other supporting files and directories that can be used to develop
|
|
|
|
a rubygem with that name.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
Run rake -T in the resulting project for a list of Rake tasks that can
|
2018-11-02 19:07:56 -04:00
|
|
|
be used to test and publish the gem to rubygems.org.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
The generated project skeleton can be customized with OPTIONS, as
|
|
|
|
explained below. Note that these options can also be specified via
|
2018-11-02 19:07:56 -04:00
|
|
|
Bundler's global configuration file using the following names:
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
o gem.coc
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
o gem.mit
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
o gem.test
|
2018-11-02 19:07:56 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
OPTIONS
|
|
|
|
--exe or -b or --bin
|
2018-11-02 19:07:56 -04:00
|
|
|
Specify that Bundler should create a binary executable (as
|
2019-04-14 02:01:35 -04:00
|
|
|
exe/GEM_NAME) in the generated rubygem project. This binary will
|
|
|
|
also be added to the GEM_NAME.gemspec manifest. This behavior is
|
2018-11-02 19:07:56 -04:00
|
|
|
disabled by default.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--no-exe
|
|
|
|
Do not create a binary (overrides --exe specified in the global
|
2018-11-02 19:07:56 -04:00
|
|
|
config).
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--coc Add a CODE_OF_CONDUCT.md file to the root of the generated
|
2018-11-02 19:07:56 -04:00
|
|
|
project. If this option is unspecified, an interactive prompt
|
|
|
|
will be displayed and the answer will be saved in Bundler's
|
2019-04-14 02:01:35 -04:00
|
|
|
global config for future bundle gem use.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--no-coc
|
|
|
|
Do not create a CODE_OF_CONDUCT.md (overrides --coc specified in
|
2018-11-02 19:07:56 -04:00
|
|
|
the global config).
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--ext Add boilerplate for C extension code to the generated project.
|
2018-11-02 19:07:56 -04:00
|
|
|
This behavior is disabled by default.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--no-ext
|
|
|
|
Do not add C extension code (overrides --ext specified in the
|
2018-11-02 19:07:56 -04:00
|
|
|
global config).
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--mit Add an MIT license to a LICENSE.txt file in the root of the gen-
|
2018-11-02 19:07:56 -04:00
|
|
|
erated project. Your name from the global git config is used for
|
2019-04-14 02:01:35 -04:00
|
|
|
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 future bundle gem use.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--no-mit
|
|
|
|
Do not create a LICENSE.txt (overrides --mit specified in the
|
2018-11-02 19:07:56 -04:00
|
|
|
global config).
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
-t, --test=minitest, --test=rspec
|
2018-11-02 19:07:56 -04:00
|
|
|
Specify the test framework that Bundler should use when generat-
|
2019-04-14 02:01:35 -04:00
|
|
|
ing the project. Acceptable values are minitest and rspec. The
|
|
|
|
GEM_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 future bun-
|
|
|
|
dle gem use. If no option is specified, the default testing
|
|
|
|
framework is RSpec.
|
|
|
|
|
|
|
|
-e, --edit[=EDITOR]
|
2018-11-02 19:07:56 -04:00
|
|
|
Open the resulting GEM_NAME.gemspec in EDITOR, or the default
|
2019-09-18 02:28:08 -04:00
|
|
|
editor if not specified. The default is $BUNDLER_EDITOR,
|
|
|
|
$VISUAL, or $EDITOR.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
SEE ALSO
|
|
|
|
o bundle config(1) bundle-config.1.html
|
2018-11-02 19:07:56 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2019-09-18 02:28:08 -04:00
|
|
|
September 2019 BUNDLE-GEM(1)
|