guibranco / crispywaffle

🧰 🛠️ Crispy Waffle project - toolkit for .NET projects

👋 Hi there! I'm Guilherme

💁 My name is Guilherme Branco Stracini, I'm from São Paulo, Brazil , living in Dublin, Ireland .

Important

🗣️ The correct pronunciation of my name is [ɡiˈʎɛɾmi], that's a Portuguese name.

---

🔭 Now working in OUTsurance Ireland an online insurance company from OUTsurance South Africa and Youi Australia . Based in Dublin, Ireland as a senior software engineer, working with C# (.NET versions 6, 7, and 8), Docker, Azure DevOps, Azure CosmosDB, Terraform, Azure Service Bus, RabbitMQ, Microsoft SQL Server and other tools, building the billing and financial services.

🔭 Two years working in Talabat (part of Delivery Hero ), which is a Q-commerce delivery company in GCC and MENA. Based in Dubai, UAE , as a backend engineer, working with C# (.NET versions 5, 6, and 7), Docker, AWS (SQS, SNS, Lambda, S3, SSM, EC2), Microsoft SQL Server, PostgreSQL, Terraform, ArgoCD, CircleCI and other tools on QCommerce tribe (formerly Grocery tribe) in Grocery Fulfillment and later on Shopping Experience (SHOPX) squad (once Finding and Shopping Team - FAST).

🔭 Over one year and a half, working in Banco BS2 , as a backend engineer, using C# (.NET Core versions 2.2, 3.0, and 3.1), Docker, RabbitMQ, Azure DevOps, and Microsoft SQL Server to develop the SPI/PIX solution (Brazilian Instant Payments system). I've also worked on Open Banking and API Banking (BaaS - Banking as a Service) projects.

🔭 In the past, I worked with e-commerce for about eight years. Significant time using VTEX PaaS (Platform as a Service).

🏢 Companies: OUTsurance | Talabat | Syndigo | FCamara | The Bridge Social | Grace Kennedy Group | Farfetch | Multivision | Banco BS2 | K2 Partnering Solutions | C&A | Inovação Media Brasil .

🏗️ Industries: Financial 💵 | Insurance 💰 | Delivery 🛵 | Logistics 🚚 | Integrations ⚙️ | QCommerce 🛒 | e-Commerce 🧺.

---

🗣️ Latest blog posts

• 💯 AppVeyor vs GitHub Actions
• 🔥 RabbitMQ gratuito: Potencialize sua arquitetura de mensageria sem custos
• 💫 Dev Essentials – JetBrains ReSharper Extensions
• 🚀 Dev Essentials – Visual Studio Code Extensions
• 🌮 Dev Essentials – Visual Studio (IDE) Extensions

---

🎡 Hobbies

🌱 Using Go, Rust, and Python for personal projects or just for a hobby. Meantime, playing with Flutter, React, and Kafka.

👯 Looking to collaborate on open-source projects with payment gateways, courier platforms, and e-commerce/q-commerce platforms.

💬 Ask me about C#, JS/TS (frontend and backend), NodeJS, PHP, DDD, SOLID, software architecture, system design, and design patterns.

⚡ Fun fact: LEGO lover.

---

💻 Organizations

Account	Description
	Main account with stable projects.
	🧪 POCs, Hello Worlds and learning stuff.
	⚙️ API BR project (free APIs with Brazilian data).
	Job opportunities for .NET developers in Brazil.
	Job opportunities for Node.JS developers in Brazil.
	Job opportunities for Python developers in Brazil.
	Job opportunities for Ruby developers in Brazil.
	Job opportunities for Rust developers in Brazil.
	Job opportunities for backend developers in Angola.
	Job opportunities for frontend developers in Angola.
	Job opportunities for backend developers in Portugal.
	Job opportunities for frontend developers in Portugal.

---

🧰 Things I code with

Skill	Technologies
Backend
JS/TS ecosystem
Frontend
SQL
noSQL
Queue / Messaging
Package Manager
Version Control System (VCS)
Code hosting
Infrastructure as Code (IaC)
Containers
(Web) Servers
Observability (O11Y)
Continuous Integration (CI)
Continuous Deployment (CD)
Cloud
Agile
Testing
Code Quality

---

🎂 Experience

Experience (in years)
13+ C# .NET	13+ .NET Framework	8+ .NET Core	9+ Node.JS (JS/TS)	17+ PHP
16+ MS SQL Server	17+ MySQL/MariaDB	8+ PostgreSQL	5+ MongoDB	3+ CosmosDB
8+ Elastic Search	9+ Redis	7+ RabbitMQ	3+ Apache Kafka	9+ AWS
3+ Azure	5+ Oracle 11g	17+ JS (Frontend)	17+ jQuery	8+ ReactJS
3+ Terraform	4+ Rust	3+ Python	2+ Go	2+ NextJS

---

Github Stats

(since January 23, 2013)

---

🕐 Wakatime Stats

(since April 10, 2015)

crispywaffle's Issues

[DOCS] Add `CommandsConsumer` documentation

Description

Add docs about CommandsConsumer, with some usage examples.

Screenshots

No response

Additional information

No response

[FEATURE] Add `Toml` serializer

Description

Add a Toml serializer

This is an ongoing brainstorming about how to deal with the Toml format and its serialization.
I am working in a PoC to determine which library/implementation should be used here.

Tech notes

The ongoing work can be found here: PoC .NET Toml handling

Once it is done, I will update this ticket with the expected library to be used.

Additional information

• Add proper labels help wanted, good first issue, and hacktoberfest after finishing tech requirements.
• This feature requires documentation.
• This feature requires unit testing.
• This feature requires a minor version bump

Add issue template

Add issue template

Remove `ISSUE_TEMPLATE` directory

Is your feature request related to a problem? Please describe.
Remove the ISSUE_TEMPLATE directory.

Remove retry rules from FtpClient class.

The retry rules (retry 3x, wait 1s between retries) should not reside in the code of this tool, instead it should be something that who is using the code decides how to deal with it and how to retry (manually or using Polly)

CrispyWaffle/Src/CrispyWaffle.Utils/Communications/FtpClient.cs

Line 244 in 5bd17e9

throw new FtpClientException(path.GetPathOrFileName(), "create", e);

Implement FailoverExceptionHandler

Implement the Failover Exception handler that saves the exception to a file in fatal-{date}.log pattern

Depfu Error: No dependency files found

Hello,

We've tried to activate or update your repository on Depfu and couldn't find any supported dependency files. If we were to guess, we would say that this is not actually a project Depfu supports and has probably been activated by error.

Monorepos

Please note that Depfu currently only searches for your dependency files in the root folder. We do support monorepos and non-root files, but don't auto-detect them. If that's the case with this repo, please send us a quick email with the folder you want Depfu to work on and we'll set it up right away!

How to deactivate the project

• Go to the Settings page of either your own account or the organization you've used
• Go to "Installed Integrations"
• Click the "Configure" button on the Depfu integration
• Remove this repo (guibranco/CrispyWaffle) from the list of accessible repos.

Please note that using the "All Repositories" setting doesn't make a lot of sense with Depfu.

If you think that this is a mistake

Please let us know by sending an email to [email protected].

---

This is an automated issue by Depfu. You're getting it because someone configured Depfu to automatically update dependencies on this project.

[FEATURE] Converts a project to use Centralised Package Management

Description

Converts a project to use Centralised Package Management

Tech notes

Use this tool: CentralisedPackageConverter

Additional information

No response

[FEATURE] Add Saga capability

Is your feature request related to a problem? Please describe.
It would be nice to have SAGA capabilities in the event handler process.

Describe the solution you'd like
Could you implement the SAGA pattern handling in the EventsConsumer class?

• An event should trigger the saga (like any other event already present in the events consumer feature).
• Multiple other messages can continue the SAGA (like the EventHandler can handle multiple types of events, the saga also can do it)
  • This will be different from standard event handler, since it will be a SAGA data class that will be correlated to all messages
  • The SAGA data will be present in all event handler, and needs to be correlated upon being handled by the new event/message
• The SAGA needs to be persisted (SQL, noSQL, memory)
• The SAGA needs to be completed
• The SAGA needs to have a timeout feature

Add receive message from queue/exchange in RabbitMQ

Add a method to receive messages from exchanges/queues in RabbitMQ

[FEATURE] Add `SEQ` log provider

Is your feature request related to a problem? Please describe.
Add a project CrispyWaffle.Seq that should implement SeqLogProvider and SeqBatchLogAdapter classes that will forward logs to HTTP endpoint (the SEQ server).

Describe the solution you'd like

• Create a new project (and NuGet package) named: CrispyWaffle.Seq
• Create a class SeqLogProvider that implements ILogProvider
• Create a class SeqBatchLogAdapter that implements ICategorizedLogAdapter
• The class should forward the messages through HTTP using the SEQ Ingestion with HTTP or some of .NET implementation in a batch configurable behaviour (timeout or throughput or both)

Add CodeClimate badges

Add badges from Code Climate

Build badge should point to main branch

Describe the bug
The build badge should show only main branch status

Implement EnvironmentHelper

Implement the class EnvironmentHelper with the followin properties:

• ApplicationName
• DisplayApplicationName
• ExecutionPath
• Host
• IpAddress
• IpAddressExternal
• OperationalSystemVersion
• ProcessId
• UserAgent
• UserName
• Version
• VersionDate

Add Log to EventsConsumer

Add LogConsumer call(s) to EventsConsumer class

Remove StringExtensions.Culture

Remove the property Culture from StringExtensions class

[FEATURE] Upgrade `ElasticSearch` dependencies

Description

Currently, the project uses both deprecated dependencies:

• Elasticsearch.Net
• Nest

We must replace it with the up-to-date version, which introduces breaking changes:

• Elastic.Clients.Elasticsearch

Tech notes

Some content to address the breaking changes:

• Release notes v8.0.0

Additional information

No response

Fix test tab on CI

Describe the bug
Fiz test report in AppVeyor

To Reproduce
Steps to reproduce the behavior:

1. Go to 'AppVeyor'
2. Click on 'tests' tab, it is empty

Add async handler for `EventsConsumer` class

Add a HandleAsync method to EventsConsumer class.

Implement ElasticSearch package

Implement the ElasticSearch package with:

• Log provider
• Extensions / Helpers

[FEATURE] Add async operations for `CacheManager` and `ICacheRepository` classes

Add async support to CacheManager methods and for the ICacheRepository implementations:

• MemoryCacheRepository
• RedisCacheRepository

Add README to NuGet

Is your feature request related to a problem? Please describe.
Add README to NuGet

Describe the solution you'd like
Add README to NuGet

[BUG] Remove culture specific from codebase

Is your feature request related to a problem? Please describe.
Remove culture-specific code from the codebase.

Describe the solution you'd like

• Remove the extensions method for Brazilian formats
• Remove default CultureInfo for pt-BR
• Remove any other specific code that might change or default to another based on implementation culture info.

Add SecureCredentialProvider

Add class and interface SecureCredetianlProvider

The class provides data for securing the Credential from configuration.

Add CodeFactor badge

Add EventLogAdapter and EventLogProvider

Add EventLogAdapter and EventLogProvider

[FEATURE] Add support to `UseServiceProviderFactory`

Is your feature request related to a problem? Please describe.
Add support to the built-in method of .NET UseServiceProviderFactory in Service Registry (DI).

Describe the solution you'd like
Autofac.Extensions.DependencyInjection

Rename master to main

Rename branch master to main

Add SMTP and FTP clients in Utils projects

Is your feature request related to a problem? Please describe.
Add new project CrispyWaflle.Utils and add communications namespace with FTP and SMTP clients.

Describe the solution you'd like

• Add FtpClient class.
• Add SmtpClient class;

Add explicitly support to `.NET 6`, `.NET 7` and `.NET 8`

Is your feature request related to a problem? Please describe.
This library currently targets .NET Standard 2.0 and .NET Standard 2.1. The goal is to also target it to .NET 6 (LTS - Nov/2024), .NET 7 (STS - May/2024) and .NET 8 (Nov/2026).

Describe the solution you'd like
Add the three versions to TargetFrameworks node in each .csproj.
No source code change, only configuration at this stage.
Subsequently we can consider having compiler conditionals for specific code that targets specific .NET versions/features.

Extract `EventLog` and remove dependency `System.Diagnostics.EventLog` from `CrispyWaffle` project

Extract the System.Diagnostics.EventLog from Src/CrispyWaffle/Log/Providers and Src/CrispyWaffle/Log/Adapters to a dedicated project CrispyWaffle.EventLog and remove the dependency of System.Diagnostics.EventLog in CrispyWaffle project.

Files:

• EventLogAdapter
• EventLogProvider
• IEventIdProvider
• EventIdProvider

Steps to archive the goal:

• Create a new project in the CrispyWaffle solution named CrispyWaffle.EventLog
• Add a dependency to the main project in this newly created project
• Uninstall the System.Diagnostics.EventLog from the main project
• Install the System.Diagnostics.EventLog package in the new project
• If you are new to .NET, you can just cut the line from one project and paste it in the other, this will be enough to uninstall/install a nugget package
• Move the 4 files listed above in the main project to this newly created project
• Keep the same file structure for the moved files, so it will be something like Src/CrispyWaffle.EventLog/Log/Adapters (for the adapter) and Src/CrispyWaffle.EventLog/Log/Providers (for the other 3 files)

Implement RabbitMQ package

Implement the RabbitMQ package with:

• Log provider
• Extensions / Helpers
• Generic queue methods

[FEATURE] Add tests to `CrispyWaffle.Redis` and other cache features

Add tests to CrispyWaffle.Redis, CacheManager and the MemoryCacheRepository

Add a log method Trace that accepts an Exception as a parameter

Add the log level Trace with Exception as a parameter

Add self reference in methods

When registering a interface/class, allow the usage of ServiceLocator methods inside constructor

ServiceLocator.Register<T>(s => new T(s.Resolve<TDependency>());

So s is a reference to ServiceLocator class.

Fix bugs and code smells reported by SonarCloud

Is your feature request related to a problem? Please describe.
Fix the bugs and code smells reported by SonarCloud.

Describe the solution you'd like
Fix the following problems reported by SonarCloud:

• 1 bug
• 930 code smells
  SonarCloud report

Add Snyk badge to readme.md

Add the [Snyk badge] to this readm.md file

Add serializer for `System.Text.Json`

This issue is about adding a new serializer adapter to the project.

The new serializer should use the System.Text.Json instead of the Newtonsoft.Json used by JsonSerializerAdapter.

Currently, we have the following serializers in the project:

• BinarySerializerAdapter.cs
• JsonSerializerAdapter.cs
• XmlSerializerAdapter.cs

The proposed solution is to rename JsonSerializerAdapter to NewtonsoftJsonSerializerAdapter and also add the JsonSerializerAdapter that will implement the serialization and deserialization logic using the System.Text.Json.

The class should implement the ISerializerAdapter interface. More precisely, it should implement the BaseSerializerAdapter abstract class.

Add Fatal log level

Add Fatal as a new log level, higher than Error

Add CodeClimate coverage report

Add CodeClimate coverage report based on appveyor.yml

[FEATURE] Add `Yaml` serializer

Description

Add a Yaml serializer

This is an ongoing brainstorming about how to deal with the Toml format and its serialization.
I am working in a PoC to determine which library/implementation should be used here.

Tech notes

The ongoing work can be found here: PoC .NET Yaml handling

Once it is done, I will update this ticket with the expected library to be used.

Additional information

• Add proper labels help wanted, good first issue, and hacktoberfest after finishing tech requirements.
• This feature requires documentation.
• This feature requires unit testing.
• This feature requires a minor version bump

Remove StringExtensions.Comparison

Remove the property Comparison from StringExtensions class.

[FEATURE] Implement `RollingTextFileLogAdapter`

Is your feature request related to a problem? Please describe.
Implement the class RollingTextFileLogAdapter

Describe the solution you'd like
I would like to have an implementation of the Rolling Text File Log Adapter.
It should be a text file log adapter and should handle the file size/name.
A new file must be created whenever the file reaches the configured maximum size or the number of messages per file.

The rules are:

• file size (B, MB, GB, ...)
• quantity of messages (number of messages to roll up)

Add CancellationToken to ServiceLocator

Allow ServiceLocator create instance with CancellationToken dependency.
CancellationToken lifecycle should be managed by ServiceLocator.

Remove manual .NET 8 installation in AppVeyor

Is your feature request related to a problem? Please describe.
Remove the manual installation of .NET 8 from appVeyor.yml file when AppVeyor releases a new image with built-in support for the .NET 8

Describe the solution you'd like
Remove lines 28 and 29 from the appVeyor.yml file when AppVeyor releases an official.NET 8 image.

[FEATURE] Add Request/Response pattern in EventsDispatcher (maybe a CommandsDispatcher)

Description

Currently, we have the EventsDispatcher that receives an IEvent and dispatches it overall EventsHandlers.

The idea here is to have a CommandsDispatcher that will receive an ICommand as input, and dispatch/send it for one, and one only CommandHandler and send back to the caller the response.dispatch/send it for one and only one CommandHandler, and send the response back to the caller

Tech notes

Use memory transport for this (maybe in the future we can have distributed system arch for this).

Additional information

No response

SYSLIB0021: Derived cryptographic types are obsolete

Replace System.Security.Cryptography.MD5CryptoServiceProvider
With System.Security.Cryptography.MD5.create

Warning: SYSLIB0021

Implementation:

CrispyWaffle/Src/CrispyWaffle/Cryptography/Security.cs

Line 111 in abc21d4

{HashAlgorithmType.Md5, new MD5CryptoServiceProvider()},

Join deploy statements in appveyor.yml

Join/merge deploy statements to use a generic package name.

https://www.appveyor.com/docs/deployment/nuget/

Create `BaseSerializerAdapter` abstract class

Create SerializerAdapterBase abstract class and implement duplicated code on it from inherited adapters.

Refer to Sonar Cloud duplicated code to extract necessary methods.

Replace sonar.login with sonar.token in appveyor.yml

Replace sonar.login with sonar.token in appveyor.yml