Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xabaril/esquio
Esquio is a Feature Toggle Library for .NET Developers.
https://github.com/xabaril/esquio
Last synced: 3 days ago
JSON representation
Esquio is a Feature Toggle Library for .NET Developers.
- Host: GitHub
- URL: https://github.com/xabaril/esquio
- Owner: Xabaril
- License: apache-2.0
- Created: 2019-04-08T10:29:38.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-25T13:10:54.000Z (9 months ago)
- Last Synced: 2024-12-14T04:02:05.087Z (10 days ago)
- Language: JavaScript
- Size: 29.4 MB
- Stars: 429
- Watchers: 16
- Forks: 50
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
[](https://esquio.readthedocs.io/en/latest/?badge=latest)
## About [Esquio](https://esquio.readthedocs.io)
Esquio is a [Feature Toggles (aka Feature Flags)](https://martinfowler.com/articles/feature-toggles.html) and A/B testing framework for .NET Core 3.0. Feature Toggle is a powerful technique that allows developers to deliver new functionality to users without changing code. Provides an alternative to to mantain multiples branches (aka feature branches), so any feature can be tested even before it is completed and ready for the release. We can release a version of our product with non production ready features. These non production ready features are hidden (toggled) for the broader set of users but can be enabled to any subset of testing or internal users we want them to try the features. We can use feature toggles to enable or disable features during run time.
Esquio is built with the possibility of using it not only in ASP.NET Core 3.0 in mind but making it possible to use also in other .NET Core 3.0 projects like workers, web jobs, class libraries, ... almost any kind of .NET Core 3.0 project. For the Esquio team, this is not only about using a library, but using a full Feature Toggles framework for all of our projects, and as a delivery mechanism.
We believe Feature Toggling is, somekind, a way of delivering software, making it a first class citizen in your DevOps processes, therefore we are working hard towards integrating it, via extension and pipelines tasks, with Azure DevOps, so you can use Esquio Toggles directly in your releases and delivery flows. Having a full toggle delivery experience.
Esquio Azure DevOps extensions are built in top of the Esquio API, in the case you need to integrate Esquio with any other tool, you can always use this API to handle the toggles.
Additionally, if you need it, Esquio has a full UI developed, so you can be able to handle all your Toggles in it, making it fairly simple to use and manage.
Maintained by [awesome community contributors](https://github.com/Xabaril/Esquio/graphs/contributors).
For project documentation, please visit [readthedocs](https://esquio.readthedocs.io).
## How to build
Esquio is built against the latest NET Core 3.
* Run [install-sdk.ps1](https://github.com/Xabaril/Esquio/blob/master/install-sdk.ps1) or [install-sdk.sh](https://github.com/Xabaril/Esquio/blob/master/install-sdk.sh) to install required .NET Core SDK.
* Run [build.ps1](https://github.com/Xabaril/Esquio/blob/master/build.ps1) or [build.sh](https://github.com/Xabaril/Esquio/blob/master/build.sh) in the root of the repo to restore package, build solution and run tests.
## How to run migrations
### For SqlServer
dotnet ef migrations add *MigrationName* --context StoreDbContext --project src/Esquio.UI.Api --output-dir Infrastructure/Data/Migrations/SqlServer
### For Postgres
dotnet ef migrations add *MigrationName* --context NpgSqlContext --project src/Esquio.UI.Api --output-dir Infrastructure/Data/Migrations/NpgSql
### For MySql
dotnet ef migrations add *MigrationName* --context MySqlContext --project src/Esquio.UI.Api --output-dir Infrastructure/Data/Migrations/MySql
## Acknowledgements
Esquio is built using the following great open source projects and free services:
* [ASP.NET Core](https://github.com/aspnet)
* [XUnit](https://xunit.github.io/)
* [Fluent Assertions](http://www.fluentassertions.com/)
* [Fluent Validations](https://github.com/JeremySkinner/FluentValidation)
* [MediatR](https://github.com/jbogard/MediatR)
* [Problem Details](https://www.nuget.org/packages/Hellang.Middleware.ProblemDetails)
* [Serilog](https://github.com/serilog/serilog)
* [Swashbucke.AspNetCore](https://github.com/domaindrivendev/Swashbuckle.AspNetCore)
* [Acheve](https://github.com/Xabaril/Acheve.TestHost)
..and last but not least a big thanks to all our [contributors](https://github.com/Xabaril/Esquio/graphs/contributors)!
## Code of conduct
This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community.
For more information see the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct).
## Videos
ASP.NET Community Standup - May 12th 2020 - Esquio Feature Toggles
[](https://youtu.be/qotnVlgYd8c?list=PL1rZQsJPBU2St9-Mz1Kaa7rofciyrwWVx&t=225)
MeetUp | NetCore y Feature Flags(Spanish)
[](https://www.youtube.com/watch?v=VCGZZOFaPL0)