Merge pull request #6755 from DIRACGridBot/cherry-pick-2-03ae65b4e-integration

[sweep:integration] COMDIRAC merge

Author: chrisburr

docs/docs.conf

@@ -164,3 +164,10 @@ sectionPath = source/UserGuide/CommandReference/%(title)s
 pattern = dirac-proxy, dirac-info, -resource-
 title = Others
 sectionPath = source/UserGuide/CommandReference/%(title)s
+
+[commands.comdirac]
+prefix = shorthand
+pattern = d
+exclude = dirac
+title = Shorthand
+sectionPath = source/UserGuide/CommandReference/%(title)s

docs/source/UserGuide/Tutorials/ShorthandCommands/index.rst

@@ -0,0 +1,36 @@
+==================
+Shorthand Commands
+==================
+
+These commands are aimed at frequest users of a DIRAC UI, especially if you experience latency issues, as this setup offers a caching mechanism.
+They do require some initial setup.
+
+#. Setting up your default
+
+You only need to do this once.
+
+    $ source diracos/diracosrc
+    $ dirac-proxy-init -g [your DIRAC group]
+    $ dconfig --minimal
+
+This will create a skeleton config file in ``~/.dirac/dcommands.conf``
+Now edit the configuration file using your details. If you are a member of more than one VO, you might want to setup different profiles for each.
+
+    [global]
+    default_profile = my_dirac_group
+
+    [my_dirac_group]
+    group_name = my_dirac_group
+    home_dir = /my_dirac_group/user/m/mydir
+    default_se = MYHOME-SE-disk
+
+
+#. Session Initialization
+
+You need to do this for every session.
+
+    $ source diracos/diracosrc
+    $ dinit
+
+Now you are set up to use the DIRAC short commands. For a full list of what is available,
+please see the :ref:`commands_reference` section.

docs/source/UserGuide/Tutorials/index.rst

@@ -12,3 +12,4 @@ Tutorials
    FileCatalogBasic/index
    JobManagementAdvanced/index
    UsingDIRACFromPython/index
+   ShorthandCommands/index

docs/source/UserGuide/commands.rst

@@ -1,12 +1,19 @@
+.. _commands_reference:
+
 ==================
 Commands Reference
 ==================
 
-This page is the work in progress. See more material here soon !
+This page is the work in progress.
+
+The shorthand section contains short commands specifically developed for the interactive use of a DIRAC UI.
+To be able to use these commands, please check the :ref:`shorthand_cmd` section for an
+introduction and initial setup.
 
 .. toctree::
    :maxdepth: 1
 
    CommandReference/DataManagement/index
    CommandReference/WorkloadManagement/index
    CommandReference/Others/index
+   CommandReference/Shorthand/index

setup.cfg

@@ -234,6 +234,31 @@ console_scripts =
     dirac-wms-job-submit = DIRAC.Interfaces.scripts.dirac_wms_job_submit:main
     dirac-wms-jobs-select-output-search = DIRAC.Interfaces.scripts.dirac_wms_jobs_select_output_search:main
     dirac-wms-select-jobs = DIRAC.Interfaces.scripts.dirac_wms_select_jobs:main
+    dcd = DIRAC.Interfaces.scripts.dcd:main
+    dchgrp = DIRAC.Interfaces.scripts.dchgrp:main
+    dchmod = DIRAC.Interfaces.scripts.dchmod:main
+    dchown = DIRAC.Interfaces.scripts.dchown:main
+    dconfig = DIRAC.Interfaces.scripts.dconfig:main
+    dfind = DIRAC.Interfaces.scripts.dfind:main
+    dget = DIRAC.Interfaces.scripts.dget:main
+    dgetenv = DIRAC.Interfaces.scripts.dgetenv:main
+    dinit = DIRAC.Interfaces.scripts.dinit:main
+    dinput = DIRAC.Interfaces.scripts.dinput:main
+    dkill = DIRAC.Interfaces.scripts.dkill:main
+    dlogging = DIRAC.Interfaces.scripts.dlogging:main
+    dls = DIRAC.Interfaces.scripts.dls:main
+    dmeta = DIRAC.Interfaces.scripts.dmeta:main
+    dmkdir = DIRAC.Interfaces.scripts.dmkdir:main
+    doutput = DIRAC.Interfaces.scripts.doutput:main
+    dput = DIRAC.Interfaces.scripts.dput:main
+    dpwd = DIRAC.Interfaces.scripts.dpwd:main
+    drepl = DIRAC.Interfaces.scripts.drepl:main
+    dreplicas = DIRAC.Interfaces.scripts.dreplicas:main
+    drm = DIRAC.Interfaces.scripts.drm:main
+    drmdir = DIRAC.Interfaces.scripts.drmdir:main
+    dsize = DIRAC.Interfaces.scripts.dsize:main
+    dstat = DIRAC.Interfaces.scripts.dstat:main
+    dsub = DIRAC.Interfaces.scripts.dsub:main
     # ProductionSystem
     dirac-prod-add-trans = DIRAC.ProductionSystem.scripts.dirac_prod_add_trans:main [admin]
     dirac-prod-complete = DIRAC.ProductionSystem.scripts.dirac_prod_complete:main [admin]