rda-python-dsarch 3.0.0__py3-none-any.whl → 3.0.2__py3-none-any.whl

rda_python_dsarch/dsarch.usg

@@ -11,6 +11,14 @@ reference. Files can be organized into nested sub-products called groups.
 Any metadata stored in GDEXDB can also be retrieved or updated through
 'dsarch'.
 
+By default, 'dsarch' runs as the common user (default 'gdexdata') through
+the rda_python_setuid setuid mechanism, so that data files are archived and
+owned under the common user, and all GDEXDB records are written as the
+common user, regardless of which specialist invokes the command. 'dsarch'
+can also be executed directly as an individual specialist without the
+setuid mechanism, in which case archived files are owned by that
+specialist.
+
 A few terms used throughout this document:
   GDEX       - Geoscience Data Exchange, NCAR's data publication platform
   GDEXDB     - the metadata database backing GDEX
@@ -89,6 +97,16 @@ Only Web data files are placed under DOI/Version control. Saved data
 staged on disk for internal use or NCAR user access is not version-
 controlled and remains the responsibility of the dataset owner.
 
+This user guide is generated from this file. Opening a pull request that
+modifies it in the GitHub repository https://github.com/NCAR/rda-python-dsarch
+triggers an automated workflow that converts it into the RST source files,
+syncs the rda_python_dsarch version into the documentation, and opens a new
+pull request for review in the GitHub repository
+https://github.com/NCAR/gdex-docs-dsarch. Merging that pull request
+publishes the content as the 'latest' version at
+https://gdex-docs-dsarch.readthedocs.io, and creating a GitHub release
+there publishes it as the 'stable' version.
+
 This document first covers general 'dsarch' usage, then describes each
 Action option in detail, followed by Mode and Information (Info for
 short) options. Examples are provided throughout each section.

{rda_python_dsarch-3.0.0.dist-info → rda_python_dsarch-3.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rda_python_dsarch
-Version: 3.0.0
+Version: 3.0.2
 Summary: RDA Python package for utility program dsarch archive RDA data
 Author-email: Zaihua Ji <zji@ucar.edu>
 Project-URL: Homepage, https://github.com/NCAR/rda-python-dsarch
@@ -118,6 +118,11 @@ pip install rda_python_dsarch
 in automatically as a dependency.  After `pip install` above, choose one
 of the wiring options below.
 
+> **Note:** If `rda_python_setuid` is already installed and fully set up in
+> your environment, you can skip the compile step (`-c/--compile`) and the
+> optional `pgstart` step (`-p/--pgstart`).  The `-l/--link` step is still
+> required to wire up this package's own setuid program.
+
 ### Full setuid install (requires sudo access to COMMONUSER)
 
 Run these steps once per environment:
@@ -167,12 +172,21 @@ invoked directly before the setuid wrapper has been configured.
 
 ## Documentation sync
 
-The user guide rendered at
+The user guide at
 [gdex-docs-dsarch.readthedocs.io](https://gdex-docs-dsarch.readthedocs.io) is
-generated from `src/rda_python_dsarch/dsarch.usg` in this repository.  When a
-pull request that modifies `dsarch.usg` is merged here, an automated workflow
-converts the updated `dsarch.usg` into the RST-format source files in the
-[gdex-docs-dsarch](https://github.com/NCAR/gdex-docs-dsarch) repository and
-opens a pull request there with the regenerated docs, ready for review and
-merge.  No manual RST editing is required — keep all user-facing content in
-`dsarch.usg` and let the sync produce the docs.
+generated from `src/rda_python_dsarch/dsarch.usg`.  Keep all user-facing content
+in `dsarch.usg` — no manual RST editing is required.
+
+When a pull request modifying `dsarch.usg` is opened, an automated workflow
+converts it into RST source files and the version number from this repository's
+`pyproject.toml` into the
+[gdex-docs-dsarch](https://github.com/NCAR/gdex-docs-dsarch) repository, then
+opens a pull request from `automated-update-branch` against its `main` branch for
+review.
+
+To publish to Read the Docs:
+
+- **Merge** that pull request into `main` to serve the content as the `latest`
+  version.
+- **Create a GitHub release** in `gdex-docs-dsarch` to serve the latest release
+  as the `stable` version.

{rda_python_dsarch-3.0.0.dist-info → rda_python_dsarch-3.0.2.dist-info}/RECORD

@@ -3,12 +3,12 @@ rda_python_dsarch/PgMeta.py,sha256=FV4GytgnJK00FUlyM6iHqpNd7-XTVHO1j5tZtcLTWgY,2
 rda_python_dsarch/__init__.py,sha256=Y-s3WV6vKvLYuMy6oy0FB9DYNVaiEaSjZVJYBMVlD_8,812
 rda_python_dsarch/ds_arch.py,sha256=6bR0y6_rhIXyvbuYd-oZfL1YcaHhWBkojjzYz1yCrVg,233810
 rda_python_dsarch/dsarch.py,sha256=wQZS-mI4vyc7GDKOMl--_wQejx4_Wa77hegF_9deZX8,255105
-rda_python_dsarch/dsarch.usg,sha256=w26gjVm5BYZAX9h_6vHsDvFR6bLVeLFmWa4R7ROd-X4,105687
+rda_python_dsarch/dsarch.usg,sha256=VWNqPYiALbglTWpQ0eWSE6TpVSjl8Xzl6MjoWZPTSAs,106715
 rda_python_dsarch/pg_arch.py,sha256=0mZGlQT9ecJr-92dloXDNtwF8EnPnY76IGLksqYsyYo,81057
 rda_python_dsarch/pg_meta.py,sha256=FFEkphGAT--66zvMNDPfiFG4nZQpXed_yVGMARdZb-o,46981
-rda_python_dsarch-3.0.0.dist-info/licenses/LICENSE,sha256=1dck4EAQwv8QweDWCXDx-4Or0S8YwiCstaso_H57Pno,1097
-rda_python_dsarch-3.0.0.dist-info/METADATA,sha256=70_sxUjVrfPEjWFyYPkP6a4aG5LErvGzRVeHsurWBEo,6682
-rda_python_dsarch-3.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-rda_python_dsarch-3.0.0.dist-info/entry_points.txt,sha256=BA1iRAFIZExG0656Ri9f-_OKlSK31CuABWPQSsA9MsI,64
-rda_python_dsarch-3.0.0.dist-info/top_level.txt,sha256=-vwcMgUXbBdHscvAKB3De9zKac3m_s_FaKIdApP1FGY,18
-rda_python_dsarch-3.0.0.dist-info/RECORD,,
+rda_python_dsarch-3.0.2.dist-info/licenses/LICENSE,sha256=1dck4EAQwv8QweDWCXDx-4Or0S8YwiCstaso_H57Pno,1097
+rda_python_dsarch-3.0.2.dist-info/METADATA,sha256=M64SImUspzEEA1GPDt1PbeAk7xdDkzFiioCe6t6rti0,7165
+rda_python_dsarch-3.0.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rda_python_dsarch-3.0.2.dist-info/entry_points.txt,sha256=BA1iRAFIZExG0656Ri9f-_OKlSK31CuABWPQSsA9MsI,64
+rda_python_dsarch-3.0.2.dist-info/top_level.txt,sha256=-vwcMgUXbBdHscvAKB3De9zKac3m_s_FaKIdApP1FGY,18
+rda_python_dsarch-3.0.2.dist-info/RECORD,,