UNPKG

5.83 kBMarkdownView Raw
1@oclif/dev-cli
2===============
3
4helpers 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<!-- toc -->
15* [Usage](#usage)
16* [Commands](#commands)
17<!-- tocstop -->
18# Usage
19<!-- usage -->
20```sh-session
21$ npm install -g @oclif/dev-cli
22$ oclif-dev COMMAND
23running 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]
27USAGE
28 $ oclif-dev COMMAND
29...
30```
31<!-- usagestop -->
32# Commands
33<!-- commands -->
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
48display help for oclif-dev
49
50```
51USAGE
52 $ oclif-dev help [COMMAND]
53
54ARGUMENTS
55 COMMAND command to show help for
56
57OPTIONS
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
65generates plugin manifest json
66
67```
68USAGE
69 $ oclif-dev manifest [PATH]
70
71ARGUMENTS
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
79packages oclif cli into tarballs
80
81```
82USAGE
83 $ oclif-dev pack
84
85OPTIONS
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
90DESCRIPTION
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
98pack CLI into debian package
99
100```
101USAGE
102 $ oclif-dev pack:deb
103
104OPTIONS
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
112pack CLI into MacOS .pkg
113
114```
115USAGE
116 $ oclif-dev pack:macos
117
118OPTIONS
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
126create windows installer from oclif CLI
127
128```
129USAGE
130 $ oclif-dev pack:win
131
132OPTIONS
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
140publish an oclif CLI to S3
141
142```
143USAGE
144 $ oclif-dev publish
145
146OPTIONS
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
150DESCRIPTION
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
158publish deb package built with pack:deb
159
160```
161USAGE
162 $ oclif-dev publish:deb
163
164OPTIONS
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
172publish macos installers built with pack:macos
173
174```
175USAGE
176 $ oclif-dev publish:macos
177
178OPTIONS
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
186publish windows installers built with pack:win
187
188```
189USAGE
190 $ oclif-dev publish:win
191
192OPTIONS
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
200adds commands to README.md in current directory
201
202```
203USAGE
204 $ oclif-dev readme
205
206OPTIONS
207 --dir=dir (required) [default: docs] output directory for multi docs
208 --multi create a different markdown page for each topic
209
210DESCRIPTION
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<!-- commandsstop -->