[![Build Status](https://travis-ci.com/ladybug-tools/dragonfly-core.svg?branch=master)](https://travis-ci.com/ladybug-tools/dragonfly-core)
[![Coverage Status](https://coveralls.io/repos/github/ladybug-tools/dragonfly-core/badge.svg?branch=master)](https://coveralls.io/github/ladybug-tools/dragonfly-core)
[![Python 3.10](https://img.shields.io/badge/python-3.10-orange.svg)](https://www.python.org/downloads/release/python-3100/) [![Python 3.7](https://img.shields.io/badge/python-3.7-blue.svg)](https://www.python.org/downloads/release/python-370/) [![Python 2.7](https://img.shields.io/badge/python-2.7-green.svg)](https://www.python.org/downloads/release/python-270/) [![IronPython](https://img.shields.io/badge/ironpython-2.7-red.svg)](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)
# dragonfly-core
![Screenshot](https://github.com/chriswmackey/Dragonfly/blob/master/dragonfly.png)
Dragonfly is a collection of Python libraries to create representations of buildings
following [dragonfly-schema](https://github.com/ladybug-tools/dragonfly-schema/wiki).
It abstracts the capabilities of [honeybee-core](https://github.com/ladybug-tools/honeybee-core/)
to make it easier to construct and edit large models.
This repository is the core repository that provides dragonfly's common functionalities.
To extend these functionalities you should install available Dragonfly extensions or write
your own.
Here are a number of frequently used extensions for Dragonfly:
- [dragonfly-energy](https://github.com/ladybug-tools/dragonfly-energy): Adds Energy simulation to Dragonfly.
## Installation
`pip install -U dragonfly-core`
To check if Dragonfly command line interface is installed correctly use `dragonfly viz` and you
should get a `viiiiiiiiiiiiizzzzzzzzz!` back in response!
## [API Documentation](https://www.ladybug.tools/dragonfly-core/docs/)
## Local Development
1. Clone this repo locally
```console
git clone git@github.com:ladybug-tools/dragonfly-core.git
# or
git clone https://github.com/ladybug-tools/dragonfly-core.git
```
2. Install dependencies:
```console
cd dragonfly-core
pip install -r dev-requirements.txt
pip install -r requirements.txt
```
3. Run Tests:
```console
python -m pytests tests/
```
4. Generate Documentation:
```console
sphinx-apidoc -f -e -d 4 -o ./docs ./dragonfly
sphinx-build -b html ./docs ./docs/_build/docs
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ladybug-tools/dragonfly-core",
"name": "dragonfly-core",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Ladybug Tools",
"author_email": "info@ladybug.tools",
"download_url": "https://files.pythonhosted.org/packages/ae/d6/7612371a4c444bec68b77c7e7d0cbddc50453d600f63c37c3501c66f481c/dragonfly_core-1.56.5.tar.gz",
"platform": null,
"description": "[![Build Status](https://travis-ci.com/ladybug-tools/dragonfly-core.svg?branch=master)](https://travis-ci.com/ladybug-tools/dragonfly-core)\n[![Coverage Status](https://coveralls.io/repos/github/ladybug-tools/dragonfly-core/badge.svg?branch=master)](https://coveralls.io/github/ladybug-tools/dragonfly-core)\n\n[![Python 3.10](https://img.shields.io/badge/python-3.10-orange.svg)](https://www.python.org/downloads/release/python-3100/) [![Python 3.7](https://img.shields.io/badge/python-3.7-blue.svg)](https://www.python.org/downloads/release/python-370/) [![Python 2.7](https://img.shields.io/badge/python-2.7-green.svg)](https://www.python.org/downloads/release/python-270/) [![IronPython](https://img.shields.io/badge/ironpython-2.7-red.svg)](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)\n\n# dragonfly-core\n\n![Screenshot](https://github.com/chriswmackey/Dragonfly/blob/master/dragonfly.png)\n\nDragonfly is a collection of Python libraries to create representations of buildings\nfollowing [dragonfly-schema](https://github.com/ladybug-tools/dragonfly-schema/wiki).\nIt abstracts the capabilities of [honeybee-core](https://github.com/ladybug-tools/honeybee-core/)\nto make it easier to construct and edit large models.\n\nThis repository is the core repository that provides dragonfly's common functionalities.\nTo extend these functionalities you should install available Dragonfly extensions or write\nyour own.\n\nHere are a number of frequently used extensions for Dragonfly:\n- [dragonfly-energy](https://github.com/ladybug-tools/dragonfly-energy): Adds Energy simulation to Dragonfly.\n\n## Installation\n\n`pip install -U dragonfly-core`\n\nTo check if Dragonfly command line interface is installed correctly use `dragonfly viz` and you\nshould get a `viiiiiiiiiiiiizzzzzzzzz!` back in response!\n\n## [API Documentation](https://www.ladybug.tools/dragonfly-core/docs/)\n\n## Local Development\n1. Clone this repo locally\n```console\ngit clone git@github.com:ladybug-tools/dragonfly-core.git\n\n# or\n\ngit clone https://github.com/ladybug-tools/dragonfly-core.git\n```\n2. Install dependencies:\n```console\ncd dragonfly-core\npip install -r dev-requirements.txt\npip install -r requirements.txt\n```\n\n3. Run Tests:\n```console\npython -m pytests tests/\n```\n\n4. Generate Documentation:\n```console\nsphinx-apidoc -f -e -d 4 -o ./docs ./dragonfly\nsphinx-build -b html ./docs ./docs/_build/docs\n```\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": ":dragon: dragonfly core library",
"version": "1.56.5",
"project_urls": {
"Homepage": "https://github.com/ladybug-tools/dragonfly-core"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bc98a3ee1f79a95a96e2d2bf86bad339b58d694ca340e40aa184691927d43ec0",
"md5": "b97a310b7813431caa4a6d265066089d",
"sha256": "4f21d24a04b38ef8b3cba77bdcd9c5aa7f1b5f04de357e47a28dde8f59356ab3"
},
"downloads": -1,
"filename": "dragonfly_core-1.56.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "b97a310b7813431caa4a6d265066089d",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 201621,
"upload_time": "2024-11-03T20:01:15",
"upload_time_iso_8601": "2024-11-03T20:01:15.149229Z",
"url": "https://files.pythonhosted.org/packages/bc/98/a3ee1f79a95a96e2d2bf86bad339b58d694ca340e40aa184691927d43ec0/dragonfly_core-1.56.5-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aed67612371a4c444bec68b77c7e7d0cbddc50453d600f63c37c3501c66f481c",
"md5": "2ce427e946f290554ba5395814d972c0",
"sha256": "92434e6efbbdd0eada01c6b4e52023709d6d2b773b2f41c0567e4ea0f166fb67"
},
"downloads": -1,
"filename": "dragonfly_core-1.56.5.tar.gz",
"has_sig": false,
"md5_digest": "2ce427e946f290554ba5395814d972c0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 712405,
"upload_time": "2024-11-03T20:01:18",
"upload_time_iso_8601": "2024-11-03T20:01:18.061551Z",
"url": "https://files.pythonhosted.org/packages/ae/d6/7612371a4c444bec68b77c7e7d0cbddc50453d600f63c37c3501c66f481c/dragonfly_core-1.56.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-03 20:01:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ladybug-tools",
"github_project": "dragonfly-core",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "honeybee-core",
"specs": [
[
"==",
"1.58.59"
]
]
},
{
"name": "dragonfly-schema",
"specs": [
[
"==",
"1.12.6"
]
]
}
],
"lcname": "dragonfly-core"
}