From 2fd5d33094a1d698b5f87f2fe70dda7e53065b0a Mon Sep 17 00:00:00 2001 From: Ross Scroggs Date: Mon, 7 Aug 2023 12:35:36 -0700 Subject: [PATCH] Added `output_dateformat` and `output_timeformat` variables to `gam.cfg` --- docs/GamUpdates.md | 18 ++++++++++++++++-- docs/How-to-Upgrade-from-Standard-GAM.md | 4 ++-- docs/Version-and-Help.md | 12 ++++++------ docs/gam.cfg.md | 18 ++++++++++++++++-- 4 files changed, 40 insertions(+), 12 deletions(-) diff --git a/docs/GamUpdates.md b/docs/GamUpdates.md index e8e439df..2e895657 100644 --- a/docs/GamUpdates.md +++ b/docs/GamUpdates.md @@ -10,6 +10,20 @@ Add the `-s` option to the end of the above commands to suppress creating the `g See [Downloads](https://github.com/taers232c/GAMADV-XTD3/wiki/Downloads) for Windows or other options, including manual installation. +### 6.62.00 + +Added `output_dateformat` and `output_timeformat` variables to `gam.cfg` that provide alternate +output date and time formats that may be required by programs that will be processing the data. +GAM will not accept alternate date/time formats as input. + +* See: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes + +### 6.61.21 + +Updated `gam empty drivetrash ` to use new Drive API v3 +functionality for emptying the trash of a Shared Drive with a single API call. Previously, GAM had to purge each +individual file and folder in the trash. + ### 6.61.20 Remove `audit.googleapis.com` from the list of project APIs. @@ -3162,13 +3176,13 @@ Updated option `dateheaderformat iso|rfc2822|` to `gam reformatting of the message `Date` header value from RFC2822 format to the the following: * `iso` - Format is `%Y-%m-%dT%H:%M:%S%z` * `rfc2822` - Format is `%a, %d %b %Y %H:%M:%S %z` -* `` - Format according to: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior +* `` - Format according to: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes ### 6.15.05 Added option `dateheaderformat ` to `gam print|show messages|threads` that allows reformatting of the message `Date` header from RFC2822 format to the format specified by ``. -If `` is `iso`, then ISO 8601 format is used, otherwise see: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior +If `` is `iso`, then ISO 8601 format is used, otherwise see: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes If the `Date` header can't be parsed as RFC2822, it is left unchanged. ### 6.15.04 diff --git a/docs/How-to-Upgrade-from-Standard-GAM.md b/docs/How-to-Upgrade-from-Standard-GAM.md index 5c4ada88..a840f5c3 100644 --- a/docs/How-to-Upgrade-from-Standard-GAM.md +++ b/docs/How-to-Upgrade-from-Standard-GAM.md @@ -329,7 +329,7 @@ writes the credentials into the file oauth2.txt. admin@server:/Users/admin/bin/gamadv-xtd3$ rm -f /Users/admin/GAMConfig/oauth2.txt admin@server:/Users/admin/bin/gamadv-xtd3$ ./gam version WARNING: Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: /Users/admin/GAMConfig/oauth2.txt, Not Found -GAMADV-XTD3 6.61.18 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.62.00 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.10.8 64-bit final MacOS High Sierra 10.13.6 x86_64 @@ -969,7 +969,7 @@ writes the credentials into the file oauth2.txt. C:\GAMADV-XTD3>del C:\GAMConfig\oauth2.txt C:\GAMADV-XTD3>gam version WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found -GAMADV-XTD3 6.61.18 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.62.00 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.4 64-bit final Windows-10-10.0.17134 AMD64 diff --git a/docs/Version-and-Help.md b/docs/Version-and-Help.md index 5da6dc04..2551bdaf 100644 --- a/docs/Version-and-Help.md +++ b/docs/Version-and-Help.md @@ -3,7 +3,7 @@ Print the current version of Gam with details ``` gam version -GAMADV-XTD3 6.61.18 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.22.00 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.4 64-bit final MacOS Monterey 12.6.6 x86_64 @@ -15,7 +15,7 @@ Time: 2023-06-02T21:10:00-07:00 Print the current version of Gam with details and time offset information ``` gam version timeoffset -GAMADV-XTD3 6.61.18 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.22.00 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.4 64-bit final MacOS Monterey 12.6.6 x86_64 @@ -27,7 +27,7 @@ Your system time differs from www.googleapis.com by less than 1 second Print the current version of Gam with extended details and SSL information ``` gam version extended -GAMADV-XTD3 6.61.18 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.22.00 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.4 64-bit final MacOS Monterey 12.6.6 x86_64 @@ -64,7 +64,7 @@ MacOS High Sierra 10.13.6 x86_64 Path: /Users/Admin/bin/gamadv-xtd3 Version Check: Current: 5.35.08 - Latest: 6.61.18 + Latest: 6.22.00 echo $? 1 ``` @@ -72,7 +72,7 @@ echo $? Print the current version number without details ``` gam version simple -6.61.18 +6.22.00 ``` In Linux/MacOS you can do: ``` @@ -82,7 +82,7 @@ echo $VER Print the current version of Gam and address of this Wiki ``` gam help -GAM 6.61.18 - https://github.com/taers232c/GAMADV-XTD3 +GAM 6.22.00 - https://github.com/taers232c/GAMADV-XTD3 Ross Scroggs Python 3.11.4 64-bit final MacOS Monterey 12.6.6 x86_64 diff --git a/docs/gam.cfg.md b/docs/gam.cfg.md index da54e6fc..46030985 100644 --- a/docs/gam.cfg.md +++ b/docs/gam.cfg.md @@ -386,6 +386,16 @@ oauth2service_json Path to oauth2service.json Default: GamConfigDir/oauth2service.json Environment variable: OAUTHSERVICEFILE +output_dateformat + Output format of dates + See: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes + Default: '' which selects the format YYYY-MM-DD + Example: %m/%d/%Y will display as 08/07/2023 +output_timeformat + Output format of times + See: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes + Default: '' which selects the format YYYY-MM-DDTHH:MM:SS[Z|(+|-)HH:MM) + Example: %H:%M: %m/%d/%Y will display as 09:00 08/07/2023 people_max_results When retrieving lists of People from API, how many should be retrieved in each API call @@ -496,7 +506,7 @@ todrive_sheet_timestamp Default: False todrive_sheet_timeformat Format of the timestamp added to the sheet (tab) title of CSV files - See: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior + See: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes Default: '' which selects an ISO format timestamp Example: %Y-%m-%dT%H:%M:%S will display as 2020-07-06T17:48:54 todrive_timestamp @@ -504,7 +514,7 @@ todrive_timestamp Default: False todrive_timeformat Format of the timestamp added to the title of CSV files - See: https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior + See: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes Default: '' which selects an ISO format timestamp Example: %Y-%m-%dT%H:%M:%S will display as 2020-07-06T17:48:54 todrive_timezone @@ -615,6 +625,8 @@ Section: DEFAULT num_threads = 5 oauth2_txt = oauth2.txt ; /Users/admin/.gam/oauth2.txt oauth2service_json = oauth2service.json ; /Users/admin/.gam/oauth2service.json + output_dateformat = '' + output_timeformat = '' people_max_results = 100 quick_cros_move = false quick_info_user = false @@ -793,6 +805,8 @@ num_tbatch_threads = 2 num_threads = 5 oauth2_txt = oauth2.txt oauth2service_json = oauth2service.json +output_dateformat = '' +output_timeformat = '' people_max_results = 100 quick_cros_move = False quick_info_user = False