servicekit

README

Overview

This package provides a simple way to manage services in a Go application. It allows you to register and retrieve services using Go interfaces.

It simplifies the process of writing unit tests by providing a simple and easy-to-use interface for managing dependencies between different components of your application. It allows you to register services and callbacks, and retrieve them whenever needed, making it easy to test your code in isolation. This results in more maintainable and reliable tests, as well as a faster development process.

Installation

To install this package, use the go get command:

go get github.com/lab210-dev/service

📚 Usage

To use this package, you must first register your service using the Register function :

package example

import "github.com/lab210-dev/servicekit"

type MyService interface {
	DoSomething()
}

type myServiceImpl struct{}

func (s *myServiceImpl) DoSomething() {
	// Do something here...
}

func init() {
	servicekit.Register[MyService](new(myServiceImpl))
}

You can now retrieve your service using the Get function :

package example

import "github.com/lab210-dev/servicekit"

type MyService interface {
	DoSomething()
}

func main() {
	servicekit.Get[MyService]().DoSomething()
}

You can also use the GetAfterRegister function to execute a callback once the service has been registered :

package example

import "github.com/lab210-dev/servicekit"

type MyService interface {
	DoSomething()
}

func main() {
    servicekit.GetAfterRegister[MyService](func(s MyService) {
        s.DoSomething()
    })
}

To reset all registered services, use the Reset function :

package example

import "github.com/lab210-dev/servicekit"

func main() {
	servicekit.Reset()
}

Notes

• Services must be registered using interfaces, not concrete types.
• If you try to retrieve a service that has not been registered, an error will panic.

⚡️ Benchmark

goos: darwin
goarch: arm64
pkg: github.com/lab210-dev/servicekit
BenchmarkServiceGet
BenchmarkServiceGet-10                 	 7306159	       162.2 ns/op
BenchmarkServiceGetAfterRegister
BenchmarkServiceGetAfterRegister-10    	 5068532	       232.1 ns/op

🤝 Contributions

Contributors to the package are encouraged to help improve the code.

If you have any questions or comments, don't hesitate to contact me.

I hope this package is helpful to you !

Documentation

Index

• func Get[T any]() (module T)
• func GetAfterRegister[T any](fn func(module T))
• func Register[T any](module T)
• func Reset()
• type Service
  • func (s *Service) GetCallbacksByIdentifier(identifier string) []any
  • func (s *Service) GetServiceByIdentifier(identifier string) any
  • func (s *Service) SetCallbacksByIdentifier(identifier string, fn any)
  • func (s *Service) SetServiceByIdentifier(identifier string, module any)

Functions

func Get

func Get[T any]() (module T)

Get returns the registered service associated with the given interface.

func GetAfterRegister

func GetAfterRegister[T any](fn func(module T))

GetAfterRegister is a special case for the init function, the callback is triggered after the service is registered. If the service has already been registered for the given interface, the callback is executed with the registered service as a parameter. If the service has not yet been registered, the callback is added to the list of registered callbacks for this interface.

func Register

func Register[T any](module T)

Register a service associated with the given interface. If a service is already registered for this interface, the function does nothing. If callbacks have been registered for this interface, they are executed with the registered service as a parameter.

func Reset

func Reset()

Reset resets all registered services by creating new empty maps for the services and callbacks.

Types

type Service

type Service struct {
	sync.Mutex
	// contains filtered or unexported fields
}

func (*Service) GetCallbacksByIdentifier

func (s *Service) GetCallbacksByIdentifier(identifier string) []any

GetCallbacksByIdentifier : This function returns the list of registered callbacks associated with the given identifier. If no callback is associated with this identifier, the function returns an empty list

func (*Service) GetServiceByIdentifier

func (s *Service) GetServiceByIdentifier(identifier string) any

GetServiceByIdentifier : This function returns the registered service associated with the given identifier. If no service is associated with this identifier, the function returns nil.

func (*Service) SetCallbacksByIdentifier

func (s *Service) SetCallbacksByIdentifier(identifier string, fn any)

SetCallbacksByIdentifier : This function adds a callback to the list of registered callbacks associated with the given identifier.

func (*Service) SetServiceByIdentifier

func (s *Service) SetServiceByIdentifier(identifier string, module any)

SetServiceByIdentifier : This function registers a service associated with the given identifier.