# ITR-tool
WWF version of the SBTi-Finance-tool, based on the WWF/CDP Temperature rating methodology
> Visit https://wwf-sweden.github.io/ITR-tool/ for the full documentation
> If you have any additional questions or comments send a mail to: ekonomi-finans@wwf.se
## About the tool
This package helps companies and financial institutions to assess the temperature alignment of current
targets, commitments, and investment and lending portfolios, and to use this information to develop
targets for official validation by the SBTi.
The WWF Finance toolkit can be used in different ways:
- Users can integrate the Python package in their codebase
- Using Notebooks, either locally or on Google Colab
## Structure
The folder structure for this project is as follows:
.
├── .github # Github specific files (Github Actions workflows)
├── app # FastAPI app files for the API endpoints
├── docs # Documentation files (Sphinx)
├── config # Config files for the Docker container
├── ITR # The main Python package for the temperature alignment tool
└── test # Automated unit tests for the SBTi package (Nose2 tests)
## Installation
The SBTi package may be installed using PIP. If you'd like to install it locally use the following command. For testing or production please see the deployment section for further instructions
```bash
pip install -e .
```
For installing the latest stable release in PyPi run:
```bash
pip install wwf-itr
```
## Development
To set up the local dev environment with all dependencies, [install poetry](https://python-poetry.org/docs/#osx--linux--bashonwindows-install-instructions) and run
```bash
poetry install
```
This will create a virtual environment inside the project folder under `.venv`.
### Testing
Each class should be unit tested. The unit tests are written using the Nose2 framework.
The setup.py script should have already installed Nose2, so now you may run the tests as follows:
```bash
nose2 -v
```
### Publish to PyPi
The package should be published to PyPi when any changes to main are merged.
Update package
1. bump version in `pyproject.toml` based on semantic versioning principles
2. run `poetry build`
3. run `poetry publish`
4. check whether package has been successfully uploaded
**Initial Setup**
- Create account on [PyPi](https://pypi.org/)
Raw data
{
"_id": null,
"home_page": "",
"name": "WWF-ITR",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "Climate,ITR,SBTi,Finance,WWF",
"author": "wwf",
"author_email": "ekonomi-finans@wwf.se",
"download_url": "https://files.pythonhosted.org/packages/84/ba/2aaff14c337319dc5b36e700eb3bfc3c2fe4856061c39fec3dab81225a47/wwf_itr-0.9.1.tar.gz",
"platform": null,
"description": "# ITR-tool\nWWF version of the SBTi-Finance-tool, based on the WWF/CDP Temperature rating methodology\n\n> Visit https://wwf-sweden.github.io/ITR-tool/ for the full documentation\n\n> If you have any additional questions or comments send a mail to: ekonomi-finans@wwf.se\n\n## About the tool\n\nThis package helps companies and financial institutions to assess the temperature alignment of current\ntargets, commitments, and investment and lending portfolios, and to use this information to develop\ntargets for official validation by the SBTi.\n\nThe WWF Finance toolkit can be used in different ways:\n\n- Users can integrate the Python package in their codebase\n- Using Notebooks, either locally or on Google Colab\n\n## Structure\n\nThe folder structure for this project is as follows:\n\n .\n \u251c\u2500\u2500 .github # Github specific files (Github Actions workflows)\n \u251c\u2500\u2500 app # FastAPI app files for the API endpoints\n \u251c\u2500\u2500 docs # Documentation files (Sphinx)\n \u251c\u2500\u2500 config # Config files for the Docker container\n \u251c\u2500\u2500 ITR # The main Python package for the temperature alignment tool\n \u2514\u2500\u2500 test # Automated unit tests for the SBTi package (Nose2 tests)\n\n## Installation\n\nThe SBTi package may be installed using PIP. If you'd like to install it locally use the following command. For testing or production please see the deployment section for further instructions\n\n```bash\npip install -e .\n```\n\nFor installing the latest stable release in PyPi run:\n\n```bash\npip install wwf-itr\n```\n\n## Development\n\nTo set up the local dev environment with all dependencies, [install poetry](https://python-poetry.org/docs/#osx--linux--bashonwindows-install-instructions) and run\n\n```bash\npoetry install\n```\n\nThis will create a virtual environment inside the project folder under `.venv`.\n\n### Testing\n\nEach class should be unit tested. The unit tests are written using the Nose2 framework.\nThe setup.py script should have already installed Nose2, so now you may run the tests as follows:\n\n```bash\nnose2 -v\n```\n\n### Publish to PyPi\n\nThe package should be published to PyPi when any changes to main are merged.\n\nUpdate package\n\n1. bump version in `pyproject.toml` based on semantic versioning principles\n2. run `poetry build`\n3. run `poetry publish`\n4. check whether package has been successfully uploaded\n\n**Initial Setup**\n\n- Create account on [PyPi](https://pypi.org/)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This package helps companies and financial institutions to assess the temperature alignment of current targets, commitments, and investment and lending portfolios, and to use this information to develop targets for official validation by the SBTi.'",
"version": "0.9.1",
"project_urls": {
"Bug Tracker": "https://github.com/WWF-Sweden/ITR-tool/issues",
"Documentation": "https://wwf-sweden.github.io/ITR-tool",
"Source Code": "https://github.com/WWF-Sweden/ITR-tool/issues"
},
"split_keywords": [
"climate",
"itr",
"sbti",
"finance",
"wwf"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8a276513bc1ff2db18a91783cf91ec83732bcb8edc32a08cf32356764952716d",
"md5": "d43de07ec61080da781cc352cbb7f492",
"sha256": "fec803a54679bcd090dc40b257de0061f5e515aebc37fcfaf900b9871c4039bd"
},
"downloads": -1,
"filename": "wwf_itr-0.9.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d43de07ec61080da781cc352cbb7f492",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 1619164,
"upload_time": "2024-03-08T10:35:24",
"upload_time_iso_8601": "2024-03-08T10:35:24.594056Z",
"url": "https://files.pythonhosted.org/packages/8a/27/6513bc1ff2db18a91783cf91ec83732bcb8edc32a08cf32356764952716d/wwf_itr-0.9.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "84ba2aaff14c337319dc5b36e700eb3bfc3c2fe4856061c39fec3dab81225a47",
"md5": "f90b065e49fb31d5ec7853afd7b1af54",
"sha256": "c52caff0e4bf6d56c17bf29bfb051074fed9e41d322bfa7a770b0094d0057e4c"
},
"downloads": -1,
"filename": "wwf_itr-0.9.1.tar.gz",
"has_sig": false,
"md5_digest": "f90b065e49fb31d5ec7853afd7b1af54",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 1608951,
"upload_time": "2024-03-08T10:35:27",
"upload_time_iso_8601": "2024-03-08T10:35:27.239034Z",
"url": "https://files.pythonhosted.org/packages/84/ba/2aaff14c337319dc5b36e700eb3bfc3c2fe4856061c39fec3dab81225a47/wwf_itr-0.9.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-08 10:35:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WWF-Sweden",
"github_project": "ITR-tool",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "certifi",
"specs": [
[
">=",
"2023.11.17"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
">=",
"3.3.2"
]
]
},
{
"name": "et-xmlfile",
"specs": [
[
"==",
"1.1.0"
]
]
},
{
"name": "idna",
"specs": [
[
">=",
"3.6"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.26.3"
]
]
},
{
"name": "openpyxl",
"specs": [
[
"==",
"3.1.2"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.2.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
"==",
"1.10.14"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
">=",
"2.8.2"
]
]
},
{
"name": "pytz",
"specs": [
[
"==",
"2023.3.post1"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "typing-extensions",
"specs": [
[
">=",
"4.9.0"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "xlrd",
"specs": [
[
">=",
"2.0.1"
]
]
}
],
"lcname": "wwf-itr"
}
JSON
