From d3648d18a994eaf9863c054740d9683957ec2858 Mon Sep 17 00:00:00 2001
From: Winni Neessen <wn@neessen.net>
Date: Sat, 27 Mar 2021 17:17:41 +0100
Subject: [PATCH 1/2] New DEV branch

---
 .idea/workspace.xml | 79 ++++-----------------------------------------
 apg.go              |  2 +-
 2 files changed, 8 insertions(+), 73 deletions(-)

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index ad74fb5..72822d2 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -5,7 +5,8 @@
   </component>
   <component name="ChangeListManager">
     <list default="true" id="fbb0c733-4aa1-4d27-87d5-c7276d8aa613" name="Default Changelist" comment="">
-      <change beforePath="$PROJECT_DIR$/.gitignore" beforeDir="false" afterPath="$PROJECT_DIR$/.gitignore" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/apg.go" beforeDir="false" afterPath="$PROJECT_DIR$/apg.go" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -24,7 +25,7 @@
   <component name="Git.Settings">
     <option name="RECENT_BRANCH_BY_REPOSITORY">
       <map>
-        <entry key="$PROJECT_DIR$" value="dev" />
+        <entry key="$PROJECT_DIR$" value="main" />
       </map>
     </option>
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
@@ -69,7 +70,7 @@
       <recent name="C:\Users\Winni Neessen\go\src\apg.go\test" />
     </key>
   </component>
-  <component name="RunManager" selected="Go Test.Test Application">
+  <component name="RunManager" selected="Go Test.Benchmark Application">
     <configuration name="Run Application (with excludes)" type="GoApplicationRunConfiguration" factoryName="Go Application">
       <module name="apg.go" />
       <working_directory value="$PROJECT_DIR$" />
@@ -139,17 +140,6 @@
       <filePath value="$PROJECT_DIR$" />
       <method v="2" />
     </configuration>
-    <configuration name="BenchmarkGetRandNum in apg.go" type="GoTestRunConfiguration" factoryName="Go Test" temporary="true" nameIsGenerated="true">
-      <module name="apg.go" />
-      <working_directory value="$PROJECT_DIR$" />
-      <framework value="gobench" />
-      <kind value="PACKAGE" />
-      <package value="apg.go" />
-      <directory value="$PROJECT_DIR$" />
-      <filePath value="$PROJECT_DIR$" />
-      <pattern value="^\QBenchmarkGetRandNum\E$" />
-      <method v="2" />
-    </configuration>
     <configuration name="Test Application" type="GoTestRunConfiguration" factoryName="Go Test">
       <module name="apg.go" />
       <working_directory value="$PROJECT_DIR$" />
@@ -160,49 +150,6 @@
       <filePath value="$PROJECT_DIR$" />
       <method v="2" />
     </configuration>
-    <configuration name="TestConvert in github.com/wneessen/apg.go" type="GoTestRunConfiguration" factoryName="Go Test" temporary="true" nameIsGenerated="true">
-      <module name="apg.go" />
-      <working_directory value="$PROJECT_DIR$" />
-      <framework value="gotest" />
-      <kind value="PACKAGE" />
-      <package value="github.com/wneessen/apg.go" />
-      <directory value="$PROJECT_DIR$" />
-      <filePath value="$PROJECT_DIR$" />
-      <pattern value="^\QTestConvert\E$" />
-      <method v="2" />
-    </configuration>
-    <configuration name="TestGetCharRange in apg.go" type="GoTestRunConfiguration" factoryName="Go Test" temporary="true" nameIsGenerated="true">
-      <module name="apg.go" />
-      <working_directory value="$PROJECT_DIR$" />
-      <framework value="gotest" />
-      <kind value="DIRECTORY" />
-      <package value="apg.go" />
-      <directory value="$PROJECT_DIR$" />
-      <filePath value="$PROJECT_DIR$" />
-      <pattern value="^\QTestGetCharRange\E$" />
-      <method v="2" />
-    </configuration>
-    <configuration name="TestGetRandNum in github.com/wneessen/apg.go (1)" type="GoTestRunConfiguration" factoryName="Go Test" temporary="true" nameIsGenerated="true">
-      <module name="apg.go" />
-      <working_directory value="$PROJECT_DIR$" />
-      <framework value="gotest" />
-      <kind value="PACKAGE" />
-      <package value="github.com/wneessen/apg.go" />
-      <directory value="$PROJECT_DIR$" />
-      <filePath value="$PROJECT_DIR$" />
-      <pattern value="^\QTestGetRandNum\E$" />
-      <method v="2" />
-    </configuration>
-    <configuration name="apg.go" type="GoTestRunConfiguration" factoryName="Go Test" temporary="true" nameIsGenerated="true">
-      <module name="apg.go" />
-      <working_directory value="$PROJECT_DIR$" />
-      <framework value="gotest" />
-      <kind value="DIRECTORY" />
-      <package value="apg.go" />
-      <directory value="$PROJECT_DIR$" />
-      <filePath value="$PROJECT_DIR$" />
-      <method v="2" />
-    </configuration>
     <list>
       <item itemvalue="Go Build.Run Application" />
       <item itemvalue="Go Build.Run Application (with params)" />
@@ -212,21 +159,7 @@
       <item itemvalue="Go Build.Run Application (with newstyle params and spelling and multiple pws)" />
       <item itemvalue="Go Test.Test Application" />
       <item itemvalue="Go Test.Benchmark Application" />
-      <item itemvalue="Go Test.TestGetRandNum in github.com/wneessen/apg.go (1)" />
-      <item itemvalue="Go Test.TestConvert in github.com/wneessen/apg.go" />
-      <item itemvalue="Go Test.BenchmarkGetRandNum in apg.go" />
-      <item itemvalue="Go Test.apg.go" />
-      <item itemvalue="Go Test.TestGetCharRange in apg.go" />
     </list>
-    <recent_temporary>
-      <list>
-        <item itemvalue="Go Test.TestGetCharRange in apg.go" />
-        <item itemvalue="Go Test.apg.go" />
-        <item itemvalue="Go Test.BenchmarkGetRandNum in apg.go" />
-        <item itemvalue="Go Test.TestConvert in github.com/wneessen/apg.go" />
-        <item itemvalue="Go Test.TestGetRandNum in github.com/wneessen/apg.go (1)" />
-      </list>
-    </recent_temporary>
   </component>
   <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
   <component name="TypeScriptGeneratedFilesManager">
@@ -271,7 +204,9 @@
     <MESSAGE value="Tests cleanup. Used structs for tests instead of repeating code" />
     <MESSAGE value="v0.2.7: Switched global config to it's own package" />
     <MESSAGE value="Updated .gitignore" />
-    <option name="LAST_COMMIT_MESSAGE" value="Updated .gitignore" />
+    <MESSAGE value="Removed .idea from .gitignore" />
+    <MESSAGE value="Let's have centralized IDE config" />
+    <option name="LAST_COMMIT_MESSAGE" value="Let's have centralized IDE config" />
   </component>
   <component name="VgoProject">
     <integration-enabled>true</integration-enabled>
diff --git a/apg.go b/apg.go
index 5b139b5..c7d17c1 100644
--- a/apg.go
+++ b/apg.go
@@ -8,7 +8,7 @@ import (
 
 // Constants
 const DefaultPwLenght int = 20
-const VersionString string = "0.2.8"
+const VersionString string = "0.2.9"
 
 type Config struct {
 	minPassLen    int

From 0c371569c0f1fc21a6e0570b6180a28858bd4424 Mon Sep 17 00:00:00 2001
From: Winni Neessen <wn@neessen.net>
Date: Sun, 28 Mar 2021 11:51:26 +0200
Subject: [PATCH 2/2] v0.2.9: Replaced standard go-help with custom usage text

---
 .idea/workspace.xml | 28 ++++++++++++++++++++++++++--
 apg.go              | 23 +++++++++++++++++++++++
 2 files changed, 49 insertions(+), 2 deletions(-)

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 72822d2..037a583 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -70,7 +70,27 @@
       <recent name="C:\Users\Winni Neessen\go\src\apg.go\test" />
     </key>
   </component>
-  <component name="RunManager" selected="Go Test.Benchmark Application">
+  <component name="RunManager" selected="Go Build.Run Application (show help text)">
+    <configuration name="Run Application (show help text)" type="GoApplicationRunConfiguration" factoryName="Go Application">
+      <module name="apg.go" />
+      <working_directory value="$PROJECT_DIR$" />
+      <parameters value="-h" />
+      <kind value="PACKAGE" />
+      <filePath value="$PROJECT_DIR$" />
+      <package value="github.com/wneessen/apg.go" />
+      <directory value="$PROJECT_DIR$" />
+      <method v="2" />
+    </configuration>
+    <configuration name="Run Application (show version string)" type="GoApplicationRunConfiguration" factoryName="Go Application">
+      <module name="apg.go" />
+      <working_directory value="$PROJECT_DIR$" />
+      <parameters value="-v" />
+      <kind value="PACKAGE" />
+      <filePath value="$PROJECT_DIR$" />
+      <package value="github.com/wneessen/apg.go" />
+      <directory value="$PROJECT_DIR$" />
+      <method v="2" />
+    </configuration>
     <configuration name="Run Application (with excludes)" type="GoApplicationRunConfiguration" factoryName="Go Application">
       <module name="apg.go" />
       <working_directory value="$PROJECT_DIR$" />
@@ -157,6 +177,8 @@
       <item itemvalue="Go Build.Run Application (with newstyle params)" />
       <item itemvalue="Go Build.Run Application (with newstyle params and spelling)" />
       <item itemvalue="Go Build.Run Application (with newstyle params and spelling and multiple pws)" />
+      <item itemvalue="Go Build.Run Application (show help text)" />
+      <item itemvalue="Go Build.Run Application (show version string)" />
       <item itemvalue="Go Test.Test Application" />
       <item itemvalue="Go Test.Benchmark Application" />
     </list>
@@ -206,7 +228,9 @@
     <MESSAGE value="Updated .gitignore" />
     <MESSAGE value="Removed .idea from .gitignore" />
     <MESSAGE value="Let's have centralized IDE config" />
-    <option name="LAST_COMMIT_MESSAGE" value="Let's have centralized IDE config" />
+    <MESSAGE value="New DEV branch" />
+    <MESSAGE value="v0.2.9: Replaced standard go-help with custom usage text" />
+    <option name="LAST_COMMIT_MESSAGE" value="v0.2.9: Replaced standard go-help with custom usage text" />
   </component>
   <component name="VgoProject">
     <integration-enabled>true</integration-enabled>
diff --git a/apg.go b/apg.go
index c7d17c1..354cb71 100644
--- a/apg.go
+++ b/apg.go
@@ -1,6 +1,7 @@
 package main
 
 import (
+	"flag"
 	"fmt"
 	"log"
 	"os"
@@ -28,12 +29,34 @@ type Config struct {
 	outputMode    int
 }
 
+// Help text
+const usage = `Usage:
+    apg [-m <length>] [-x <length>] -L -U -N -S -H
+    apg [-m <length>] [-x <length>] -M LUNsh -E <list of chars>
+
+Options:
+    -m LENGTH            Minimum length of the password to be generated (Default: 20)
+    -x LENGTH            Maximum length of the password to be generated (Default: 20)
+    -n NUMBER            Amount of password to be generated (Default: 1)
+    -E CHARS             List of characters to be excluded in the generated password
+    -M [LUNSHClunshc]    New style password parameters (upper case: on, lower case: off)
+    -L                   Use lower case characters in passwords (Default: on)
+    -U                   Use upper case characters in passwords (Default: on)
+    -N                   Use numeric characters in passwords (Default: on)
+    -S                   Use special characters in passwords (Default: on)
+    -H                   Avoid ambiguous characters in passwords (i. e.: 1, l, I, O, 0) (Default: off)
+    -C                   Enable complex password mode (implies -L -U -N -S and disables -H) (Default: off)
+    -l                   Spell generated passwords in phonetic alphabet (Default: off)
+    -h                   Show this help text
+    -v                   Show version string`
+
 // Main function that generated the passwords and returns them
 func main() {
 	// Log config
 	log.SetFlags(log.Ltime | log.Ldate | log.Lshortfile)
 
 	// Read and parse flags
+	flag.Usage = func() { _, _ = fmt.Fprintf(os.Stderr, "%s\n", usage) }
 	var config = parseFlags()
 
 	// Show version and exit