Prepare to release 4.0

CHANGELOG.md

@@ -1,3 +1,12 @@
+# Version 4.0.0
+
+- Upgrade to AWS SDK release (1.x) versions.
+- Switch error handling to anyhow.
+- Switch logging to tracing.
+
+I'm treating the logging change, moving log level from a command line
+option to an environment variable, as a breaking change.
+
 # Version 3.0.2
 
 And, um, correct the broken download links in the README.

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "query-rds-data"
-version = "3.1.0"
+version = "4.0.0"
 authors = ["Bruce Adams <[email protected]>"]
 edition = "2021"
 categories = ["database", "command-line-utilities"]

README.md

@@ -71,6 +71,9 @@ $ cargo build  # The first build takes longer, with more output
 $ target/debug/query-rds-data --help
 Query AWS RDS Data from the command line
 
+You can set the environment variable `RUST_LOG` to adjust
+logging, for example `RUST_LOG=trace query-rds-data`.
+
 Usage: query-rds-data [OPTIONS] <QUERY>
 
 Arguments:
@@ -79,15 +82,15 @@ Arguments:
 
 Options:
   -p, --profile <PROFILE>
-          AWS source profile to use. This name references an entry in ~/.aws/config
+          AWS source profile to use. This name references an
+          entry in ~/.aws/config
 
           [env: AWS_PROFILE=]
 
   -r, --region <REGION>
           AWS region to target
 
-          [env: AWS_DEFAULT_REGION=]
-          [default: us-east-1]
+          [env: AWS_REGION=]
 
   -c, --db-cluster-identifier <CLUSTER_ID>
           RDS cluster identifier
@@ -106,16 +109,15 @@ Options:
 
           Possible values:
           - csv:  CSV output, including a header line
-          - json: An array of JSON Objects, {"field_name": field_value, …}
+          - json: A JSON Object. For example:
+            {"numberOfRecordsUpdated": 0, "records": [{"id": 1,
+            "name": "bruce", "amount": 0.05}]}
 
   -d, --database <DATABASE>
           Database name
 
           [env: AWS_RDS_DATABASE=]
 
-  -v, --verbose...
-          Increase logging verbosity (-v, -vv, -vvv, etc)
-
   -h, --help
           Print help (see a summary with '-h')
 

src/main.rs

@@ -22,12 +22,18 @@ use tracing_subscriber::{fmt, prelude::*, EnvFilter};
 enum Format {
     /// CSV output, including a header line.
     Csv,
-    /// An array of JSON Objects, {"field_name": field_value, …}.
+    /// A JSON Object. For example:
+    /// {"numberOfRecordsUpdated": 0,
+    ///  "records": [{"id": 1,
+    ///               "name": "bruce",
+    ///               "amount": 0.05}]}
     Json,
 }
 
-/// You can set the environment variable `RUST_LOG` to
-/// adjust logging, for example `RUST_LOG=trace aws-caller-id`
+/// Query AWS RDS Data from the command line
+///
+/// You can set the environment variable `RUST_LOG` to adjust
+/// logging, for example `RUST_LOG=trace query-rds-data`.
 #[derive(Clone, Debug, Parser)]
 #[command(about, author, version)]
 struct MyArgs {