mirror of
https://github.com/mCaptcha/mCaptcha.git
synced 2024-11-23 18:05:54 +03:00
108 lines
2.6 KiB
Markdown
108 lines
2.6 KiB
Markdown
# Development Setup
|
|
|
|
## Setting up development environment
|
|
|
|
### Toolchain
|
|
|
|
You'll have to install before you can start writing code.
|
|
|
|
1. Install Rust:
|
|
Install Cargo(Rust toolchain) using [rustup](https://rustup.rs/) with:
|
|
|
|
```
|
|
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|
```
|
|
|
|
2. Install Node:
|
|
Please refer to [official instructions](https://nodejs.org/en/download/)
|
|
|
|
3. Install yarn:
|
|
`npm install -g yarn`
|
|
For more details, refer to [official
|
|
instructions](https://yarnpkg.com/getting-started/install)
|
|
|
|
4. GNU Make:
|
|
If you are on Linux, it's probably already installed on your machine.
|
|
|
|
You can check it's existence by running:
|
|
|
|
```bash
|
|
$ make --version
|
|
```
|
|
|
|
If it's not available, you download it with your package manager or
|
|
refer to [official instructions](https://www.gnu.org/software/make/)
|
|
|
|
### External Dependencies:
|
|
|
|
### Postgres databse:
|
|
|
|
The backend requires a Postgres database. We have
|
|
compiletime SQL checks so without a database available, you won't be
|
|
able to build the project.
|
|
|
|
I use Postgres in Docker.
|
|
|
|
1. To install Docker, please refer to [official
|
|
instructions](https://docs.docker.com/engine/install/].
|
|
|
|
2. Create create database user:
|
|
|
|
```bash
|
|
$ docker create --name mcaptcha-postgres \
|
|
-e POSTGRES_PASSWORD=password \
|
|
-p 5432:5432 postgres
|
|
```
|
|
|
|
3. Start database container:
|
|
|
|
```bash
|
|
$ docker start mcaptcha-postgres
|
|
```
|
|
|
|
4. Set configurations:
|
|
|
|
```bash
|
|
$ cd guard # your copy of https://github.com/mCaptcha/guard
|
|
$ echo 'export DATABASE_URL="postgres://postgres:password@localhost:5432/postgres"' > .env
|
|
```
|
|
|
|
**NOTE: Don't use this database for other projects**
|
|
|
|
5. Run migrations:
|
|
This step is only required when migrations are updated. The server
|
|
binary has inbuilt migrations manager but that can only be used after
|
|
the server is compiled. Since we are trying to compile the server here,
|
|
we can't use that.
|
|
|
|
However, this project ships with a utility to run migrations!
|
|
|
|
```bash
|
|
$ cd guard # your copy of https://github.com/mCaptcha/guard
|
|
$ cargo run --bin tests-migrate
|
|
```
|
|
|
|
That's it, you are all set!
|
|
|
|
## Build commands:
|
|
|
|
### Compile:
|
|
|
|
```bash
|
|
$ cd guard # your copy of https://github.com/mCaptcha/guard
|
|
$ make
|
|
```
|
|
|
|
### Additional commands:
|
|
|
|
```bash
|
|
➜ guard git:(master) ✗ make help
|
|
docs - build documentation
|
|
run - run developer instance
|
|
test - run unit and integration tests
|
|
migrate - run database migrations
|
|
dev-env - download dependencies
|
|
clean - drop builds and environments
|
|
coverage - build test coverage in HTML format
|
|
xml-coverage - build test coverage in XML for upload to codecov
|
|
```
|