README
¶
gosrvlib
Go Service Library
This Open Source project contains a collection of high-quality GO (golang) packages.
Each package follows common conventions and they can be individually imported in any project.
This package collection forms the base structure for fully-fledged production-ready web-services.
A new Web service can be generated by using the command make project CONFIG=project.cfg.
The new generated project name, description, etc..., can be set in the file specified via the CONFIG parameter.
The packages documentation is available at: https://pkg.go.dev/github.com/Vonage/gosrvlib/
- category Library
- license MIT
- link https://github.com/Vonage/gosrvlib
TOC
Developers' Quick Start
To quickly get started with this project, follow these steps:
- Ensure you have installed the latest Go version and Python3 for some extra tests.
- Clone the repository:
git clone https://github.com/Vonage/gosrvlib.git. - Change into the project directory:
cd gosrvlib. - Install the required dependencies and test everything:
DEVMODE=LOCAL make x.
Now you are ready to start developing with gosrvlib!
This project includes a Makefile that allows you to test and build the project in a Linux-compatible system with simple commands.
All the artifacts and reports produced using this Makefile are stored in the target folder.
Alternatively, everything can be built inside a Docker container using the command make dbuild that uses the environment defined at resources/docker/Dockerfile.dev.
To see all available options:
make help
Running all tests
Before committing the code, please format it and check if it passes all tests using
DEVMODE=LOCAL make x
Examples
Please check the examples/service folder for an example of a service based on this library.
The following command generates a new project from the example using the data set in the project.cfg file:
make project CONFIG=project.cfg
Directories
¶
| Path | Synopsis |
|---|---|
|
pkg
|
|
|
awsopt
Package awsopt provides functions to configure common AWS options for the official aws-sdk-go-v2 library.
|
Package awsopt provides functions to configure common AWS options for the official aws-sdk-go-v2 library. |
|
awssecretcache
Package awssecretcache provides a simple client to retrieve and cache secrets from AWS Secrets Manager.
|
Package awssecretcache provides a simple client to retrieve and cache secrets from AWS Secrets Manager. |
|
bootstrap
Package bootstrap provides a simple way to bootstrap an application with managed configuration, logging, metrics, application context, and shutdown signals.
|
Package bootstrap provides a simple way to bootstrap an application with managed configuration, logging, metrics, application context, and shutdown signals. |
|
config
Package config handles the configuration of a program.
|
Package config handles the configuration of a program. |
|
decint
Package decint provides utility functions to parse and represent decimal values as integers with a set precision.
|
Package decint provides utility functions to parse and represent decimal values as integers with a set precision. |
|
dnscache
Package dnscache provides a thread-safe local single-flight DNS cache for LookupHost.
|
Package dnscache provides a thread-safe local single-flight DNS cache for LookupHost. |
|
encode
Package encode provides serialization and deserialization functions to safely transmit, store and retrieve data between different systems (e.g., databases, queues, caches, etc.).
|
Package encode provides serialization and deserialization functions to safely transmit, store and retrieve data between different systems (e.g., databases, queues, caches, etc.). |
|
encrypt
Package encrypt contains a collection of utility functions to encrypt and decrypt data.
|
Package encrypt contains a collection of utility functions to encrypt and decrypt data. |
|
enumbitmap
Package enumbitmap provides functions to encode slices of enumeration strings into integer bitmap values and vice versa.
|
Package enumbitmap provides functions to encode slices of enumeration strings into integer bitmap values and vice versa. |
|
enumcache
Package enumcache provides simple thread-safe methods to store and retrieve enumeration sets with an integer ID and string name.
|
Package enumcache provides simple thread-safe methods to store and retrieve enumeration sets with an integer ID and string name. |
|
enumdb
Package enumdb allows to load enumeration sets (enumcache) from multiple database tables.
|
Package enumdb allows to load enumeration sets (enumcache) from multiple database tables. |
|
errtrace
Package errtrace provides a function to automatically trace errors.
|
Package errtrace provides a function to automatically trace errors. |
|
filter
Package filter provides generic rule-based filtering capabilities for struct slices.
|
Package filter provides generic rule-based filtering capabilities for struct slices. |
|
healthcheck
Package healthcheck provides a simple way to define health checks for external services or components.
|
Package healthcheck provides a simple way to define health checks for external services or components. |
|
httpclient
Package httpclient provides a configurable and instrumented HTTP client with common options.
|
Package httpclient provides a configurable and instrumented HTTP client with common options. |
|
httpretrier
Package httpretrier provides the ability to automatically repeat HTTP requests based on user-defined conditions.
|
Package httpretrier provides the ability to automatically repeat HTTP requests based on user-defined conditions. |
|
httpreverseproxy
Package httpreverseproxy provides an HTTP Reverse Proxy that takes an incoming request and sends it to another server, proxying the response back to the client.
|
Package httpreverseproxy provides an HTTP Reverse Proxy that takes an incoming request and sends it to another server, proxying the response back to the client. |
|
httpserver
Package httpserver defines a default configurable HTTP server with common routes and options.
|
Package httpserver defines a default configurable HTTP server with common routes and options. |
|
httpserver/route
Package route is deprecated.
|
Package route is deprecated. |
|
httputil
Package httputil contains a collection of common HTTP Request and Response utility functions.
|
Package httputil contains a collection of common HTTP Request and Response utility functions. |
|
httputil/jsendx
Package jsendx implements a custom JSend model to wrap all HTTP responses in a consistent JSON object with default fields.
|
Package jsendx implements a custom JSend model to wrap all HTTP responses in a consistent JSON object with default fields. |
|
ipify
Package ipify allows to get the public IP address of this service instance via the ipify API (https://www.ipify.org/).
|
Package ipify allows to get the public IP address of this service instance via the ipify API (https://www.ipify.org/). |
|
jwt
Package jwt provides simple wrapper functions to manage basic JWT Auth with username/password credentials.
|
Package jwt provides simple wrapper functions to manage basic JWT Auth with username/password credentials. |
|
kafka
Package kafka provides a simple high-level API for producing and consuming Apache Kafka messages.
|
Package kafka provides a simple high-level API for producing and consuming Apache Kafka messages. |
|
kafkacgo
Package kafkacgo provides a simple high-level API for producing and consuming Apache Kafka messages.
|
Package kafkacgo provides a simple high-level API for producing and consuming Apache Kafka messages. |
|
logging
Package logging implements a structured-log model with common functionalities and utility functions.
|
Package logging implements a structured-log model with common functionalities and utility functions. |
|
maputil
Package maputil provides a collection of map utility functions.
|
Package maputil provides a collection of map utility functions. |
|
metrics
Package metrics defines a common interface for instrumenting applications and components to collect metrics.
|
Package metrics defines a common interface for instrumenting applications and components to collect metrics. |
|
metrics/prometheus
Package prometheus implements the metrics interface for Prometheus.
|
Package prometheus implements the metrics interface for Prometheus. |
|
metrics/statsd
Package statsd implements the metrics interface for StatsD.
|
Package statsd implements the metrics interface for StatsD. |
|
mysqllock
Package mysqllock provides a distributed locking mechanism leveraging MySQL internal functions.
|
Package mysqllock provides a distributed locking mechanism leveraging MySQL internal functions. |
|
paging
Package paging contains utilities to handle pagination.
|
Package paging contains utilities to handle pagination. |
|
passwordhash
Package passwordhash provides functions to create and verify a password hash using a strong one-way hashing algorithm.
|
Package passwordhash provides functions to create and verify a password hash using a strong one-way hashing algorithm. |
|
passwordpwned
Package passwordpwned allows to verify if a password was pwned via the haveibeenpwned.com (HIBP) service API.
|
Package passwordpwned allows to verify if a password was pwned via the haveibeenpwned.com (HIBP) service API. |
|
periodic
Package periodic provides a way to execute a given function periodically at a specified interval.
|
Package periodic provides a way to execute a given function periodically at a specified interval. |
|
profiling
Package profiling provides an HTTP handler that can be registered to a router to expose pprof profiling data.
|
Package profiling provides an HTTP handler that can be registered to a router to expose pprof profiling data. |
|
randkey
Package randkey provides utility functions to generate random uint64 keys in different formats.
|
Package randkey provides utility functions to generate random uint64 keys in different formats. |
|
random
Package random contains a collection of utility functions to generate random numbers and strings.
|
Package random contains a collection of utility functions to generate random numbers and strings. |
|
redact
Package redact contains utility functions to obscure sensitive data.
|
Package redact contains utility functions to obscure sensitive data. |
|
redis
Package redis provides a simple and basic wrapper client for interacting with Redis, an in-memory data store.
|
Package redis provides a simple and basic wrapper client for interacting with Redis, an in-memory data store. |
|
retrier
Package retrier provides the ability to automatically repeat a user-defined function based on the error status.
|
Package retrier provides the ability to automatically repeat a user-defined function based on the error status. |
|
s3
Package s3 provides a simple client to interact with a AWS S3 bucket, including the ability to upload, download, and delete objects.
|
Package s3 provides a simple client to interact with a AWS S3 bucket, including the ability to upload, download, and delete objects. |
|
sfcache
Package sfcache provides a thread-safe local single-flight cache for external lookup calls.
|
Package sfcache provides a thread-safe local single-flight cache for external lookup calls. |
|
slack
Package slack is a basic client for the official Slack API to send messages via a Webhook.
|
Package slack is a basic client for the official Slack API to send messages via a Webhook. |
|
sleuth
Package sleuth is a basic client for the official Sleuth.io API to register deployments, manual changes, custom incident impact, and custom metric impact.
|
Package sleuth is a basic client for the official Sleuth.io API to register deployments, manual changes, custom incident impact, and custom metric impact. |
|
sliceutil
Package sliceutil provides a collection of slice utility functions, including descriptive statistics functions for numerical slices.
|
Package sliceutil provides a collection of slice utility functions, including descriptive statistics functions for numerical slices. |
|
sqlconn
Package sqlconn provides a simple way to connect to a SQL database and manage the connection.
|
Package sqlconn provides a simple way to connect to a SQL database and manage the connection. |
|
sqltransaction
Package sqltransaction provides a simple way to execute a function inside an SQL transaction.
|
Package sqltransaction provides a simple way to execute a function inside an SQL transaction. |
|
sqlutil
Package sqlutil provides SQL utilities.
|
Package sqlutil provides SQL utilities. |
|
sqlxtransaction
Package sqlxtransaction provides a simple way to execute a function inside an SQLX transaction.
|
Package sqlxtransaction provides a simple way to execute a function inside an SQLX transaction. |
|
sqs
Package sqs provides a simple client for interacting with AWS SQS (Amazon Simple Queue Service), including the ability to send, receive, and delete messages.
|
Package sqs provides a simple client for interacting with AWS SQS (Amazon Simple Queue Service), including the ability to send, receive, and delete messages. |
|
stringkey
Package stringkey provides the ability to create a simple unique key from multiple strings.
|
Package stringkey provides the ability to create a simple unique key from multiple strings. |
|
stringmetric
Package stringmetric provides functions to calculate string metrics, also known as string similarity metrics or string distance functions.
|
Package stringmetric provides functions to calculate string metrics, also known as string similarity metrics or string distance functions. |
|
testutil
Package testutil provides common testing utility functions.
|
Package testutil provides common testing utility functions. |
|
threadsafe
Package threadsafe provides an interface for thread-safe functions that can be safely used between multiple goroutines.
|
Package threadsafe provides an interface for thread-safe functions that can be safely used between multiple goroutines. |
|
threadsafe/tsmap
Package tsmap provides a collection of generic thread-safe map utility functions that can be safely used between multiple goroutines.
|
Package tsmap provides a collection of generic thread-safe map utility functions that can be safely used between multiple goroutines. |
|
threadsafe/tsslice
Package tsslice provides a collection of generic thread-safe slice utility functions that can be safely used between multiple goroutines.
|
Package tsslice provides a collection of generic thread-safe slice utility functions that can be safely used between multiple goroutines. |
|
timeutil
Package timeutil adds utility functions to the standard time library.
|
Package timeutil adds utility functions to the standard time library. |
|
traceid
Package traceid allows to store and retrieve a trace ID value associated with a context.Context and an HTTP request.
|
Package traceid allows to store and retrieve a trace ID value associated with a context.Context and an HTTP request. |
|
typeutil
Package typeutil contains a collection of type-related utility functions.
|
Package typeutil contains a collection of type-related utility functions. |
|
uid
Package uid provides functions to generate simple time-and-random-based unique identifiers.
|
Package uid provides functions to generate simple time-and-random-based unique identifiers. |
|
uidc
Package uidc provides functions to generate simple time-and-random-based unique identifiers.
|
Package uidc provides functions to generate simple time-and-random-based unique identifiers. |
|
validator
Package validator provides a simple and extensible fields validation mechanism for structs and individual fields based on tags.
|
Package validator provides a simple and extensible fields validation mechanism for structs and individual fields based on tags. |
Click to show internal directories.
Click to hide internal directories.