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
Copy file name to clipboardExpand all lines: README.md
+12-81Lines changed: 12 additions & 81 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,16 +18,16 @@ Hare is a user-friendly lib for sockets in Golang. You can send and listen to TC
18
18
## Contents
19
19
20
20
-[Installation](#installation)
21
-
-[Quick start](#quick-start)
21
+
-[Quickstart](#quickstart)
22
22
-[Documentation](#documentation)
23
23
-[Examples](#examples)
24
24
-[Testing](#testing)
25
25
-[Contributing](#contributing)
26
26
-[License](#license)
27
27
28
-
## Installation
28
+
## 🖥️ Installation
29
29
30
-
First you need [Go](https://golang.org/) installed (version 1.12+ is required), then you can install Hare:
30
+
First, you need [Go](https://golang.org/) installed (version 1.12+ is required), then you can install Hare:
31
31
32
32
```shell
33
33
$ go get -u "github.com/leozz37/hare"
@@ -47,7 +47,7 @@ $ brew tap leozz37/jaguar
47
47
$ brew install jaguar
48
48
```
49
49
50
-
## Quick start
50
+
## 🍕 Quickstart
51
51
52
52
[Sample code](./examples/send.go) for sending payloads:
53
53
@@ -85,9 +85,9 @@ func main() {
85
85
}
86
86
```
87
87
88
-
## Documentation
88
+
## 📖 Documentation
89
89
90
-
The library consists on two features: **listen** and **send** to a given port. You can check the full documentation on [Godoc](https://pkg.go.dev/github.com/leozz37/hare#section-documentation).
90
+
The library consists of two features: **listen** and **send** to a given port. You can check the full documentation on [Godoc](https://pkg.go.dev/github.com/leozz37/hare#section-documentation).
91
91
92
92
### Send
93
93
@@ -195,11 +195,11 @@ func main() {
195
195
}
196
196
```
197
197
198
-
## Examples
198
+
## 📙 Examples
199
199
200
200
You can check the [example](./examples) for code usages, like [send](./examples/send.go) and [listen](./examples/listen.go) samples.
201
201
202
-
Since Hare only listen and send messages, here's a complete example:
202
+
Since Hare only listens and send messages, here's a complete example:
203
203
204
204
```go
205
205
package main
@@ -233,7 +233,7 @@ func main() {
233
233
}
234
234
```
235
235
236
-
## Testing
236
+
## 🧪 Testing
237
237
238
238
To run the test suite, you can run with:
239
239
@@ -247,79 +247,10 @@ If you want a more detailed report with coverage and an `coverage.out` file, do
247
247
$ go test -v -covermode=count -coverprofile=coverage.out
248
248
```
249
249
250
-
## Contributing
250
+
## 🤝 Contributing
251
251
252
-
A full guideline about contributing to Alacritty can be found in the [CONTRIBUTING.md](./CONTRIBUTING.md) file.
252
+
A full guideline about contributing to Hare can be found in the [CONTRIBUTING.md](./CONTRIBUTING.md) file.
253
253
254
-
### Issues
255
-
256
-
Use the search tool before opening a new issue.
257
-
258
-
Please provide source code and commit sha if you found a bug.
259
-
260
-
Review existing issues and provide feedback or react to them.
261
-
262
-
### Pull requests
263
-
264
-
Open your pull request against ```develop```.
265
-
266
-
You should add/modify tests to cover your proposed code changes.
267
-
268
-
Tests coverage should never go down from 90%.
269
-
270
-
If your pull request contains a new feature, please document it on the README.
271
-
272
-
### Branching
273
-
274
-
The ```main``` is a **regular branch** which always contains the latest
275
-
**stable** codebase and must **never** be broken.
276
-
277
-
The ```develop``` is a **regular branch** which always contains the latest
278
-
**development** codebase and **eventually** can be broken. But you'll need to
279
-
accept the **sombrero of shame** if you do that.
280
-
281
-
The ```release``` is a **regular branch** which contains a specific release
282
-
version. You must use the following name convention: **release-X.Y.Z**, where
283
-
X, Y and Z are: major, minor and patch [version numbers](#versioning).
284
-
285
-
The ```experimental``` is a **temporary branch** which contains a new feature or
286
-
ideia. You must use the following name convention: **experimental-brief-description**.
287
-
288
-
The ```feature``` is a **temporary branch** which contains a new feature under
289
-
development that latter will be merged against the development branch. You must
290
-
use the following name convention: **feature-brief-description**.
291
-
292
-
The ```bugfix``` is a **temporary branch** which contains necessary fix to be
293
-
applied **after** a specific release to be merged against the development branch.
294
-
You must use the following name convention: **bugfix-brief-description**.
295
-
296
-
The ```hotfix``` is a **temporary branch** which contains a critical fix to be
297
-
applied **immediately** and merged against the main and the development branches.
298
-
You must use the following name convention: **hotfix-brief-description**.
299
-
300
-
Feel free to apply the labels from GitHub to the branches, they are very helpful.
301
-
302
-
### Versioning
303
-
304
-
The project uses the [semantic versioning 2.0.0](https://semver.org) in
305
-
order to control the version numbers.
306
-
307
-
### Commiting
308
-
309
-
The ```main```, ```develop``` and ```release``` branches have protection rules
310
-
against **push**.
311
-
312
-
In order to contribute you must create a new branch following the [branching](#branching)
313
-
guideline and once your work is done, open a **pull request** from your branch
314
-
to the **develop** branch.
315
-
316
-
The **pull request** will trigger the test suites automatically
317
-
and the code must **pass all the tests** and also be reviewed and approved
318
-
before merged in the **develop** branch (or even ``main`` or ``release`` in case
319
-
of a ``*fix``).
320
-
321
-
Feel free to apply the labels from GitHub to the pull requests, they are very helpful.
322
-
323
-
## License
254
+
## ⚖️ License
324
255
325
256
Hare is released under the [MIT License](./LICENSE).
0 commit comments