@salesforce/plugin-packaging 2.18.4 → 2.19.0
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 +90 -27
- package/lib/commands/package/version/displaydependencies.d.ts +16 -0
- package/lib/commands/package/version/displaydependencies.js +54 -0
- package/lib/commands/package/version/displaydependencies.js.map +1 -0
- package/messages/package_version_displaydependencies.md +37 -0
- package/oclif.manifest.json +1358 -1240
- package/package.json +5 -5
- package/schemas/package-version-displaydependencies.json +16 -0
package/README.md
CHANGED
|
@@ -49,6 +49,7 @@ See [DEVELOPING.md](DEVELOPING.md)
|
|
|
49
49
|
- [`sf package version create report`](#sf-package-version-create-report)
|
|
50
50
|
- [`sf package version delete`](#sf-package-version-delete)
|
|
51
51
|
- [`sf package version displayancestry`](#sf-package-version-displayancestry)
|
|
52
|
+
- [`sf package version displaydependencies`](#sf-package-version-displaydependencies)
|
|
52
53
|
- [`sf package version list`](#sf-package-version-list)
|
|
53
54
|
- [`sf package version promote`](#sf-package-version-promote)
|
|
54
55
|
- [`sf package version report`](#sf-package-version-report)
|
|
@@ -153,7 +154,7 @@ FLAG DESCRIPTIONS
|
|
|
153
154
|
--installation-key-bypass flag is required.
|
|
154
155
|
```
|
|
155
156
|
|
|
156
|
-
_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
157
|
+
_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/convert.ts)_
|
|
157
158
|
|
|
158
159
|
## `sf package create`
|
|
159
160
|
|
|
@@ -232,7 +233,7 @@ FLAG DESCRIPTIONS
|
|
|
232
233
|
Org-Dependent Unlocked Packages" in the Salesforce DX Developer Guide.
|
|
233
234
|
```
|
|
234
235
|
|
|
235
|
-
_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
236
|
+
_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/create.ts)_
|
|
236
237
|
|
|
237
238
|
## `sf package delete`
|
|
238
239
|
|
|
@@ -274,7 +275,7 @@ EXAMPLES
|
|
|
274
275
|
$ sf package delete --package 0Ho... --target-dev-hub devhub@example.com
|
|
275
276
|
```
|
|
276
277
|
|
|
277
|
-
_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
278
|
+
_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/delete.ts)_
|
|
278
279
|
|
|
279
280
|
## `sf package install`
|
|
280
281
|
|
|
@@ -373,7 +374,7 @@ FLAG DESCRIPTIONS
|
|
|
373
374
|
- Delete: Delete removed components, except for custom objects and custom fields, that don't have dependencies.
|
|
374
375
|
```
|
|
375
376
|
|
|
376
|
-
_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
377
|
+
_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/install.ts)_
|
|
377
378
|
|
|
378
379
|
## `sf package install report`
|
|
379
380
|
|
|
@@ -406,7 +407,7 @@ EXAMPLES
|
|
|
406
407
|
$ sf package install report --request-id 0Hf... --target-org me@example.com
|
|
407
408
|
```
|
|
408
409
|
|
|
409
|
-
_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
410
|
+
_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/install/report.ts)_
|
|
410
411
|
|
|
411
412
|
## `sf package installed list`
|
|
412
413
|
|
|
@@ -438,7 +439,7 @@ EXAMPLES
|
|
|
438
439
|
$ sf package installed list --target-org me@example.com
|
|
439
440
|
```
|
|
440
441
|
|
|
441
|
-
_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
442
|
+
_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/installed/list.ts)_
|
|
442
443
|
|
|
443
444
|
## `sf package list`
|
|
444
445
|
|
|
@@ -476,7 +477,7 @@ EXAMPLES
|
|
|
476
477
|
$ sf package list --target-dev-hub devhub@example.com --verbose
|
|
477
478
|
```
|
|
478
479
|
|
|
479
|
-
_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
480
|
+
_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/list.ts)_
|
|
480
481
|
|
|
481
482
|
## `sf package push-upgrade abort`
|
|
482
483
|
|
|
@@ -515,7 +516,7 @@ EXAMPLES
|
|
|
515
516
|
$ sf package push-upgrade abort --push-request-id 0DV... --target-dev-hub devhub@example.com
|
|
516
517
|
```
|
|
517
518
|
|
|
518
|
-
_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
519
|
+
_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/push-upgrade/abort.ts)_
|
|
519
520
|
|
|
520
521
|
## `sf package push-upgrade list`
|
|
521
522
|
|
|
@@ -574,7 +575,7 @@ EXAMPLES
|
|
|
574
575
|
$ sf package push-upgrade list --package 033xyz –-status Failed
|
|
575
576
|
```
|
|
576
577
|
|
|
577
|
-
_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
578
|
+
_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/push-upgrade/list.ts)_
|
|
578
579
|
|
|
579
580
|
## `sf package push-upgrade report`
|
|
580
581
|
|
|
@@ -616,7 +617,7 @@ EXAMPLES
|
|
|
616
617
|
$ sf package push-upgrade report --push-request-id 0DV... --target-dev-hub devhub@example.com
|
|
617
618
|
```
|
|
618
619
|
|
|
619
|
-
_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
620
|
+
_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/push-upgrade/report.ts)_
|
|
620
621
|
|
|
621
622
|
## `sf package push-upgrade schedule`
|
|
622
623
|
|
|
@@ -703,7 +704,7 @@ FLAG DESCRIPTIONS
|
|
|
703
704
|
Overrides the value of the target-dev-hub configuration variable, if set.
|
|
704
705
|
```
|
|
705
706
|
|
|
706
|
-
_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
707
|
+
_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/push-upgrade/schedule.ts)_
|
|
707
708
|
|
|
708
709
|
## `sf package uninstall`
|
|
709
710
|
|
|
@@ -751,7 +752,7 @@ EXAMPLES
|
|
|
751
752
|
$ sf package uninstall --package "Undesirable Package Alias"
|
|
752
753
|
```
|
|
753
754
|
|
|
754
|
-
_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
755
|
+
_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/uninstall.ts)_
|
|
755
756
|
|
|
756
757
|
## `sf package uninstall report`
|
|
757
758
|
|
|
@@ -784,7 +785,7 @@ EXAMPLES
|
|
|
784
785
|
$ sf package uninstall report --request-id 06y... --target-org me@example.com
|
|
785
786
|
```
|
|
786
787
|
|
|
787
|
-
_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
788
|
+
_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/uninstall/report.ts)_
|
|
788
789
|
|
|
789
790
|
## `sf package update`
|
|
790
791
|
|
|
@@ -839,7 +840,7 @@ FLAG DESCRIPTIONS
|
|
|
839
840
|
associated with your package.
|
|
840
841
|
```
|
|
841
842
|
|
|
842
|
-
_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
843
|
+
_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/update.ts)_
|
|
843
844
|
|
|
844
845
|
## `sf package version create`
|
|
845
846
|
|
|
@@ -1014,7 +1015,7 @@ FLAG DESCRIPTIONS
|
|
|
1014
1015
|
periods of no output from commands.
|
|
1015
1016
|
```
|
|
1016
1017
|
|
|
1017
|
-
_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1018
|
+
_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/create.ts)_
|
|
1018
1019
|
|
|
1019
1020
|
## `sf package version create list`
|
|
1020
1021
|
|
|
@@ -1075,7 +1076,7 @@ EXAMPLES
|
|
|
1075
1076
|
$ sf package version create list --created-last-days 0 --status Success
|
|
1076
1077
|
```
|
|
1077
1078
|
|
|
1078
|
-
_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1079
|
+
_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/create/list.ts)_
|
|
1079
1080
|
|
|
1080
1081
|
## `sf package version create report`
|
|
1081
1082
|
|
|
@@ -1118,7 +1119,7 @@ EXAMPLES
|
|
|
1118
1119
|
$ sf package version create report --package-create-request-id 08c... --target-dev-hub devhub@example.com
|
|
1119
1120
|
```
|
|
1120
1121
|
|
|
1121
|
-
_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1122
|
+
_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/create/report.ts)_
|
|
1122
1123
|
|
|
1123
1124
|
## `sf package version delete`
|
|
1124
1125
|
|
|
@@ -1159,7 +1160,7 @@ EXAMPLES
|
|
|
1159
1160
|
$ sf package version delete --package 04t... --target-org devhub@example.com
|
|
1160
1161
|
```
|
|
1161
1162
|
|
|
1162
|
-
_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1163
|
+
_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/delete.ts)_
|
|
1163
1164
|
|
|
1164
1165
|
## `sf package version displayancestry`
|
|
1165
1166
|
|
|
@@ -1219,7 +1220,69 @@ FLAG DESCRIPTIONS
|
|
|
1219
1220
|
You can use the DOT code output in graph visualization software to create tree visualizations.
|
|
1220
1221
|
```
|
|
1221
1222
|
|
|
1222
|
-
_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1223
|
+
_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/displayancestry.ts)_
|
|
1224
|
+
|
|
1225
|
+
## `sf package version displaydependencies`
|
|
1226
|
+
|
|
1227
|
+
Display the dependency graph for an unlocked or 2GP managed package version.
|
|
1228
|
+
|
|
1229
|
+
```
|
|
1230
|
+
USAGE
|
|
1231
|
+
$ sf package version displaydependencies -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [--edge-direction
|
|
1232
|
+
root-first|root-last] [--verbose]
|
|
1233
|
+
|
|
1234
|
+
FLAGS
|
|
1235
|
+
-p, --package=<value> (required) ID or alias of the package version (starts with 04t) or the package version
|
|
1236
|
+
create request (starts with 08c) to display the dependency graph for.
|
|
1237
|
+
-v, --target-dev-hub=<value> (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`
|
|
1238
|
+
configuration variable is already set.
|
|
1239
|
+
--api-version=<value> Override the api version used for api requests made by this command
|
|
1240
|
+
--edge-direction=<option> [default: root-first] Order (root-first or root-last) in which the dependencies are
|
|
1241
|
+
displayed.
|
|
1242
|
+
<options: root-first|root-last>
|
|
1243
|
+
--verbose Display both the package version ID (starts with 04t) and the version number
|
|
1244
|
+
(major.minor.patch.build) in each node.
|
|
1245
|
+
|
|
1246
|
+
GLOBAL FLAGS
|
|
1247
|
+
--flags-dir=<value> Import flag values from a directory.
|
|
1248
|
+
--json Format output as json.
|
|
1249
|
+
|
|
1250
|
+
EXAMPLES
|
|
1251
|
+
Display the dependency graph for a package version with the specified alias, using your default Dev Hub org and the
|
|
1252
|
+
default edge-direction:
|
|
1253
|
+
|
|
1254
|
+
$ sf package version displaydependencies --package package_version_alias
|
|
1255
|
+
|
|
1256
|
+
Display the dependency graph for a package version with the specified ID and display the graph using a root-last
|
|
1257
|
+
edge direction. Use the Dev Hub org with username devhub@example.com:
|
|
1258
|
+
|
|
1259
|
+
$ sf package version displaydependencies --package 04t... --edge-direction root-last --target-dev-hub \
|
|
1260
|
+
devhub@example.com
|
|
1261
|
+
|
|
1262
|
+
Display the dependency graph of a version create request with the specified ID, using your default Dev Hub org and
|
|
1263
|
+
the default edge-direction:
|
|
1264
|
+
|
|
1265
|
+
$ sf package version displaydependencies --package 08c...
|
|
1266
|
+
|
|
1267
|
+
FLAG DESCRIPTIONS
|
|
1268
|
+
-p, --package=<value>
|
|
1269
|
+
|
|
1270
|
+
ID or alias of the package version (starts with 04t) or the package version create request (starts with 08c) to
|
|
1271
|
+
display the dependency graph for.
|
|
1272
|
+
|
|
1273
|
+
Before running this command, update your sfdx-project.json file to specify the calculateTransitiveDependencies
|
|
1274
|
+
attribute, and set the value to true. This command returns GraphViz code, which can be compiled to a graph using DOT
|
|
1275
|
+
code or another graph visualization software.
|
|
1276
|
+
|
|
1277
|
+
--edge-direction=root-first|root-last Order (root-first or root-last) in which the dependencies are displayed.
|
|
1278
|
+
|
|
1279
|
+
A root-first graph declares the root as the package that must be installed last. A root-last graph is the reverse
|
|
1280
|
+
order of root-first. If you specify "--edge-direction root-last", the graph displays the packages in the order they
|
|
1281
|
+
must be installed. The root starts with the farthest leaf of the package dependencies and ends with the base
|
|
1282
|
+
package, which must be installed last.
|
|
1283
|
+
```
|
|
1284
|
+
|
|
1285
|
+
_See code: [src/commands/package/version/displaydependencies.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/displaydependencies.ts)_
|
|
1223
1286
|
|
|
1224
1287
|
## `sf package version list`
|
|
1225
1288
|
|
|
@@ -1295,7 +1358,7 @@ EXAMPLES
|
|
|
1295
1358
|
$ sf package version list --packages exp-mgr,exp-mgr-util --released --modified-last-days 0
|
|
1296
1359
|
```
|
|
1297
1360
|
|
|
1298
|
-
_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1361
|
+
_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/list.ts)_
|
|
1299
1362
|
|
|
1300
1363
|
## `sf package version promote`
|
|
1301
1364
|
|
|
@@ -1339,7 +1402,7 @@ EXAMPLES
|
|
|
1339
1402
|
$ sf package version promote --package "Awesome Package Alias"
|
|
1340
1403
|
```
|
|
1341
1404
|
|
|
1342
|
-
_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1405
|
+
_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/promote.ts)_
|
|
1343
1406
|
|
|
1344
1407
|
## `sf package version report`
|
|
1345
1408
|
|
|
@@ -1379,7 +1442,7 @@ EXAMPLES
|
|
|
1379
1442
|
$ sf package version report --package "Your Package Alias" --target-dev-hub devhub@example.com
|
|
1380
1443
|
```
|
|
1381
1444
|
|
|
1382
|
-
_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1445
|
+
_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/report.ts)_
|
|
1383
1446
|
|
|
1384
1447
|
## `sf package version update`
|
|
1385
1448
|
|
|
@@ -1432,7 +1495,7 @@ EXAMPLES
|
|
|
1432
1495
|
$ sf package version update --package 04t... --version-description "New Package Version Description"
|
|
1433
1496
|
```
|
|
1434
1497
|
|
|
1435
|
-
_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1498
|
+
_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package/version/update.ts)_
|
|
1436
1499
|
|
|
1437
1500
|
## `sf package1 version create`
|
|
1438
1501
|
|
|
@@ -1499,7 +1562,7 @@ FLAG DESCRIPTIONS
|
|
|
1499
1562
|
subscribers.
|
|
1500
1563
|
```
|
|
1501
1564
|
|
|
1502
|
-
_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1565
|
+
_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package1/version/create.ts)_
|
|
1503
1566
|
|
|
1504
1567
|
## `sf package1 version create get`
|
|
1505
1568
|
|
|
@@ -1532,7 +1595,7 @@ EXAMPLES
|
|
|
1532
1595
|
$ sf package1 version create get --request-id 0HD... --target-org myorg@example.com
|
|
1533
1596
|
```
|
|
1534
1597
|
|
|
1535
|
-
_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1598
|
+
_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package1/version/create/get.ts)_
|
|
1536
1599
|
|
|
1537
1600
|
## `sf package1 version display`
|
|
1538
1601
|
|
|
@@ -1566,7 +1629,7 @@ EXAMPLES
|
|
|
1566
1629
|
$ sf package1 version display --package-version-id 04t... --target-org myorg@example.com
|
|
1567
1630
|
```
|
|
1568
1631
|
|
|
1569
|
-
_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1632
|
+
_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package1/version/display.ts)_
|
|
1570
1633
|
|
|
1571
1634
|
## `sf package1 version list`
|
|
1572
1635
|
|
|
@@ -1604,6 +1667,6 @@ FLAG DESCRIPTIONS
|
|
|
1604
1667
|
If not specified, shows all versions for all packages (managed and unmanaged) in the org.
|
|
1605
1668
|
```
|
|
1606
1669
|
|
|
1607
|
-
_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.
|
|
1670
|
+
_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.19.0/src/commands/package1/version/list.ts)_
|
|
1608
1671
|
|
|
1609
1672
|
<!-- commandsstop -->
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { SfCommand } from '@salesforce/sf-plugins-core';
|
|
2
|
+
export type DisplayDependenciesCommandResult = string | void;
|
|
3
|
+
export declare class PackageVersionDisplayDependenciesCommand extends SfCommand<DisplayDependenciesCommandResult> {
|
|
4
|
+
static readonly summary: string;
|
|
5
|
+
static readonly examples: string[];
|
|
6
|
+
static readonly deprecateAliases = true;
|
|
7
|
+
static readonly flags: {
|
|
8
|
+
loglevel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
'target-dev-hub': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
package: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
12
|
+
'edge-direction': import("@oclif/core/interfaces").OptionFlag<"root-first" | "root-last", import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
14
|
+
};
|
|
15
|
+
run(): Promise<DisplayDependenciesCommandResult>;
|
|
16
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* Copyright (c) 2022, salesforce.com, inc.
|
|
3
|
+
* All rights reserved.
|
|
4
|
+
* Licensed under the BSD 3-Clause license.
|
|
5
|
+
* For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
|
|
6
|
+
*/
|
|
7
|
+
import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
|
|
8
|
+
import { Messages } from '@salesforce/core/messages';
|
|
9
|
+
import { Package } from '@salesforce/packaging';
|
|
10
|
+
import { requiredHubFlag } from '../../../utils/hubFlag.js';
|
|
11
|
+
import { maybeGetProject } from '../../../utils/getProject.js';
|
|
12
|
+
Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
|
|
13
|
+
const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_displaydependencies');
|
|
14
|
+
export class PackageVersionDisplayDependenciesCommand extends SfCommand {
|
|
15
|
+
static summary = messages.getMessage('summary');
|
|
16
|
+
static examples = messages.getMessages('examples');
|
|
17
|
+
static deprecateAliases = true;
|
|
18
|
+
static flags = {
|
|
19
|
+
loglevel,
|
|
20
|
+
'target-dev-hub': requiredHubFlag,
|
|
21
|
+
'api-version': orgApiVersionFlagWithDeprecations,
|
|
22
|
+
package: Flags.string({
|
|
23
|
+
char: 'p',
|
|
24
|
+
summary: messages.getMessage('flags.package.summary'),
|
|
25
|
+
description: messages.getMessage('flags.package.description'),
|
|
26
|
+
required: true,
|
|
27
|
+
}),
|
|
28
|
+
'edge-direction': Flags.custom({
|
|
29
|
+
options: ['root-first', 'root-last'],
|
|
30
|
+
})({
|
|
31
|
+
summary: messages.getMessage('flags.edge-direction.summary'),
|
|
32
|
+
description: messages.getMessage('flags.edge-direction.description'),
|
|
33
|
+
default: 'root-first',
|
|
34
|
+
}),
|
|
35
|
+
verbose: Flags.boolean({
|
|
36
|
+
summary: messages.getMessage('flags.verbose.summary'),
|
|
37
|
+
default: false,
|
|
38
|
+
}),
|
|
39
|
+
};
|
|
40
|
+
async run() {
|
|
41
|
+
const { flags } = await this.parse(PackageVersionDisplayDependenciesCommand);
|
|
42
|
+
const packageDependencyGraph = await Package.getDependencyGraph(flags.package, await maybeGetProject(), flags['target-dev-hub'].getConnection(flags['api-version']), {
|
|
43
|
+
verbose: flags['verbose'],
|
|
44
|
+
edgeDirection: flags['edge-direction'],
|
|
45
|
+
});
|
|
46
|
+
const dotProducer = await packageDependencyGraph.getDependencyDotProducer();
|
|
47
|
+
const dotCodeResult = dotProducer.produce();
|
|
48
|
+
if (flags.json) {
|
|
49
|
+
return dotCodeResult;
|
|
50
|
+
}
|
|
51
|
+
this.log(dotCodeResult);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=displaydependencies.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"displaydependencies.js","sourceRoot":"","sources":["../../../../src/commands/package/version/displaydependencies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,iCAAiC,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,8BAA8B,EAAE,qCAAqC,CAAC,CAAC;AAG9G,MAAM,OAAO,wCAAyC,SAAQ,SAA2C;IAChG,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC;IAExC,MAAM,CAAU,KAAK,GAAG;QAC7B,QAAQ;QACR,gBAAgB,EAAE,eAAe;QACjC,aAAa,EAAE,iCAAiC;QAChD,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;YACrD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,2BAA2B,CAAC;YAC7D,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAA6B;YACzD,OAAO,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;SACrC,CAAC,CAAC;YACD,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,8BAA8B,CAAC;YAC5D,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,kCAAkC,CAAC;YACpE,OAAO,EAAE,YAAY;SACtB,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;YACrD,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC7E,MAAM,sBAAsB,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAC7D,KAAK,CAAC,OAAO,EACb,MAAM,eAAe,EAAE,EACvB,KAAK,CAAC,gBAAgB,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAC3D;YACE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;YACzB,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC;SACvC,CACF,CAAC;QAEF,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC,wBAAwB,EAAE,CAAC;QAC5E,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;QAE5C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1B,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# summary
|
|
2
|
+
|
|
3
|
+
Display the dependency graph for an unlocked or 2GP managed package version.
|
|
4
|
+
|
|
5
|
+
# examples
|
|
6
|
+
|
|
7
|
+
- Display the dependency graph for a package version with the specified alias, using your default Dev Hub org and the default edge-direction:
|
|
8
|
+
|
|
9
|
+
<%= config.bin %> <%= command.id %> --package package_version_alias
|
|
10
|
+
|
|
11
|
+
- Display the dependency graph for a package version with the specified ID and display the graph using a root-last edge direction. Use the Dev Hub org with username devhub@example.com:
|
|
12
|
+
|
|
13
|
+
<%= config.bin %> <%= command.id %> --package 04t... --edge-direction root-last --target-dev-hub devhub@example.com
|
|
14
|
+
|
|
15
|
+
- Display the dependency graph of a version create request with the specified ID, using your default Dev Hub org and the default edge-direction:
|
|
16
|
+
|
|
17
|
+
<%= config.bin %> <%= command.id %> --package 08c...
|
|
18
|
+
|
|
19
|
+
# flags.package.summary
|
|
20
|
+
|
|
21
|
+
ID or alias of the package version (starts with 04t) or the package version create request (starts with 08c) to display the dependency graph for.
|
|
22
|
+
|
|
23
|
+
# flags.package.description
|
|
24
|
+
|
|
25
|
+
Before running this command, update your sfdx-project.json file to specify the calculateTransitiveDependencies attribute, and set the value to true. This command returns GraphViz code, which can be compiled to a graph using DOT code or another graph visualization software.
|
|
26
|
+
|
|
27
|
+
# flags.edge-direction.summary
|
|
28
|
+
|
|
29
|
+
Order (root-first or root-last) in which the dependencies are displayed.
|
|
30
|
+
|
|
31
|
+
# flags.edge-direction.description
|
|
32
|
+
|
|
33
|
+
A root-first graph declares the root as the package that must be installed last. A root-last graph is the reverse order of root-first. If you specify "--edge-direction root-last", the graph displays the packages in the order they must be installed. The root starts with the farthest leaf of the package dependencies and ends with the base package, which must be installed last.
|
|
34
|
+
|
|
35
|
+
# flags.verbose.summary
|
|
36
|
+
|
|
37
|
+
Display both the package version ID (starts with 04t) and the version number (major.minor.patch.build) in each node.
|