feat(service): add generic HTTP service

[nikoksr]

Description

Adding a generic HTTP service. This service tries to provide common functionalities that would be required by a Notify HTTP service while staying intuitive, lean but powerful.

The service mostly is a wrapper around the standard libraries http package and provides us with some QoL functions, while still following the libraries general practices.

See here for a usage example.

Motivation and Context

As discussed with multiple other devs, we decided to initiate the move away from the heavy SDK dependency over to a leaner but more manual approach. To achieve this we have to implement the services through direct HTTP calls rather than the usage of 3rd-party SDKs.

Implicitly this means that we'd end up with a ton of different implementations and practices when it comes to HTTP communication in Go. To avoid or minimize that, we decided to provide the project with a generalized HTTP service. Additionally, this will help people connect to services with HTTP endpoints that are not (yet) officially supported by Notify.

How Has This Been Tested?

Wrote extensive tests using the net/http/httptest package. I chose the httptest package over our common practice as I like the idea of a full integration test for our most fundamental service better, than to mock it.

The httptest.Server used will run on the lo network interface and we'll thus test against "real" HTTP calls instead of intercepted or emulated ones.

As more and more services will be reimplemented with a manual HTTP approach, it is likely that this is gonna become the projects new standard for service testing, too. It feels like the right step at this point in time.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation (no code change)
• Refactor (refactoring production code)
• Other

Checklist:

• My code follows the code style of this project.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All new and existing tests passed.

[codecov-commenter]

Codecov Report

Base: 73.43% // Head: 75.39% // Increases project coverage by +1.95% 🎉

Coverage data is based on head (fcbf222) compared to base (868f04d).
Patch coverage: 92.96% of modified lines in pull request are covered.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #506      +/-   ##
==========================================
+ Coverage   73.43%   75.39%   +1.95%     
==========================================
  Files          37       38       +1     
  Lines        1148     1276     +128     
==========================================
+ Hits          843      962     +119     
- Misses        228      234       +6     
- Partials       77       80       +3     

Impacted Files	Coverage Δ
service/http/http.go	92.96% <92.96%> (ø)

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.