blob: 06225174ebbc53c89adf4ecbb346e30a3c1e67ac (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
# Contributing to Bolt
This document provides guidelines and instructions for contributing to the
project.
## How to Contribute
Bolt is hosted at <https://git.eugenetriguba.com/bolt/cli> and uses an
[email-based workflow](https://git-send-email.io/) for accepting contributions.
- All questions, discussions, requests, or patches should be submitted via
email to [hello@eugenetriguba.com](mailto:hello@eugenetriguba.com).
For patches, use the subject prefix `[PATCH bolt]`. For anything else, please
use a prefix of `[bolt]`.
## Development Setup
### Prerequisites
- Go 1.24.0 or later
- Docker (for running database integration tests)
- git
### Initial Setup
1. Clone the repository:
```bash
git clone https://git.eugenetriguba.com/bolt/cli bolt
cd bolt
```
2. Install dependencies:
```bash
go mod download
```
3. Build the project:
```bash
./scripts/build.sh
```
### Running Tests
Bolt has integration tests for all supported databases. The test
suite uses docker containers to run database instances.
Run all tests:
```bash
./scripts/test.sh
```
Run all tests and leave database containers running:
```
./scripts/test.sh --keepdb
```
Run tests for a specific database:
```bash
./scripts/test.sh postgres
./scripts/test.sh mysql
./scripts/test.sh mssql
./scripts/test.sh sqlite3
```
### Running Linters/Formatters
To lint:
```bash
./scripts/lint.sh
```
To format:
```bash
./scripts/format.sh
```
|