Repository: rucio/rucio

Issue:
Update concepts & terminology section of the documentation
Motivation
----------
Update concepts & terminology section of the documentation

- [x] Rucio account
- [x] Files, Datasets and Containers
- [x] Rucio Storage Element
- [x] Meta-data attributes
- [x] Permission model
- [x] Replica management
- [x] Replication rule examples
- [x] RSE Expressions
- [x] Accounting and quota
- [x] Notifications
- [x] Subscriptions / Policies
Add auto-generated CLIs documentation for the daemons
Motivation
----------
Add auto-generated CLIs documentation for the daemons

Modification
------------
-- Function to get parser
-- consistent headers


Discussion:

Resolving patch:
diff --git a/lib/rucio/common/dumper/__init__.py b/lib/rucio/common/dumper/__init__.py
--- a/lib/rucio/common/dumper/__init__.py
+++ b/lib/rucio/common/dumper/__init__.py
@@ -1,17 +1,24 @@
-'''
- Copyright European Organization for Nuclear Research (CERN)
-
- Licensed under the Apache License, Version 2.0 (the "License");
- You may not use this file except in compliance with the License.
- You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
-
- Authors:
- - Fernando Lopez, <felopez@cern.ch>, 2015
- - Cedric Serfon, <cedric.serfon@cern.ch>, 2016
- - Mario Lassnig, <mario.lassnig@cern.ch>, 2017
-'''
+# Copyright 2012-2018 CERN for the benefit of the ATLAS collaboration.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Authors:
+# - Fernando Lopez <felopez@cern.ch>, 2015
+# - Cedric Serfon <cedric.serfon@cern.ch>, 2016
+# - Mario Lassnig <mario.lassnig@cern.ch>, 2017-2018
 
 from rucio.common import config
+
 import contextlib
 import datetime
 import gzip
@@ -28,7 +35,7 @@
     import gfal2
     from gfal2 import GError
 except ImportError as e:
-    if 'nose' not in sys.modules and 'py.test' not in sys.modules:
+    if 'nose' not in sys.modules and 'py.test' not in sys.modules and 'sphinx' not in sys.modules:
         raise e
 
 # bz2 module doesn't support multi-stream files in Python < 3.3
diff --git a/lib/rucio/daemons/auditor/srmdumps.py b/lib/rucio/daemons/auditor/srmdumps.py
--- a/lib/rucio/daemons/auditor/srmdumps.py
+++ b/lib/rucio/daemons/auditor/srmdumps.py
@@ -1,18 +1,25 @@
-'''
- Copyright European Organization for Nuclear Research (CERN)
-
- Licensed under the Apache License, Version 2.0 (the "License");
- You may not use this file except in compliance with the License.
- You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
-
- Authors:
- - Fernando Lopez, <felopez@cern.ch>, 2015
- - Mario Lassnig, <mario.lassnig@cern.ch>, 2017
-'''
+# Copyright 2012-2018 CERN for the benefit of the ATLAS collaboration.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Authors:
+# - Fernando Lopez <felopez@cern.ch>, 2015
+# - Mario Lassnig <mario.lassnig@cern.ch>, 2017-2018
 
 from rucio.common.config import __CONFIGFILES as __RUCIOCONFIGFILES
 from rucio.common.dumper import DUMPS_CACHE_DIR
 from rucio.common.dumper import http_download_to_file, srm_download_to_file, ddmendpoint_url, temp_file
+
 import ConfigParser
 import HTMLParser
 import datetime
@@ -26,10 +33,10 @@
 
 try:
     import gfal2
-except ImportError:
+except ImportError as e:
     import sys
-    if 'nose' not in sys.modules and 'py.test' not in sys.modules:
-        raise
+    if 'nose' not in sys.modules and 'py.test' not in sys.modules and 'sphinx' not in sys.modules:
+        raise e
 
 CHUNK_SIZE = 10485760
 


Test patch: