summaryrefslogtreecommitdiff
path: root/man/bundle-gem.1.txt
blob: 18ce2ba4655dfb22002957b76c79dbc61bf0fdfd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
BUNDLE-GEM(1)							 BUNDLE-GEM(1)



NAME
       bundle-gem - 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:

       o   gem.coc

       o   gem.mit

       o   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 gen-
	      erated 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 generat-
	      ing the project.	Acceptable  values  are  minitest,  rspec  and
	      test-unit.  The GEM_NAME.gemspec will be configured and a skele-
	      ton test/spec directory will be created based on this option. If
	      this  option  is unspecified, an interactive prompt will be dis-
	      played and the answer will be saved in Bundler's	global	config
	      for  future  bundle  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, $VIS-
	      UAL, or $EDITOR.

SEE ALSO
       o   bundle config(1) bundle-config.1.html






				 January 2020			 BUNDLE-GEM(1)