# cherno
![Versions](https://img.shields.io/badge/python->3.8-blue)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Documentation Status](https://readthedocs.org/projects/sdss-cherno/badge/?version=latest)](https://sdss-cherno.readthedocs.io/en/latest/?badge=latest)
[![Tests Status](https://github.com/sdss/cherno/workflows/Test/badge.svg)](https://github.com/sdss/cherno/actions)
<!-- [![codecov](https://codecov.io/gh/sdss/cherno/branch/main/graph/badge.svg)](https://codecov.io/gh/sdss/cherno) -->
SDSS guider actor
## Installation
In general you should be able to install ``cherno`` by doing
```console
pip install sdss-cherno
```
To build from source, use
```console
git clone git@github.com:sdss/cherno
cd cherno
pip install .
```
## Development
`cherno` uses [poetry](http://poetry.eustace.io/) for dependency management and packaging. To work with an editable install it's recommended that you setup `poetry` and install `cherno` in a virtual environment by doing
```console
poetry install
```
### Style and type checking
This project uses the [black](https://github.com/psf/black) code style with 88-character line lengths for code and docstrings. It is recommended that you run `black` on save. Imports must be sorted using [isort](https://pycqa.github.io/isort/). The GitHub test workflow checks all the Python file to make sure they comply with the black formatting.
Configuration files for [flake8](https://flake8.pycqa.org/en/latest/), [isort](https://pycqa.github.io/isort/), and [black](https://github.com/psf/black) are provided and will be applied by most editors. For Visual Studio Code, the following project file is compatible with the project configuration:
```json
{
"python.formatting.provider": "black",
"[python]" : {
"editor.codeActionsOnSave": {
"source.organizeImports": true
},
"editor.formatOnSave": true
},
"[markdown]": {
"editor.wordWrapColumn": 88
},
"[restructuredtext]": {
"editor.wordWrapColumn": 88
},
"editor.rulers": [88],
"editor.wordWrapColumn": 88,
"python.analysis.typeCheckingMode": "basic"
}
```
This assumes that the [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python) and [Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance) extensions are installed.
This project uses [type hints](https://docs.python.org/3/library/typing.html). Typing is enforced by the test workflow using [pyright](https://github.com/microsoft/pyright) (in practice this means that if ``Pylance`` doesn't produce any errors in basic mode, ``pyright`` shouldn't).
Raw data
{
"_id": null,
"home_page": "https://github.com/sdss/cherno",
"name": "sdss-cherno",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "astronomy, software",
"author": "Jos\u00e9 S\u00e1nchez-Gallego",
"author_email": "gallegoj@uw.edu",
"download_url": "https://files.pythonhosted.org/packages/32/41/be8c28ae2e6905ca415ee27c349bbffe847a8a3fb751dc44d03e2d5f2095/sdss_cherno-0.6.9.tar.gz",
"platform": null,
"description": "# cherno\n\n![Versions](https://img.shields.io/badge/python->3.8-blue)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Documentation Status](https://readthedocs.org/projects/sdss-cherno/badge/?version=latest)](https://sdss-cherno.readthedocs.io/en/latest/?badge=latest)\n[![Tests Status](https://github.com/sdss/cherno/workflows/Test/badge.svg)](https://github.com/sdss/cherno/actions)\n<!-- [![codecov](https://codecov.io/gh/sdss/cherno/branch/main/graph/badge.svg)](https://codecov.io/gh/sdss/cherno) -->\n\n\nSDSS guider actor\n\n## Installation\n\nIn general you should be able to install ``cherno`` by doing\n\n```console\npip install sdss-cherno\n```\n\nTo build from source, use\n\n```console\ngit clone git@github.com:sdss/cherno\ncd cherno\npip install .\n```\n\n## Development\n\n`cherno` uses [poetry](http://poetry.eustace.io/) for dependency management and packaging. To work with an editable install it's recommended that you setup `poetry` and install `cherno` in a virtual environment by doing\n\n```console\npoetry install\n```\n\n### Style and type checking\n\nThis project uses the [black](https://github.com/psf/black) code style with 88-character line lengths for code and docstrings. It is recommended that you run `black` on save. Imports must be sorted using [isort](https://pycqa.github.io/isort/). The GitHub test workflow checks all the Python file to make sure they comply with the black formatting.\n\nConfiguration files for [flake8](https://flake8.pycqa.org/en/latest/), [isort](https://pycqa.github.io/isort/), and [black](https://github.com/psf/black) are provided and will be applied by most editors. For Visual Studio Code, the following project file is compatible with the project configuration:\n\n```json\n{\n \"python.formatting.provider\": \"black\",\n \"[python]\" : {\n \"editor.codeActionsOnSave\": {\n \"source.organizeImports\": true\n },\n \"editor.formatOnSave\": true\n },\n \"[markdown]\": {\n \"editor.wordWrapColumn\": 88\n },\n \"[restructuredtext]\": {\n \"editor.wordWrapColumn\": 88\n },\n \"editor.rulers\": [88],\n \"editor.wordWrapColumn\": 88,\n \"python.analysis.typeCheckingMode\": \"basic\"\n}\n```\n\nThis assumes that the [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python) and [Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance) extensions are installed.\n\nThis project uses [type hints](https://docs.python.org/3/library/typing.html). Typing is enforced by the test workflow using [pyright](https://github.com/microsoft/pyright) (in practice this means that if ``Pylance`` doesn't produce any errors in basic mode, ``pyright`` shouldn't).\n\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "SDSS guider actor",
"version": "0.6.9",
"project_urls": {
"Documentation": "https://sdss-cherno.readthedocs.org",
"Homepage": "https://github.com/sdss/cherno",
"Repository": "https://github.com/sdss/cherno"
},
"split_keywords": [
"astronomy",
" software"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ba7cccdcf70b71772d097a976eeccde0d336075073ce507a313afad442892674",
"md5": "815fa6fa2315c323304685650f433815",
"sha256": "259364e7594b82aec821b4ca98b8e1f0b27aeb200cc2917f9d29328b4a96d603"
},
"downloads": -1,
"filename": "sdss_cherno-0.6.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "815fa6fa2315c323304685650f433815",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 49856,
"upload_time": "2024-04-18T16:20:21",
"upload_time_iso_8601": "2024-04-18T16:20:21.005273Z",
"url": "https://files.pythonhosted.org/packages/ba/7c/ccdcf70b71772d097a976eeccde0d336075073ce507a313afad442892674/sdss_cherno-0.6.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3241be8c28ae2e6905ca415ee27c349bbffe847a8a3fb751dc44d03e2d5f2095",
"md5": "f16054c757d2d9f5c30b6a3738beeee3",
"sha256": "770f3be674bab45b3a0811a6041d936f6cdfb4c0528f18fd1a2e82457b943ffd"
},
"downloads": -1,
"filename": "sdss_cherno-0.6.9.tar.gz",
"has_sig": false,
"md5_digest": "f16054c757d2d9f5c30b6a3738beeee3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 37912,
"upload_time": "2024-04-18T16:20:22",
"upload_time_iso_8601": "2024-04-18T16:20:22.548766Z",
"url": "https://files.pythonhosted.org/packages/32/41/be8c28ae2e6905ca415ee27c349bbffe847a8a3fb751dc44d03e2d5f2095/sdss_cherno-0.6.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-18 16:20:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sdss",
"github_project": "cherno",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sdss-cherno"
}