[日本語版](https://github.com/opthub-org/opthub-client/blob/main/README_ja.md) 👈
# OptHub Client
The Opthub Client is a Python package that provides the following features:
- Submitting solutions to OptHub competitions
- Checking the history and status of solutions submitted to OptHub competitions
This section explains how to install the OptHub Client and provides a tutorial. For more detailed instructions, please refer to the [OptHub Client User Guide](https://opthub.notion.site/OptHub-Client-User-Guide-ece08c9977ec4733b7cbeb2d5bafb797?pvs=4).
## Installation
Make sure you have Python 3.10 or higher installed and that you have set up pip as your package manager. Then, run the following command to install opthub-client from PyPI.
```bash
$ pip install opthub-client
```
## Tutorial
In this tutorial, we will explain how to submit solutions for the competitions you are participating in and how to review the history of your submissions.
To submit solutions, you need to create an account and join a competition beforehand.
👉 [How to Create an Account and Join a Competition](https://opthub.notion.site/Tutorial-23febfdfbb7c41d0893a6681f3e7ae20?pvs=4)
### Login
Execute `opt login` and enter your username and password.
```bash
$ opt login
Username: [username] # Your username
Password: [password] # Your password
Hello [username]. Successfully logged in.
```
⚠ You need to create an account and verify your email address beforehand.
### Select a Competition and Match
Execute `opt select` and select a competition and match.
```bash
$ opt select
? Select a competition: [competition_id] # Use ↑↓ keys to select a competition
? Select a match: [match_id] # Use ↑↓ keys to select a match
You have selected [competition_id]/[match_id]
```
⚠ You need to join at least one competition beforehand.
### Submit a Solution
Execute `opt submit` and enter a solution according to the competition's input/output requirements.
```bash
$ opt submit
? Write the solution: [your_solution] # Enter your solution
Submitting to [competition_id]/[match_id]... # Submitting
...Submitted # Submission complete
```
👉 [How to submit solutions from files](https://opthub.notion.site/submit-Submit-a-solution-2192134bad9b40c39670b567dd6d8f3f?pvs=4)
👉 [How to submit solutions by your program](https://opthub.notion.site/How-to-Use-OptHub-API-8f54f4456319430b85039c06ec6cc14e?pvs=4)
### Check Submitted Solutions
Execute `opt show trials` to display the solutions you have submitted. Press `n` to display the next 20 solutions, or press `e` to exit the check.
```bash
$ opt show trials # Displays 20 solutions in descending order by default
Trial No: 30, status: success, Score: 0.0001
Trial No: 29, status: scoring
Trial No: 28, status: evaluating
・・・
n: next solutions, e: exit
# Press n to display the next 20 solutions, e to exit the check
```
### Download Submitted Solutions
Execute `opt download` to download the solutions by specifying the range of trial numbers.
```bash
$ opt download -s 10 -e 30 # Download trial numbers 10 to 30
Downloading trials [####################################] 100%
Trials have been written to trials_match1.json
```
👉 [Format of the Output JSON File](https://opthub.notion.site/download-Download-the-solutions-c77b44f02df24609a8f04490d6036e77?pvs=4)
## For Contributors
Follow these steps to set up the environment:
1. Clone this repository.
2. Set up Poetry.
3. Run `poetry install`.
4. Download the recommended VSCode Extensions.
5. Disable the following VS Code Extensions for this workspace to avoid conflicts with other packages:
- ms-python.pylint
- ms-python.black-formatter
- ms-python.flake8
- ms-python.isort
Once you have completed the above setup, you can use the `opt` command in the project's root directory.
## Contact <a id="Contact"></a>
If you have any questions or concerns, please feel free to contact us (Email: dev@opthub.ai).
<img src="https://opthub.ai/assets/images/logo.svg" width="200">
Raw data
{
"_id": null,
"home_page": "https://github.com/opthub-org/opthub-client",
"name": "opthub_client",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "opthub, cli",
"author": "Opthub Inc.",
"author_email": "dev@opthub.ai",
"download_url": "https://files.pythonhosted.org/packages/17/7e/65969e6e5a665cb696ff195fde083933ac44eabd4eeede2d81486d553bf3/opthub_client-0.8.1.tar.gz",
"platform": null,
"description": "[\u65e5\u672c\u8a9e\u7248](https://github.com/opthub-org/opthub-client/blob/main/README_ja.md) \ud83d\udc48\n\n# OptHub Client\n\n\n\nThe Opthub Client is a Python package that provides the following features:\n\n- Submitting solutions to OptHub competitions\n- Checking the history and status of solutions submitted to OptHub competitions\n\nThis section explains how to install the OptHub Client and provides a tutorial. For more detailed instructions, please refer to the [OptHub Client User Guide](https://opthub.notion.site/OptHub-Client-User-Guide-ece08c9977ec4733b7cbeb2d5bafb797?pvs=4).\n\n## Installation\nMake sure you have Python 3.10 or higher installed and that you have set up pip as your package manager. Then, run the following command to install opthub-client from PyPI.\n\n```bash\n$ pip install opthub-client\n```\n\n## Tutorial\n\nIn this tutorial, we will explain how to submit solutions for the competitions you are participating in and how to review the history of your submissions.\n\nTo submit solutions, you need to create an account and join a competition beforehand.\n\n\ud83d\udc49 [How to Create an Account and Join a Competition](https://opthub.notion.site/Tutorial-23febfdfbb7c41d0893a6681f3e7ae20?pvs=4)\n\n### Login\n\nExecute `opt login` and enter your username and password.\n\n```bash\n$ opt login\nUsername: [username] # Your username\nPassword: [password] # Your password\nHello [username]. Successfully logged in.\n```\n\n\u26a0 You need to create an account and verify your email address beforehand.\n\n### Select a Competition and Match\n\nExecute `opt select` and select a competition and match.\n\n```bash\n$ opt select\n? Select a competition: [competition_id] # Use \u2191\u2193 keys to select a competition\n? Select a match: [match_id] # Use \u2191\u2193 keys to select a match\nYou have selected [competition_id]/[match_id]\n```\n\n\u26a0 You need to join at least one competition beforehand.\n\n### Submit a Solution\n\nExecute `opt submit` and enter a solution according to the competition's input/output requirements.\n\n```bash\n$ opt submit\n? Write the solution: [your_solution] # Enter your solution\nSubmitting to [competition_id]/[match_id]... # Submitting\n...Submitted # Submission complete\n```\n\n\ud83d\udc49 [How to submit solutions from files](https://opthub.notion.site/submit-Submit-a-solution-2192134bad9b40c39670b567dd6d8f3f?pvs=4)\n\ud83d\udc49\u00a0[How to submit solutions by your program](https://opthub.notion.site/How-to-Use-OptHub-API-8f54f4456319430b85039c06ec6cc14e?pvs=4)\n\n### Check Submitted Solutions\n\nExecute `opt show trials` to display the solutions you have submitted. Press `n` to display the next 20 solutions, or press `e` to exit the check.\n\n```bash\n$ opt show trials # Displays 20 solutions in descending order by default\nTrial No: 30, status: success, Score: 0.0001\nTrial No: 29, status: scoring\nTrial No: 28, status: evaluating\n\u30fb\u30fb\u30fb\nn: next solutions, e: exit\n# Press n to display the next 20 solutions, e to exit the check\n```\n\n### Download Submitted Solutions\n\nExecute `opt download` to download the solutions by specifying the range of trial numbers.\n\n```bash\n$ opt download -s 10 -e 30 # Download trial numbers 10 to 30\nDownloading trials [####################################] 100%\nTrials have been written to trials_match1.json\n```\n\n\ud83d\udc49 [Format of the Output JSON File](https://opthub.notion.site/download-Download-the-solutions-c77b44f02df24609a8f04490d6036e77?pvs=4)\n\n## For Contributors\n\nFollow these steps to set up the environment:\n\n1. Clone this repository.\n2. Set up Poetry.\n3. Run `poetry install`.\n4. Download the recommended VSCode Extensions.\n5. Disable the following VS Code Extensions for this workspace to avoid conflicts with other packages:\n - ms-python.pylint\n - ms-python.black-formatter\n - ms-python.flake8\n - ms-python.isort\n\nOnce you have completed the above setup, you can use the `opt` command in the project's root directory.\n\n## Contact <a id=\"Contact\"></a>\n\nIf you have any questions or concerns, please feel free to contact us (Email: dev@opthub.ai).\n\n<img src=\"https://opthub.ai/assets/images/logo.svg\" width=\"200\">\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Library for Opthub CLI tools.",
"version": "0.8.1",
"project_urls": {
"Documentation": "https://github.com/opthub-org/opthub-client",
"Homepage": "https://github.com/opthub-org/opthub-client",
"Repository": "https://github.com/opthub-org/opthub-client"
},
"split_keywords": [
"opthub",
" cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "05dc81a3677219b403db174d8b87a231428f5d5d6a2a42aa689b101c680105d4",
"md5": "4e25e5e847767a9b2b5dad5880fcf1c6",
"sha256": "ed6d986018cb023b4ef5bbc2e0b5a5267cfe81c612b34b0dfbb0b3d776f77516"
},
"downloads": -1,
"filename": "opthub_client-0.8.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4e25e5e847767a9b2b5dad5880fcf1c6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 36543,
"upload_time": "2024-12-17T23:58:57",
"upload_time_iso_8601": "2024-12-17T23:58:57.273051Z",
"url": "https://files.pythonhosted.org/packages/05/dc/81a3677219b403db174d8b87a231428f5d5d6a2a42aa689b101c680105d4/opthub_client-0.8.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "177e65969e6e5a665cb696ff195fde083933ac44eabd4eeede2d81486d553bf3",
"md5": "bab59f29f8d2f5049e0c51b050ecc04f",
"sha256": "fd2c20a11f150150bbd56bccfd3ea40ea6181bed4bd15d4c49f09c08c18a7231"
},
"downloads": -1,
"filename": "opthub_client-0.8.1.tar.gz",
"has_sig": false,
"md5_digest": "bab59f29f8d2f5049e0c51b050ecc04f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 23688,
"upload_time": "2024-12-17T23:58:59",
"upload_time_iso_8601": "2024-12-17T23:58:59.472772Z",
"url": "https://files.pythonhosted.org/packages/17/7e/65969e6e5a665cb696ff195fde083933ac44eabd4eeede2d81486d553bf3/opthub_client-0.8.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-17 23:58:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "opthub-org",
"github_project": "opthub-client",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "opthub_client"
}
JSON
