rda-python-dsarch 2.0.16__py3-none-any.whl → 2.0.17__py3-none-any.whl

rda_python_dsarch/dsarch.py

@@ -4957,6 +4957,10 @@ def main():
    Instantiates DsArch, parses arguments via read_parameters(), executes the
    requested action via start_actions(), and exits cleanly.
    """
+   import sys
+   if os.path.basename(sys.argv[0]) == 'setuid_dsarch':
+      from rda_python_dsarch.dsarch_setup import main as setup_main
+      setup_main()
    object = DsArch()
    object.read_parameters()
    object.start_actions()

rda_python_dsarch/dsarch_setup.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+#
+##################################################################################
+#
+#     Title: dsarch-setup
+#    Author: Zaihua Ji, zji@ucar.edu
+#      Date: 2026-05-12
+#   Purpose: Display the setuid setup guide for dsarch after pip install.
+#            Run automatically when setuid_dsarch is invoked directly instead
+#            of through the dsarch -> pywrapper setuid symlink.
+#
+#    Github: https://github.com/NCAR/rda-python-dsarch.git
+#
+##################################################################################
+
+import os
+import sys
+
+
+SETUP_GUIDE = """
+ dsarch - Setuid Setup Guide
+ ===========================
+
+ dsarch must be run as the common user 'gdexdata' via the rda_python_setuid
+ mechanism.  rda_python_setuid is installed automatically as a dependency.
+
+ If you are seeing this message after running 'setuid_dsarch' directly, it
+ means the setuid wrapper has not been set up yet.  Follow the steps below.
+
+ Run 'pywrapper-install' with no arguments for the full pywrapper user guide.
+
+ Environment Setup
+ -----------------
+
+   Option A - Python venv (DECS machines):
+      python3 -m venv $ENVHOME    # e.g. /glade/u/home/gdexdata/gdexmsenv
+      source $ENVHOME/bin/activate
+      pip install rda_python_dsarch
+
+   Option B - Conda (DAV/Casper):
+      conda activate pg-gdex      # e.g. /glade/work/gdexdata/conda-envs/pg-gdex
+      pip install rda_python_dsarch
+
+ Full Setuid Install (requires sudo access to gdexdata)
+ ------------------------------------------------------
+
+   # Compile the pywrapper C binary (once per environment):
+   pywrapper-install --user gdexdata
+
+   # Wire up dsarch as a setuid entry:
+   pywrapper-install --link dsarch --user gdexdata
+
+ Simple Install (no sudo required, runs as current user)
+ -------------------------------------------------------
+
+   pywrapper-install --link dsarch --simple
+
+   This creates bin/dsarch -> bin/setuid_dsarch.
+   The program runs as the current user with no privilege change.
+
+"""
+
+
+def main():
+   print(SETUP_GUIDE)
+   sys.exit(0)
+
+
+if __name__ == '__main__': main()

rda_python_dsarch-2.0.17.dist-info/METADATA

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: rda_python_dsarch
+Version: 2.0.17
+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
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rda_python_common
+Requires-Dist: rda_python_setuid
+Requires-Dist: rda_python_miscs
+Dynamic: license-file
+
+# dsarch
+
+Python project to archive and maintain datasets for the [NSF NCAR Geoscience Data Exchange (GDEX)](https://gdex.ucar.edu).
+
+The user guide for this utility tool can be viewed at: [User guide](https://gdex-docs-dsarch.readthedocs.io).
+
+## Setuid Setup
+
+`dsarch` is executed as the common user `gdexdata` via the `rda_python_setuid`
+setuid mechanism.  `rda_python_setuid` is declared as a dependency and is
+installed automatically with this package.
+
+### Environment setup
+
+#### Option A — Python venv (DECS machines)
+
+```bash
+python3 -m venv $ENVHOME          # e.g. /glade/u/home/gdexdata/gdexmsenv
+source $ENVHOME/bin/activate
+pip install rda_python_dsarch
+```
+
+#### Option B — Conda (DAV/Casper)
+
+```bash
+conda activate pg-gdex            # e.g. /glade/work/gdexdata/conda-envs/pg-gdex
+pip install rda_python_dsarch
+```
+
+### Full setuid install (requires sudo access to gdexdata)
+
+Run these steps once per environment after `pip install`:
+
+```bash
+# Compile the pywrapper C binary (once per environment):
+pywrapper-install --user gdexdata
+
+# Wire up dsarch as a setuid entry:
+pywrapper-install --link dsarch --user gdexdata
+```
+
+`pywrapper-install` with no arguments displays the full user guide.
+
+### Simple install (no sudo required, runs as current user)
+
+Users who do not need the setuid mechanism can create a direct symlink instead:
+
+```bash
+pywrapper-install --link dsarch --simple
+```
+
+This creates `bin/dsarch -> bin/setuid_dsarch` and the program runs as the
+current user with no privilege change.
+
+### Setup guide
+
+After `pip install`, run `dsarch-setup` at any time to display the setup guide:
+
+```bash
+dsarch-setup
+```
+
+The guide is also shown automatically if `setuid_dsarch` is invoked directly
+before the setuid wrapper has been configured.

{rda_python_dsarch-2.0.16.dist-info → rda_python_dsarch-2.0.17.dist-info}/RECORD

@@ -2,13 +2,14 @@ rda_python_dsarch/PgArch.py,sha256=d1Y87MT49tgQygLAffNff9Qs4c12KXspYyDG8liSnpQ,5
 rda_python_dsarch/PgMeta.py,sha256=FV4GytgnJK00FUlyM6iHqpNd7-XTVHO1j5tZtcLTWgY,26845
 rda_python_dsarch/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 rda_python_dsarch/ds_arch.py,sha256=6bR0y6_rhIXyvbuYd-oZfL1YcaHhWBkojjzYz1yCrVg,233810
-rda_python_dsarch/dsarch.py,sha256=d0fHTYcCkTFQRJ3uA0_LyATew0M9tyL-99E7R0eDTtI,255211
+rda_python_dsarch/dsarch.py,sha256=NEConPE8kIPGoEsmPjBdpeYqZW8p-OKMD1W8rxLO4Io,255368
 rda_python_dsarch/dsarch.usg,sha256=w26gjVm5BYZAX9h_6vHsDvFR6bLVeLFmWa4R7ROd-X4,105687
+rda_python_dsarch/dsarch_setup.py,sha256=r69zh1pcRwYH9ka6_-oMX5IioDI7tFsGlcvnFRmXgh4,2092
 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-2.0.16.dist-info/licenses/LICENSE,sha256=1dck4EAQwv8QweDWCXDx-4Or0S8YwiCstaso_H57Pno,1097
-rda_python_dsarch-2.0.16.dist-info/METADATA,sha256=ZafAGoh2SGdmQCjpo-_8eftoSu1HNciKU5e3SKGgSRg,858
-rda_python_dsarch-2.0.16.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-rda_python_dsarch-2.0.16.dist-info/entry_points.txt,sha256=GR7ShgBv8qixS2l4ufAu-jw3N09pbo9zRewwPHqaOxo,60
-rda_python_dsarch-2.0.16.dist-info/top_level.txt,sha256=-vwcMgUXbBdHscvAKB3De9zKac3m_s_FaKIdApP1FGY,18
-rda_python_dsarch-2.0.16.dist-info/RECORD,,
+rda_python_dsarch-2.0.17.dist-info/licenses/LICENSE,sha256=1dck4EAQwv8QweDWCXDx-4Or0S8YwiCstaso_H57Pno,1097
+rda_python_dsarch-2.0.17.dist-info/METADATA,sha256=iiYib_f0_sbl7DQb2NU-aW28NoIHnnZQd1O_x0OXQOY,2419
+rda_python_dsarch-2.0.17.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rda_python_dsarch-2.0.17.dist-info/entry_points.txt,sha256=9P6XioifNVKguvlnW716G1HP0Oloezo6ZWPOa_pVwZQ,115
+rda_python_dsarch-2.0.17.dist-info/top_level.txt,sha256=-vwcMgUXbBdHscvAKB3De9zKac3m_s_FaKIdApP1FGY,18
+rda_python_dsarch-2.0.17.dist-info/RECORD,,

rda_python_dsarch-2.0.17.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+dsarch-setup = rda_python_dsarch.dsarch_setup:main
+setuid_dsarch = rda_python_dsarch.dsarch:main

rda_python_dsarch-2.0.16.dist-info/METADATA

@@ -1,22 +0,0 @@
-Metadata-Version: 2.4
-Name: rda_python_dsarch
-Version: 2.0.16
-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
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rda_python_common
-Requires-Dist: rda_python_setuid
-Dynamic: license-file
-
-# dsarch
-
-Python project to archive and maintain datasets for the [NSF NCAR Geoscience Data Exchange (GDEX)](https://gdex.ucar.edu).
-
-The user guide for this utility tool can be viewed at: [User guide](https://gdex-docs-dsarch.readthedocs.io).

rda_python_dsarch-2.0.16.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-dsarch.py = rda_python_dsarch.dsarch:main