Skip to main content

Develop serverless applications

Project description

# Runit CLI ![Python](https://img.shields.io/badge/builthwith-python-brightgreen) 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 ![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54) ![JavaScript](https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge&logo=javascript&logoColor=%23F7DF1E) ![PHP](https://img.shields.io/badge/php-%23777BB4.svg?style=for-the-badge&logo=php&logoColor=white)

## 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 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 -e . `

## Usage Run the below command to print out usage message. `shell runit --help ` ![Runit Cli](https://awesomescreenshot.s3.amazonaws.com/image/3778408/34500895-ad63d3ceaef8002f59fc5fd499797ca5.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJSCJQ2NM3XLFPVKA%2F20221117%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20221117T180652Z&X-Amz-Expires=28800&X-Amz-SignedHeaders=host&X-Amz-Signature=afd652759d272e68a62fb9959ce4e86647af5d6269991c012c9e753bf22ef534)

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 ![License](https://img.shields.io/badge/LICENSE-MIT-brightgreen/?style=flat-square)

Free Software, Hell Yeah!

Project details


Download files

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

Source Distribution

python-runit-0.0.7.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

python_runit-0.0.7-py3-none-any.whl (14.5 kB view details)

Uploaded Python 3

File details

Details for the file python-runit-0.0.7.tar.gz.

File metadata

  • Download URL: python-runit-0.0.7.tar.gz
  • Upload date:
  • Size: 11.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for python-runit-0.0.7.tar.gz
Algorithm Hash digest
SHA256 fc8b8c25c1e2466c27de1da8746578f2d759fc89d3fb47c6c0b93a869d55b641
MD5 1a85fc5794eaded31653cb361da74b0d
BLAKE2b-256 4a4d911ea7422bc934aeb084fb7c448ce7fa4404b4d090d5380918e139e8b0b5

See more details on using hashes here.

File details

Details for the file python_runit-0.0.7-py3-none-any.whl.

File metadata

File hashes

Hashes for python_runit-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 7942cdadb4b2edf33b591809a45e44d8bde0e4874afdffd68aeb8a3a64a39356
MD5 717c47e2f8b5d1781d9c09f55c809d00
BLAKE2b-256 b8d0da30a070e8dd13630ada18cb8ddb111cfddde4086711857c4121073d1f58

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page