You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
OpenCov is a self-hosted opensource test coverage history viewer.
7
+
LibreCov is a self-hosted opensource test coverage history viewer.
8
8
It is (mostly) compatible with [coveralls](https://coveralls.io/), so most
9
9
coverage tools will work easily.
10
10
11
11
## Demo and screenshots
12
12
13
-
A demo is available at https://opencov-reloaded.herokuapp.com, you can create an account or login with
13
+
A demo is available at https://www.librecov.com, you can create an account or login with
14
14
15
-
* username: user@opencov.com
15
+
* username: user@librecov.com
16
16
* password: password123
17
17
18
18
For "security" reasons, the user is not admin.
@@ -44,7 +44,7 @@ NOTE: the demo is on a Heroku free dyno, so it may not always be available and m
44
44
45
45
First, you will need to at least setup a database
46
46
To configure the app, create a `local.exs` file and override the configuration you need.
47
-
Check [config/local.sample.exs](https://github.com/yknx4/opencov/blob/master/config/local.sample.exs) to see the available configurations.
47
+
Check [config/local.sample.exs](https://github.com/yknx4/librecov/blob/main/config/local.sample.exs) to see the available configurations.
48
48
49
49
### Using docker
50
50
@@ -54,32 +54,32 @@ If you already have a database to use, you can simply start the application usin
54
54
55
55
Setup database, run migrations and seeds
56
56
```
57
-
$ docker run --rm -v /absolute/path/to/local.exs:/opencov/config/local.exs yknx4/opencov mix ecto.setup
57
+
$ docker run --rm -v /absolute/path/to/local.exs:/librecov/config/local.exs yknx4/librecov mix ecto.setup
58
58
```
59
59
60
60
Execute Phoenix Server
61
61
```
62
-
$ docker run -v /absolute/path/to/local.exs:/opencov/config/local.exs yknx4/opencov
62
+
$ docker run -v /absolute/path/to/local.exs:/librecov/config/local.exs yknx4/librecov
63
63
```
64
64
65
65
This will start the server on the port you set in `local.exs`.
66
66
67
67
#### With docker-compose
68
68
69
-
If you do not have a database, you can start one with `docker` and `docker-compose`. See [docker-compose.yml](https://github.com/yknx4/opencov/blob/master/docker-compose.yml) for a sample `docker-compose.yml` file.
69
+
If you do not have a database, you can start one with `docker` and `docker-compose`. See [docker-compose.yml](https://github.com/yknx4/librecov/blob/main/docker-compose.yml) for a sample `docker-compose.yml` file.
70
70
71
71
Once you have your `docker-compose.yml` and `local.exs` ready, you can run
72
72
73
73
```
74
-
$ docker-compose run opencov mix ecto.setup
74
+
$ docker-compose run librecov mix ecto.setup
75
75
$ docker-compose up
76
76
```
77
77
78
78
### Manually
79
79
80
80
```
81
-
$ git clone https://github.com/yknx4/opencov.git
82
-
$ cd opencov
81
+
$ git clone https://github.com/yknx4/librecov.git
82
+
$ cd librecov
83
83
$ cp /path/to/local.exs config/local.exs # local.exs must be in the `config` directory of the app
84
84
85
85
$ npm install # (or yarn install)
@@ -88,7 +88,7 @@ $ mix ecto.setup
88
88
$ mix phoenix.server
89
89
```
90
90
91
-
This should start OpenCov at port 4000.
91
+
This should start LibreCov at port 4000.
92
92
93
93
If you want to setup the server for production, you will need to run the above commands
94
94
with `MIX_ENV=prod` and to run
@@ -104,8 +104,8 @@ before starting the server.
104
104
You should also be able to deploy to Heroku by simply git pushing this repository.
105
105
You will need to set the following environment variables using `heroku config:set`
106
106
107
-
*`OPENCOV_PORT`
108
-
*`OPENCOV_SCHEME`
107
+
*`LIBRECOV_PORT`
108
+
*`LIBRECOV_SCHEME`
109
109
*`SECRET_KEY_BASE`
110
110
*`SMTP_USER`
111
111
*`SMTP_PASSWORD`
@@ -129,9 +129,9 @@ You should use it for your first login and the change the email and password.
129
129
130
130
## Sending test metrics
131
131
132
-
A few languages are documented in [the wiki](https://github.com/yknx4/opencov/wiki).
132
+
A few languages are documented in [the wiki](https://github.com/yknx4/librecov/wiki).
133
133
For other languages, coveralls instructions should work out of the box,
134
-
you just need to set the URL to your OpenCov server and to explicitly set
134
+
you just need to set the URL to your LibreCov server and to explicitly set
135
135
the token, even when using Travis.
136
136
137
137
## Development status
@@ -140,6 +140,6 @@ The application is more or less stable. I have been using it
140
140
for a little while now with coverage data from the 4 languages in the Wiki.
141
141
142
142
The main missing feature is the ability to send coverage status on pull requests.
143
-
The implementation is started in the [integrations branch](https://github.com/yknx4/opencov/tree/integrations) but I could not find the time to finish it yet.
143
+
The implementation is started in the [integrations branch](https://github.com/yknx4/librecov/tree/integrations) but I could not find the time to finish it yet.
144
144
145
145
I am open to any other suggestions, and help is very welcome.
0 commit comments