# Runit CLI 
The Runit Command Line Interface (CLI) Tools can be used to test, manage, and deploy your Runit project from the command line.
- Create new runit project
- Run a local web server for your runit project
- publish code and assets to your runit-server domain
- Interact with data in your runit-server database
## Supported Languages
  
## Installation
### Python Package
You can install the Runit CLI using pip (Python package manager). Note that you will need to install [Python](https://python.org).
To download and install the runit CLI run the following command:
```shell
pip install python-runit
```
This will provide you with the globally accessible ```runit``` command.
### Install from source
```shell
git clone https://github.com/theonlyamos/runit.git
cd runit
pip install .
```
## Usage
Run the below command to print out usage message.
```shell
runit --help
```
**Create New Project**
Run the following in the command line to create a new runit project.
> Supported languages include: [Python](), [Javascript](), [PHP]()
```shell
runit new <project-name> --language <langugage>
```
Run ```runit new --help``` for all options
**Run project locally**
***Access functions on local server****
Running the command ```runit``` in a project directory spins up a local webserver which can be used to access the funtions in project.
```shell
cd <project-directory>
runit
```
Point your browser to the address provided followed by the function name to access that function.
```http://localhost:5000/``` will be the default address.
Visiting ```http://localhost:5000/hello_world``` will run the ```hello_world``` function in the project.
***Run function and print output to shell***
Output function result to shell. Required arguments include:
> ```--function <function_name>```: Function name to call
> ```--shell```: sets shell output to true
> [Optional] ```--arguments|-x```: Arguments for the function if required. Can be called multiple times for multiple arguments
```shell
cd <project-directory>
runit --function <hello_world> --shell
```
### Publishing Project
Before you can publish any of your projects, you must setup the backend for your runit. You must also be logged in.
**Setup Backend Details**
The backend must be running ***[runit-server](https://github.com/theonlyamos/runit-server)***.
Run ```runit setup --help``` for help message.
***Follow the prompts to complete the setup after running the below comman.***
```shell
runit setup
```
**Account Login**
```shell
runit login --help
```
```shell
runit login --email <email@example.org> --password <supersecretpass>
```
**or**
***Follow the commands after running below command***
```shell
runit login
```
**Deploy/Publish Project**
```shell
cd <project-directory>
runit publish
```
## License
**Free Software, Hell Yeah!**
Raw data
{
"_id": null,
"home_page": "",
"name": "python-runit",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python3 runit developer serverless architecture docker",
"author": "Amos Amissah",
"author_email": "theonlyamos@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/48/0c/199e7c0d3f3cba3fda8b92cd686dc17535927c24efdab552ade06d12812c/python-runit-0.3.0.tar.gz",
"platform": null,
"description": "# Runit CLI  \nThe Runit Command Line Interface (CLI) Tools can be used to test, manage, and deploy your Runit project from the command line.\n- Create new runit project\n- Run a local web server for your runit project\n- publish code and assets to your runit-server domain\n- Interact with data in your runit-server database\n\n\n## Supported Languages\n  \n\n## Installation\n### Python Package\nYou can install the Runit CLI using pip (Python package manager). Note that you will need to install [Python](https://python.org).\nTo download and install the runit CLI run the following command:\n```shell\npip install python-runit\n```\nThis will provide you with the globally accessible ```runit``` command.\n\n### Install from source\n```shell\ngit clone https://github.com/theonlyamos/runit.git\ncd runit\npip install .\n```\n\n## Usage\nRun the below command to print out usage message.\n```shell\nrunit --help\n```\n\n\n**Create New Project**\nRun the following in the command line to create a new runit project.\n> Supported languages include: [Python](), [Javascript](), [PHP]()\n```shell\nrunit new <project-name> --language <langugage>\n```\nRun ```runit new --help``` for all options\n\n**Run project locally**\n***Access functions on local server****\nRunning the command ```runit``` in a project directory spins up a local webserver which can be used to access the funtions in project.\n```shell\ncd <project-directory>\nrunit\n```\nPoint your browser to the address provided followed by the function name to access that function.\n```http://localhost:5000/``` will be the default address.\nVisiting ```http://localhost:5000/hello_world``` will run the ```hello_world``` function in the project.\n\n***Run function and print output to shell***\nOutput function result to shell. Required arguments include:\n> ```--function <function_name>```: Function name to call\n> ```--shell```: sets shell output to true\n> [Optional] ```--arguments|-x```: Arguments for the function if required. Can be called multiple times for multiple arguments\n\n```shell\ncd <project-directory>\nrunit --function <hello_world> --shell\n```\n\n### Publishing Project\nBefore you can publish any of your projects, you must setup the backend for your runit. You must also be logged in.\n\n**Setup Backend Details**\nThe backend must be running ***[runit-server](https://github.com/theonlyamos/runit-server)***.\nRun ```runit setup --help``` for help message.\n***Follow the prompts to complete the setup after running the below comman.***\n```shell\nrunit setup\n```\n\n**Account Login**\n```shell\nrunit login --help\n```\n```shell\nrunit login --email <email@example.org> --password <supersecretpass>\n```\n**or**\n***Follow the commands after running below command***\n```shell\nrunit login\n```\n\n**Deploy/Publish Project**\n```shell\ncd <project-directory>\nrunit publish\n```\n\n## License\n\n\n**Free Software, Hell Yeah!**\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Develop serverless applications",
"version": "0.3.0",
"project_urls": {
"Source": "https://github.com/theonlyamos/runit/",
"Tracker": "https://github.com/theonlyamos/runit/issues"
},
"split_keywords": [
"python3",
"runit",
"developer",
"serverless",
"architecture",
"docker"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b6a0963dedb8905ea176c805fb9972240e93cd12ffcb82ad1e3919529cc57d45",
"md5": "e55d63ac622c00ad87c758b5dbc4bbdd",
"sha256": "c4fb07fc7cf4b348b0a98b05c4a762e3836ac76a5a93d792e3b43e2eaeeca1f3"
},
"downloads": -1,
"filename": "python_runit-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e55d63ac622c00ad87c758b5dbc4bbdd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 31353,
"upload_time": "2023-09-17T10:07:03",
"upload_time_iso_8601": "2023-09-17T10:07:03.815072Z",
"url": "https://files.pythonhosted.org/packages/b6/a0/963dedb8905ea176c805fb9972240e93cd12ffcb82ad1e3919529cc57d45/python_runit-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "480c199e7c0d3f3cba3fda8b92cd686dc17535927c24efdab552ade06d12812c",
"md5": "6b581ca046e91381459aa3ffe500d0c2",
"sha256": "fb11a6c3a323de1aa2ebe66da23a5d40588f9afe29a30c0794a72dded007f432"
},
"downloads": -1,
"filename": "python-runit-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "6b581ca046e91381459aa3ffe500d0c2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 20751,
"upload_time": "2023-09-17T10:07:05",
"upload_time_iso_8601": "2023-09-17T10:07:05.435051Z",
"url": "https://files.pythonhosted.org/packages/48/0c/199e7c0d3f3cba3fda8b92cd686dc17535927c24efdab552ade06d12812c/python-runit-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-17 10:07:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "theonlyamos",
"github_project": "runit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "python-runit"
}
JSON
