chore(release): 1.4.0 [ci skip]

salesforcecli · Jul 13, 2021 · 8366e79 · 8366e79
1 parent a983eb4
commit 8366e79
Show file tree

Hide file tree

Showing 3 changed files with 67 additions and 10 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [1.4.0](https://github.com/salesforcecli/plugin-user/compare/v1.3.1...v1.4.0) (2021-07-13)
+
+
+### Features
+
+* checking metadata ([9c52240](https://github.com/salesforcecli/plugin-user/commit/9c5224000a281932541d7f6963043934fbe6af31))
+* update password generation functionality ([b1e9c39](https://github.com/salesforcecli/plugin-user/commit/b1e9c39bfebf42376dd7479544f2de799f749626))
+
 ### [1.3.1](https://github.com/salesforcecli/plugin-user/compare/v1.3.0...v1.3.1) (2021-07-08)
 
 ## [1.3.0](https://github.com/salesforcecli/plugin-user/compare/v1.2.11...v1.3.0) (2021-05-19)

diff --git a/README.md b/README.md
@@ -90,14 +90,17 @@ For more NUT options and examples, see <https://github.com/salesforcecli/cli-plu
 * [`sfdx force:user:create [name=value...] [-a <string>] [-f <string>] [-s] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceusercreate-namevalue--a-string--f-string--s--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 * [`sfdx force:user:display [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserdisplay--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 * [`sfdx force:user:list [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserlist--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-* [`sfdx force:user:password:generate [-o <array>] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpasswordgenerate--o-array--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+* [`sfdx force:user:password:generate [-o <array>] [-l <integer>] [-c <integer>] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpasswordgenerate--o-array--l-integer--c-integer--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 * [`sfdx force:user:permset:assign -n <array> [-o <array>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceuserpermsetassign--n-array--o-array--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 
 ## `sfdx force:user:create [name=value...] [-a <string>] [-f <string>] [-s] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
 create a user for a scratch org
 
 ```
+create a user for a scratch org
+Create a user for a scratch org, optionally setting an alias for use by the CLI, assigning permission sets (e.g., permsets=ps1,ps2), generating a password (e.g., generatepassword=true), and setting User sObject fields.
+
 USAGE
   $ sfdx force:user:create [name=value...] [-a <string>] [-f <string>] [-s] [-v <string>] [-u <string>] [--apiversion 
   <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
@@ -138,13 +141,16 @@ EXAMPLES
   sfdx force:user:create -f config/project-user-def.json [email protected] generatepassword=true
 ```
 
-_See code: [src/commands/force/user/create.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.0/src/commands/force/user/create.ts)_
+_See code: [src/commands/force/user/create.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.1/src/commands/force/user/create.ts)_
 
 ## `sfdx force:user:display [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
 displays information about a user of a scratch org
 
 ```
+displays information about a user of a scratch org
+Output includes the profile name, org ID, access token, instance URL, login URL, and alias if applicable.
+
 USAGE
   $ sfdx force:user:display [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel 
   trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
@@ -172,13 +178,16 @@ EXAMPLES
   sfdx force:user:display -u [email protected] --json
 ```
 
-_See code: [src/commands/force/user/display.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.0/src/commands/force/user/display.ts)_
+_See code: [src/commands/force/user/display.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.1/src/commands/force/user/display.ts)_
 
 ## `sfdx force:user:list [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
 list all authenticated users of an org
 
 ```
+list all authenticated users of an org
+The original scratch org admin is marked with "(A)"
+
 USAGE
   $ sfdx force:user:list [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel 
   trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
@@ -207,18 +216,43 @@ EXAMPLES
   sfdx force:user:list --json > tmp/MyUserList.json
 ```
 
-_See code: [src/commands/force/user/list.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.0/src/commands/force/user/list.ts)_
+_See code: [src/commands/force/user/list.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.1/src/commands/force/user/list.ts)_
 
-## `sfdx force:user:password:generate [-o <array>] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx force:user:password:generate [-o <array>] [-l <integer>] [-c <integer>] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
 generate a password for scratch org users
 
 ```
+generate a password for scratch org users
+Generates and sets a random password for one or more scratch org users. Targets the usernames listed with the --onbehalfof parameter or the --targetusername parameter. Defaults to the defaultusername.
+
+If you haven’t set a default Dev Hub, or if your scratch org isn’t associated with your default Dev Hub, --targetdevhubusername is required.
+
+To change the password strength, set the --complexity parameter to a value between 0 and 5. 
+Each value specifies the types of characters used in the generated password: 
+
+0 - lower case letters only.
+1 - lower case letters and numbers only.
+2 - lower case letters and symbols only.
+3 - lower and upper case letters and numbers only
+4 - lower and upper case letters and symbols only
+5 - lower and upper case letters and numbers and symbols only 
+
+To see a password that was previously generated, run "sfdx force:user:display".
+
 USAGE
-  $ sfdx force:user:password:generate [-o <array>] [-v <string>] [-u <string>] [--apiversion <string>] [--json] 
-  [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx force:user:password:generate [-o <array>] [-l <integer>] [-c <integer>] [-v <string>] [-u <string>] 
+  [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
 
 OPTIONS
+  -c, --complexity=complexity                                                       [default: 5] level of password
+                                                                                    complexity or strength; the higher
+                                                                                    the value, the stronger the password
+
+  -l, --length=length                                                               [default: 13] number of characters
+                                                                                    in the generated password; valid
+                                                                                    values are between 8 and 1000
+
   -o, --onbehalfof=onbehalfof                                                       comma-separated list of usernames or
                                                                                     aliases to assign the password to
 
@@ -243,21 +277,36 @@ DESCRIPTION
   If you haven’t set a default Dev Hub, or if your scratch org isn’t associated with your default Dev Hub, 
   --targetdevhubusername is required.
 
+  To change the password strength, set the --complexity parameter to a value between 0 and 5. 
+  Each value specifies the types of characters used in the generated password: 
+
+  0 - lower case letters only.
+  1 - lower case letters and numbers only.
+  2 - lower case letters and symbols only.
+  3 - lower and upper case letters and numbers only
+  4 - lower and upper case letters and symbols only
+  5 - lower and upper case letters and numbers and symbols only 
+
   To see a password that was previously generated, run "sfdx force:user:display".
 
 EXAMPLES
   sfdx force:user:password:generate
+  sfdx force:user:password:generate -l 12
+  sfdx force:user:password:generate -c 3
   sfdx force:user:password:generate -u [email protected] --json
   sfdx force:user:password:generate -o "[email protected],[email protected],[email protected]"
 ```
 
-_See code: [src/commands/force/user/password/generate.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.0/src/commands/force/user/password/generate.ts)_
+_See code: [src/commands/force/user/password/generate.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.1/src/commands/force/user/password/generate.ts)_
 
 ## `sfdx force:user:permset:assign -n <array> [-o <array>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
 assign a permission set to one or more users of an org
 
 ```
+assign a permission set to one or more users of an org
+To specify an alias for the -u or -o parameter, use the username alias you set with the "alias:set" CLI command, not the User.Alias value of the org user.
+
 USAGE
   $ sfdx force:user:permset:assign -n <array> [-o <array>] [-u <string>] [--apiversion <string>] [--json] [--loglevel 
   trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
@@ -291,5 +340,5 @@ EXAMPLES
   sfdx force:user:permset:assign -n DreamHouse -o "[email protected],user2,user3"
 ```
 
-_See code: [src/commands/force/user/permset/assign.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.0/src/commands/force/user/permset/assign.ts)_
+_See code: [src/commands/force/user/permset/assign.ts](https://github.com/salesforcecli/plugin-user/blob/v1.3.1/src/commands/force/user/permset/assign.ts)_
 <!-- commandsstop -->
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-user",
   "description": "Commands to interact with Users and Permission Sets",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {