# Ensembl Python general-purpose utils
[![License](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](https://github.com/Ensembl/ensembl-utils/blob/main/LICENSE)
[![Coverage](https://ensembl.github.io/ensembl-utils/coverage/coverage-badge.svg)](https://ensembl.github.io/ensembl-utils/coverage)
[![CI](https://github.com/Ensembl/ensembl-utils/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Ensembl/ensembl-utils/actions/workflows/ci.yml)
[![Release](https://img.shields.io/pypi/v/ensembl-utils)](https://pypi.org/project/ensembl-utils)
Centralise generic Python utils used by other projects within Ensembl design to facilitate frequent tasks such as input file path checks, archive files IO manipulation or logging setup, among others.
For more information, please consult this repository's [GitHub pages](https://ensembl.github.io/ensembl-utils/).
## Getting Started
### Basic installation
This library is publicly available in [PyPI](https://pypi.org/project/ensembl-utils/) so it can be easily installed with your favourite Python dependency and packaging management tool, e.g.
```bash
pip install ensembl-utils
```
### Quick usage
Besides the standard `import ensembl.utils`, this library also provides some useful command line scripts:
- `extract_file` - to easily extract archive files in different formats
Furthermore, `ensembl-utils` also has a [`pytest`](https://docs.pytest.org/) plugin with some useful functionalities to ease your unit testing. You can enable it by adding it explicitly when running pytest:
```bash
pytest -p ensembl.utils.plugin ...
```
Or adding the following line to your `conftest.py`:
```python
pytest_plugins = ("ensembl.utils.plugin",)
```
## Dependencies
This repository has been developed to support [SQLAlchemy](https://www.sqlalchemy.org) version 1.4 (1.4.45 or later, to ensure "future-compatibility") as well as version 2.0+.
Raw data
{
"_id": null,
"home_page": null,
"name": "ensembl-utils",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ensembl, python, utils",
"author": null,
"author_email": "Ensembl <dev@ensembl.org>",
"download_url": "https://files.pythonhosted.org/packages/c5/df/9f46cec13f5c01653020685cb9f2d399ddabf509467c6e3a7af07eb5be29/ensembl_utils-0.6.0.tar.gz",
"platform": null,
"description": "# Ensembl Python general-purpose utils\n\n[![License](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](https://github.com/Ensembl/ensembl-utils/blob/main/LICENSE)\n[![Coverage](https://ensembl.github.io/ensembl-utils/coverage/coverage-badge.svg)](https://ensembl.github.io/ensembl-utils/coverage)\n[![CI](https://github.com/Ensembl/ensembl-utils/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Ensembl/ensembl-utils/actions/workflows/ci.yml)\n[![Release](https://img.shields.io/pypi/v/ensembl-utils)](https://pypi.org/project/ensembl-utils)\n\nCentralise generic Python utils used by other projects within Ensembl design to facilitate frequent tasks such as input file path checks, archive files IO manipulation or logging setup, among others.\n\nFor more information, please consult this repository's [GitHub pages](https://ensembl.github.io/ensembl-utils/).\n\n## Getting Started\n\n### Basic installation\n\nThis library is publicly available in [PyPI](https://pypi.org/project/ensembl-utils/) so it can be easily installed with your favourite Python dependency and packaging management tool, e.g.\n```bash\npip install ensembl-utils\n```\n\n### Quick usage\n\nBesides the standard `import ensembl.utils`, this library also provides some useful command line scripts:\n- `extract_file` - to easily extract archive files in different formats\n\nFurthermore, `ensembl-utils` also has a [`pytest`](https://docs.pytest.org/) plugin with some useful functionalities to ease your unit testing. You can enable it by adding it explicitly when running pytest:\n```bash\npytest -p ensembl.utils.plugin ...\n```\n\nOr adding the following line to your `conftest.py`:\n```python\npytest_plugins = (\"ensembl.utils.plugin\",)\n```\n\n## Dependencies\n\nThis repository has been developed to support [SQLAlchemy](https://www.sqlalchemy.org) version 1.4 (1.4.45 or later, to ensure \"future-compatibility\") as well as version 2.0+.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Ensembl Python general-purpose utils",
"version": "0.6.0",
"project_urls": {
"Documentation": "https://ensembl.github.io/ensembl-utils/",
"Homepage": "https://www.ensembl.org",
"Issues": "https://github.com/Ensembl/ensembl-utils/issues",
"Repository": "https://github.com/Ensembl/ensembl-utils.git"
},
"split_keywords": [
"ensembl",
" python",
" utils"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cd61d5e9a6553fff5bbe11a4bd73cc72ab6561b7d633841df02d3b48752c2eda",
"md5": "d8b4b104f370f8de5e6fd9382c310a72",
"sha256": "d57ec879b9d29cd9a77a3496a6b766c7ba99fb14ac51ba07aa65f0881ae10bc2"
},
"downloads": -1,
"filename": "ensembl_utils-0.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d8b4b104f370f8de5e6fd9382c310a72",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 27392,
"upload_time": "2024-11-06T14:10:57",
"upload_time_iso_8601": "2024-11-06T14:10:57.952209Z",
"url": "https://files.pythonhosted.org/packages/cd/61/d5e9a6553fff5bbe11a4bd73cc72ab6561b7d633841df02d3b48752c2eda/ensembl_utils-0.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c5df9f46cec13f5c01653020685cb9f2d399ddabf509467c6e3a7af07eb5be29",
"md5": "7ce29ddc5c8a66e2ebc549f6ccfade91",
"sha256": "ee2841af4da1b7f10d2fa88ab844f72dad17042de473759971f4ec1d870a0506"
},
"downloads": -1,
"filename": "ensembl_utils-0.6.0.tar.gz",
"has_sig": false,
"md5_digest": "7ce29ddc5c8a66e2ebc549f6ccfade91",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 175760,
"upload_time": "2024-11-06T14:10:59",
"upload_time_iso_8601": "2024-11-06T14:10:59.878823Z",
"url": "https://files.pythonhosted.org/packages/c5/df/9f46cec13f5c01653020685cb9f2d399ddabf509467c6e3a7af07eb5be29/ensembl_utils-0.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-06 14:10:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Ensembl",
"github_project": "ensembl-utils",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ensembl-utils"
}