# Artificial Intelligence Library for Chemical Applications (AILCA)
This is a python package for machine learning with chemical data.
It provides various pre-processing modules for chemical data, such as engineering conditions, chemical formulas, and molecular structures.
Also, several wrapper classes and functions are included for chemical machine learning.
This package was implemented based on [Scikit-learn](https://scikit-learn.org/stable/) and [PyTorch](https://pytorch.org/).
# Installation
Before installing AILCA, several required packages should be installed in your environment.
We highly recommend to use [Anaconda](https://www.anaconda.com/) to build your Python environment for AILCA.
1. Install a cheminformatics package [RDKit](https://www.rdkit.org/).
RDKit is available at Anaconda archive.
You can install RDKit using the following command in the Anaconda prompt.
```bash
conda install -c rdkit rdkit
```
2. Install a deep learning framework [PyTorch](https://pytorch.org/).
**If you want to build your machine learning models using GPU, [CUDA >= 11.1](https://developer.nvidia.com/cuda-11.1.0-download-archive) must be installed your machine.**
With CUDA of version 11.1, you can install PyTorch using the following command.
```bash
conda install pytorch torchvision torchaudio cudatoolkit=11.1 -c pytorch -c conda-forge
```
3. Install a graph-based deep learning framework [PyTorch Geometric](https://pytorch-geometric.readthedocs.io/en/latest/).
It must be installed to build machine learning models that predict target values from molecular and crystal structures.
You can install PyTorch Geometric using the following command.
```bash
conda install pytorch-geometric -c rusty1s -c conda-forge
```
4. Install required packages from `requirements.txt` in GitHub.
After downloading the requirements file, you can install all required packages using the following commend.
```bash
conda install --file requirements.txt
```
5. (Optional) If your operating system is Windows, install [Graphviz](https://graphviz.org/) to visualize interpretable information of machine learning algorithms.
You can install Graphviz using the following command.
```bash
conda install -c conda-forge python-graphviz
```
6. Finally, install AILCA in your Python environment with the following command.
```bash
pip install ailca
```
---
## Examples
Follow the instructions in [PyTorch Installation](https://pytorch.org/get-started/locally/) to install the PyTorch package on your environment.
## Installation of PyTorch Geometric
## Installation of RDKit
### Package, module name
Many use a same package and module name, you could definitely do that. But this example package and its module's names are different: `example_pypi_package` and `examplepy`.
Open `example_pypi_package` folder with Visual Studio Code, <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> (Windows / Linux) or <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> (MacOS) to find all occurrences of both names and replace them with your package and module's names. Also remember to change the name of the folder **src/examplepy**.
Simply and very roughly speaking, package name is used in `pip install <PACKAGENAME>` and module name is used in `import <MODULENAME>`. Both names should consist of lowercase basic letters (a-z). They may have underscores (`_`) if you really need them. Hyphen-minus (`-`) should not be used.
You'll also need to make sure the URL "https://pypi.org/project/example-pypi-package/" (replace `example-pypi-package` by your package name, with all `_` becoming `-`) is not occupied.
<details><summary><strong>Details on naming convention (click to show/hide)</strong></summary>
Underscores (`_`) can be used but such use is discouraged. Numbers can be used if the name does not start with a number, but such use is also discouraged.
Name starting with a number and/or containing hyphen-minus (`-`) should not be used: although technically legal, such name causes a lot of trouble − users have to use `importlib` to import it.
Don't be fooled by the URL "[pypi.org/project/example-pypi-package/](https://pypi.org/project/example-pypi-package/)" and the name "example-pypi-package" on pypi.org. pypi.org and pip system convert all `_` to `-` and use the latter on the website / in `pip` command, but the real name is still with `_`, which users should use when importing the package.
There's also [namespace](https://packaging.python.org/guides/packaging-namespace-packages/) to use if you need sub-packages.
</details>
### Other changes
Make necessary changes in **setup.py**.
The package's version number `__version__` is in **src/examplepy/\_\_init\_\_.py**. You may want to change that.
The example package is designed to be compatible with Python 3.6, 3.7, 3.8, 3.9, and will be tested against these versions. If you need to change the version range, you should change:
- `classifiers`, `python_requires` in **setup.py**
- `envlist` in **tox.ini**
- `matrix: python:` in **.github/workflows/test.yml**
If you plan to upload to [TestPyPI](https://test.pypi.org/) which is a playground of [PyPI](https://pypi.org/) for testing purpose, change `twine upload --repository pypi dist/*` to `twine upload --repository testpypi dist/*` in the file **.github/workflows/release.yml**.
## Development
### pip
pip is a Python package manager. You already have pip if you use Python 3.4 and later version which include it by default. Read [this](https://pip.pypa.io/en/stable/installing/#do-i-need-to-install-pip) to know how to check whether pip is installed. Read [this](https://pip.pypa.io/en/stable/installing/#installing-with-get-pip-py) if you need to install it.
### Use VS Code
Visual Studio Code is the most popular code editor today, our example package is configured to work with VS Code.
Install VS Code extension "[Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python)".
"Python" VS Code extension will suggest you install pylint. Also, the example package is configured to use pytest with VS Code + Python extensions, so, install pylint and pytest:
```bash
pip install pylint pytest
```
(It's likely you will be prompted to install them, if that's the case, you don't need to type and execute the command)
**vscode.env**'s content is now `PYTHONPATH=/;src/;${PYTHONPATH}` which is good for Windows. If you use Linux or MacOS, you need to change it to `PYTHONPATH=/:src/:${PYTHONPATH}` (replacing `;` with `:`). If the PATH is not properly set, you'll see linting errors in test files and pytest won't be able to run **tests/test\_\*.py** files correctly.
Close and reopen VS Code. You can now click the lab flask icon in the left menu and run all tests there, with pytest. pytest seems better than the standard unittest framework, it supports `unittest` thus you can keep using `import unittest` in your test files.
The example package also has a **.editorconfig** file. You may install VS Code extension "[EditorConfig for VS Code](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)" that uses the file. With current configuration, the EditorConfig tool can automatically use spaces (4 spaces for .py, 2 for others) for indentation, set `UTF-8` encoding, `LF` end of lines, trim trailing whitespaces in non Markdown files, etc.
In VS Code, you can go to File -> Preferences -> Settings, type "Python Formatting Provider" in the search box, and choose one of the three Python code formatting tools (autopep8, black and yapf), you'll be prompted to install it. The shortcuts for formatting of a code file are <kbd>Shift</kbd> + <kbd>Alt</kbd> + <kbd>F</kbd> (Windows); <kbd>Shift</kbd> + <kbd>Option (Alt)</kbd> + <kbd>F</kbd> (MacOS); <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>I</kbd> (Linux).
### Write your package
In **src/examplepy/** (`examplepy` should have been replaced by your module name) folder, rename **module1.py** and write your code in it. Add more module .py files if you need to.
### Write your tests
In **tests/** folder, rename **test_module1.py** (to **test\_\*.py**) and write your unit test code (with [unittest](https://docs.python.org/3/library/unittest.html)) in it. Add more **test\_\*.py** files if you need to.
<details><summary><strong>The testing tool `tox` will be used in the automation with GitHub Actions CI/CD. If you want to use `tox` locally, click to read the "Use tox locally" section</strong></summary>
### Use tox locally
Install tox and run it:
```bash
pip install tox
tox
```
In our configuration, tox runs a check of source distribution using [check-manifest](https://pypi.org/project/check-manifest/) (which requires your repo to be git-initialized (`git init`) and added (`git add .`) at least), setuptools's check, and unit tests using pytest. You don't need to install check-manifest and pytest though, tox will install them in a separate environment.
The automated tests are run against several Python versions, but on your machine, you might be using only one version of Python, if that is Python 3.9, then run:
```bash
tox -e py39
```
</details>
If you add more files to the root directory (**example_pypi_package/**), you'll need to add your file to `check-manifest --ignore` list in **tox.ini**.
<details><summary><strong>Thanks to GitHub Actions' automated process, you don't need to generate distribution files locally. But if you insist, click to read the "Generate distribution files" section</strong></summary>
## Generate distribution files
### Install tools
Install or upgrade `setuptools` and `wheel`:
```bash
python -m pip install --user --upgrade setuptools wheel
```
(If `python3` is the command on your machine, change `python` to `python3` in the above command, or add a line `alias python=python3` to **~/.bashrc** or **~/.bash_aliases** file if you use bash on Linux)
### Generate `dist`
From `example_pypi_package` directory, run the following command, in order to generate production version for source distribution (sdist) in `dist` folder:
```bash
python setup.py sdist bdist_wheel
```
### Install locally
Optionally, you can install dist version of your package locally before uploading to [PyPI](https://pypi.org/) or [TestPyPI](https://test.pypi.org/):
```bash
pip install dist/example_pypi_package-0.1.0.tar.gz
```
(You may need to uninstall existing package first:
```bash
pip uninstall example_pypi_package
```
There may be several installed packages with the same name, so run `pip uninstall` multiple times until it says no more package to remove.)
</details>
## Upload to PyPI
### Register on PyPI and get token
Register an account on [PyPI](https://pypi.org/), go to [Account settings § API tokens](https://pypi.org/manage/account/#api-tokens), "Add API token". The PyPI token only appears once, copy it somewhere. If you missed it, delete the old and add a new token.
(Register a [TestPyPI](https://test.pypi.org/) account if you are uploading to TestPyPI)
### Set secret in GitHub repo
On the page of your newly created or existing GitHub repo, click **Settings** -> **Secrets** -> **New repository secret**, the **Name** should be `PYPI_API_TOKEN` and the **Value** should be your PyPI token (which starts with `pypi-`).
### Push or release
The example package has automated tests and upload (publishing) already set up with GitHub Actions:
- Every time you `git push` your `master` or `main` branch, the package is automatically tested against the desired Python versions with GitHub Actions.
- Every time a new release (either the initial version or an updated version) is created, the package is automatically uploaded to PyPI with GitHub Actions.
### View it on pypi.org
After your package is published on PyPI, go to [https://pypi.org/project/example-pypi-package/](https://pypi.org/project/example-pypi-package/) (`_` becomes `-`). Copy the command on the page, execute it to download and install your package from PyPI. (or test.pypi.org if you use that)
<details><summary><strong>If you publish the package to PyPI manually, click to read</strong></summary>
### Install Twine
Install or upgrade Twine:
```bash
python -m pip install --user --upgrade twine
```
Create a **.pypirc** file in your **$HOME** (**~**) directory, its content should be:
```ini
[pypi]
username = __token__
password = <PyPI token>
```
(Use `[testpypi]` instead of `[pypi]` if you are uploading to [TestPyPI](https://test.pypi.org/))
Replace `<PyPI token>` with your real PyPI token (which starts with `pypi-`).
(if you don't manually create **$HOME/.pypirc**, you will be prompted for a username (which should be `__token__`) and password (which should be your PyPI token) when you run Twine)
### Upload
Run Twine to upload all of the archives under **dist** folder:
```bash
python -m twine upload --repository pypi dist/*
```
(use `testpypi` instead of `pypi` if you are uploading to [TestPyPI](https://test.pypi.org/))
### Update
When you finished developing a newer version of your package, do the following things.
Modify the version number `__version__` in **src\examplepy\_\_init\_\_.py**.
Delete all old versions in **dist**.
Run the following command again to regenerate **dist**:
```bash
python setup.py sdist bdist_wheel
```
Run the following command again to upload **dist**:
```bash
python -m twine upload --repository pypi dist/*
```
(use `testpypi` instead of `pypi` if needed)
</details>
## References
- [Python Packaging Authority (PyPA)'s sample project](https://github.com/pypa/sampleproject)
- [PyPA's Python Packaging User Guide](https://packaging.python.org/tutorials/packaging-projects/)
- [Stackoverflow questions and answers](https://stackoverflow.com/questions/41093648/how-to-test-that-pypi-install-will-work-before-pushing-to-pypi-python)
- [GitHub Actions Guides: Building and testing Python](https://docs.github.com/en/free-pro-team@latest/actions/guides/building-and-testing-python)
Raw data
{
"_id": null,
"home_page": "",
"name": "ailca",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "chemical science,materials science,artificial intelligence,machine learning",
"author": "Gyoung S. Na",
"author_email": "ngs0@krict.re.kr",
"download_url": "https://files.pythonhosted.org/packages/38/15/08a6b75aef4d4e926e2014d51a7cc8a1d710dc2fb874c3cab98b9efd659c/ailca-0.3.2.tar.gz",
"platform": null,
"description": "# Artificial Intelligence Library for Chemical Applications (AILCA)\n\nThis is a python package for machine learning with chemical data.\nIt provides various pre-processing modules for chemical data, such as engineering conditions, chemical formulas, and molecular structures.\nAlso, several wrapper classes and functions are included for chemical machine learning.\nThis package was implemented based on [Scikit-learn](https://scikit-learn.org/stable/) and [PyTorch](https://pytorch.org/).\n\n# Installation\nBefore installing AILCA, several required packages should be installed in your environment.\nWe highly recommend to use [Anaconda](https://www.anaconda.com/) to build your Python environment for AILCA.\n\n1. Install a cheminformatics package [RDKit](https://www.rdkit.org/). \n RDKit is available at Anaconda archive.\n You can install RDKit using the following command in the Anaconda prompt.\n \n```bash\nconda install -c rdkit rdkit\n```\n\n2. Install a deep learning framework [PyTorch](https://pytorch.org/). \n **If you want to build your machine learning models using GPU, [CUDA >= 11.1](https://developer.nvidia.com/cuda-11.1.0-download-archive) must be installed your machine.**\n With CUDA of version 11.1, you can install PyTorch using the following command.\n \n```bash\nconda install pytorch torchvision torchaudio cudatoolkit=11.1 -c pytorch -c conda-forge\n```\n\n3. Install a graph-based deep learning framework [PyTorch Geometric](https://pytorch-geometric.readthedocs.io/en/latest/). \n It must be installed to build machine learning models that predict target values from molecular and crystal structures. \n You can install PyTorch Geometric using the following command.\n \n```bash\nconda install pytorch-geometric -c rusty1s -c conda-forge\n```\n\n4. Install required packages from `requirements.txt` in GitHub.\n After downloading the requirements file, you can install all required packages using the following commend.\n \n```bash\nconda install --file requirements.txt\n```\n\n5. (Optional) If your operating system is Windows, install [Graphviz](https://graphviz.org/) to visualize interpretable information of machine learning algorithms.\n You can install Graphviz using the following command.\n \n```bash\nconda install -c conda-forge python-graphviz\n```\n\n6. Finally, install AILCA in your Python environment with the following command.\n\n```bash\npip install ailca\n```\n---\n\n## Examples\n\nFollow the instructions in [PyTorch Installation](https://pytorch.org/get-started/locally/) to install the PyTorch package on your environment.\n\n\n## Installation of PyTorch Geometric\n\n\n## Installation of RDKit\n\n\n### Package, module name\n\nMany use a same package and module name, you could definitely do that. But this example package and its module's names are different: `example_pypi_package` and `examplepy`.\n\nOpen `example_pypi_package` folder with Visual Studio Code, <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> (Windows / Linux) or <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> (MacOS) to find all occurrences of both names and replace them with your package and module's names. Also remember to change the name of the folder **src/examplepy**.\n\nSimply and very roughly speaking, package name is used in `pip install <PACKAGENAME>` and module name is used in `import <MODULENAME>`. Both names should consist of lowercase basic letters (a-z). They may have underscores (`_`) if you really need them. Hyphen-minus (`-`) should not be used.\n\nYou'll also need to make sure the URL \"https://pypi.org/project/example-pypi-package/\" (replace `example-pypi-package` by your package name, with all `_` becoming `-`) is not occupied.\n\n<details><summary><strong>Details on naming convention (click to show/hide)</strong></summary>\n\nUnderscores (`_`) can be used but such use is discouraged. Numbers can be used if the name does not start with a number, but such use is also discouraged.\n\nName starting with a number and/or containing hyphen-minus (`-`) should not be used: although technically legal, such name causes a lot of trouble \u2212 users have to use `importlib` to import it.\n\nDon't be fooled by the URL \"[pypi.org/project/example-pypi-package/](https://pypi.org/project/example-pypi-package/)\" and the name \"example-pypi-package\" on pypi.org. pypi.org and pip system convert all `_` to `-` and use the latter on the website / in `pip` command, but the real name is still with `_`, which users should use when importing the package.\n\nThere's also [namespace](https://packaging.python.org/guides/packaging-namespace-packages/) to use if you need sub-packages.\n\n</details>\n\n### Other changes\n\nMake necessary changes in **setup.py**.\n\nThe package's version number `__version__` is in **src/examplepy/\\_\\_init\\_\\_.py**. You may want to change that.\n\nThe example package is designed to be compatible with Python 3.6, 3.7, 3.8, 3.9, and will be tested against these versions. If you need to change the version range, you should change:\n\n- `classifiers`, `python_requires` in **setup.py**\n- `envlist` in **tox.ini**\n- `matrix: python:` in **.github/workflows/test.yml**\n\nIf you plan to upload to [TestPyPI](https://test.pypi.org/) which is a playground of [PyPI](https://pypi.org/) for testing purpose, change `twine upload --repository pypi dist/*` to `twine upload --repository testpypi dist/*` in the file **.github/workflows/release.yml**.\n\n## Development\n\n### pip\n\npip is a Python package manager. You already have pip if you use Python 3.4 and later version which include it by default. Read [this](https://pip.pypa.io/en/stable/installing/#do-i-need-to-install-pip) to know how to check whether pip is installed. Read [this](https://pip.pypa.io/en/stable/installing/#installing-with-get-pip-py) if you need to install it.\n\n### Use VS Code\n\nVisual Studio Code is the most popular code editor today, our example package is configured to work with VS Code.\n\nInstall VS Code extension \"[Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python)\".\n\n\"Python\" VS Code extension will suggest you install pylint. Also, the example package is configured to use pytest with VS Code + Python extensions, so, install pylint and pytest:\n\n```bash\npip install pylint pytest\n```\n\n(It's likely you will be prompted to install them, if that's the case, you don't need to type and execute the command)\n\n**vscode.env**'s content is now `PYTHONPATH=/;src/;${PYTHONPATH}` which is good for Windows. If you use Linux or MacOS, you need to change it to `PYTHONPATH=/:src/:${PYTHONPATH}` (replacing `;` with `:`). If the PATH is not properly set, you'll see linting errors in test files and pytest won't be able to run **tests/test\\_\\*.py** files correctly.\n\nClose and reopen VS Code. You can now click the lab flask icon in the left menu and run all tests there, with pytest. pytest seems better than the standard unittest framework, it supports `unittest` thus you can keep using `import unittest` in your test files.\n\nThe example package also has a **.editorconfig** file. You may install VS Code extension \"[EditorConfig for VS Code](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)\" that uses the file. With current configuration, the EditorConfig tool can automatically use spaces (4 spaces for .py, 2 for others) for indentation, set `UTF-8` encoding, `LF` end of lines, trim trailing whitespaces in non Markdown files, etc.\n\nIn VS Code, you can go to File -> Preferences -> Settings, type \"Python Formatting Provider\" in the search box, and choose one of the three Python code formatting tools (autopep8, black and yapf), you'll be prompted to install it. The shortcuts for formatting of a code file are <kbd>Shift</kbd> + <kbd>Alt</kbd> + <kbd>F</kbd> (Windows); <kbd>Shift</kbd> + <kbd>Option (Alt)</kbd> + <kbd>F</kbd> (MacOS); <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>I</kbd> (Linux).\n\n### Write your package\n\nIn **src/examplepy/** (`examplepy` should have been replaced by your module name) folder, rename **module1.py** and write your code in it. Add more module .py files if you need to.\n\n### Write your tests\n\nIn **tests/** folder, rename **test_module1.py** (to **test\\_\\*.py**) and write your unit test code (with [unittest](https://docs.python.org/3/library/unittest.html)) in it. Add more **test\\_\\*.py** files if you need to.\n\n<details><summary><strong>The testing tool `tox` will be used in the automation with GitHub Actions CI/CD. If you want to use `tox` locally, click to read the \"Use tox locally\" section</strong></summary>\n\n### Use tox locally\n\nInstall tox and run it:\n\n```bash\npip install tox\ntox\n```\n\nIn our configuration, tox runs a check of source distribution using [check-manifest](https://pypi.org/project/check-manifest/) (which requires your repo to be git-initialized (`git init`) and added (`git add .`) at least), setuptools's check, and unit tests using pytest. You don't need to install check-manifest and pytest though, tox will install them in a separate environment.\n\nThe automated tests are run against several Python versions, but on your machine, you might be using only one version of Python, if that is Python 3.9, then run:\n\n```bash\ntox -e py39\n```\n\n</details>\n\nIf you add more files to the root directory (**example_pypi_package/**), you'll need to add your file to `check-manifest --ignore` list in **tox.ini**.\n\n<details><summary><strong>Thanks to GitHub Actions' automated process, you don't need to generate distribution files locally. But if you insist, click to read the \"Generate distribution files\" section</strong></summary>\n\n## Generate distribution files\n\n### Install tools\n\nInstall or upgrade `setuptools` and `wheel`:\n\n```bash\npython -m pip install --user --upgrade setuptools wheel\n```\n\n(If `python3` is the command on your machine, change `python` to `python3` in the above command, or add a line `alias python=python3` to **~/.bashrc** or **~/.bash_aliases** file if you use bash on Linux)\n\n### Generate `dist`\n\nFrom `example_pypi_package` directory, run the following command, in order to generate production version for source distribution (sdist) in `dist` folder:\n\n```bash\npython setup.py sdist bdist_wheel\n```\n\n### Install locally\n\nOptionally, you can install dist version of your package locally before uploading to [PyPI](https://pypi.org/) or [TestPyPI](https://test.pypi.org/):\n\n```bash\npip install dist/example_pypi_package-0.1.0.tar.gz\n```\n\n(You may need to uninstall existing package first:\n\n```bash\npip uninstall example_pypi_package\n```\n\nThere may be several installed packages with the same name, so run `pip uninstall` multiple times until it says no more package to remove.)\n\n</details>\n\n## Upload to PyPI\n\n### Register on PyPI and get token\n\nRegister an account on [PyPI](https://pypi.org/), go to [Account settings \u00a7 API tokens](https://pypi.org/manage/account/#api-tokens), \"Add API token\". The PyPI token only appears once, copy it somewhere. If you missed it, delete the old and add a new token.\n\n(Register a [TestPyPI](https://test.pypi.org/) account if you are uploading to TestPyPI)\n\n### Set secret in GitHub repo\n\nOn the page of your newly created or existing GitHub repo, click **Settings** -> **Secrets** -> **New repository secret**, the **Name** should be `PYPI_API_TOKEN` and the **Value** should be your PyPI token (which starts with `pypi-`).\n\n### Push or release\n\nThe example package has automated tests and upload (publishing) already set up with GitHub Actions:\n\n- Every time you `git push` your `master` or `main` branch, the package is automatically tested against the desired Python versions with GitHub Actions.\n- Every time a new release (either the initial version or an updated version) is created, the package is automatically uploaded to PyPI with GitHub Actions.\n\n### View it on pypi.org\n\nAfter your package is published on PyPI, go to [https://pypi.org/project/example-pypi-package/](https://pypi.org/project/example-pypi-package/) (`_` becomes `-`). Copy the command on the page, execute it to download and install your package from PyPI. (or test.pypi.org if you use that)\n\n<details><summary><strong>If you publish the package to PyPI manually, click to read</strong></summary>\n\n### Install Twine\n\nInstall or upgrade Twine:\n\n```bash\npython -m pip install --user --upgrade twine\n```\n\nCreate a **.pypirc** file in your **$HOME** (**~**) directory, its content should be:\n\n```ini\n[pypi]\nusername = __token__\npassword = <PyPI token>\n```\n\n(Use `[testpypi]` instead of `[pypi]` if you are uploading to [TestPyPI](https://test.pypi.org/))\n\nReplace `<PyPI token>` with your real PyPI token (which starts with `pypi-`).\n\n(if you don't manually create **$HOME/.pypirc**, you will be prompted for a username (which should be `__token__`) and password (which should be your PyPI token) when you run Twine)\n\n### Upload\n\nRun Twine to upload all of the archives under **dist** folder:\n\n```bash\npython -m twine upload --repository pypi dist/*\n```\n\n(use `testpypi` instead of `pypi` if you are uploading to [TestPyPI](https://test.pypi.org/))\n\n### Update\n\nWhen you finished developing a newer version of your package, do the following things.\n\nModify the version number `__version__` in **src\\examplepy\\_\\_init\\_\\_.py**.\n\nDelete all old versions in **dist**.\n\nRun the following command again to regenerate **dist**:\n\n```bash\npython setup.py sdist bdist_wheel\n```\n\nRun the following command again to upload **dist**:\n\n```bash\npython -m twine upload --repository pypi dist/*\n```\n\n(use `testpypi` instead of `pypi` if needed)\n\n</details>\n\n## References\n\n- [Python Packaging Authority (PyPA)'s sample project](https://github.com/pypa/sampleproject)\n- [PyPA's Python Packaging User Guide](https://packaging.python.org/tutorials/packaging-projects/)\n- [Stackoverflow questions and answers](https://stackoverflow.com/questions/41093648/how-to-test-that-pypi-install-will-work-before-pushing-to-pypi-python)\n- [GitHub Actions Guides: Building and testing Python](https://docs.github.com/en/free-pro-team@latest/actions/guides/building-and-testing-python)\n",
"bugtrack_url": null,
"license": "",
"summary": "Python package for chemical machine learning.",
"version": "0.3.2",
"split_keywords": [
"chemical science",
"materials science",
"artificial intelligence",
"machine learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "a34dd1f16b832d30710aed977ef894fc",
"sha256": "f41f0d72ffdfcc2426cd6c57c53656fa106ebe98f27ff182ccfaa1db28bd837d"
},
"downloads": -1,
"filename": "ailca-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a34dd1f16b832d30710aed977ef894fc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 46333,
"upload_time": "2022-12-08T06:03:57",
"upload_time_iso_8601": "2022-12-08T06:03:57.641559Z",
"url": "https://files.pythonhosted.org/packages/26/4c/d415e00c939754e12fa32c5075b66b3cefac819b8406847586150559d792/ailca-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "e46f901af0a38abd5f5b651e6a5279fc",
"sha256": "0655aadb9c3e20a853f1610ed549c0ea6499efa91b653a933098738579e5e635"
},
"downloads": -1,
"filename": "ailca-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "e46f901af0a38abd5f5b651e6a5279fc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 38677,
"upload_time": "2022-12-08T06:04:01",
"upload_time_iso_8601": "2022-12-08T06:04:01.397556Z",
"url": "https://files.pythonhosted.org/packages/38/15/08a6b75aef4d4e926e2014d51a7cc8a1d710dc2fb874c3cab98b9efd659c/ailca-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-08 06:04:01",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "ailca"
}
JSON