1 | @oclif/dev-cli
|
2 | ===============
|
3 |
|
4 | helpers for oclif CLIs
|
5 |
|
6 | [![Version](https://img.shields.io/npm/v/@oclif/dev-cli.svg)](https://npmjs.org/package/@oclif/dev-cli)
|
7 | [![CircleCI](https://circleci.com/gh/oclif/dev-cli/tree/master.svg?style=shield)](https://circleci.com/gh/oclif/dev-cli/tree/master)
|
8 | [![Appveyor CI](https://ci.appveyor.com/api/projects/status/github/oclif/dev-cli?branch=master&svg=true)](https://ci.appveyor.com/project/heroku/dev-cli/branch/master)
|
9 | [![Codecov](https://codecov.io/gh/oclif/dev-cli/branch/master/graph/badge.svg)](https://codecov.io/gh/oclif/dev-cli)
|
10 | [![Known Vulnerabilities](https://snyk.io/test/npm/@oclif/dev-cli/badge.svg)](https://snyk.io/test/npm/@oclif/dev-cli)
|
11 | [![Downloads/week](https://img.shields.io/npm/dw/@oclif/dev-cli.svg)](https://npmjs.org/package/@oclif/dev-cli)
|
12 | [![License](https://img.shields.io/npm/l/@oclif/dev-cli.svg)](https://github.com/oclif/dev-cli/blob/master/package.json)
|
13 |
|
14 |
|
15 | * [Usage](#usage)
|
16 | * [Commands](#commands)
|
17 |
|
18 | # Usage
|
19 |
|
20 | ```sh-session
|
21 | $ npm install -g @oclif/dev-cli
|
22 | $ oclif-dev COMMAND
|
23 | running command...
|
24 | $ oclif-dev (-v|--version|version)
|
25 | @oclif/dev-cli/1.26.0 linux-x64 node-v12.0.0
|
26 | $ oclif-dev --help [COMMAND]
|
27 | USAGE
|
28 | $ oclif-dev COMMAND
|
29 | ...
|
30 | ```
|
31 |
|
32 | # Commands
|
33 |
|
34 | * [`oclif-dev help [COMMAND]`](#oclif-dev-help-command)
|
35 | * [`oclif-dev manifest [PATH]`](#oclif-dev-manifest-path)
|
36 | * [`oclif-dev pack`](#oclif-dev-pack)
|
37 | * [`oclif-dev pack:deb`](#oclif-dev-packdeb)
|
38 | * [`oclif-dev pack:macos`](#oclif-dev-packmacos)
|
39 | * [`oclif-dev pack:win`](#oclif-dev-packwin)
|
40 | * [`oclif-dev publish`](#oclif-dev-publish)
|
41 | * [`oclif-dev publish:deb`](#oclif-dev-publishdeb)
|
42 | * [`oclif-dev publish:macos`](#oclif-dev-publishmacos)
|
43 | * [`oclif-dev publish:win`](#oclif-dev-publishwin)
|
44 | * [`oclif-dev readme`](#oclif-dev-readme)
|
45 |
|
46 | ## `oclif-dev help [COMMAND]`
|
47 |
|
48 | display help for oclif-dev
|
49 |
|
50 | ```
|
51 | USAGE
|
52 | $ oclif-dev help [COMMAND]
|
53 |
|
54 | ARGUMENTS
|
55 | COMMAND command to show help for
|
56 |
|
57 | OPTIONS
|
58 | --all see all commands in CLI
|
59 | ```
|
60 |
|
61 | _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.0/src/commands/help.ts)_
|
62 |
|
63 | ## `oclif-dev manifest [PATH]`
|
64 |
|
65 | generates plugin manifest json
|
66 |
|
67 | ```
|
68 | USAGE
|
69 | $ oclif-dev manifest [PATH]
|
70 |
|
71 | ARGUMENTS
|
72 | PATH [default: .] path to plugin
|
73 | ```
|
74 |
|
75 | _See code: [src/commands/manifest.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/manifest.ts)_
|
76 |
|
77 | ## `oclif-dev pack`
|
78 |
|
79 | packages oclif cli into tarballs
|
80 |
|
81 | ```
|
82 | USAGE
|
83 | $ oclif-dev pack
|
84 |
|
85 | OPTIONS
|
86 | -r, --root=root (required) [default: .] path to oclif CLI root
|
87 | -t, --targets=targets comma-separated targets to pack (e.g.: linux-arm,win32-x64)
|
88 | --[no-]xz also build xz
|
89 |
|
90 | DESCRIPTION
|
91 | This can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.
|
92 | ```
|
93 |
|
94 | _See code: [src/commands/pack/index.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/pack/index.ts)_
|
95 |
|
96 | ## `oclif-dev pack:deb`
|
97 |
|
98 | pack CLI into debian package
|
99 |
|
100 | ```
|
101 | USAGE
|
102 | $ oclif-dev pack:deb
|
103 |
|
104 | OPTIONS
|
105 | -r, --root=root (required) [default: .] path to oclif CLI root
|
106 | ```
|
107 |
|
108 | _See code: [src/commands/pack/deb.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/pack/deb.ts)_
|
109 |
|
110 | ## `oclif-dev pack:macos`
|
111 |
|
112 | pack CLI into MacOS .pkg
|
113 |
|
114 | ```
|
115 | USAGE
|
116 | $ oclif-dev pack:macos
|
117 |
|
118 | OPTIONS
|
119 | -r, --root=root (required) [default: .] path to oclif CLI root
|
120 | ```
|
121 |
|
122 | _See code: [src/commands/pack/macos.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/pack/macos.ts)_
|
123 |
|
124 | ## `oclif-dev pack:win`
|
125 |
|
126 | create windows installer from oclif CLI
|
127 |
|
128 | ```
|
129 | USAGE
|
130 | $ oclif-dev pack:win
|
131 |
|
132 | OPTIONS
|
133 | -r, --root=root (required) [default: .] path to oclif CLI root
|
134 | ```
|
135 |
|
136 | _See code: [src/commands/pack/win.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/pack/win.ts)_
|
137 |
|
138 | ## `oclif-dev publish`
|
139 |
|
140 | publish an oclif CLI to S3
|
141 |
|
142 | ```
|
143 | USAGE
|
144 | $ oclif-dev publish
|
145 |
|
146 | OPTIONS
|
147 | -r, --root=root (required) [default: .] path to oclif CLI root
|
148 | -t, --targets=targets comma-separated targets to pack (e.g.: linux-arm,win32-x64)
|
149 |
|
150 | DESCRIPTION
|
151 | "aws-sdk" will need to be installed as a devDependency to publish.
|
152 | ```
|
153 |
|
154 | _See code: [src/commands/publish/index.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/publish/index.ts)_
|
155 |
|
156 | ## `oclif-dev publish:deb`
|
157 |
|
158 | publish deb package built with pack:deb
|
159 |
|
160 | ```
|
161 | USAGE
|
162 | $ oclif-dev publish:deb
|
163 |
|
164 | OPTIONS
|
165 | -r, --root=root (required) [default: .] path to oclif CLI root
|
166 | ```
|
167 |
|
168 | _See code: [src/commands/publish/deb.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/publish/deb.ts)_
|
169 |
|
170 | ## `oclif-dev publish:macos`
|
171 |
|
172 | publish macos installers built with pack:macos
|
173 |
|
174 | ```
|
175 | USAGE
|
176 | $ oclif-dev publish:macos
|
177 |
|
178 | OPTIONS
|
179 | -r, --root=root (required) [default: .] path to oclif CLI root
|
180 | ```
|
181 |
|
182 | _See code: [src/commands/publish/macos.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/publish/macos.ts)_
|
183 |
|
184 | ## `oclif-dev publish:win`
|
185 |
|
186 | publish windows installers built with pack:win
|
187 |
|
188 | ```
|
189 | USAGE
|
190 | $ oclif-dev publish:win
|
191 |
|
192 | OPTIONS
|
193 | -r, --root=root (required) [default: .] path to oclif CLI root
|
194 | ```
|
195 |
|
196 | _See code: [src/commands/publish/win.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/publish/win.ts)_
|
197 |
|
198 | ## `oclif-dev readme`
|
199 |
|
200 | adds commands to README.md in current directory
|
201 |
|
202 | ```
|
203 | USAGE
|
204 | $ oclif-dev readme
|
205 |
|
206 | OPTIONS
|
207 | --dir=dir (required) [default: docs] output directory for multi docs
|
208 | --multi create a different markdown page for each topic
|
209 |
|
210 | DESCRIPTION
|
211 | The readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:
|
212 | # Usage
|
213 | <!-- usage -->
|
214 | # Commands
|
215 | <!-- commands -->
|
216 |
|
217 | Customize the code URL prefix by setting oclif.repositoryPrefix in package.json.
|
218 | ```
|
219 |
|
220 | _See code: [src/commands/readme.ts](https://github.com/oclif/dev-cli/blob/v1.26.0/src/commands/readme.ts)_
|
221 |
|