Skip to main content

Crunch CLI

PyTest

This Python library is designed for the Crunch Hub, 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 to install the crunch-cli.

pip install crunch-cli --upgrade

Usage

Setup your environment

Go to any competition's page and click on the 'Submit' section. Then copy and paste the command into your terminal.

Reveal your token (animation)

Write your model

import crunch
crunch_tools = crunch.load_notebook()

# load the data
data = crunch_tools.load_data()

# define your model
def train(): ...
def infer(): ...

# test your model
crunch_tools.test()

[!TIP] We always recommend trying the quickstarter, which already contains a working model to help you get started in minutes!

Detecting the environment

Being able to detect whether you are running inside the Runner allows you to configure your programme more precisely.

import crunch

if crunch.is_inside_runner:
  print("running inside the runner")
else:
  print("running elsewhere")

  model.enable_debug()
  logger.set_level("TRACE")

Submit with Crunch CLI

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, limited to 1000 characters)
  --main-file TEXT        Entrypoint of your code.  [default: main.py]       
  --model-directory TEXT  Directory where your model is stored.  [default: resources]
  --export TEXT           Copy the `.tar` to the specified file.
  --no-pip-freeze         Do not do a `pip freeze` to know preferred packages version.
  --dry                   Prepare file but do not really create the submission.

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

crunch_cli-11.11.0.tar.gz (84.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

crunch_cli-11.11.0-py3-none-any.whl (111.3 kB view details)

Uploaded Python 3

File details

Details for the file crunch_cli-11.11.0.tar.gz.

File metadata

  • Download URL: crunch_cli-11.11.0.tar.gz
  • Upload date:
  • Size: 84.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for crunch_cli-11.11.0.tar.gz
Algorithm Hash digest
SHA256 982ffa0550569c3ebfb1e3fa2b804002a30ac6908a9bbf1772010131d3ca8b96
MD5 e5b7410134727005838a7db0ab642cdc
BLAKE2b-256 9e47a751c0fd806e19889b0c710cef93f262773b07e071a770fa41bc7a3eceeb

See more details on using hashes here.

File details

Details for the file crunch_cli-11.11.0-py3-none-any.whl.

File metadata

  • Download URL: crunch_cli-11.11.0-py3-none-any.whl
  • Upload date:
  • Size: 111.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for crunch_cli-11.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2ac4985490b02826a860ac70d9c6c602f1d0309a0236bd83deb8ca7453cac7fa
MD5 c91d9cf3389fce72883269a358cada61
BLAKE2b-256 53a7196f7d4f99de318f41a689bf9a4739cb09f839ec23d0f812171fa7aca5fb

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page