rda-python-dsupdt 2.0.11__tar.gz → 2.0.13__tar.gz

{rda_python_dsupdt-2.0.11 → rda_python_dsupdt-2.0.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rda_python_dsupdt
-Version: 2.0.11
+Version: 2.0.13
 Summary: RDA Python Package to update RDA operational datasets
 Author-email: Zaihua Ji <zji@ucar.edu>
 Project-URL: Homepage, https://github.com/NCAR/rda-python-dsupdt
@@ -16,3 +16,5 @@ Requires-Dist: rda_python_dsarch
 Dynamic: license-file
 
 RDA python package to update RDA operational datasets.
+
+The user guide for this utility tool can be viewed at: [User guide](https://gdex-docs-dsupdt.readthedocs.io).

rda_python_dsupdt-2.0.13/README.md

@@ -0,0 +1,3 @@
+RDA python package to update RDA operational datasets.
+
+The user guide for this utility tool can be viewed at: [User guide](https://gdex-docs-dsupdt.readthedocs.io).

{rda_python_dsupdt-2.0.11 → rda_python_dsupdt-2.0.13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rda_python_dsupdt"
-version = "2.0.11"
+version = "2.0.13"
 authors = [
   { name="Zaihua Ji", email="zji@ucar.edu" },
 ]

{rda_python_dsupdt-2.0.11 → rda_python_dsupdt-2.0.13}/src/rda_python_dsupdt/dsupdt.usg

@@ -25,10 +25,10 @@ on placing a dataset under 'dsarch' control.
 
 Once update information is configured in GDEXDB, 'dsupdt' downloads and archives
 data in the following steps:
- Server Files on remote server or at other local area =========DOWNLOAD/COPY=>
- Remote Files at local working area ========================VALIDATE/CONVERT=>
- Remote Files ready for building Local Files =============TAR/COMPRESS/BUILD=>
- Local Files ready for archive =======================================DSARCH=>
+ Server Files on remote server or at other local area ===DOWNLOAD/COPY=>
+ Remote Files at local working area ==================VALIDATE/CONVERT=>
+ Remote Files ready for building Local Files =======TAR/COMPRESS/BUILD=>
+ Local Files ready for archive =================================DSARCH=>
  Files on GDEX Servers
 
 If not specified explicitly, the server file name defaults to the remote file name.
@@ -98,14 +98,16 @@ command-line options. The -IF option name itself may be omitted when a single
 input file is given on the command line and all action and option information is
 contained within that file.
 
-When retrieving update control, local file, or remote file information, Info
-options specify query conditions. The special characters '!', '<', '>', and
-'<>' can be used for more specific filtering. When supplied on the command line,
-these characters must be quoted or escaped to avoid shell interpretation. '!'
-(or \!) denotes exclusion and must appear immediately after the option name.
-'<' and '>' denote less-than and greater-than comparisons on the following
-value. '<>' denotes a range between two values. Combining '!' with '<' as
-'!' '<' OptionValue creates a 'greater than or equal to OptionValue' condition.
+Info options used with GET actions serve as query filters. Four special
+characters enable more precise filtering — they must be quoted or escaped
+on the command line to prevent shell interpretation:
+   '!' - exclude matches; must appear immediately after the option name
+   '<' - less-than comparison on the following value
+   '>' - greater-than comparison on the following value
+  '<>' - range between two values
+
+Combining '!' and '<' as "-<OptionName>!<OptionValue>" expresses a 'greater than
+or equal to OptionValue' condition.
 
 The description of an individual option is displayed when 'dsupdt' is run as
 
@@ -118,7 +120,7 @@ available at $DSSHOME/dssdb/prog_usage/dsupdt.usg, where $DSSHOME is the
 environment variable for the DSS home directory.
 
 #The online HTML version of this document is available at
-#http://dss.ucar.edu/internal/docs/dsupdt/
+#https://gdex-docs-dsupdt.readthedocs.io/en/latest/index.html
 
 
 3 ACTION OPTIONS
@@ -261,8 +263,7 @@ ControlIndex<:>Specialist<:>ParentIndex<:>Action<:>Frequency<:>ControlOffset<:>C
   Z      -(HO|HourOffset)       time zone hour offset, hours ahead of local time
   D      -(DT|DataTime)         time data updated to, format: YYYY-MM-DD HH:NN:SS
   H      -(HN|HostName)         hostnames on which this control index can or cannot be processed
-  S      -(SB|SBatchOptions)    additional SLURM sbatch options
-  Q      -(QS|QSubOptions)      additional PBS qsub options
+  Q      -(QS|QsubOptions)      additional PBS qsub options
   Y      -(CC|CarbonCopy)       carbon copies for additional email addresses
   X      -(XC|ExecuteCommand)   Command to be executed after successful update
 
@@ -1337,12 +1338,6 @@ Information (Info) options supply values to 'dsupdt'. There are two types:
   in the form YYYY-MM-DD HH:NN:SS. After a successful update, this time is
   advanced to the next period based on the control frequency and offset.
 
-  -DC or -DownloadCommand (Alias: -Download|-Command), the command used to
-  download a remote file, copy a local file, or generate a remote file via local
-  processing. Can be set in both local and remote file records; used by
-  -DR (-DownloadRemote). At run time, the command precedence is:
-  command line > remote file record > local file record.
-
   -DB or -Debug, enables debug mode with specified detail level. This option
   accepts up to 3 values: Debug Level, debug log file path, and debug log file
   name. The debug level is required and may be a single integer (e.g., 1000 to
@@ -1350,6 +1345,12 @@ Information (Info) options supply values to 'dsupdt'. There are two types:
   is '$DSSHOME/dssdb/log' and the default log file name is 'mydss.dbg'. Provide
   the second and third values to override these defaults.
 
+  -DC or -DownloadCommand (Alias: -Download|-Command), the command used to
+  download a remote file, copy a local file, or generate a remote file via local
+  processing. Can be set in both local and remote file records; used by
+  -DR (-DownloadRemote). At run time, the command precedence is
+  command line, remote file record and local file record.
+
   -DE or -Description (Alias: -Desc|-Note|-FileDesc|-FileDescription), a
   description for data files. Multi-line descriptions are supported when
   supplied via an input file (-IF).
@@ -1533,11 +1534,6 @@ Information (Info) options supply values to 'dsupdt'. There are two types:
   -RI or -RetryInterval, the wait time (in days or hours) before retrying an
   update control process after a failed attempt.
 
-  -RO or -ResetOrder (Alias: -Reorder), when present, resets the execution
-  order of the given local files to match the order in which the update records
-  are provided for action -SL (-SetLocalFile). Local files can also be reordered
-  by explicitly providing order index values via Info option -XO (-ExecOrder).
-
   -SF or -ServerFile, specifies file names on remote servers when they differ
   from the remote file names.
 

{rda_python_dsupdt-2.0.11 → rda_python_dsupdt-2.0.13}/src/rda_python_dsupdt/pg_updt.py

@@ -66,7 +66,7 @@ class PgUpdt(PgOPT, PgCMD):
          'KR': [0, 'KeepRemote'],
          'KS': [0, 'KeepServer'],
          'LO': [0, 'LogOn'],
-         'MD': [0, 'PgDataset'],
+         'MD': [0, 'MyDataset'],
          'MO': [0, 'MissedOnly'],
          'MU': [0, 'MultipleUpdate'],
          'NC': [0, 'NewControl'],

{rda_python_dsupdt-2.0.11 → rda_python_dsupdt-2.0.13}/src/rda_python_dsupdt.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rda_python_dsupdt
-Version: 2.0.11
+Version: 2.0.13
 Summary: RDA Python Package to update RDA operational datasets
 Author-email: Zaihua Ji <zji@ucar.edu>
 Project-URL: Homepage, https://github.com/NCAR/rda-python-dsupdt
@@ -16,3 +16,5 @@ Requires-Dist: rda_python_dsarch
 Dynamic: license-file
 
 RDA python package to update RDA operational datasets.
+
+The user guide for this utility tool can be viewed at: [User guide](https://gdex-docs-dsupdt.readthedocs.io).

rda_python_dsupdt-2.0.11/README.md

@@ -1 +0,0 @@
-RDA python package to update RDA operational datasets.