cli entries do not work exactly as I suspected

[jgriesfeller]

I have added some new entry points to pyaerocom for my paralleisation effort (#663):

pyaerocom/setup.cfg

Lines 64 to 65 in 0ebc275

	aeroval_parallelise = pyaerocom.scripts.aeroval_parallelise:main
	aeroval_run_json = pyaerocom.scripts.aeroval_run_json:main

Unfortunately they do not work as the pure command line usage. They load pyaerocom first, checking e.g Lustre access. This is entirely useless if a user just wants to see the help.

direct usage:

(pya-applied) jang@pc4847:~/.../pyaerocom-config/eval_py$ ~/data/Python3/pyaerocom/pyaerocom/scripts/aeroval_parallelise.py -h
usage: aeroval_parallelise.py [-h] [-v] [-o OUTDIR] [--subdry] [--createjobfiles] [--jsonrunscript JSONRUNSCRIPT]
                              [--cfgvar CFGVAR] [--tempdir TEMPDIR] [--remotetempdir REMOTETEMPDIR] [-c]
                              files [files ...]

command line interface to aeroval parallelisation. aeroval config has to to be in the variable CFG for now!

positional arguments:
  files                 file(s) to read

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         switch on verbosity
  -o OUTDIR, --outdir OUTDIR
                        output directory for experiment assembly
  --subdry              dryrun for submission to queue
  --createjobfiles      create all that is necessary to submit the jobs to the queue, but do not start the jobs.
  --jsonrunscript JSONRUNSCRIPT
                        script to run json config files; defaults to aeroval_run_json_cfg.py
  --cfgvar CFGVAR       variable that holds the aeroval config in the file(s) provided. Defaults to CFG
  --tempdir TEMPDIR     directory for temporary files; defaults to /tmp
  --remotetempdir REMOTETEMPDIR
                        directory for temporary files on qsub node; defaults to /tmp
  -c, --combinedirs     output directory

via cli:

(pya-applied) jang@pc4847:~/.../pyaerocom-config/eval_py$ aeroval_parallelise -h
Checking access to: /lustre/storeA/project
Checking access to: /lustre/storeA/project/aerocom
Checking access to: /lustre/storeA/project/aerocom/aerocom1
/home/jang/anaconda.2018/envs/pya-applied/lib/python3.9/site-packages/geonum/__init__.py:26: UserWarning: Plotting of maps etc. is deactivated, please install Basemap
  warn('Plotting of maps etc. is deactivated, please install Basemap')
geopy library is not available. Aeolus data read not enabled
usage: aeroval_parallelise [-h] [-v] [-o OUTDIR] [--subdry] [--createjobfiles] [--jsonrunscript JSONRUNSCRIPT] [--cfgvar CFGVAR]
                           [--tempdir TEMPDIR] [--remotetempdir REMOTETEMPDIR] [-c]
                           files [files ...]

command line interface to aeroval parallelisation. aeroval config has to to be in the variable CFG for now!

positional arguments:
  files                 file(s) to read

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         switch on verbosity
  -o OUTDIR, --outdir OUTDIR
                        output directory for experiment assembly
  --subdry              dryrun for submission to queue
  --createjobfiles      create all that is necessary to submit the jobs to the queue, but do not start the jobs.
  --jsonrunscript JSONRUNSCRIPT
                        script to run json config files; defaults to aeroval_run_json_cfg.py
  --cfgvar CFGVAR       variable that holds the aeroval config in the file(s) provided. Defaults to CFG
  --tempdir TEMPDIR     directory for temporary files; defaults to /tmp
  --remotetempdir REMOTETEMPDIR
                        directory for temporary files on qsub node; defaults to /tmp
  -c, --combinedirs     output directory

What am I doing wrong?

The cli is not finished btw

[avaldebe]

Different invocations use different entry points.

direct usage:

(pya-applied) jang@pc4847:~/.../pyaerocom-config/eval_py$ ~/data/Python3/pyaerocom/pyaerocom/scripts/aeroval_parallelise.py -h
usage:

The direct invocation calls the CLI trough the if __name__ == "__main__" clause at the end of the script. There is no reference to the pyaerocom package here, so it is not loeaded.

via cli:

(pya-applied) jang@pc4847:~/.../pyaerocom-config/eval_py$ aeroval_parallelise -h

Here you are accessing the CLI trough the entry point defined as part of the package.
There is no way (until PEP 660 is approved and merged)
to access an entry point defined on a package without loading the package.