anemoi-datasets 0.2.1__tar.gz → 0.3.1__tar.gz

{anemoi_datasets-0.2.1 → anemoi_datasets-0.3.1}/.pre-commit-config.yaml

@@ -13,19 +13,19 @@ repos:
 
 
 - repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v4.4.0
+  rev: v4.6.0
   hooks:
   - id: check-yaml # Check YAML files for syntax errors only
     args: [--unsafe, --allow-multiple-documents]
   - id: debug-statements # Check for debugger imports and py37+ breakpoint()
   - id: end-of-file-fixer # Ensure files end in a newline
   - id: trailing-whitespace # Trailing whitespace checker
-#  - id: no-commit-to-branch # Prevent committing to main / master
+  - id: no-commit-to-branch # Prevent committing to main / master
   - id: check-added-large-files # Check for large files added to git
   - id: check-merge-conflict # Check for files that contain merge conflict
 
 - repo: https://github.com/psf/black-pre-commit-mirror
-  rev: 24.1.1
+  rev: 24.4.2
   hooks:
     - id: black
       args: [--line-length=120]
@@ -41,7 +41,7 @@ repos:
 
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.3.0
+  rev: v0.4.6
   hooks:
   - id: ruff
     exclude: '(dev/.*|.*_)\.py$'
@@ -51,7 +51,6 @@ repos:
     - --exit-non-zero-on-fix
     - --preview
 
-
 - repo: https://github.com/sphinx-contrib/sphinx-lint
   rev: v0.9.1
   hooks:
@@ -62,9 +61,21 @@ repos:
   rev: v0.0.14
   hooks:
     - id: rstfmt
+      exclude: 'cli/.*' # Because we use argparse
 
 - repo: https://github.com/b8raoult/pre-commit-docconvert
   rev: "0.1.4"
   hooks:
   - id: docconvert
     args: ["numpy"]
+
+- repo: https://github.com/b8raoult/optional-dependencies-all
+  rev: "0.0.2"
+  hooks:
+  - id: optional-dependencies-all
+    args: ["--inplace", "--all-key", "all", "--exclude-keys", "dev,docs"]
+
+- repo: https://github.com/tox-dev/pyproject-fmt
+  rev: "2.1.3"
+  hooks:
+    - id: pyproject-fmt

{anemoi_datasets-0.2.1 → anemoi_datasets-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: anemoi-datasets
-Version: 0.2.1
+Version: 0.3.1
 Summary: A package to hold various functions to support training of ML models on ECMWF data.
 Author-email: "European Centre for Medium-Range Weather Forecasts (ECMWF)" <software.support@ecmwf.int>
 License:                                  Apache License
@@ -205,60 +205,69 @@ License:                                  Apache License
            See the License for the specific language governing permissions and
            limitations under the License.
         
-Project-URL: Homepage, https://github.com/ecmwf/anemoi-datasets/
 Project-URL: Documentation, https://anemoi-datasets.readthedocs.io/
-Project-URL: Repository, https://github.com/ecmwf/anemoi-datasets/
+Project-URL: Homepage, https://github.com/ecmwf/anemoi-datasets/
 Project-URL: Issues, https://github.com/ecmwf/anemoi-datasets/issues
-Keywords: tools,datasets,ai
+Project-URL: Repository, https://github.com/ecmwf/anemoi-datasets/
+Keywords: ai,datasets,tools
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 License-File: LICENSE
-Requires-Dist: anemoi-utils[provenance]>=0.1.7
-Requires-Dist: zarr<=2.17.0
-Requires-Dist: pyyaml
+Requires-Dist: anemoi-utils[provenance]>=0.3
 Requires-Dist: numpy
-Requires-Dist: tqdm
+Requires-Dist: pyyaml
 Requires-Dist: semantic-version
-Provides-Extra: remote
-Requires-Dist: boto3; extra == "remote"
-Requires-Dist: requests; extra == "remote"
-Requires-Dist: s3fs; extra == "remote"
-Provides-Extra: create
-Requires-Dist: climetlab>=0.22.1; extra == "create"
-Requires-Dist: earthkit-meteo; extra == "create"
-Requires-Dist: pyproj; extra == "create"
-Requires-Dist: ecmwflibs>=0.6.3; extra == "create"
-Provides-Extra: docs
-Requires-Dist: sphinx; extra == "docs"
-Requires-Dist: sphinx_rtd_theme; extra == "docs"
-Requires-Dist: nbsphinx; extra == "docs"
-Requires-Dist: pandoc; extra == "docs"
+Requires-Dist: tqdm
+Requires-Dist: zarr<=2.17
 Provides-Extra: all
+Requires-Dist: anemoi-utils[provenance]>=0.3; extra == "all"
 Requires-Dist: boto3; extra == "all"
-Requires-Dist: requests; extra == "all"
-Requires-Dist: s3fs; extra == "all"
 Requires-Dist: climetlab>=0.22.1; extra == "all"
 Requires-Dist: earthkit-meteo; extra == "all"
-Requires-Dist: pyproj; extra == "all"
 Requires-Dist: ecmwflibs>=0.6.3; extra == "all"
+Requires-Dist: numpy; extra == "all"
+Requires-Dist: pyproj; extra == "all"
+Requires-Dist: pyyaml; extra == "all"
+Requires-Dist: requests; extra == "all"
+Requires-Dist: s3fs; extra == "all"
+Requires-Dist: semantic-version; extra == "all"
+Requires-Dist: tqdm; extra == "all"
+Requires-Dist: zarr<=2.17; extra == "all"
+Provides-Extra: create
+Requires-Dist: climetlab>=0.22.1; extra == "create"
+Requires-Dist: earthkit-meteo; extra == "create"
+Requires-Dist: ecmwflibs>=0.6.3; extra == "create"
+Requires-Dist: pyproj; extra == "create"
 Provides-Extra: dev
 Requires-Dist: boto3; extra == "dev"
-Requires-Dist: requests; extra == "dev"
-Requires-Dist: s3fs; extra == "dev"
 Requires-Dist: climetlab>=0.22.1; extra == "dev"
 Requires-Dist: earthkit-meteo; extra == "dev"
-Requires-Dist: pyproj; extra == "dev"
 Requires-Dist: ecmwflibs>=0.6.3; extra == "dev"
-Requires-Dist: sphinx; extra == "dev"
-Requires-Dist: sphinx_rtd_theme; extra == "dev"
 Requires-Dist: nbsphinx; extra == "dev"
 Requires-Dist: pandoc; extra == "dev"
+Requires-Dist: pyproj; extra == "dev"
+Requires-Dist: requests; extra == "dev"
+Requires-Dist: s3fs; extra == "dev"
+Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: sphinx-argparse; extra == "dev"
+Requires-Dist: sphinx-rtd-theme; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: nbsphinx; extra == "docs"
+Requires-Dist: pandoc; extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-argparse; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Provides-Extra: remote
+Requires-Dist: boto3; extra == "remote"
+Requires-Dist: requests; extra == "remote"
+Requires-Dist: s3fs; extra == "remote"

anemoi_datasets-0.3.1/docs/building/handling-missing-values.rst

@@ -0,0 +1,20 @@
+#########################
+ Handling missing values
+#########################
+
+When handling data for machine learning models, missing values (`NaNs`)
+can pose a challenge, as models require complete data to operate
+effectively and may crash otherwise. Ideally, we anticipate having
+complete data in all fields.
+
+However, there are scenarios where `NaNs` naturally occur, such as with
+variables only relevant on land or at sea. This happens for sea surface
+temperature (`sst`), for example. In such cases, the default behavior is
+to reject data with `NaNs` as invalid. To accommodate `NaNs` and
+accurately compute statistics based on them, you can include the
+``allow_nans`` key in the configuration.
+
+Here's an example of how to implement it:
+
+.. literalinclude:: yaml/nan.yaml
+   :language: yaml

{anemoi_datasets-0.2.1 → anemoi_datasets-0.3.1}/docs/building/sources/accumulations.rst

@@ -24,9 +24,9 @@ dataset is unknown, the package assumes that the fields to use are
 accumulated since the beginning of the forecast, over a 6h period.
 
 The user can specify the desired accumulation period with the
-``accumulation_period`` parameter. If its value is a single interger,
-the source will attempt to accumulate the variables over that period.
-This does not always mean that the data used is accumulated from the
+``accumulation_period`` parameter. If its value is a single integer, the
+source will attempt to accumulate the variables over that period. This
+does not always mean that the data used is accumulated from the
 beginning of the forecast, but the most recent data available will be
 used:
 
@@ -44,13 +44,13 @@ used:
 If the of ``accumulation_period`` value is a pair of integers `[step1,
 step2]`, the algorithm is different. The source will compute the
 accumulation between the `step1` and `step2` previous forecast that
-valiate at the given date at `step2`. For example, if the accumulation
+validate at the given date at `step2`. For example, if the accumulation
 period is `[6, 12]`, and the valid date is 2020-10-10 18:00, the source
 will use the forecast of 2020-10-10 06:00 and the steps 6h and 12h.
 
 Please note that ``accumulation_period=6`` and ``accumulation_period=[0,
 6]`` are not equivalent. In the first case, the source can use return an
-accumulation bwteen step 1h and step 7h if it is the most appropriate
+accumulation between step 1h and step 7h if it is the most appropriate
 data available, while in the second case, the source will always return
 the accumulation between step 0h and step 6h, if available.
 

anemoi_datasets-0.3.1/docs/building/sources/yaml/hindcasts.yaml

@@ -0,0 +1,2 @@
+---
+# TODO

anemoi_datasets-0.2.1/docs/building/sources/yaml/perturbations.yaml → anemoi_datasets-0.3.1/docs/building/sources/yaml/recentre.yaml

@@ -21,6 +21,6 @@ data_sources:
       stream: oper
 
 input:
-  perturbations:
-    center: ${data_sources.center_source}
+  recentre:
+    centre: ${data_sources.center_source}
     members: ${data_sources.members_source}

anemoi_datasets-0.3.1/docs/building/sources.rst

@@ -0,0 +1,29 @@
+.. _sources:
+
+#########
+ Sources
+#########
+
+The source is a software component that given a list of dates and
+variables will return the corresponding fields.
+
+A `source` is responsible for reading data from the source and
+converting it to a set of fields. A `source` is also responsible for
+handling the metadata of the data, such as the variables names, and
+more.
+
+A example of source is ECMWF’s MARS archive, a collection of GRIB or
+NetCDF files, etc.
+
+The following `sources` are currently available:
+
+.. toctree::
+   :maxdepth: 1
+
+   sources/mars
+   sources/grib
+   sources/netcdf
+   sources/opendap
+   sources/forcings
+   sources/accumulations
+   sources/recentre

anemoi_datasets-0.3.1/docs/building/statistics.rst

@@ -0,0 +1,65 @@
+.. _gathering_statistics:
+
+######################
+ Gathering statistics
+######################
+
+*Anemoi* will collect statistics about each variables in the dataset as
+it is created. These statistics are intended to be used to normalise the
+data during training.
+
+The statistics are stored in the :doc:`statistics attribute
+<../using/statistics>` of the dataset. The computed statistics include
+`minimum, maximum, mean, standard deviation`.
+
+************************
+ Statistics dates range
+************************
+
+By defaults, the statistics are not computed on the whole dataset, but
+on a subset of dates. This usually is done to avoid any data leakage
+from the validation and test sets to the training set.
+
+The dates subset used to compute the statistics is defined using the
+following algorithm:
+
+   -  If the dataset covers 20 years or more, the last 3 years are
+      excluded.
+   -  If the dataset covers 10 years or more, the last year is excluded.
+   -  Otherwise, 80% of the dataset is used.
+
+You can override this behaviour by setting either the `start` parameter
+or the `end` parameters in the `statistics` config.
+
+Example configuration gathering statistics from 2000 to 2020 :
+
+.. code:: yaml
+
+   statistics:
+       start: 2000
+       end: 2020
+
+Example configuration gathering statistics from the beginning of the
+dataset period to 2020 :
+
+.. code:: yaml
+
+   statistics:
+       end: 2020
+
+Example configuration gathering statistics using only 2020 data :
+
+.. code:: yaml
+
+   statistics:
+       start: 2020
+       end: 2020
+
+**************************
+ Data with missing values
+**************************
+
+If the dataset contains missing values (known as `NaNs`), an error will
+be raised when trying to compute the statistics. To allow `NaNs` in the
+dataset, you can set the `allow_nans` as described :doc:`here
+</building/handling-missing-values>`.

anemoi_datasets-0.3.1/docs/cli/compare.rst

@@ -0,0 +1,18 @@
+compare
+=======
+
+Use this command to compare two datasets.
+
+The command will run a quick comparison of the two datasets and output a summary of the differences.
+
+.. warning::
+
+    This command will not compare the data in the datasets, only some of the metadata.
+    Subsequent versions of this command may include more detailed comparisons.
+
+
+.. argparse::
+    :module: anemoi.datasets.__main__
+    :func: create_parser
+    :prog: anemoi-datasets
+    :path: compare

anemoi_datasets-0.3.1/docs/cli/copy.rst

@@ -0,0 +1,27 @@
+copy
+====
+
+
+Copying a dataset from one location to another can be error-prone and time-consuming.
+This command-line script allows for incremental copying.
+When the copying process fails, it can be resumed.
+It can be used to copy files from a local directory to a remote server, from a remote server to a local directory as long as there is a zarr backend to read and write the data.
+
+The script uses multiple threads to make the process faster.
+However, it is important to consider that making parallel requests to the same server may not be ideal, for instance if the server internally uses a limited number of threads to handle requests.
+
+The option to rechunk the data is available, which can be useful when the data is stored on a platform that does not support having may small files or many file on the same directory.
+However keep in mind that rechunking has a huge impact on the performance when reading the data:
+The chunk pattern for the source dataset has been defined for good reasons, and changing it is very likey to have a negative impact on the performance.
+
+.. warning::
+
+    When resuming the copying process (using ``--resume``), calling the script with the same arguments for ``--block-size`` and ``--rechunk`` is recommended.
+    Using different values for these arguments to resume copying the same dataset may lead to unexpected behavior.
+
+
+.. argparse::
+    :module: anemoi.datasets.__main__
+    :func: create_parser
+    :prog: anemoi-datasets
+    :path: copy

anemoi_datasets-0.3.1/docs/cli/create.rst

@@ -0,0 +1,11 @@
+create
+======
+
+Use this command to create a dataset from a recipe file.
+The syntax of the recipe file is described in :doc:`building datasets <../building/introduction>`.
+
+.. argparse::
+    :module: anemoi.datasets.__main__
+    :func: create_parser
+    :prog: anemoi-datasets
+    :path: create

anemoi_datasets-0.3.1/docs/cli/inspect.rst

@@ -0,0 +1,27 @@
+inspect
+=======
+
+
+Anemoi datasets are stored in a zarr format and can be located on a local file system or on a remote server.
+The `inspect` command is used to inspect the contents of a dataset.
+This command will output the metadata of the dataset, including the variables, dimensions, and attributes.
+
+.. code:: console
+
+   $ anemoi-datasets inspect dataset.zarr
+
+
+which will output something like the following. The output should be self-explanatory.
+
+.. literalinclude:: ../building/yaml/building1.txt
+   :language: console
+
+*********************
+ Command line usage
+*********************
+
+.. argparse::
+    :module: anemoi.datasets.__main__
+    :func: create_parser
+    :prog: anemoi-datasets
+    :path: inspect

anemoi_datasets-0.3.1/docs/cli/introduction.rst

@@ -0,0 +1,28 @@
+Introduction
+============
+
+When you install the `anemoi-datasets` package, this will also install command line tool
+called ``anemoi-datasets`` which can be used to manage the zarr datasets.
+
+The tool can provide help with the ``--help`` options:
+
+.. code-block:: bash
+
+    % anemoi-datasets --help
+
+The commands are:
+
+.. toctree::
+    :maxdepth: 1
+
+    compare
+    copy
+    create
+    inspect
+    scan
+
+.. argparse::
+    :module: anemoi.datasets.__main__
+    :func: create_parser
+    :prog: anemoi-datasets
+    :nosubcommands:

anemoi_datasets-0.3.1/docs/cli/scan.rst

@@ -0,0 +1,10 @@
+scan
+====
+
+Use this command to scan for GRIB files
+
+.. argparse::
+    :module: anemoi.datasets.__main__
+    :func: create_parser
+    :prog: anemoi-datasets
+    :path: scan

{anemoi_datasets-0.2.1 → anemoi_datasets-0.3.1}/docs/conf.py

@@ -16,11 +16,11 @@
 
 import datetime
 import os
+import sys
 
 read_the_docs_build = os.environ.get("READTHEDOCS", None) == "True"
 
-# top = os.path.realpath(os.path.dirname(os.path.dirname(__file__)))
-# sys.path.insert(0, top)
+sys.path.insert(0, os.path.join(os.path.abspath(".."), "src"))
 
 
 source_suffix = ".rst"
@@ -45,7 +45,12 @@ else:
 copyright = "%s, ECMWF" % (years,)
 
 
-release = "0.1.0"
+try:
+    from anemoi.datasets._version import __version__
+
+    release = __version__
+except ImportError:
+    release = "0.0.0"
 
 
 # -- General configuration ---------------------------------------------------
@@ -59,6 +64,9 @@ extensions = [
     "nbsphinx",
     "sphinx.ext.graphviz",
     "sphinx.ext.intersphinx",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+    "sphinxarg.ext",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -112,3 +120,5 @@ html_css_files = ["style.css"]
 
 
 todo_include_todos = not read_the_docs_build
+
+autodoc_member_order = "bysource"  # Keep file order

{anemoi_datasets-0.2.1 → anemoi_datasets-0.3.1}/docs/requirements.txt

@@ -2,6 +2,7 @@
 sphinx
 sphinx_rtd_theme
 nbsphinx
+sphinx_argparse
 
 # Also requires `brew install pandoc` on Mac
 pandoc

{anemoi_datasets-0.2.1 → anemoi_datasets-0.3.1}/docs/using/code/open_complex.py

@@ -5,7 +5,7 @@ config = {
         "ensemble": [
             "/path/to/dataset1.zarr",
             {"dataset": "dataset_name", "end": 2010},
-            {"dataset": "s3://path/to/dataset3.zarr", "begin": 2000, "end": 2010},
+            {"dataset": "s3://path/to/dataset3.zarr", "start": 2000, "end": 2010},
         ],
         "frequency": "24h",
     },

{anemoi_datasets-0.2.1 → anemoi_datasets-0.3.1}/docs/using/code/open_other.py

@@ -2,4 +2,4 @@ from anemoi.datasets import open_dataset
 
 ds1 = open_dataset("/path/to/dataset.zarr")
 
-ds2 = open_dataset(ds1, frequency="24h", begin="2000", end="2010")
+ds2 = open_dataset(ds1, frequency="24h", start="2000", end="2010")

anemoi_datasets-0.3.1/pyproject.toml

@@ -0,0 +1,121 @@
+#!/usr/bin/env python
+# (C) Copyright 2024 ECMWF.
+#
+# This software is licensed under the terms of the Apache Licence Version 2.0
+# which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
+# In applying this licence, ECMWF does not waive the privileges and immunities
+# granted to it by virtue of its status as an intergovernmental organisation
+# nor does it submit to any jurisdiction.
+
+# https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+
+[build-system]
+requires = [
+  "setuptools>=60",
+  "setuptools-scm>=8",
+]
+
+[project]
+name = "anemoi-datasets"
+
+description = "A package to hold various functions to support training of ML models on ECMWF data."
+keywords = [
+  "ai",
+  "datasets",
+  "tools",
+]
+
+license = { file = "LICENSE" }
+authors = [
+  { name = "European Centre for Medium-Range Weather Forecasts (ECMWF)", email = "software.support@ecmwf.int" },
+]
+
+requires-python = ">=3.9"
+
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: Apache Software License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Programming Language :: Python :: Implementation :: PyPy",
+]
+
+dynamic = [
+  "version",
+]
+dependencies = [
+  "anemoi-utils[provenance]>=0.3",
+  "numpy",
+  "pyyaml",
+  "semantic-version",
+  "tqdm",
+  "zarr<=2.17",
+]
+
+optional-dependencies.all = [
+  "anemoi-utils[provenance]>=0.3",
+  "boto3",
+  "climetlab>=0.22.1",
+  "earthkit-meteo",
+  "ecmwflibs>=0.6.3",
+  "numpy",
+  "pyproj",
+  "pyyaml",
+  "requests",
+  "s3fs",
+  "semantic-version",
+  "tqdm",
+  "zarr<=2.17",
+]
+optional-dependencies.create = [
+  "climetlab>=0.22.1", # "earthkit-data"
+  "earthkit-meteo",
+  "ecmwflibs>=0.6.3",
+  "pyproj",
+]
+optional-dependencies.dev = [
+  "boto3",
+  "climetlab>=0.22.1", # "earthkit-data"
+  "earthkit-meteo",
+  "ecmwflibs>=0.6.3",
+  "nbsphinx",
+  "pandoc",
+  "pyproj",
+  "requests",
+  "s3fs",
+  "sphinx",
+  "sphinx-argparse",
+  "sphinx-rtd-theme",
+]
+optional-dependencies.docs = [
+  "nbsphinx",
+  "pandoc",
+  "sphinx",
+  "sphinx-argparse",
+  "sphinx-rtd-theme",
+]
+optional-dependencies.remote = [
+  "boto3",
+  "requests",
+  "s3fs",
+]
+urls.Documentation = "https://anemoi-datasets.readthedocs.io/"
+urls.Homepage = "https://github.com/ecmwf/anemoi-datasets/"
+urls.Issues = "https://github.com/ecmwf/anemoi-datasets/issues"
+# Changelog = "https://github.com/ecmwf/anemoi-datasets/CHANGELOG.md"
+urls.Repository = "https://github.com/ecmwf/anemoi-datasets/"
+scripts.anemoi-datasets = "anemoi.datasets.__main__:main"
+
+[tool.setuptools.package-data]
+"anemoi.datasets.data" = [
+  "*.css",
+]
+
+[tool.setuptools_scm]
+version_file = "src/anemoi/datasets/_version.py"

anemoi_datasets-0.3.1/src/anemoi/datasets/__main__.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python
+# (C) Copyright 2024 ECMWF.
+#
+# This software is licensed under the terms of the Apache Licence Version 2.0
+# which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
+# In applying this licence, ECMWF does not waive the privileges and immunities
+# granted to it by virtue of its status as an intergovernmental organisation
+# nor does it submit to any jurisdiction.
+#
+
+from anemoi.utils.cli import cli_main
+from anemoi.utils.cli import make_parser
+
+from . import __version__
+from .commands import COMMANDS
+
+
+# For read-the-docs
+def create_parser():
+    return make_parser(__doc__, COMMANDS)
+
+
+def main():
+    cli_main(__version__, __doc__, COMMANDS)
+
+
+if __name__ == "__main__":
+    main()