Cumin Service Locator

A lightweight Service Locator implementation for C# and Unity.

Cumin provides a simple way to register and resolve shared services without introducing a full dependency injection container. It is suitable for managing global services and managers in small to medium-sized applications.

日本語はこちら

Features

• Simple Service Locator pattern
• Locator<T> for managing a single service instance
• CompositeLocator for managing multiple services
• Supports interface-to-implementation registration
• No external dependencies

Locator

A locator for managing a single service instance.

Register

Locator<GameManager>.Register(newGameManager());

Access

varmanager=Locator<GameManager>.Instance;

Check Availability

if(Locator<GameManager>.IsValid){// Available}

Dispose

Locator<GameManager>.Dispose();

CompositeLocator

A locator for managing multiple services.

Register an Existing Instance

CompositeLocator.Register(newAudioManager());

Create and Register Automatically

CompositeLocator.Register<AudioManager>();

Register an Interface and Implementation

CompositeLocator.Register<IAudioManager,AudioManager>();

Resolve

varaudio=CompositeLocator.Resolve<AudioManager>();

or

varaudio=CompositeLocator.Resolve<IAudioManager>();

Unregister

CompositeLocator.Unregister<AudioManager>();

Clear All Registrations

CompositeLocator.Clear();

Example

publicinterfaceIAudioManager{voidPlay(stringname);}publicclassAudioManager:IAudioManager{publicvoidPlay(stringname){Console.WriteLine(name);}}CompositeLocator.Register<IAudioManager,AudioManager>();varaudio=CompositeLocator.Resolve<IAudioManager>();audio?.Play("BGM");

Use Cases

• Game development
• Small applications
• Managing global services
• Sharing manager classes
• Projects that do not require a full DI container

Notes

Cumin is a lightweight Service Locator implementation.

It does not provide advanced dependency injection features such as automatic injection, lifetime management, or scoped services. For larger projects, consider using a dedicated DI container where appropriate.

License

zlib/libpng License