datastock 0.0.49__py3-none-any.whl → 0.0.50__py3-none-any.whl

datastock/__init__.py

@@ -1,10 +1,31 @@
+# ###############
+# __version__
+# ###############
 
 
-from .version import __version__
+from . import _version
+__version__ = _version.version
+__version_tuple__ = _version.version_tuple
+
+
+# from setuptools_scm import get_version
+# __version__ = get_version(root='..', relative_to=__file__)
+
+
+# from importlib.metadata import version
+# __version__ = version(__package__)
+# cleanup
+# del get_version
+
+
+# ###############
+# sub-packages
+# ###############
+
 
 from . import _generic_check
 from ._generic_utils_plot import *
 from ._class import DataStock
 from ._saveload import load, get_files
 from ._direct_calls import *
-from . import tests
+from . import tests

datastock/_version.py

@@ -0,0 +1,21 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = ["__version__", "__version_tuple__", "version", "version_tuple"]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '0.0.50'
+__version_tuple__ = version_tuple = (0, 0, 50)

datastock/tests/prepublish.py

@@ -0,0 +1,3 @@
+print('test import datastock')
+import datastock as ds
+print('import datastock ok')

datastock/version.py

@@ -1,2 +1,2 @@
 # Do not edit, pipeline versioning governed by git tags!
-__version__ = '0.0.49'
+__version__ = '0.0.49-1-g545b8a4'

{datastock-0.0.49.dist-info → datastock-0.0.50.dist-info}/METADATA

@@ -1,33 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: datastock
-Version: 0.0.49
+Version: 0.0.50
 Summary: Generic handler for multiple heterogenous numpy arrays and subclasses
-Home-page: https://github.com/ToFuProject/datastock
-Author: Didier VEZINET
 Author-email: Didier VEZINET <didier.vezinet@gmail.com>
 Maintainer-email: Didier VEZINET <didier.vezinet@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2022 ToFuProject
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
+License: MIT
+Project-URL: Homepage, https://github.com/ToFuProject/datastock
+Project-URL: Issues, https://github.com/ToFuProject/datastock/issues
 Keywords: data,analysis,interactive,heterogeneous arrays,numpy,Collection
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Science/Research
@@ -38,24 +17,20 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.6
+Classifier: Natural Language :: English
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-License-File: LICENSE
+License-File: LICENSE.txt
 Requires-Dist: numpy
 Requires-Dist: scipy
 Requires-Dist: matplotlib
+Requires-Dist: PyQt5; platform_system != "Windows"
 Requires-Dist: astropy
-Provides-Extra: dev
-Requires-Dist: check-manifest; extra == "dev"
-Requires-Dist: coverage; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: sphinx; extra == "dev"
-Requires-Dist: sphinx-gallery; extra == "dev"
-Requires-Dist: sphinx-bootstrap-theme; extra == "dev"
-Provides-Extra: formatting
-Requires-Dist: ruff; extra == "formatting"
 Provides-Extra: linting
 Requires-Dist: ruff; extra == "linting"
+Provides-Extra: formatting
+Requires-Dist: ruff; extra == "formatting"
+Dynamic: license-file
 
 [![Conda]( https://anaconda.org/conda-forge/datastock/badges/version.svg)](https://anaconda.org/conda-forge/datastock)
 [![](https://anaconda.org/conda-forge/datastock/badges/downloads.svg)](https://anaconda.org/conda-forge/datastock)
@@ -100,15 +75,15 @@ Examples:
 Straightforward array visualization:
 ------------------------------------
 
-```
+``
 import datastock as ds
 
 # any 1d, 2d or 3d array
-aa = np.np.random.random((100, 100, 100))
+aa = np.random((100, 100, 100))
 
 # plot interactive figure using shortcut to method
 dax = ds.plot_as_array(aa)
-```
+``
 
 Now do **shift + left clic** on any axes, the rest of the interactive commands are automatically printed in your python console
 
@@ -134,7 +109,7 @@ Thanks to dref, the class knows the relationaships between all numpy arrays.
 In particular it knows which arrays share the same references / dimensions
 
 
-```
+```python
 import numpy as np
 import datastock as ds
 
@@ -155,24 +130,24 @@ lprof = [(1 + np.cos(t)[:, None]) * x[None, :] for t in lt]
 # Populate DataStock
 
 # instanciate 
-st = ds.DataStock()
+coll = ds.DataStock()
 
 # add references (i.e.: store size of each dimension under a unique key)
-st.add_ref(key='nc', size=nc)
-st.add_ref(key='nx', size=nx)
+coll.add_ref(key='nc', size=nc)
+coll.add_ref(key='nx', size=nx)
 for ii, nt in enumerate(lnt):
-    st.add_ref(key=f'nt{ii}', size=nt)
+    coll.add_ref(key=f'nt{ii}', size=nt)
 
 # add data dependening on these references
 # you can, optionally, specify units, physical dimensionality (ex: distance, time...), quantity (ex: radius, height, ...) and name (to your liking)
 
-st.add_data(key='x', data=x, dimension='distance', quant='radius', units='m', ref='nx')
+coll.add_data(key='x', data=x, dimension='distance', quant='radius', units='m', ref='nx')
 for ii, nt in enumerate(lnt):
-    st.add_data(key=f't{ii}', data=lt[ii], dimension='time', units='s', ref=f'nt{ii}')
-    st.add_data(key=f'prof{ii}', data=lprof[ii], dimension='velocity', units='m/s', ref=(f'nt{ii}', 'x'))
+    coll.add_data(key=f't{ii}', data=lt[ii], dimension='time', units='s', ref=f'nt{ii}')
+    coll.add_data(key=f'prof{ii}', data=lprof[ii], dimension='velocity', units='m/s', ref=(f'nt{ii}', 'x'))
 
 # print in the console the content of st
-st
+coll
 ```
 
 <p align="center">
@@ -183,22 +158,22 @@ You can see that DataStock stores the relationships between each array and each
 Specifying explicitly the references is only necessary if there is an ambiguity (i.e.: several references have the same size, like nx and nt2 in our case)
 
 
-```
+``
 # plot any array interactively
-dax = st.plot_as_array('x')
-dax = st.plot_as_array('t0')
-dax = st.plot_as_array('prof0')
-dax = st.plot_as_array('prof0', keyX='t0', keyY='x', aspect='auto')
-```
+dax = coll.plot_as_array('x')
+dax = coll.plot_as_array('t0')
+dax = coll.plot_as_array('prof0')
+dax = coll.plot_as_array('prof0', keyX='t0', keyY='x', aspect='auto')
+``
 
 You can then decide to store any object category
 Let's create a 'campaign' category to store the characteristics of each measurements campaign
 and let's add a 'campaign' parameter to each profile data
 
-```
+``
 # add arbitrary object category as sub-dict of self.dobj
 for ii in range(nc):
-    st.add_obj(
+    coll.add_obj(
         which='campaign',
 	    key=f'c{ii}',
         start_date=f'{ii}.04.2022',
@@ -209,16 +184,16 @@ for ii in range(nc):
     )
 
 # create new 'campaign' parameter for data arrays
-st.add_param('campaign', which='data')
+coll.add_param('campaign', which='data')
 
 # tag each data with its campaign
 for ii in range(nc):
-    st.set_param(which='data', key=f't{ii}', param='campaign', value=f'c{ii}')	
-    st.set_param(which='data', key=f'prof{ii}', param='campaign', value=f'c{ii}')	
+    coll.set_param(which='data', key=f't{ii}', param='campaign', value=f'c{ii}')	
+    coll.set_param(which='data', key=f'prof{ii}', param='campaign', value=f'c{ii}')	
 
 # print in the console the content of st
-st
-```
+coll
+``
 
 <p align="center">
 <img align="middle" src="https://github.com/ToFuProject/datastock/blob/devel/README_figures/DataStock_Obj.png" width="600" alt="Direct 3d array visualization"/>
@@ -227,31 +202,31 @@ st
 DataStock also provides built-in object selection method to allow return all
 objects matching a criterion, as lits of int indices, bool indices or keys.
 
-```
-In [9]: st.select(which='campaign', index=2, returnas=int)
+``
+In [9]: coll.select(which='campaign', index=2, returnas=int)
 Out[9]: array([2])
 
 # list of 2 => return all matches inside the interval
-In [10]: st.select(which='campaign', index=[2, 4], returnas=int)
+In [10]: coll.select(which='campaign', index=[2, 4], returnas=int)
 Out[10]: array([2, 3, 4])
 
 # tuple of 2 => return all matches outside the interval
-In [11]: st.select(which='campaign', index=(2, 4), returnas=int)
+In [11]: coll.select(which='campaign', index=(2, 4), returnas=int)
 Out[11]: array([0, 1])
 
 # return as keys
-In [12]: st.select(which='campaign', index=(2, 4), returnas=str)
+In [12]: coll.select(which='campaign', index=(2, 4), returnas=str)
 Out[12]: array(['c0', 'c1'], dtype='<U2')
 
 # return as bool indices
-In [13]: st.select(which='campaign', index=(2, 4), returnas=bool)
+In [13]: coll.select(which='campaign', index=(2, 4), returnas=bool)
 Out[13]: array([ True,  True, False, False, False])
 
 # You can combine as many constraints as needed
-In [17]: st.select(which='campaign', index=[2, 4], operator='Barnaby', returnas=str)
+In [17]: coll.select(which='campaign', index=[2, 4], operator='Barnaby', returnas=str)
 Out[17]: array(['c3', 'c4'], dtype='<U2')
 
-```
+``
 
 You can also decide to sub-class DataStock to implement methods and visualizations specific to your needs
 
@@ -264,6 +239,6 @@ DataStock provides built-in methods like:
     - size is the total size of all data stored in the instance in bytes
     - dsize is a dict with the detail (size for each item in each sub-dict of the instance)
 * `save()`: will save the instance
-* `ds.load()`: will load a saved instance
+* `coll.load()`: will load a saved instance
 
 

{datastock-0.0.49.dist-info → datastock-0.0.50.dist-info}/RECORD

@@ -1,6 +1,5 @@
-_updateversion.py,sha256=OR6OJJozaHWzu7NWjKu5ERi0IyYqR61KrWvzf7kfoto,951
 datastock/_DataCollection_utils.py,sha256=hHf6HvGKMmM-psx3fj9QcY1TEmKrAtTdkRokH7SFqoo,7143
-datastock/__init__.py,sha256=i_Ijl-AM07n4zN52frWfbeGN1iB6v4e5oLzTuVIh_oM,217
+datastock/__init__.py,sha256=LLPm4DAkXl5xYAQT4jUfQd5ZAmYx5w2nBSBmjN2XhdE,598
 datastock/_class.py,sha256=Az9PS3aSskiPMb1ekt78Y2ynBujYVc_cDjJxW9xH9g4,47
 datastock/_class0.py,sha256=je4ckTynK8lEGBa7OSURYZZ_-3XjzAtf6SazN3b-f5k,6028
 datastock/_class1.py,sha256=2PrIT26yRfNrP6YmZMpvb0_b0v_397Y9tOjzeVOxK_I,29313
@@ -32,17 +31,15 @@ datastock/_plot_correlations.py,sha256=ITOypu_AEoKl0ihxocV-JVTXIHqut6p9TfG-xZmQy
 datastock/_plot_old_backup.py,sha256=XixTi2CiihKjtQP0TRycH0b25caWN1m35DgpsDeiWZE,21729
 datastock/_plot_text.py,sha256=wQPqjfpLyIioS2JeOt3E9C9HgYUJ49YEoOgRuKYvAR8,3143
 datastock/_saveload.py,sha256=1vAMp27KfqXbo5b_Pi8hJux0stsHq6dO5vy8k1d4_iA,14141
-datastock/version.py,sha256=3LGOrbR0FKVCMYF5gFB0Z3jb_YfYLLDyuMY0M-oeJrU,80
+datastock/_version.py,sha256=E35Bq14aHx0dG_mA8HPiJoVRTCMU_V3unyyjRET8Kww,513
+datastock/version.py,sha256=VJcnSK0zygwEhh_p6KIoC9yiMkp0bs-SJgLCbyubs9o,91
 datastock/tests/__init__.py,sha256=teOo2xP0IO7PQMuMDmum61XVHe2TuxW3BiHiL73X8jQ,35
+datastock/tests/prepublish.py,sha256=3gSr3nRhEl5qsmhxJ-nEoePvbINYq0EvcZCfxfUVHBM,83
 datastock/tests/test_01_DataStock.py,sha256=aUseXH2zYnFtNDJSCuEROgPxfKKNeLCkCQSR--_Fheg,19176
 datastock/tests/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scripts/_bash_version.py,sha256=B-NJPgjuqGiXVVUEBJDHP4uDc5yBDFvBX2mmvL2T4E0,1837
-scripts/_dparser.py,sha256=TvJ4ZWbOX0sN8Xqa-IRhcqtyOIIewRTkeb-OE0vXWbs,2755
-scripts/main.py,sha256=JrRRQK3BCnepBa0RMsG3OtpMCoVRo_RcElMScPcbvF4,3530
-datastock-0.0.49.dist-info/LICENSE,sha256=V1uXqi3vxR0QhB4QdFyjkynl6jpN4wZmlB5EMYJk0NM,1068
-datastock-0.0.49.dist-info/METADATA,sha256=KVm2w4WDF--bfwCyc8TaKyn_5vvc45wReU07WuhnkVY,10197
-datastock-0.0.49.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-datastock-0.0.49.dist-info/entry_points.txt,sha256=GqmxVVp9G2ulEDaS9gLpwSVOBLF_FEBlj8k5Z6TJKsc,42
-datastock-0.0.49.dist-info/top_level.txt,sha256=4mahLJQfvNnKq213ODWrMXeNzyoyjzRRke_OAw07iA8,33
-datastock-0.0.49.dist-info/RECORD,,
+datastock-0.0.50.dist-info/licenses/LICENSE.txt,sha256=SM-QOA3JwR1e0RVBGb1HhPmc5yD1Gsl1CRPnMSKJhH8,1068
+datastock-0.0.50.dist-info/METADATA,sha256=FLc5tLiMeT7uqPs9_kNV3tZNALar_DErqHZeO0uql68,8893
+datastock-0.0.50.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+datastock-0.0.50.dist-info/entry_points.txt,sha256=GqmxVVp9G2ulEDaS9gLpwSVOBLF_FEBlj8k5Z6TJKsc,42
+datastock-0.0.50.dist-info/top_level.txt,sha256=0HeA0gZ4G1IKtkPhmqijZRYH9hID6LKLQskeSjAna8g,10
+datastock-0.0.50.dist-info/RECORD,,

{datastock-0.0.49.dist-info → datastock-0.0.50.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.45.1)
+Generator: setuptools (78.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

datastock-0.0.49.dist-info/LICENSE → datastock-0.0.50.dist-info/licenses/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 ToFuProject
+Copyright (c) 2023 ToFuProject
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

datastock-0.0.50.dist-info/top_level.txt

@@ -0,0 +1 @@
+datastock

_updateversion.py

@@ -1,32 +0,0 @@
-#!/usr/bin/env/python
-# coding=utf-8
-
-
-import os
-import subprocess
-
-
-_HERE = os.path.abspath(os.path.dirname(__file__))
-
-
-def updateversion(path=_HERE):
-
-    # Fetch version from git tags, and write to version.py
-    # Also, when git is not available (PyPi package), use stored version.py
-    version_py = os.path.join(path, 'datastock', 'version.py')
-    try:
-        version_git = subprocess.check_output(
-            ["git", "describe"]
-        ).rstrip().decode()
-
-    except subprocess.CalledProcessError:
-        with open(version_py, 'r') as fh:
-            version_git = fh.read().strip().split("=")[-1].replace("'", '')
-
-    version_git = version_git.lower().replace('v', '').replace(' ', '')
-
-    version_msg = "# Do not edit, pipeline versioning governed by git tags!"
-    with open(version_py, "w") as fh:
-        msg = "{0}__version__ = '{1}'{0}".format(os.linesep, version_git)
-        fh.write(version_msg + msg)
-    return version_git

datastock-0.0.49.dist-info/top_level.txt

@@ -1,3 +0,0 @@
-_updateversion
-datastock
-scripts

scripts/_bash_version.py

@@ -1,77 +0,0 @@
-#!/usr/bin/env python
-
-# Built-in
-import os
-
-
-###################################################
-###################################################
-#       DEFAULTS
-###################################################
-
-
-_PATH_HERE = os.path.dirname(__file__)
-
-
-###################################################
-###################################################
-#       function
-###################################################
-
-
-def main(
-    verb=None,
-    envvar=None,
-    path=None,
-    warn=None,
-    force=None,
-    ddef=None,
-):
-    """ Print version """
-
-    # --------------
-    # Check inputs
-    # --------------
-
-    kwd = locals()
-    for k0 in set(ddef.keys()).intersection(kwd.keys()):
-        if kwd[k0] is None:
-            kwd[k0] = ddef[k0]
-    verb, path = kwd['verb'], kwd['path']
-
-    # verb, warn, force
-    dbool = {'verb': verb}
-    for k0, v0 in dbool.items():
-        if v0 is None:
-            dbool[k0] = ddef[k0]
-        if not isinstance(dbool[k0], bool):
-            msg = (
-                f"Arg '{k0}' must be a bool\n"
-                f"\t- provided: {dbool[k0]}\n"
-            )
-            raise Exception(msg)
-
-    # --------------
-    # Fetch version from git tags, and write to version.py
-    # Also, when git is not available (PyPi package), use stored version.py
-
-    pfe = os.path.join(path, 'version.py')
-    if not os.path.isfile(pfe):
-        msg = (
-            "It seems your current install has no version.py:\n"
-            f"\t- looked for: {pfe}"
-        )
-        raise Exception(msg)
-
-    # --------------
-    # Read file
-
-    with open(pfe, 'r') as fh:
-        version = fh.read().strip().split("=")[-1].replace("'", '')
-    version = version.lower().replace('v', '').replace(' ', '')
-
-    # --------------
-    # Outputs
-
-    if dbool['verb'] is True:
-        print(version)

scripts/_dparser.py

@@ -1,109 +0,0 @@
-import sys
-import os
-import getpass
-import argparse
-
-
-# test if in a git repo
-_HERE = os.path.abspath(os.path.dirname(__file__))
-_REPOPATH = os.path.dirname(_HERE)
-_REPO_NAME = 'datastock'
-
-
-# #############################################################################
-#       utility functions
-# #############################################################################
-
-
-def _str2bool(v):
-    if isinstance(v, bool):
-        return v
-    elif v.lower() in ['yes', 'true', 'y', 't', '1']:
-        return True
-    elif v.lower() in ['no', 'false', 'n', 'f', '0']:
-        return False
-    else:
-        raise argparse.ArgumentTypeError('Boolean value expected!')
-
-
-def _str2boolstr(v):
-    if isinstance(v, bool):
-        return v
-    elif isinstance(v, str):
-        if v.lower() in ['yes', 'true', 'y', 't', '1']:
-            return True
-        elif v.lower() in ['no', 'false', 'n', 'f', '0']:
-            return False
-        elif v.lower() == 'none':
-            return None
-        else:
-            return v
-    else:
-        raise argparse.ArgumentTypeError('Boolean, None or str expected!')
-
-
-def _str2tlim(v):
-    c0 = (v.isdigit()
-          or ('.' in v
-              and len(v.split('.')) == 2
-              and all([vv.isdigit() for vv in v.split('.')])))
-    if c0 is True:
-        v = float(v)
-    elif v.lower() == 'none':
-        v = None
-    return v
-
-
-# #############################################################################
-#       Parser for version
-# #############################################################################
-
-
-def parser_version():
-    msg = f""" Get {_REPO_NAME} version from bash
-
-    If run from a git repo containing {_REPO_NAME}, just returns git describe
-    Otherwise reads the version stored in {_REPO_NAME}/version.py
-
-    """
-    ddef = {
-        'path': os.path.join(_REPOPATH, _REPO_NAME),
-        'envvar': False,
-        'verb': True,
-        'warn': True,
-        'force': False,
-        'name': f'{_REPO_NAME.upper()}_VERSION',
-    }
-
-    # Instanciate parser
-    parser = argparse.ArgumentParser(description=msg)
-
-    # optional path
-    parser.add_argument(
-        '-p', '--path',
-        type=str,
-        help='source directory where version.py is found',
-        required=False,
-        default=ddef['path'],
-    )
-
-    # verb
-    parser.add_argument(
-        '-v', '--verb',
-        type=_str2bool,
-        help='flag indicating whether to print the version',
-        required=False,
-        default=ddef['verb'],
-    )
-
-    return ddef, parser
-
-
-# #############################################################################
-#       Parser dict
-# #############################################################################
-
-
-_DPARSER = {
-    'version': parser_version,
-}

scripts/main.py

@@ -1,147 +0,0 @@
-#!/usr/bin/env python
-
-# Built-in
-import sys
-import os
-import argparse
-
-
-# import parser dicti
-from . import _dparser
-from . import _bash_version
-
-
-###################################################
-###################################################
-#       default values
-###################################################
-
-
-_PATH_HERE = os.path.abspath(os.path.dirname(__file__))
-
-
-_LOPTIONS = ['--version']
-_LOPSTRIP = [ss.strip('--') for ss in _LOPTIONS]
-
-
-###################################################
-###################################################
-#       function
-###################################################
-
-
-def datastock_bash(option=None, ddef=None, **kwdargs):
-    """ Print tofu version and / or store in environment variable """
-
-    # --------------
-    # Check inputs
-    # --------------
-
-    if option not in _LOPSTRIP:
-        msg = (
-            "Provided option is not acceptable:\n"
-            f"\t- available: {_LOPSTRIP}\n"
-            f"\t- provided:  {option}"
-        )
-        raise Exception(msg)
-
-    # --------------
-    # call corresponding bash command
-    # --------------
-
-    if option == 'version':
-        _bash_version.main(
-            ddef=ddef,
-            **kwdargs,
-        )
-
-
-###################################################
-###################################################
-#          main
-###################################################
-
-
-def main():
-    # Parse input arguments
-    msg = """ Get tofu version from bash optionally set an enviroment variable
-
-    If run from a git repo containing tofu, simply returns git describe
-    Otherwise reads the tofu version stored in tofu/version.py
-
-    """
-
-    # ------------------
-    # Instanciate parser
-    # ------------------
-
-    parser = argparse.ArgumentParser(description=msg)
-
-    # ---------------------
-    # which script to call
-    # ---------------------
-
-    parser.add_argument(
-        'option',
-        nargs='?',
-        type=str,
-        default='None',
-    )
-
-    #
-    parser.add_argument(
-        '-v', '--version',
-        help='get tofu current version',
-        required=False,
-        action='store_true',
-    )
-
-    # Others
-    # parser.add_argument('kwd', nargs='?', type=str, default='None')
-
-    # -------------------
-    # check options
-    # -------------------
-
-    if sys.argv[1] not in _LOPTIONS:
-        msg = (
-            "Provided option is not acceptable:\n"
-            f"\t- available: {_LOPTIONS}\n"
-            f"\t- provided:  {sys.argv[1]}\n"
-        )
-        raise Exception(msg)
-
-    if len(sys.argv) > 2:
-        if any([ss in sys.argv[2:] for ss in _LOPTIONS]):
-            lopt = [ss for ss in sys.argv[1:] if ss in _LOPTIONS]
-            msg = (
-                "Only one option can be provided!\n"
-                f"\t- provided: {lopt}"
-            )
-            raise Exception(msg)
-
-    # ----------------------
-    # def values and parser
-    # ----------------------
-
-    option = sys.argv[1].strip('--')
-    ddef, parser = _dparser._DPARSER[option]()
-    if len(sys.argv) > 2:
-        kwdargs = dict(parser.parse_args(sys.argv[2:])._get_kwargs())
-    else:
-        kwdargs = {}
-
-    # ----------------------
-    # Call function
-    # ----------------------
-
-    datastock_bash(option=option, ddef=ddef, **kwdargs)
-
-
-###################################################
-###################################################
-#                   __main__
-###################################################
-
-if __name__ == '__main__':
-    main()