Skip to content

Commit 33a4da8

Browse files
committed
Clean up of the README
1 parent 9489b63 commit 33a4da8

1 file changed

Lines changed: 33 additions & 17 deletions

File tree

README.md

Lines changed: 33 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Encryption API endpoints with Node.js
22

3-
[![Build Status](https://travis-ci.org/timoa/nodejs-encryption-api-example.svg?branch=master)](https://travis-ci.org/timoa/nodejs-encryption-api-example)
4-
![Docker Pulls](https://img.shields.io/docker/pulls/timoa/nodejs-encryption-api-example.svg)
5-
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=alert_status)](https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example)
6-
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=security_rating)](https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example)
7-
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example)
3+
[![Build Status][travis-badge]][travis-url]
4+
[![Docker Pulls][docker-badge]][docker-url]
5+
[![Quality Gate Status][sonarcloud-status-badge]][sonarcloud-url]
6+
[![Security Rating][sonarcloud-security-badge]][sonarcloud-url]
7+
[![Maintainability Rating][sonarcloud-maintainability-badge]][sonarcloud-url]
88

9-
[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=bugs)](https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example)
10-
[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=code_smells)](https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example)
11-
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=coverage)](https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example)
12-
[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example)
9+
[![Bugs][sonarcloud-bugs-badge]][sonarcloud-url]
10+
[![Code Smells][sonarcloud-codesmells-badge]][sonarcloud-url]
11+
[![Coverage][sonarcloud-coverage-badge]][sonarcloud-url]
12+
[![Duplicated Lines (%)][sonarcloud-duplicated-badge]][sonarcloud-url]
1313

1414
Example of encrypting/decrypting data thru an API using node.js.
1515

@@ -33,6 +33,8 @@ This project doesn't cover encryption in transit (SSL) and not meant to be used
3333
- Dockerfile to generate the Docker image
3434
- Docker Compose file to launch the API and MongoDB official Docker images
3535
- Build, test and deploy to Docker Hub with Travis CI
36+
- SonarQube code quality check (SonarCloud)
37+
- Unit tests and functional tests
3638

3739
## Run locally
3840

@@ -90,17 +92,17 @@ There is a default encryption key and ID to have a quick look to the API.
9092

9193
### Download and Import the Postman environment
9294

93-
[Download Postman Environment](https://raw.githubusercontent.com/timoa/nodejs-encryption-api-example/master/src/config/postman.environment.json)
95+
Download the [Postman Environment][postman-environment]
9496

9597
### Run the Postman collection
9698

97-
[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/e34aee6688c0937c6643)
99+
[![Run in Postman][postman-run-button]][postman-run-url]
98100

99101
## Documentation / Specifications
100102

101103
You can access to the documentation (Swagger) here:
102104

103-
[http://localhost:3000/swagger][1]
105+
[http://localhost:3000/swagger][swagger]
104106

105107
## How it works
106108

@@ -110,7 +112,7 @@ You need to generate an encryption key that you will use to encrypt the data sav
110112

111113
You can use this online website to create your key (256 bit):
112114

113-
[https://www.allkeysgenerator.com][2]
115+
[https://www.allkeysgenerator.com][allkeysgenerator]
114116

115117
### Add secret
116118

@@ -249,7 +251,21 @@ This will return an array of results:
249251
- Swagger detailed schema
250252
- PM2 support under the Docker container (to restart the app in case of crash)
251253

252-
[1]: http://localhost:3000/swagger
253-
[2]: http://www.allkeysgenerator.com/Random/Security-Encryption-Key-Generator.aspx
254-
[3]: https://raw.githubusercontent.com/timoa/nodejs-encryption-api-example/master/src/config/postman.environment.json
255-
[4]: https://sonarcloud.io/about
254+
[swagger]: http://localhost:3000/swagger
255+
[allkeysgenerator]: https://www.allkeysgenerator.com/Random/Security-Encryption-Key-Generator.aspx
256+
[postman-environment]: https://raw.githubusercontent.com/timoa/nodejs-encryption-api-example/master/src/config/postman.environment.json
257+
[postman-run-button]: https://run.pstmn.io/button.svg
258+
[postman-run-url]: https://app.getpostman.com/run-collection/e34aee6688c0937c6643
259+
[sonarcloud]: https://sonarcloud.io/about
260+
[travis-badge]: https://travis-ci.org/timoa/nodejs-encryption-api-example.svg?branch=master
261+
[travis-url]: https://travis-ci.org/timoa/nodejs-encryption-api-example
262+
[docker-badge]: https://img.shields.io/docker/pulls/timoa/nodejs-encryption-api-example.svg
263+
[docker-url]: https://hub.docker.com/r/timoa/nodejs-encryption-api-example
264+
[sonarcloud-url]: https://sonarcloud.io/dashboard?id=timoa_nodejs-encryption-api-example
265+
[sonarcloud-status-badge]: https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=alert_status
266+
[sonarcloud-security-badge]: https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=security_rating
267+
[sonarcloud-maintainability-badge]: https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=sqale_rating
268+
[sonarcloud-bugs-badge]: https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=bugs
269+
[sonarcloud-codesmells-badge]: https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=code_smells
270+
[sonarcloud-coverage-badge]: https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=coverage
271+
[sonarcloud-duplicated-badge]: https://sonarcloud.io/api/project_badges/measure?project=timoa_nodejs-encryption-api-example&metric=duplicated_lines_density

0 commit comments

Comments
 (0)