summaryrefslogtreecommitdiff
path: root/man/bundle-gem.1.txt
blob: 8f124a61329acfef7dbd26d24c1f8afc831289a8 (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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
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
              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.

       -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
       o   bundle config(1) bundle-config.1.html






                                   July 2020                     BUNDLE-GEM(1)