# CrunchDAO CLI
[](https://github.com/crunchdao/crunch-cli/actions/workflows/pytest.yml)
This Python library is designed for the CrunchDAO Platform, offering convenient access to competition's data and enabling effortless submission. When utilized in the command-line interface (CLI), its goal is to deliver a user experience akin to GitHub, enabling you to seamlessly push the code from your local environment.
## Installation
Use [pip](https://pypi.org/project/crunch-cli/) to install the `crunch-cli`.
```bash
pip install crunch-cli --upgrade
```
## Usage
```python
import crunch
crunch = crunch.load_notebook()
# Getting the data
X_train, y_train, X_test = crunch.load_data()
```
`crunch.load_data()` accept arguments for `read_parquet`.
```python
crunch.load_data(
engine="fastparquet"
)
```
## Submit with Crunch CLI
```bash
Usage: crunch push [OPTIONS]
Send the new submission of your code.
Options:
-m, --message TEXT Specify the change of your code. (like a commit
message)
-e, --main-file TEXT Entrypoint of your code. [default: main.py]
--model-directory TEXT Directory where your model is stored. [default:
resources]
--help Show this message and exit.
```
## Detecting the environment
Detecting whether you are running inside the runner or not, allows you to configure your program more precisely.
```python
import crunch
if crunch.is_inside_runner:
print("running inside the runner")
else:
print("running elsewhere")
model.enable_debug()
logger.set_level("TRACE")
```
## Competition Links
- [Competition Platform](https://www.crunchdao.com)
- [ADIA Lab Market Prediction Competition](https://www.crunchdao.com/live/adialab)
- [see more](https://hub.crunchdao.com/)
## Contributing
Pull requests are always welcome! If you find any issues or have suggestions for improvements, please feel free to submit a pull request or open an issue in the GitHub repository.
## License
[MIT](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": "https://github.com/crunchdao/crunch-cli",
"name": "crunch-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": null,
"keywords": "package development template",
"author": "Enzo CACERES",
"author_email": "enzo.caceres@crunchdao.com",
"download_url": "https://files.pythonhosted.org/packages/aa/5d/8a5c6098a5e2bc06200d47a3d1794daefba2fe70fc4d7e08e1b0f5eaba89/crunch_cli-5.7.5.tar.gz",
"platform": null,
"description": "# CrunchDAO CLI\n\n[](https://github.com/crunchdao/crunch-cli/actions/workflows/pytest.yml)\n\nThis Python library is designed for the CrunchDAO Platform, offering convenient access to competition's data and enabling effortless submission. When utilized in the command-line interface (CLI), its goal is to deliver a user experience akin to GitHub, enabling you to seamlessly push the code from your local environment.\n\n## Installation\n\nUse [pip](https://pypi.org/project/crunch-cli/) to install the `crunch-cli`.\n\n```bash\npip install crunch-cli --upgrade\n```\n\n## Usage\n\n```python\nimport crunch\ncrunch = crunch.load_notebook()\n\n# Getting the data\nX_train, y_train, X_test = crunch.load_data()\n```\n\n`crunch.load_data()` accept arguments for `read_parquet`.\n\n```python\ncrunch.load_data(\n engine=\"fastparquet\"\n)\n```\n\n## Submit with Crunch CLI\n\n```bash\nUsage: crunch push [OPTIONS]\n\n Send the new submission of your code.\n\nOptions:\n -m, --message TEXT Specify the change of your code. (like a commit\n message)\n\n -e, --main-file TEXT Entrypoint of your code. [default: main.py]\n --model-directory TEXT Directory where your model is stored. [default:\n resources]\n\n --help Show this message and exit.\n```\n\n## Detecting the environment\n\nDetecting whether you are running inside the runner or not, allows you to configure your program more precisely.\n\n```python\nimport crunch\n\nif crunch.is_inside_runner:\n print(\"running inside the runner\")\nelse:\n print(\"running elsewhere\")\n\n model.enable_debug()\n logger.set_level(\"TRACE\")\n```\n\n## Competition Links\n\n- [Competition Platform](https://www.crunchdao.com)\n- [ADIA Lab Market Prediction Competition](https://www.crunchdao.com/live/adialab)\n- [see more](https://hub.crunchdao.com/)\n\n## Contributing\n\nPull requests are always welcome! If you find any issues or have suggestions for improvements, please feel free to submit a pull request or open an issue in the GitHub repository.\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n",
"bugtrack_url": null,
"license": null,
"summary": "crunch-cli - CLI of the CrunchDAO Platform",
"version": "5.7.5",
"project_urls": {
"Homepage": "https://github.com/crunchdao/crunch-cli"
},
"split_keywords": [
"package",
"development",
"template"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c398a0f5839c356fa9b56d7363ef62d8cc402cf025dcd9ec62920efd0536f13f",
"md5": "acde597c3861551b71d8316ae946782b",
"sha256": "07b79903c607072ccb2d4772c9b491f8da4c90265a60ec9e8121b8d79f08fe2a"
},
"downloads": -1,
"filename": "crunch_cli-5.7.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "acde597c3861551b71d8316ae946782b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 104586,
"upload_time": "2024-12-13T16:36:07",
"upload_time_iso_8601": "2024-12-13T16:36:07.304268Z",
"url": "https://files.pythonhosted.org/packages/c3/98/a0f5839c356fa9b56d7363ef62d8cc402cf025dcd9ec62920efd0536f13f/crunch_cli-5.7.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aa5d8a5c6098a5e2bc06200d47a3d1794daefba2fe70fc4d7e08e1b0f5eaba89",
"md5": "f8e2ec9f01e360b87c4ef2138b2c5384",
"sha256": "9270b381072fb1cc3190bcc045d16ac86e62ac89abb5b6a78d729b25f7e7997f"
},
"downloads": -1,
"filename": "crunch_cli-5.7.5.tar.gz",
"has_sig": false,
"md5_digest": "f8e2ec9f01e360b87c4ef2138b2c5384",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 79065,
"upload_time": "2024-12-13T16:36:08",
"upload_time_iso_8601": "2024-12-13T16:36:08.988206Z",
"url": "https://files.pythonhosted.org/packages/aa/5d/8a5c6098a5e2bc06200d47a3d1794daefba2fe70fc4d7e08e1b0f5eaba89/crunch_cli-5.7.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-13 16:36:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "crunchdao",
"github_project": "crunch-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "crunch-cli"
}
JSON
