|
1 | | -<br /> |
| 1 | +<!-- markdownlint-disable-file MD033 --> |
| 2 | +<!-- markdownlint-disable-file MD041 --> |
2 | 3 |
|
| 4 | +<br /> |
3 | 5 | <div align="center"> |
4 | 6 | <img alt="Eventually" src = "./resources/logo.png" width = 300> |
5 | 7 | </div> |
6 | | - |
7 | 8 | <br /> |
8 | | - |
9 | 9 | <div align="center"> |
10 | 10 | <strong> |
11 | | - Event Sourcing for Go |
| 11 | + Domain-driven Design, Event Sourcing and CQRS for Go |
12 | 12 | </strong> |
13 | 13 | </div> |
14 | | - |
15 | 14 | <br /> |
16 | | - |
17 | 15 | <div align="center"> |
18 | | - <!-- Testing pipeline --> |
19 | | - <a href="https://github.com/get-eventually/go-eventually/actions?query=workflow%3A%22Main+Workflow%22"> |
20 | | - <img alt="GitHub Workflow Status" |
21 | | - src="https://img.shields.io/github/actions/workflow/status/get-eventually/go-eventually/main.yml?branch=main&style=flat-square"> |
22 | | - </a> |
23 | 16 | <!-- Code Coverage --> |
24 | | - <a href="https://sonarcloud.io/project/activity?custom_metrics=coverage&graph=custom&id=get-eventually_go-eventually"> |
25 | | - <img alt="Sonar Coverage" |
26 | | - src="https://img.shields.io/sonar/coverage/get-eventually_go-eventually?server=https%3A%2F%2Fsonarcloud.io&style=flat-square"> |
| 17 | + <a href="https://app.codecov.io/gh/get-eventually/go-eventually"> |
| 18 | + <img alt="Codecov" src="https://img.shields.io/codecov/c/github/get-eventually/go-eventually?style=flat-square"> |
27 | 19 | </a> |
28 | 20 | <!-- pkg.go.dev --> |
29 | 21 | <a href="https://pkg.go.dev/github.com/get-eventually/go-eventually"> |
|
36 | 28 | src="https://img.shields.io/github/license/get-eventually/go-eventually?style=flat-square"> |
37 | 29 | </a> |
38 | 30 | </div> |
39 | | - |
40 | 31 | <br /> |
41 | 32 |
|
| 33 | +> [!WARNING] |
| 34 | +> Though used in production environment, the library is still under active development. |
42 | 35 |
|
43 | | -Idiomatic library to help you build Event Sourced application in Go. |
| 36 | +<!-- markdownlint false positive --> |
44 | 37 |
|
45 | | -## Please note |
| 38 | +> [!NOTE] |
| 39 | +> Prior to `v1` release the following Semantic Versioning |
| 40 | +is being adopted: |
| 41 | +> |
| 42 | +> * Breaking changes are tagged with a new **minor** release, |
| 43 | +> * New features, patches and documentation are tagged with a new **patch** release. |
46 | 44 |
|
47 | | -The library is currently under development, and not yet 100% ready for production use-cases. |
| 45 | +## Overview |
48 | 46 |
|
49 | | -### Note on semantic versioning |
| 47 | +`eventually` is a library providing abstractions and components to help you: |
50 | 48 |
|
51 | | -This library is **actively being developed**, and prior to `v1` release the following [Semantic versioning]() |
52 | | -is being adopted: |
| 49 | +* Build Domain-driven Design-oriented code, (Domain Events, Aggregate Root, etc.) |
53 | 50 |
|
54 | | -* Breaking changes are tagged with a new `MINOR` release |
55 | | -* New features, patches and documentation are tagged with a new `PATCH` release |
| 51 | +* Reduce complexity of your code by providing ready-to-use components, such as PostgreSQL repository implementation, OpenTelemetry instrumentation, etc. |
56 | 52 |
|
57 | | -## Contributing |
| 53 | +* Implement event-driven architectural patterns in your application, such as Event Sourcing or CQRS. |
58 | 54 |
|
59 | | -You want to contribute to `eventually` but you don't know where to start? |
| 55 | +### How to install |
60 | 56 |
|
61 | | -First of all, thank you for considering contributing :heart: |
| 57 | +You can add this library to your project by running: |
| 58 | + |
| 59 | +```sh |
| 60 | +go get -u github.com/get-eventually/go-eventually |
| 61 | +``` |
| 62 | + |
| 63 | +## Contributing |
62 | 64 |
|
63 | | -You can head over our [`CONTRIBUTING`](./CONTRIBUTING.md) section to know |
64 | | -how to contribute to the project, and — in case you don't have a clear idea what |
65 | | -to contribute — what is most needed needed from contributors. |
| 65 | +Thank you for your consideration ❤️ You can head over our [CONTRIBUTING](./CONTRIBUTING.md) page to get started. |
66 | 66 |
|
67 | 67 | ## License |
68 | 68 |
|
69 | 69 | This project is licensed under the [MIT license](LICENSE). |
70 | 70 |
|
71 | 71 | ### Contribution |
72 | 72 |
|
73 | | -Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in `get-eventually` by you, shall be licensed as MIT, without any additional terms or conditions. |
| 73 | +Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in `go-eventually` by you, shall be licensed as MIT, without any additional terms or conditions. |
0 commit comments