apify-cli 0.7.0-beta.0 → 0.7.1-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +110 -18
- package/npm-shrinkwrap.json +3045 -8
- package/oclif.manifest.json +1 -1
- package/package.json +3 -1
- package/src/commands/actor/get-input.js +12 -0
- package/src/commands/actor/get-value.js +23 -0
- package/src/commands/actor/index.js +12 -0
- package/src/commands/actor/push-data.js +44 -0
- package/src/commands/actor/set-value.js +61 -0
- package/src/lib/actor.js +97 -0
- package/src/lib/apify_command.js +21 -0
package/README.md
CHANGED
|
@@ -235,6 +235,11 @@ or [contact us](https://www.apify.com/contact).
|
|
|
235
235
|
This section contains printouts of `apify help` for all commands.
|
|
236
236
|
|
|
237
237
|
<!-- commands -->
|
|
238
|
+
* [`apify actor`](#apify-actor)
|
|
239
|
+
* [`apify actor:get-input`](#apify-actorget-input)
|
|
240
|
+
* [`apify actor:get-value KEY`](#apify-actorget-value-key)
|
|
241
|
+
* [`apify actor:push-data [ITEM]`](#apify-actorpush-data-item)
|
|
242
|
+
* [`apify actor:set-value KEY [VALUE]`](#apify-actorset-value-key-value)
|
|
238
243
|
* [`apify call [ACTID]`](#apify-call-actid)
|
|
239
244
|
* [`apify create [ACTORNAME]`](#apify-create-actorname)
|
|
240
245
|
* [`apify info`](#apify-info)
|
|
@@ -248,6 +253,93 @@ This section contains printouts of `apify help` for all commands.
|
|
|
248
253
|
* [`apify secrets:rm NAME`](#apify-secretsrm-name)
|
|
249
254
|
* [`apify vis [PATH]`](#apify-vis-path)
|
|
250
255
|
|
|
256
|
+
## `apify actor`
|
|
257
|
+
|
|
258
|
+
Commands are designed to be used in actor runs. All commands are in PoC state, do not use in production environments.
|
|
259
|
+
|
|
260
|
+
```
|
|
261
|
+
USAGE
|
|
262
|
+
$ apify actor
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
_See code: [src/commands/actor/index.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/actor/index.js)_
|
|
266
|
+
|
|
267
|
+
## `apify actor:get-input`
|
|
268
|
+
|
|
269
|
+
Gets the actor input value from the default key-value store associated with the actor run.
|
|
270
|
+
|
|
271
|
+
```
|
|
272
|
+
USAGE
|
|
273
|
+
$ apify actor:get-input
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
_See code: [src/commands/actor/get-input.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/actor/get-input.js)_
|
|
277
|
+
|
|
278
|
+
## `apify actor:get-value KEY`
|
|
279
|
+
|
|
280
|
+
Gets a value from the default key-value store associated with the actor run.
|
|
281
|
+
|
|
282
|
+
```
|
|
283
|
+
USAGE
|
|
284
|
+
$ apify actor:get-value KEY
|
|
285
|
+
|
|
286
|
+
ARGUMENTS
|
|
287
|
+
KEY Key of the record in key-value store
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
_See code: [src/commands/actor/get-value.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/actor/get-value.js)_
|
|
291
|
+
|
|
292
|
+
## `apify actor:push-data [ITEM]`
|
|
293
|
+
|
|
294
|
+
Stores an object or an array of objects to the default dataset of the actor run.
|
|
295
|
+
|
|
296
|
+
```
|
|
297
|
+
USAGE
|
|
298
|
+
$ apify actor:push-data [ITEM]
|
|
299
|
+
|
|
300
|
+
ARGUMENTS
|
|
301
|
+
ITEM JSON string with one object or array of objects containing data to be stored in the default dataset.
|
|
302
|
+
|
|
303
|
+
DESCRIPTION
|
|
304
|
+
It is possible to pass data using item argument or stdin.
|
|
305
|
+
Passing data using argument:
|
|
306
|
+
$ apify actor:push-data {"foo": "bar"}
|
|
307
|
+
Passing data using stdin with pipe:
|
|
308
|
+
$ cat ./test.json | apify actor:push-data
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
_See code: [src/commands/actor/push-data.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/actor/push-data.js)_
|
|
312
|
+
|
|
313
|
+
## `apify actor:set-value KEY [VALUE]`
|
|
314
|
+
|
|
315
|
+
Sets or removes record into the default KeyValueStore associated with the actor run.
|
|
316
|
+
|
|
317
|
+
```
|
|
318
|
+
USAGE
|
|
319
|
+
$ apify actor:set-value KEY [VALUE]
|
|
320
|
+
|
|
321
|
+
ARGUMENTS
|
|
322
|
+
KEY Key of the record in key-value store.
|
|
323
|
+
|
|
324
|
+
VALUE Record data, which can be one of the following values:
|
|
325
|
+
- If empty, the record in the key-value store is deleted.
|
|
326
|
+
- If no `contentType` flag is specified, value is expected to be any JSON string value.
|
|
327
|
+
- If options.contentType is set, value is taken as is.
|
|
328
|
+
|
|
329
|
+
OPTIONS
|
|
330
|
+
-c, --contentType=contentType Specifies a custom MIME content type of the record. By default "application/json" is
|
|
331
|
+
used.
|
|
332
|
+
|
|
333
|
+
DESCRIPTION
|
|
334
|
+
It is possible to pass data using argument or stdin.
|
|
335
|
+
Passing data using argument:
|
|
336
|
+
$ apify actor:set-value KEY my-value
|
|
337
|
+
Passing data using stdin with pipe:
|
|
338
|
+
$ cat ./my-text-file.txt | apify actor:set-value KEY --contentType text/plain
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
_See code: [src/commands/actor/set-value.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/actor/set-value.js)_
|
|
342
|
+
|
|
251
343
|
## `apify call [ACTID]`
|
|
252
344
|
|
|
253
345
|
Runs a specific actor remotely on the Apify cloud platform.
|
|
@@ -267,11 +359,11 @@ OPTIONS
|
|
|
267
359
|
-w, --wait-for-finish=wait-for-finish Seconds for waiting to run to finish, if no value passed, it waits forever.
|
|
268
360
|
|
|
269
361
|
DESCRIPTION
|
|
270
|
-
The actor is run under your current Apify account, therefore you need to be logged in by calling "apify login". It
|
|
362
|
+
The actor is run under your current Apify account, therefore you need to be logged in by calling "apify login". It
|
|
271
363
|
takes input for the actor from the default local key-value store by default.
|
|
272
364
|
```
|
|
273
365
|
|
|
274
|
-
_See code: [src/commands/call.js](https://github.com/apify/apify-cli/blob/v0.
|
|
366
|
+
_See code: [src/commands/call.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/call.js)_
|
|
275
367
|
|
|
276
368
|
## `apify create [ACTORNAME]`
|
|
277
369
|
|
|
@@ -290,7 +382,7 @@ OPTIONS
|
|
|
290
382
|
available template names.
|
|
291
383
|
```
|
|
292
384
|
|
|
293
|
-
_See code: [src/commands/create.js](https://github.com/apify/apify-cli/blob/v0.
|
|
385
|
+
_See code: [src/commands/create.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/create.js)_
|
|
294
386
|
|
|
295
387
|
## `apify info`
|
|
296
388
|
|
|
@@ -304,7 +396,7 @@ DESCRIPTION
|
|
|
304
396
|
The information is printed to the console.
|
|
305
397
|
```
|
|
306
398
|
|
|
307
|
-
_See code: [src/commands/info.js](https://github.com/apify/apify-cli/blob/v0.
|
|
399
|
+
_See code: [src/commands/info.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/info.js)_
|
|
308
400
|
|
|
309
401
|
## `apify init [ACTORNAME]`
|
|
310
402
|
|
|
@@ -318,13 +410,13 @@ ARGUMENTS
|
|
|
318
410
|
ACTORNAME Name of the actor. If not provided, you will be prompted for it.
|
|
319
411
|
|
|
320
412
|
DESCRIPTION
|
|
321
|
-
The command only creates the "apify.json" file and the "apify_storage" directory in the current directory, but will
|
|
413
|
+
The command only creates the "apify.json" file and the "apify_storage" directory in the current directory, but will
|
|
322
414
|
not touch anything else.
|
|
323
415
|
|
|
324
416
|
WARNING: The directory at "apify_storage" will be overwritten if it already exists.
|
|
325
417
|
```
|
|
326
418
|
|
|
327
|
-
_See code: [src/commands/init.js](https://github.com/apify/apify-cli/blob/v0.
|
|
419
|
+
_See code: [src/commands/init.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/init.js)_
|
|
328
420
|
|
|
329
421
|
## `apify login`
|
|
330
422
|
|
|
@@ -338,11 +430,11 @@ OPTIONS
|
|
|
338
430
|
-t, --token=token [Optional] Apify API token
|
|
339
431
|
|
|
340
432
|
DESCRIPTION
|
|
341
|
-
The API token and other account information is stored in the ~/.apify directory, from where it is read by all other
|
|
433
|
+
The API token and other account information is stored in the ~/.apify directory, from where it is read by all other
|
|
342
434
|
"apify" commands. To log out, call "apify logout".
|
|
343
435
|
```
|
|
344
436
|
|
|
345
|
-
_See code: [src/commands/login.js](https://github.com/apify/apify-cli/blob/v0.
|
|
437
|
+
_See code: [src/commands/login.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/login.js)_
|
|
346
438
|
|
|
347
439
|
## `apify logout`
|
|
348
440
|
|
|
@@ -357,7 +449,7 @@ DESCRIPTION
|
|
|
357
449
|
call "apify login".
|
|
358
450
|
```
|
|
359
451
|
|
|
360
|
-
_See code: [src/commands/logout.js](https://github.com/apify/apify-cli/blob/v0.
|
|
452
|
+
_See code: [src/commands/logout.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/logout.js)_
|
|
361
453
|
|
|
362
454
|
## `apify push [ACTORID]`
|
|
363
455
|
|
|
@@ -384,15 +476,15 @@ OPTIONS
|
|
|
384
476
|
should be pushed. By default, it is taken from the "apify.json" file.
|
|
385
477
|
|
|
386
478
|
DESCRIPTION
|
|
387
|
-
The actor settings are read from the "apify.json" file in the current directory, but they can be overridden using
|
|
479
|
+
The actor settings are read from the "apify.json" file in the current directory, but they can be overridden using
|
|
388
480
|
command-line options.
|
|
389
|
-
NOTE: If the source files are smaller than 3 MB then they are uploaded as
|
|
481
|
+
NOTE: If the source files are smaller than 3 MB then they are uploaded as
|
|
390
482
|
"Multiple source files", otherwise they are uploaded as "Zip file".
|
|
391
483
|
|
|
392
484
|
WARNING: If the target actor already exists in your Apify account, it will be overwritten!
|
|
393
485
|
```
|
|
394
486
|
|
|
395
|
-
_See code: [src/commands/push.js](https://github.com/apify/apify-cli/blob/v0.
|
|
487
|
+
_See code: [src/commands/push.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/push.js)_
|
|
396
488
|
|
|
397
489
|
## `apify run`
|
|
398
490
|
|
|
@@ -418,11 +510,11 @@ DESCRIPTION
|
|
|
418
510
|
example, this causes the actor input, as well as all other data in key-value stores, datasets or request queues to be
|
|
419
511
|
stored in the "apify_storage" directory, rather than on the Apify platform.
|
|
420
512
|
|
|
421
|
-
NOTE: You can override the default behaviour of command overriding npm start script value in a package.json file. You
|
|
513
|
+
NOTE: You can override the default behaviour of command overriding npm start script value in a package.json file. You
|
|
422
514
|
can set up your own main file or environment variables by changing it.
|
|
423
515
|
```
|
|
424
516
|
|
|
425
|
-
_See code: [src/commands/run.js](https://github.com/apify/apify-cli/blob/v0.
|
|
517
|
+
_See code: [src/commands/run.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/run.js)_
|
|
426
518
|
|
|
427
519
|
## `apify secrets`
|
|
428
520
|
|
|
@@ -448,7 +540,7 @@ DESCRIPTION
|
|
|
448
540
|
of the actor.
|
|
449
541
|
```
|
|
450
542
|
|
|
451
|
-
_See code: [src/commands/secrets/index.js](https://github.com/apify/apify-cli/blob/v0.
|
|
543
|
+
_See code: [src/commands/secrets/index.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/secrets/index.js)_
|
|
452
544
|
|
|
453
545
|
## `apify secrets:add NAME VALUE`
|
|
454
546
|
|
|
@@ -466,7 +558,7 @@ DESCRIPTION
|
|
|
466
558
|
The secrets are stored to a file at ~/.apify
|
|
467
559
|
```
|
|
468
560
|
|
|
469
|
-
_See code: [src/commands/secrets/add.js](https://github.com/apify/apify-cli/blob/v0.
|
|
561
|
+
_See code: [src/commands/secrets/add.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/secrets/add.js)_
|
|
470
562
|
|
|
471
563
|
## `apify secrets:rm NAME`
|
|
472
564
|
|
|
@@ -480,7 +572,7 @@ ARGUMENTS
|
|
|
480
572
|
NAME Name of the secret
|
|
481
573
|
```
|
|
482
574
|
|
|
483
|
-
_See code: [src/commands/secrets/rm.js](https://github.com/apify/apify-cli/blob/v0.
|
|
575
|
+
_See code: [src/commands/secrets/rm.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/secrets/rm.js)_
|
|
484
576
|
|
|
485
577
|
## `apify vis [PATH]`
|
|
486
578
|
|
|
@@ -494,5 +586,5 @@ ARGUMENTS
|
|
|
494
586
|
PATH Optional path to your INPUT_SCHEMA.json file. If not provided ./INPUT_SCHEMA.json is used.
|
|
495
587
|
```
|
|
496
588
|
|
|
497
|
-
_See code: [src/commands/vis.js](https://github.com/apify/apify-cli/blob/v0.
|
|
589
|
+
_See code: [src/commands/vis.js](https://github.com/apify/apify-cli/blob/v0.7.1/src/commands/vis.js)_
|
|
498
590
|
<!-- commandsstop -->
|