<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [e3psi](#e3psi)
- [About](#about)
- [Development](#development)
- [First things first](#first-things-first)
- [Getting Started](#getting-started)
- [Tests](#tests)
- [Contributing](#contributing)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
# e3psi
[![python3](https://img.shields.io/badge/python-3.6%20%7C%203.7%20%7C%203.8-brightgreen.svg)](https://python3statement.org/#sections50-why)
[![CircleCI](https://circleci.com/gh/muhrin/e3psi/tree/master.svg?style=svg)](https://circleci.com/gh/muhrin/e3psi/tree/master)
[![Coverage Status](https://coveralls.io/repos/github/muhrin/e3psi/badge.svg)](https://coveralls.io/github/muhrin/e3psi)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
[![DeepSource](https://static.deepsource.io/deepsource-badge-light-mini.svg)](https://deepsource.io/gh/muhrin/e3psi/?ref=repository-badge)
[![dependabot](https://badgen.net/dependabot/muhrin/e3psi/?icon=dependabot)](https://dependabot.com/)
[![Requirements Status](https://requires.io/github/muhrin/e3psi/requirements.svg?branch=master)](https://requires.io/github/muhrin/e3psi/requirements/?branch=master)
## About
Equivariant machine learning library for learning from electronic structures
## Development
### First things first
You can develop on Windows, GNU/Linux or Mac OS X. You need:
- [Python 3.6 and above](https://www.python.org/) and a python [**virtual environment**](https://realpython.com/python-virtual-environments-a-primer/).
- [Git](https://git-scm.com/)
### Getting Started
First, [fork](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo) this repository, then fire up your command prompt and ...
1. Clone the forked repository
2. Navigate to the cloned project directory: `cd e3psi`
3. activate your python virtual environment and `pip install -r requirements.txt`.
4. `pre-commit install`
5. `pre-commit install --hook-type commit-msg`
6. `pre-commit run --all-files`
Now you can start working on the code.
### Tests
Simply run `pytest`. For more detailed output, including test coverage:
```sh
pytest -vv --cov=. --cov-report term-missing
```
### Contributing
If you would like to contribute to the project:
- if you're making code contributions, please try and write some tests to accompany your code, and ensure that the tests pass.
- commit your changes via `cz commit`. Follow the prompts. When you're done, `pre-commit` will be invoked to ensure that your contributions and commits follow defined conventions. See `pre-commit-config.yaml` for more details.
- your commit messages should follow the conventions described [here](https://www.conventionalcommits.org/en/v1.0.0/). Write your commit message in the imperative: "Fix bug" and not "Fixed bug" or "Fixes bug." This convention matches up with commit messages generated by commands like `git merge` and `git revert`.
Once you are done, please create a [pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request).
----
Raw data
{
"_id": null,
"home_page": null,
"name": "e3psi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "machine learning,equivariant,electronic structure",
"author": null,
"author_email": "Martin Uhrin <martin.uhrin.10@ucl.ac.uk>",
"download_url": "https://files.pythonhosted.org/packages/82/c2/27fd3da45a7115ee71ce35745b27f0616bcbb301ede8dbf707bbe00ab8ba/e3psi-0.3.1.tar.gz",
"platform": null,
"description": "<!-- START doctoc generated TOC please keep comment here to allow auto update -->\n<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\n**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*\n\n- [e3psi](#e3psi)\n - [About](#about)\n - [Development](#development)\n - [First things first](#first-things-first)\n - [Getting Started](#getting-started)\n - [Tests](#tests)\n - [Contributing](#contributing)\n\n<!-- END doctoc generated TOC please keep comment here to allow auto update -->\n\n# e3psi\n\n[![python3](https://img.shields.io/badge/python-3.6%20%7C%203.7%20%7C%203.8-brightgreen.svg)](https://python3statement.org/#sections50-why)\n[![CircleCI](https://circleci.com/gh/muhrin/e3psi/tree/master.svg?style=svg)](https://circleci.com/gh/muhrin/e3psi/tree/master)\n[![Coverage Status](https://coveralls.io/repos/github/muhrin/e3psi/badge.svg)](https://coveralls.io/github/muhrin/e3psi)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)\n[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)\n[![DeepSource](https://static.deepsource.io/deepsource-badge-light-mini.svg)](https://deepsource.io/gh/muhrin/e3psi/?ref=repository-badge)\n[![dependabot](https://badgen.net/dependabot/muhrin/e3psi/?icon=dependabot)](https://dependabot.com/)\n[![Requirements Status](https://requires.io/github/muhrin/e3psi/requirements.svg?branch=master)](https://requires.io/github/muhrin/e3psi/requirements/?branch=master)\n\n## About\n\nEquivariant machine learning library for learning from electronic structures\n\n\n## Development\n\n### First things first\n\nYou can develop on Windows, GNU/Linux or Mac OS X. You need:\n\n- [Python 3.6 and above](https://www.python.org/) and a python [**virtual environment**](https://realpython.com/python-virtual-environments-a-primer/).\n- [Git](https://git-scm.com/)\n\n### Getting Started\nFirst, [fork](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo) this repository, then fire up your command prompt and ...\n\n1. Clone the forked repository\n2. Navigate to the cloned project directory: `cd e3psi`\n3. activate your python virtual environment and `pip install -r requirements.txt`.\n4. `pre-commit install`\n5. `pre-commit install --hook-type commit-msg`\n6. `pre-commit run --all-files`\n\nNow you can start working on the code.\n\n### Tests\n\nSimply run `pytest`. For more detailed output, including test coverage:\n\n```sh\npytest -vv --cov=. --cov-report term-missing\n```\n\n### Contributing\n\nIf you would like to contribute to the project:\n\n- if you're making code contributions, please try and write some tests to accompany your code, and ensure that the tests pass.\n- commit your changes via `cz commit`. Follow the prompts. When you're done, `pre-commit` will be invoked to ensure that your contributions and commits follow defined conventions. See `pre-commit-config.yaml` for more details.\n- your commit messages should follow the conventions described [here](https://www.conventionalcommits.org/en/v1.0.0/). Write your commit message in the imperative: \"Fix bug\" and not \"Fixed bug\" or \"Fixes bug.\" This convention matches up with commit messages generated by commands like `git merge` and `git revert`.\nOnce you are done, please create a [pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request).\n\n\n----\n",
"bugtrack_url": null,
"license": null,
"summary": "Equivariant machine learning library for learning from electronic structures.",
"version": "0.3.1",
"project_urls": null,
"split_keywords": [
"machine learning",
"equivariant",
"electronic structure"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "91526e5485d244698bbb0ef1935364686d0b5fb52e060c02fb76d132cf4c8f3f",
"md5": "ee708296c335e596be9357dba3fd7a22",
"sha256": "d68bddf12d7e671bf457e0cb9c91ec6a8bd7e4f4bd724aea8db54863e4f76ad6"
},
"downloads": -1,
"filename": "e3psi-0.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ee708296c335e596be9357dba3fd7a22",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 12878,
"upload_time": "2024-01-05T16:48:15",
"upload_time_iso_8601": "2024-01-05T16:48:15.135814Z",
"url": "https://files.pythonhosted.org/packages/91/52/6e5485d244698bbb0ef1935364686d0b5fb52e060c02fb76d132cf4c8f3f/e3psi-0.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "82c227fd3da45a7115ee71ce35745b27f0616bcbb301ede8dbf707bbe00ab8ba",
"md5": "6eab05882cbd55fac9bbbc38f09208a0",
"sha256": "7ada985f335df8347bd0f4e42bfda6d146e4ba2aedf1551e0c9cf397092d67d9"
},
"downloads": -1,
"filename": "e3psi-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "6eab05882cbd55fac9bbbc38f09208a0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 18613,
"upload_time": "2024-01-05T16:48:17",
"upload_time_iso_8601": "2024-01-05T16:48:17.112969Z",
"url": "https://files.pythonhosted.org/packages/82/c2/27fd3da45a7115ee71ce35745b27f0616bcbb301ede8dbf707bbe00ab8ba/e3psi-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-05 16:48:17",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "e3psi"
}