docs: update readme
This commit is contained in:
64
README.md
64
README.md
@@ -8,30 +8,6 @@
|
||||
- Carton (handles perl deps)
|
||||
- Redis
|
||||
|
||||
## How to run
|
||||
|
||||
To run the application in development, you'll first need a Redis server.
|
||||
|
||||
The easiest way is to start a local Redis instance using Docker:
|
||||
|
||||
```sh
|
||||
docker run --name mojo-redis -p 6379:6379 -d redis
|
||||
```
|
||||
|
||||
Install Perl dependencies with [Carton](https://github.com/perl-carton/carton):
|
||||
|
||||
```sh
|
||||
carton install
|
||||
```
|
||||
|
||||
Start the application with `morbo`:
|
||||
|
||||
```sh
|
||||
carton exec morbo bin/urupam
|
||||
```
|
||||
|
||||
Application will listen on port `3000`.
|
||||
|
||||
## Installation
|
||||
|
||||
Run the installation script:
|
||||
@@ -56,6 +32,46 @@ docker build -t urupam .
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
## Hacking
|
||||
|
||||
To run the application in development, you'll first need a Redis server.
|
||||
|
||||
The easiest way is to start a local Redis instance using Docker:
|
||||
|
||||
```sh
|
||||
docker run --name mojo-redis -p 6379:6379 -d redis
|
||||
```
|
||||
|
||||
Install Perl dependencies with [Carton](https://github.com/perl-carton/carton):
|
||||
|
||||
```sh
|
||||
carton install
|
||||
```
|
||||
|
||||
Add your changes and your tests, then start the application with `morbo`:
|
||||
|
||||
```sh
|
||||
carton exec morbo bin/urupam
|
||||
```
|
||||
|
||||
The application will listen on port `3000` by default.
|
||||
|
||||
## Running tests
|
||||
|
||||
As every perl project, tests are located in the `t` directory.
|
||||
|
||||
To run tests, use the `carton` command:
|
||||
|
||||
```sh
|
||||
carton exec prove -lr t/
|
||||
```
|
||||
|
||||
To run specific tests (like integration tests), use:
|
||||
|
||||
```sh
|
||||
carton exec prove -lr t/integration.t
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
This project is licensed under the GPLv3+ License. See the [LICENSE](LICENSE) file for details.
|
||||
|
||||
Reference in New Issue
Block a user