new feature: --log-level can now be used twice, --debug can now be us…

…ed twice

improved log-level specification, separating nostr-commander-rs from lower-level modules

Cargo.toml

@@ -2,7 +2,7 @@
 
 [package]
 name = "nostr-commander"
-version = "0.3.0"
+version = "0.3.1"
 edition = "2021"
 description = "simple but convenient CLI-based Nostr client app for publishing,sending and subscribing"
 documentation = "https://docs.rs/nostr-commander"
@@ -31,8 +31,8 @@ thiserror = "1.0"
 serde = { version = "1.0", features = ["derive"] }
 url = { version = "2.4", features = ["serde"] }
 serde_json = "1.0"
-tracing-subscriber = "0.3"
 tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 directories = "5.0"
 update-informer = "1.1"
 chrono = "0.4"

README.md

@@ -209,16 +209,27 @@ Options:
           default log level set with environment variable 'RUST_LOG' will be
           used. If used, log level will be set to 'DEBUG' and debugging
           information will be printed. '-d' is a shortcut for '--log-level
-          DEBUG'. See also '--log-level'. '-d' takes precedence over
-          '--log-level'. Additionally, have a look also at the option
-          '--verbose'
-
-      --log-level <LOG_LEVEL>
+          DEBUG'. If used once as in '-d' it will set and/or overwrite
+          --log-level to '--log-level debug'. If used twice as in '-d -d' it
+          will set and/or overwrite --log-level to '--log-level debug debug'.
+          And third or futher occurance of '-d' will be ignored. See also
+          '--log-level'. '-d' takes precedence over '--log-level'.
+          Additionally, have a look also at the option '--verbose'
+
+      --log-level <LOG_LEVEL>...
           Set the log level by overwriting the default log level. Details:: If
           not used, then the default log level set with environment variable
-          'RUST_LOG' will be used. See also '--debug' and '--verbose'
-          
-          [default: none]
+          'RUST_LOG' will be used. If used with one value specified this value
+          is assigned to the log level of matrix-commander-rs. If used with two
+          values specified the first value is assigned to the log level of
+          matrix-commander-rs. The second value is asigned to the lower level
+          modules. More than two values should not be specified. --debug
+          overwrites -log-level. See also '--debug' and '--verbose'.
+          Alternatively you can use the RUST_LOG environment variable. An
+          example use of RUST_LOG is to use neither --log-level nor --debug,
+          and to set RUST_LOG="error,matrix_commander_rs=debug" which turns off
+          debugging on all lower level modules and turns debugging on only for
+          matrix-commander-rs
 
           Possible values:
           - none:  None: not set, default

VERSION

@@ -1 +1 @@
-0.3.0
+0.3.1

help.help.txt

@@ -21,7 +21,7 @@ Options:
           Prints README.md file, the documenation in Markdown.
   -d, --debug...
           Overwrite the default log level.
-      --log-level <LOG_LEVEL>
+      --log-level <LOG_LEVEL>...
           Set the log level by overwriting the default log level.
       --verbose...
           Set the verbosity level.

help.manual.txt

@@ -48,16 +48,27 @@ Options:
           default log level set with environment variable 'RUST_LOG' will be
           used. If used, log level will be set to 'DEBUG' and debugging
           information will be printed. '-d' is a shortcut for '--log-level
-          DEBUG'. See also '--log-level'. '-d' takes precedence over
-          '--log-level'. Additionally, have a look also at the option
-          '--verbose'
-
-      --log-level <LOG_LEVEL>
+          DEBUG'. If used once as in '-d' it will set and/or overwrite
+          --log-level to '--log-level debug'. If used twice as in '-d -d' it
+          will set and/or overwrite --log-level to '--log-level debug debug'.
+          And third or futher occurance of '-d' will be ignored. See also
+          '--log-level'. '-d' takes precedence over '--log-level'.
+          Additionally, have a look also at the option '--verbose'
+
+      --log-level <LOG_LEVEL>...
           Set the log level by overwriting the default log level. Details:: If
           not used, then the default log level set with environment variable
-          'RUST_LOG' will be used. See also '--debug' and '--verbose'
-
-          [default: none]
+          'RUST_LOG' will be used. If used with one value specified this value
+          is assigned to the log level of matrix-commander-rs. If used with two
+          values specified the first value is assigned to the log level of
+          matrix-commander-rs. The second value is asigned to the lower level
+          modules. More than two values should not be specified. --debug
+          overwrites -log-level. See also '--debug' and '--verbose'.
+          Alternatively you can use the RUST_LOG environment variable. An
+          example use of RUST_LOG is to use neither --log-level nor --debug,
+          and to set RUST_LOG="error,matrix_commander_rs=debug" which turns off
+          debugging on all lower level modules and turns debugging on only for
+          matrix-commander-rs
 
           Possible values:
           - none:  None: not set, default

help.usage.txt

@@ -7,7 +7,7 @@ Options:
       --manual
       --readme
   -d, --debug...
-      --log-level <LOG_LEVEL>
+      --log-level <LOG_LEVEL>...
       --verbose...
   -c, --credentials <PATH_TO_FILE>
       --create-user