Split main into separate function and add entry point

[blimlim]

This PR addresses the ESM1.5 conversion driver part of #81, splitting the main block into separate main() and parse_args() functions, which allows for an entry point to be added to the pytproject.toml file.

Adding entry points to um2netcdf will be addressed separately in #82.

I'm unsure how to test that the entry point is working, and so suggestions on that would be great too!

[truth-quark]

I think the only thing missing is an entry point CI test to "run" the conversion driver script in a simple fashion.

Do you want to try copying & modifying the old entry point test from the CI.yml here:
2c7b355, and see if it can run the conversion driver script with --help?

[aidanheerdegen]

@blimlim I debugged the conda packaging by copying the commands from the CI to build and install the package locally.

So something like

conda build -c accessnri -c conda-forge -c coecms . --no-anaconda-upload --output-folder=./build
conda env create -f conda/environment.yml 
conda activate um2nc 
conda install -c conda-forge -c accessnri -c coecms -c file://$(readlink -f build) um2nc

[aidanheerdegen]

The problem is with package discovery

https://setuptools.pypa.io/en/latest/userguide/package_discovery.html#custom-discovery

The package isn't discovered with the current settings because there isn't a __init__.py file in the umpost directory. So it isn't even installed correctly (see I said there would always be some problem!).

Just add one (it can be empty), e.g.

touch upmost/__init__.py

and it should all work as it is now.

(um2nc) $ esm1p5_convert_nc 
usage: esm1p5_convert_nc [-h] [--quiet] [--delete-ff] current_output_dir
esm1p5_convert_nc: error: the following arguments are required: current_output_dir
(um2nc) $ git status -s
?? build/
?? umpost/__init__.py
(um2nc) $ 

[aidanheerdegen]

Doh. We need to also remove the accessnri channel when installing the um2nc package from the local directory, otherwise it will likely pick up the version that is already installed there rather the local one.

https://github.com/ACCESS-NRI/um2nc-standalone/pull/83/files#diff-3ab46ee209a127470fce3c2cf106b1a1dbadbb929a4b5b13656a4bc4ce19c0b8L86

or make the local file channel the first channel to ensure it picks that version up.

[aidanheerdegen]

Yeah it picked up the accessnri channel version

https://github.com/ACCESS-NRI/um2nc-standalone/actions/runs/10484327176/job/29038506545?pr=83#step:6:213

[blimlim]

I moved the local file to the first channel and it's working now!

[aidanheerdegen]

I moved the local file to the first channel and it's working now!

Quick! Merge before anything changes! ;)

[truth-quark]

Looks good to go!