| Name | input4mips-validation JSON |
| Version |
0.15.0
JSON |
| download |
| home_page | None |
| Summary | Validation of input4MIPs data (checking file formats, metadata etc.). |
| upload_time | 2024-11-11 16:35:27 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | BSD-3-Clause |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<!--- --8<-- [start:description] -->
# Input4MIPs-validation
Validation of input4MIPs data (checking file formats, metadata etc.).
**Key info :**
[](https://input4mips-validation.readthedocs.io)
[](https://github.com/climate-resource/input4mips_validation/blob/main/pyproject.toml)
[](https://github.com/climate-resource/input4mips_validation/blob/main/LICENCE)
**PyPI :**
[](https://pypi.org/project/input4mips-validation/)
[](https://github.com/climate-resource/input4mips_validation/actions/workflows/install-pypi.yaml)
**Conda :**
[](https://anaconda.org/conda-forge/input4mips-validation)
[](https://anaconda.org/conda-forge/input4mips-validation)
[](https://github.com/climate-resource/input4mips_validation/actions/workflows/install-conda.yaml)
**Tests :**
[](https://github.com/climate-resource/input4mips_validation/actions/workflows/ci.yaml)
[](https://codecov.io/gh/climate-resource/input4mips_validation)
**Other info :**
[](https://github.com/climate-resource/input4mips_validation/commits/main)
[](https://github.com/climate-resource/input4mips_validation/graphs/contributors)
## Status
- development: the project is actively being worked on
As a user, please note that input4MIPs validation is undergoing heavy development.
This means that files which pass validation today may not pass in future.
While this will initially be frustrating, it will pay off in the long run
by helping us to create the cleanest, clearest set of data possible.
We hope that you can appreciate the importance of this too
(and we hope to get the effort it takes to do this
recognised at some point in the future too,
watch this space).
So, please enjoy the tool, please make use of it,
please [raise an issue](https://github.com/climate-resource/input4mips_validation/issues/new/choose)
whenever there is a problem,
but please also be ready to update your file writing scripts
when submitting the next round of files in three to six months' time.
<!--- --8<-- [end:description] -->
If you want to prepare your input4MIPs files for publication on ESGF,
please see
["How can I prepare my input4MIPs files for publication on ESGF?"](https://input4mips-validation.readthedocs.io/en/latest/how-to-guides/#how-can-i-prepare-my-input4mips-files-for-publication-on-esgf).
Full documentation can be found at:
[input4mips-validation.readthedocs.io](https://input4mips-validation.readthedocs.io/en/latest/).
We recommend reading the docs there because the internal documentation links
don't render correctly on GitHub's viewer.
<!--- TODO: add link to preparing data for input4MIPs here -->
## Installation
<!--- --8<-- [start:installation] -->
### As an application
If you want to use input4MIPs-validation as an application,
for example you just want to use its command-line interface,
then we recommend using the 'locked' version of the package.
This version pins the version of all dependencies too,
which reduces the chance of installation issues
because of breaking updates to dependencies.
The locked version of input4mips-validation can be installed with
=== "mamba"
```sh
mamba install -c conda-forge input4mips-validation-locked
```
[mamba](https://mamba.readthedocs.io/en/latest/)
is our recommend way to install the package
because it has better handling of the compiled dependencies
(like cfunits).
=== "conda"
```sh
conda install -c conda-forge input4mips-validation-locked
```
[conda](https://docs.conda.io/projects/conda/en/stable/)
is a good way to install the package
because it has better handling of the compiled dependencies
(like cfunits).
=== "pip"
```sh
pip install input4mips-validation[locked]
```
[pip](https://pip.pypa.io/en/stable/)
is a standard way to install Python packages.
We make no guarantees that this will actually work
because pip's handling of the compiled dependencies
is not guaranteed.
### As a library
If you want to use input4MIPs-validation as a library,
for example you want to use it
as a dependency in another package/application that you're building,
then we recommend installing the package with the commands below.
This method provides the loosest pins possible of all dependencies.
This gives you, the package/application developer,
as much freedom as possible to set the versions of different packages.
However, the tradeoff with this freedom is that you may install
incompatible versions of input4mips-validation's dependencies
(we cannot test all combinations of dependencies,
particularly ones which haven't been released yet!).
Hence, you may run into installation issues.
If you believe these are because of a problem in input4mips-validation,
please [raise an issue](https://github.com/climate-resource/input4mips_validation/issues/new/choose).
The (non-locked) version of input4mips-validation can be installed with
=== "mamba"
```sh
mamba install -c conda-forge input4mips-validation
```
[mamba](https://mamba.readthedocs.io/en/latest/)
is our recommend way to install the package
because it has better handling of the compiled dependencies
(like cfunits).
=== "conda"
```sh
conda install -c conda-forge input4mips-validation
```
[conda](https://docs.conda.io/projects/conda/en/stable/)
is a good way to install the package
because it has better handling of the compiled dependencies
(like cfunits).
=== "pip"
```sh
pip install input4mips-validation
```
[pip](https://pip.pypa.io/en/stable/)
is a standard way to install Python packages.
We make no guarantees that this will actually work
because pip's handling of the compiled dependencies
is not guaranteed.
Additional dependencies can be installed using
=== "mamba"
If you are installing with mamba, we recommend
installing the extras by hand because there is no stable
solution yet (see [conda issue #7502](https://github.com/conda/conda/issues/7502))
=== "conda"
If you are installing with conda, we recommend
installing the extras by hand because there is no stable
solution yet (see [conda issue #7502](https://github.com/conda/conda/issues/7502))
=== "pip"
```sh
# To add plotting dependencies
pip install input4mips-validation[plots]
# To add notebook dependencies
pip install input4mips-validation[notebooks]
```
### For developers
For development, we rely on [pixi](https://pixi.sh/latest/)
for all our dependency management.
To get started, you will need to make sure that pixi is installed
([instructions here](https://pixi.sh/latest/#installation)).
We rely on [pdm](https://pdm-project.org/en/latest/) for managing our PyPI builds.
Hence, you will also need to make sure that pdm is installed on your system
([instructions here](https://pdm-project.org/en/latest/#installation),
although we found that installing with [pipx](https://pipx.pypa.io/stable/installation/)
worked perfectly for us).
For all of our work, we use our `Makefile`.
You can read the instructions out and run the commands by hand if you wish,
but we generally discourage this because it can be error prone.
In order to create your environment, run `make virtual-environment`.
If there are any issues, the messages from the `Makefile` should guide you
through. If not, please raise an issue in the
[issue tracker](https://github.com/climate-resource/input4mips_validation/issues).
For the rest of our developer docs, please see [development][development-reference].
<!--- --8<-- [end:installation] -->
Raw data
{
"_id": null,
"home_page": null,
"name": "input4mips-validation",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Zebedee Nicholls <zebedee.nicholls@climate-resource.com>",
"download_url": "https://files.pythonhosted.org/packages/03/29/b828dfcc8a602ed32e6d68cf2067f22b0cb770e235ac99a70e2b806edd1d/input4mips_validation-0.15.0.tar.gz",
"platform": null,
"description": "<!--- --8<-- [start:description] -->\n# Input4MIPs-validation\n\nValidation of input4MIPs data (checking file formats, metadata etc.).\n\n**Key info :**\n[](https://input4mips-validation.readthedocs.io)\n[](https://github.com/climate-resource/input4mips_validation/blob/main/pyproject.toml)\n[](https://github.com/climate-resource/input4mips_validation/blob/main/LICENCE)\n\n**PyPI :**\n[](https://pypi.org/project/input4mips-validation/)\n[](https://github.com/climate-resource/input4mips_validation/actions/workflows/install-pypi.yaml)\n\n**Conda :**\n[](https://anaconda.org/conda-forge/input4mips-validation)\n[](https://anaconda.org/conda-forge/input4mips-validation)\n[](https://github.com/climate-resource/input4mips_validation/actions/workflows/install-conda.yaml)\n\n**Tests :**\n[](https://github.com/climate-resource/input4mips_validation/actions/workflows/ci.yaml)\n[](https://codecov.io/gh/climate-resource/input4mips_validation)\n\n**Other info :**\n[](https://github.com/climate-resource/input4mips_validation/commits/main)\n[](https://github.com/climate-resource/input4mips_validation/graphs/contributors)\n\n## Status\n\n- development: the project is actively being worked on\n\nAs a user, please note that input4MIPs validation is undergoing heavy development.\nThis means that files which pass validation today may not pass in future.\nWhile this will initially be frustrating, it will pay off in the long run\nby helping us to create the cleanest, clearest set of data possible.\nWe hope that you can appreciate the importance of this too\n(and we hope to get the effort it takes to do this\nrecognised at some point in the future too,\nwatch this space).\nSo, please enjoy the tool, please make use of it,\nplease [raise an issue](https://github.com/climate-resource/input4mips_validation/issues/new/choose)\nwhenever there is a problem,\nbut please also be ready to update your file writing scripts\nwhen submitting the next round of files in three to six months' time.\n\n<!--- --8<-- [end:description] -->\n\nIf you want to prepare your input4MIPs files for publication on ESGF,\nplease see\n[\"How can I prepare my input4MIPs files for publication on ESGF?\"](https://input4mips-validation.readthedocs.io/en/latest/how-to-guides/#how-can-i-prepare-my-input4mips-files-for-publication-on-esgf).\n\nFull documentation can be found at:\n[input4mips-validation.readthedocs.io](https://input4mips-validation.readthedocs.io/en/latest/).\nWe recommend reading the docs there because the internal documentation links\ndon't render correctly on GitHub's viewer.\n\n<!--- TODO: add link to preparing data for input4MIPs here -->\n\n## Installation\n\n<!--- --8<-- [start:installation] -->\n### As an application\n\nIf you want to use input4MIPs-validation as an application,\nfor example you just want to use its command-line interface,\nthen we recommend using the 'locked' version of the package.\nThis version pins the version of all dependencies too,\nwhich reduces the chance of installation issues\nbecause of breaking updates to dependencies.\n\nThe locked version of input4mips-validation can be installed with\n\n=== \"mamba\"\n ```sh\n mamba install -c conda-forge input4mips-validation-locked\n ```\n\n [mamba](https://mamba.readthedocs.io/en/latest/)\n is our recommend way to install the package\n because it has better handling of the compiled dependencies\n (like cfunits).\n\n=== \"conda\"\n ```sh\n conda install -c conda-forge input4mips-validation-locked\n ```\n\n [conda](https://docs.conda.io/projects/conda/en/stable/)\n is a good way to install the package\n because it has better handling of the compiled dependencies\n (like cfunits).\n\n=== \"pip\"\n ```sh\n pip install input4mips-validation[locked]\n ```\n\n [pip](https://pip.pypa.io/en/stable/)\n is a standard way to install Python packages.\n We make no guarantees that this will actually work\n because pip's handling of the compiled dependencies\n is not guaranteed.\n\n### As a library\n\nIf you want to use input4MIPs-validation as a library,\nfor example you want to use it\nas a dependency in another package/application that you're building,\nthen we recommend installing the package with the commands below.\nThis method provides the loosest pins possible of all dependencies.\nThis gives you, the package/application developer,\nas much freedom as possible to set the versions of different packages.\nHowever, the tradeoff with this freedom is that you may install\nincompatible versions of input4mips-validation's dependencies\n(we cannot test all combinations of dependencies,\nparticularly ones which haven't been released yet!).\nHence, you may run into installation issues.\nIf you believe these are because of a problem in input4mips-validation,\nplease [raise an issue](https://github.com/climate-resource/input4mips_validation/issues/new/choose).\n\nThe (non-locked) version of input4mips-validation can be installed with\n\n=== \"mamba\"\n ```sh\n mamba install -c conda-forge input4mips-validation\n ```\n\n [mamba](https://mamba.readthedocs.io/en/latest/)\n is our recommend way to install the package\n because it has better handling of the compiled dependencies\n (like cfunits).\n\n=== \"conda\"\n ```sh\n conda install -c conda-forge input4mips-validation\n ```\n\n [conda](https://docs.conda.io/projects/conda/en/stable/)\n is a good way to install the package\n because it has better handling of the compiled dependencies\n (like cfunits).\n\n=== \"pip\"\n ```sh\n pip install input4mips-validation\n ```\n\n [pip](https://pip.pypa.io/en/stable/)\n is a standard way to install Python packages.\n We make no guarantees that this will actually work\n because pip's handling of the compiled dependencies\n is not guaranteed.\n\nAdditional dependencies can be installed using\n\n=== \"mamba\"\n If you are installing with mamba, we recommend\n installing the extras by hand because there is no stable\n solution yet (see [conda issue #7502](https://github.com/conda/conda/issues/7502))\n\n=== \"conda\"\n If you are installing with conda, we recommend\n installing the extras by hand because there is no stable\n solution yet (see [conda issue #7502](https://github.com/conda/conda/issues/7502))\n\n=== \"pip\"\n ```sh\n # To add plotting dependencies\n pip install input4mips-validation[plots]\n # To add notebook dependencies\n pip install input4mips-validation[notebooks]\n ```\n\n### For developers\n\nFor development, we rely on [pixi](https://pixi.sh/latest/)\nfor all our dependency management.\nTo get started, you will need to make sure that pixi is installed\n([instructions here](https://pixi.sh/latest/#installation)).\n\nWe rely on [pdm](https://pdm-project.org/en/latest/) for managing our PyPI builds.\nHence, you will also need to make sure that pdm is installed on your system\n([instructions here](https://pdm-project.org/en/latest/#installation),\nalthough we found that installing with [pipx](https://pipx.pypa.io/stable/installation/)\nworked perfectly for us).\n\nFor all of our work, we use our `Makefile`.\nYou can read the instructions out and run the commands by hand if you wish,\nbut we generally discourage this because it can be error prone.\nIn order to create your environment, run `make virtual-environment`.\n\nIf there are any issues, the messages from the `Makefile` should guide you\nthrough. If not, please raise an issue in the\n[issue tracker](https://github.com/climate-resource/input4mips_validation/issues).\n\nFor the rest of our developer docs, please see [development][development-reference].\n\n<!--- --8<-- [end:installation] -->\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Validation of input4MIPs data (checking file formats, metadata etc.).",
"version": "0.15.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6204be8a35bf444f127c316592688c68177f7884dab6f8fb542a4981764fc592",
"md5": "8e831209f75fd0ef6cdd6b385364fb81",
"sha256": "86a820b3a18f5e966dd5f64596f8e256049d10d5bab998b4939846d817121ba5"
},
"downloads": -1,
"filename": "input4mips_validation-0.15.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8e831209f75fd0ef6cdd6b385364fb81",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 97693,
"upload_time": "2024-11-11T16:35:25",
"upload_time_iso_8601": "2024-11-11T16:35:25.832060Z",
"url": "https://files.pythonhosted.org/packages/62/04/be8a35bf444f127c316592688c68177f7884dab6f8fb542a4981764fc592/input4mips_validation-0.15.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0329b828dfcc8a602ed32e6d68cf2067f22b0cb770e235ac99a70e2b806edd1d",
"md5": "94158ca8d7ad99c21048557bf4829f31",
"sha256": "bc0179de40d204615682b8f76a223932dcbe618ccfaa65e4661cefd4f7020d17"
},
"downloads": -1,
"filename": "input4mips_validation-0.15.0.tar.gz",
"has_sig": false,
"md5_digest": "94158ca8d7ad99c21048557bf4829f31",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 93257,
"upload_time": "2024-11-11T16:35:27",
"upload_time_iso_8601": "2024-11-11T16:35:27.910358Z",
"url": "https://files.pythonhosted.org/packages/03/29/b828dfcc8a602ed32e6d68cf2067f22b0cb770e235ac99a70e2b806edd1d/input4mips_validation-0.15.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-11 16:35:27",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "input4mips-validation"
}
