Na}{

File Content: `bundle-gem.1.ronn`

bundle-gem(1) -- Generate a project skeleton for creating a rubygem
====================================================================

## SYNOPSIS

`bundle gem` <GEM_NAME> [OPTIONS]

## DESCRIPTION

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`

## OPTIONS

* `--exe` or `-b` or `--bin`:
  Specify that Bundler should create a binary executable (as `exe/GEM_NAME`)
  in the generated rubygem project. This binary will also be added to the
  `GEM_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 a `CODE_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 future `bundle gem` use.

* `--no-coc`:
  Do not create a `CODE_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 a `LICENSE.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 future
  `bundle gem` use.

* `--no-mit`:
  Do not create a `LICENSE.txt` (overrides `--mit` specified in the global
  config).

* `-t`, `--test=minitest`, `--test=rspec`, `--test=test-unit`:
  Specify the test framework that Bundler should use when generating the
  project. Acceptable values are `minitest`, `rspec` and `test-unit`. The
  `GEM_NAME.gemspec` will be configured and a skeleton test/spec directory will
  be created based on this option. Given no option is specified:

  When Bundler is configured to generate tests, this defaults to Bundler's
  global config setting `gem.test`.

  When Bundler is configured to not generate tests, an interactive prompt will
  be displayed and the answer will be used for the current rubygem project.

  When Bundler is unconfigured, an interactive prompt will be displayed and
  the answer will be saved in Bundler's global config for future `bundle gem`
  use.

* `--ci`, `--ci=github`, `--ci=travis`, `--ci=gitlab`, `--ci=circle`:
  Specify the continuous integration service that Bundler should use when
  generating the project. Acceptable values are `github`, `travis`, `gitlab`
  and `circle`. A configuration file will be generated in the project directory.
  Given no option is specified:

  When Bundler is configured to generate CI files, this defaults to Bundler's
  global config setting `gem.ci`.

  When Bundler is configured to not generate CI files, an interactive prompt
  will be displayed and the answer will be used for the current rubygem project.

  When Bundler is unconfigured, an interactive prompt will be displayed and
  the answer will be saved in Bundler's global config for future `bundle gem`
  use.

* `--linter`, `--linter=rubocop`, `--linter=standard`:
  Specify the linter and code formatter that Bundler should add to the
  project's development dependencies. Acceptable values are `rubocop` and
  `standard`. A configuration file will be generated in the project directory.
  Given no option is specified:

  When Bundler is configured to add a linter, this defaults to Bundler's
  global config setting `gem.linter`.

  When Bundler is configured not to add a linter, an interactive prompt
  will be displayed and the answer will be used for the current rubygem project.

  When Bundler is unconfigured, an interactive prompt will be displayed and
  the answer will be saved in Bundler's global config for future `bundle gem`
  use.

* `-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`.

## SEE ALSO

* [bundle config(1)](bundle-config.1.html)

Name	Size	Permission
bundle-add.1	1841 bytes	0644
bundle-add.1.ronn	1555 bytes	0644
bundle-binstubs.1	1615 bytes	0644
bundle-binstubs.1.ronn	1418 bytes	0644
bundle-cache.1	3461 bytes	0644
bundle-cache.1.ronn	3100 bytes	0644
bundle-check.1	965 bytes	0644
bundle-check.1.ronn	857 bytes	0644
bundle-clean.1	738 bytes	0644
bundle-clean.1.ronn	624 bytes	0644
bundle-config.1	22000 bytes	0644
bundle-config.1.ronn	19484 bytes	0644
bundle-console.1	1682 bytes	0644
bundle-console.1.ronn	1450 bytes	0644
bundle-doctor.1	1164 bytes	0644
bundle-doctor.1.ronn	975 bytes	0644
bundle-exec.1	6749 bytes	0644
bundle-exec.1.ronn	6001 bytes	0644
bundle-gem.1	5139 bytes	0644
bundle-gem.1.ronn	4626 bytes	0644
bundle-help.1	454 bytes	0644
bundle-help.1.ronn	349 bytes	0644
bundle-info.1	448 bytes	0644
bundle-info.1.ronn	369 bytes	0644
bundle-init.1	1078 bytes	0644
bundle-init.1.ronn	939 bytes	0644
bundle-inject.1	845 bytes	0644
bundle-inject.1.ronn	693 bytes	0644
bundle-install.1	18305 bytes	0644
bundle-install.1.ronn	17244 bytes	0644
bundle-list.1	964 bytes	0644
bundle-list.1.ronn	788 bytes	0644
bundle-lock.1	3190 bytes	0644
bundle-lock.1.ronn	3037 bytes	0644
bundle-open.1	580 bytes	0644
bundle-open.1.ronn	442 bytes	0644
bundle-outdated.1	3359 bytes	0644
bundle-outdated.1.ronn	3127 bytes	0644
bundle-platform.1	1461 bytes	0644
bundle-platform.1.ronn	1244 bytes	0644
bundle-plugin.1	2326 bytes	0644
bundle-plugin.1.ronn	1903 bytes	0644
bundle-pristine.1	1677 bytes	0644
bundle-pristine.1.ronn	1491 bytes	0644
bundle-remove.1	848 bytes	0644
bundle-remove.1.ronn	730 bytes	0644
bundle-show.1	689 bytes	0644
bundle-show.1.ronn	596 bytes	0644
bundle-update.1	13909 bytes	0644
bundle-update.1.ronn	12802 bytes	0644
bundle-version.1	641 bytes	0644
bundle-version.1.ronn	473 bytes	0644
bundle-viz.1	1246 bytes	0644
bundle-viz.1.ronn	1083 bytes	0644
bundle.1	3838 bytes	0644
bundle.1.ronn	3371 bytes	0644
gemfile.5	23055 bytes	0644
gemfile.5.ronn	21043 bytes	0644

File Content: bundle-gem.1.ronn

File Content: `bundle-gem.1.ronn`