Init(args)

https://docs.sisus.co/init-args/
Admin
Init(args) is a Unity framework for dependency injection that enables automatic initialization of...
Tokens:964,605
Snippets:7,851
Trust Score:5.6
Update:1 month ago
Show doc for...
Tokens:
Raw
### Traditional DI Framework Boilerplate

Source: https://docs.sisus.co/init-args/introduction/comparison

Example of the verbose setup required by other DI frameworks, involving installers, bindings, and manual injection attributes.

```csharp
class ManagerInstaller : MonoInstaller
{
   public override void InstallBindings()
   {
      Container.Bind<MyManager>().AsSingle().NonLazy();
   }
}

class CameraInstaller : MonoInstaller
{
   [SerializeField] Camera camera;

   public override void InstallBindings()
   {
      Container.Bind<Camera>().FromInstance(camera);
 	 }
}

class Client : MonoBehaviour
{
    [Inject] MyManager myManager;
    [Inject] Camera camera;

    void Awake() => Debug.Log($"{this} received {myManager} and {camera}.");
}
```

--------------------------------

### Start()

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_start_a2fbb48f448eb9dda7dd9b9bce6baa885.html

The Start method is invoked after an object and its associated scene or prefab are loaded. Its execution timing varies based on the object's active state and whether it's part of a service.

```APIDOC
## Start()

### Description
Start is called after the object, and any other objects attached to the same loaded scene or prefab, have been loaded. If the object has been attached to an active GameObject at edit time, then Start is called after the scene or prefab that contains the GameObject has been loaded. If the object is attached to an active GameObject at runtime, then Start is called after a short delay, just before the next IUpdate.Update event. If the object is attached to an inactive GameObject, then Start will only be called when the GameObject becomes active. A class that has the Service attribute receives the event after all services have being initialized, and the initial scene has been loaded. While IAwake.Awake and IOnEnable.OnEnable are called (in that order) immediately for all enabled and active objects when a scene or a prefab is being loaded, Start only gets called after a short delay, just before the first IUpdate.Update event.

### Method
void Sisus.Init.IStart.Start()
```

--------------------------------

### Sisus.Init.IStart.Start()

Source: https://docs.sisus.co/init-args-reference/functions_func_s.html

Starts the service or component.

```APIDOC
## Start()

### Description
Initiates the startup process for a service or component.

### Interface
Sisus.Init.IStart
```

--------------------------------

### Start()

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_start-members.html

Toggles the main menu visibility.

```APIDOC
## Start()

### Description
Toggles the main menu visibility.

### Method
(Not specified in source)

### Endpoint
(Not specified in source)

### Parameters
(No parameters specified in source)

### Request Example
(No request example specified in source)

### Response
#### Success Response (200)
(No response details specified in source)

#### Response Example
(No response example specified in source)
```

--------------------------------

### Start Method

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_start.html

The Start method is invoked after the object and any other objects in the same loaded scene or prefab have been loaded. It's part of the IStart interface for callback during the Start event.

```APIDOC
## void Start ()

### Description
Start is called after the object, and any other objects attached to the same loaded scene or prefab, have been loaded.

### Method
void

### Parameters
None

### Response
None
```

--------------------------------

### Sisus.Init.ICoroutineRunner.StartCoroutine()

Source: https://docs.sisus.co/init-args-reference/functions_func_s.html

Starts a coroutine.

```APIDOC
## StartCoroutine()

### Description
Starts the execution of a coroutine.

### Interface
Sisus.Init.ICoroutineRunner
```

--------------------------------

### Sisus.Init.Wrapper< TWrapped >.Start()

Source: https://docs.sisus.co/init-args-reference/functions_func_s.html

Starts the wrapped component.

```APIDOC
## Start()

### Description
Starts the underlying wrapped component or service.

### Class
Sisus.Init.Wrapper< TWrapped >
```

--------------------------------

### Start()

Source: https://docs.sisus.co/init-args-reference/functions_s.html

Initiates the startup process, implementing the IStart interface and potentially acting as a wrapper.

```APIDOC
## Start()

### Description
Initiates the startup process for an object or system. This method implements the `Sisus.Init.IStart` interface and may also function as a wrapper for a `TWrapped` type.

### Signature
`Start() : Sisus.Init.IStart, Sisus.Init.Wrapper< TWrapped >`
```

--------------------------------

### Override OnReset for Initialization Logic

Source: https://docs.sisus.co/init-args/clients/monobehaviour-t

Override the OnReset method to execute code during the Reset lifetime event, supporting the InitOnReset feature. This example initializes the collider by getting it from the component.

```csharp
class Player : MonoBehaviour<IInputManager>
{
   IInputManager inputManager;
   [SerializeField] Collider collider;

   protected override void Init(IInputManager inputManager) => this.inputManager = inputManager;

   protected override void OnReset() => collider = GetComponent<Collider>();
}
```

--------------------------------

### Override OnAwake for Initialization Logic

Source: https://docs.sisus.co/init-args/clients/monobehaviour-t

Override the OnAwake method to execute code during the Awake lifetime event after initialization arguments have been passed to Init. This example logs the injected inputManager in OnAwake, OnEnable, and Start.

```csharp
class Player : MonoBehaviour<IInputManager>
{
   IInputManager inputManager;

   protected override void Init(IInputManager inputManager) => this.inputManager = inputManager;

   protected override void OnAwake() => Debug.Log($"I can use {inputManager} in OnAwake!");
   void OnEnable() => Debug.Log($"I can use {inputManager} in OnEnable!");
   void Start() => Debug.Log($"I can use {inputManager} in Start!");
}
```

--------------------------------

### Registering and Receiving Services with Init(args)

Source: https://docs.sisus.co/init-args/introduction/what-is-init-args

Demonstrates how to register a service using the [Service] attribute and how a client component can receive it in its Init method. Services are guaranteed to be available before the Awake event.

```csharp
[Service(FindFromScene = true)] // <- Register a service
class Player : MonoBehaviour { ... }

class Enemy : MonoBehaviour<Player>
{
   protected override void Init(Player player) { ... } // <- Receive the service
}
```

--------------------------------

### Init<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument>()

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_mono_behaviour-8-g_a5cbc206dd2cd5e111dc6bb6eafa02679.html

Provides the Component with the objects that it depends on. You can think of the Init method as a parameterized constructor alternative for the component. Init get called when the script is being loaded, before the OnAwake, OnEnable and Start events when the component is created using InstantiateExtensions.Instantiate or AddComponentExtensions.AddComponent. In edit mode Init can also get called during the Reset event when the script is added to a GameObject, if the component has the InitOnResetAttribute or RequireComponent attribute for each argument. Note that Init gets called immediately following object creation even if the GameObject to which the component was added is inactive unlike some other initialization event functions such as Awake and OnEnable.

```APIDOC
## ◆ Init()

### Description
Provides the Component with the objects that it depends on. You can think of the Init method as a parameterized constructor alternative for the component. Init get called when the script is being loaded, before the OnAwake, OnEnable and Start events when the component is created using InstantiateExtensions.Instantiate<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument> or AddComponentExtensions.AddComponent<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument>.
In edit mode Init can also get called during the Reset event when the script is added to a GameObject, if the component has the InitOnResetAttribute or RequireComponent attribute for each argument.
Note that Init gets called immediately following object creation even if the GameObject to which the component was added is inactive unlike some other initialization event functions such as Awake and OnEnable.

### Parameters
- **firstArgument** (TFirstArgument) - The first object that this component depends on.
- **secondArgument** (TSecondArgument) - The second object that this component depends on.
- **thirdArgument** (TThirdArgument) - The third object that this component depends on.
- **fourthArgument** (TFourthArgument) - The fourth object that this component depends on.
- **fifthArgument** (TFifthArgument) - The fifth object that this component depends on.
- **sixthArgument** (TSixthArgument) - The sixth object that this component depends on.
- **seventhArgument** (TSeventhArgument) - The seventh object that this component depends on.
- **eighthArgument** (TEighthArgument) - The eighth object that this component depends on.

### Implements
Sisus.Init.IInitializable< TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument >
```

--------------------------------

### Init(args)

Source: https://docs.sisus.co/init-args-reference/functions_prop_o.html

Initializes the Sisus system with provided arguments. This function is used to set up the system's initial state.

```APIDOC
## Init(args)

### Description
Initializes the Sisus system with provided arguments. This function is used to set up the system's initial state.

### Method
Not applicable (Scripting Function)

### Endpoint
Not applicable (Scripting Function)

### Parameters
- **args** (object) - Required - Arguments for initialization.
```

--------------------------------

### Start()

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_wrapper-1-g_aa594cad8c206b42090357f3497b0aa33.html

Start is called on the frame when a script is enabled just before any of the Update methods are called the first time. Like the Awake function, Start is called exactly once in the lifetime of the script. However, Awake is called when the script object is initialised, regardless of whether the script is enabled. Start may not be called on the same frame as Awake if the script is not enabled at initialisation time.

```APIDOC
## ◆ Start()

### Description
Start is called on the frame when a script is enabled just before any of the Update methods are called the first time. Like the Awake function, Start is called exactly once in the lifetime of the script. However, Awake is called when the script object is initialised, regardless of whether the script is enabled. Start may not be called on the same frame as Awake if the script is not enabled at initialisation time.

### Method
protected virtual void Sisus.Init.Wrapper<TWrapped>.Start()
```

--------------------------------

### Properties starting with 'l'

Source: https://docs.sisus.co/init-args-reference/functions_prop_l.html

Lists properties that start with the letter 'l' within the Sisus Init class.

```APIDOC
## Properties

### - l -

*   **LazyInit** : Sisus.Init.ServiceAttribute
    *   Description: Not provided in source.
*   **LoadAsync** : Sisus.Init.ServiceAttribute
    *   Description: Not provided in source.
```

--------------------------------

### Initialize components with Init(args)

Source: https://docs.sisus.co/init-args/introduction/comparison

Demonstrates direct dependency injection into a component using AddComponent without requiring a DI container.

```csharp
[Test]
public void Client_Receives_Service()
{
   var gameObject = new GameObject();
   var service = new Service();

   var client = gameObject.AddComponent<Client, Service>(service); // <- inject dependencies!

   Assert.That(client.Service, Is.EqualTo(service));
}
```

--------------------------------

### Wrapped Class Example

Source: https://docs.sisus.co/init-args/7-wrappers/wrapper

An example of a plain C# class that can be wrapped. It demonstrates properties for Id and Speed.

```csharp
public class Player
{
    public Id Id { get; }
    public float Speed { get; }

    public Player(Id id, float speed)
    {
        Id = id;
        Speed = speed;
    }
}
```

--------------------------------

### System Lifecycle with Dependencies

Source: https://docs.sisus.co/init-args/advanced/ecs-support

Demonstrates the execution order of system lifecycle methods when dependencies are involved and auto-creation is not disabled. OnCreate runs before Init, and OnStartRunning before OnUpdate.

```csharp
[Service]
partial class EnemySystem : SystemBase, IInitializable<PlayerSystem>
{
    PlayerSystem playerSystem;

    protected override void OnCreate() => Debug.Log("1");

    public void Init(PlayerSystem playerSystem) => Debug.Log("2");

    protected override void OnStartRunning() => Debug.Log("3");

    protected override void OnUpdate() => Debug.Log("4");
}
```

--------------------------------

### Init3 with delegate

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t3_extensions.html

Initializes the third component using a delegate.

```APIDOC
## Init3<TFirstComponent, TSecondComponent, TThirdComponent>

### Description
Initializes the third added component of type _TThirdComponent_ using a delegate.

### Method Signature
static Components< TFirstComponent, TSecondComponent, TThirdComponent > Init3< TFirstComponent, TSecondComponent, TThirdComponent >(this GameObjectWithInit2Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > @this, [DisallowNull] Action< TThirdComponent > init)
```

--------------------------------

### ValidateArguments (Example with AssertNotNull)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_mono_behaviour_base_aa0693f29d38d4dc37045b6eb5755f4ed.html

An example of overriding ValidateArguments to check for null inputManager and camera using AssertNotNull.

```APIDOC
## ValidateArguments (Example with AssertNotNull)

### Description
Example implementation of ValidateArguments using AssertNotNull for argument validation.

### Method
protected override void ValidateArguments(IInputManager inputManager, Camera camera)

### Parameters
- **inputManager** (IInputManager) - The input manager to validate.
- **camera** (Camera) - The camera to validate.

### Remarks
You can use the AssertNotNull<TArgument> method to log an assertion to the Console if an argument is null.
Calls to this method are ignored in non-development builds.
```

--------------------------------

### ValidateArguments (Example with ThrowIfNull)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_mono_behaviour_base_aa0693f29d38d4dc37045b6eb5755f4ed.html

An example of overriding ValidateArguments to check for null inputManager and camera using ThrowIfNull.

```APIDOC
## ValidateArguments (Example with ThrowIfNull)

### Description
Example implementation of ValidateArguments using ThrowIfNull for argument validation.

### Method
protected override void ValidateArguments(IInputManager inputManager, Camera camera)

### Parameters
- **inputManager** (IInputManager) - The input manager to validate.
- **camera** (Camera) - The camera to validate.

### Remarks
Calls to this method are ignored in non-development builds.
```

--------------------------------

### TryGet Methods for Initialization

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_init_args_a936ec3a6d712461af33c356e1496d7d1.html

These methods allow for flexible initialization of SISUS clients with varying numbers of arguments. They are designed to attempt retrieval of a client instance based on the provided generic types.

```APIDOC
## TryGet<TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument>

### Description
Attempts to retrieve a client instance with up to ten generic arguments.

### Method
Generic Method

### Endpoint
N/A (SDK Method)

### Parameters
- **TClient**: Type of the client to retrieve.
- **TFirstArgument** to **TTenthArgument**: Types of the arguments for initialization.
```

```APIDOC
## TryGet<TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument, TEleventhArgument>

### Description
Attempts to retrieve a client instance with up to eleven generic arguments.

### Method
Generic Method

### Endpoint
N/A (SDK Method)

### Parameters
- **TClient**: Type of the client to retrieve.
- **TFirstArgument** to **TEleventhArgument**: Types of the arguments for initialization.
```

```APIDOC
## TryGet<TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument, TEleventhArgument, TTwelfthArgument>

### Description
Attempts to retrieve a client instance with up to twelve generic arguments.

### Method
Generic Method

### Endpoint
N/A (SDK Method)

### Parameters
- **TClient**: Type of the client to retrieve.
- **TFirstArgument** to **TTwelfthArgument**: Types of the arguments for initialization.
```

--------------------------------

### GetValueOrDefault

Source: https://docs.sisus.co/init-args-reference/struct_sisus_1_1_init_1_1_any_generic-1-g_a222c325eefa385717d739fe17c76c7e1.html

Gets the value of the current AnyGeneric<T> object if it has one. If the underlying value is `null` and T is a global service or a scene service which is accessible to the _client_ then gets the service.

```APIDOC
## ◆ GetValueOrDefault()
| T Sisus.Init.AnyGeneric< T >.GetValueOrDefault  | (   [DisallowNull] object _client_ ,   Context _context_ = Context.MainThread )

### Description
Gets the value of the current AnyGeneric<T> object if it has one. If the underlying value is `null` and T is a global service or a scene service which is accessible to the _client_ then gets the service.

### Template Parameters
     TClient| Type of the client requesting the value.

### Parameters
     client| The client requesting the value.
     context| The context from which the request is being made.

### Returns
    The value associated with the current AnyGeneric<T> object, if it has a value; otherwise, the default value of T.
```

--------------------------------

### Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument, TFifthArgument fifthArgument)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t1_extensions.html

Initializes the added component with five arguments.

```APIDOC
## Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument, TFifthArgument fifthArgument)

### Description
Initializes the added component with five arguments.

### Method
`static TComponent Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument>(this GameObject<TComponent> @this, TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument, TFifthArgument fifthArgument)`
```

--------------------------------

### GetValueOrDefault<TClient>()

Source: https://docs.sisus.co/init-args-reference/struct_sisus_1_1_init_1_1_any-1-g_a831d89effce9b6a5259ebc19b7ee10b1.html

Gets the value of the current Any<T> object if it has one. If the underlying value is `null` and T is a global service or a scene service which is accessible to the _client_ then gets the service.

```APIDOC
## ◆ GetValueOrDefault()
| T Sisus.Init.Any< T >.GetValueOrDefault  | (   
---|---
|  | Context | _context_ = Context.MainThread )

### Template Parameters
* **TClient** - Type of the client requesting the value.

### Parameters
* **client** - The client requesting the value.
* **context** - The context from which the request is being made.

### Returns
The value associated with the current Any<T> object, if it has a value; otherwise, the default value of T.
```

--------------------------------

### Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument, TFifthArgument fifthArgument, TSixthArgument sixthArgument)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t1_extensions.html

Initializes the added component with six arguments.

```APIDOC
## Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument, TFifthArgument fifthArgument, TSixthArgument sixthArgument)

### Description
Initializes the added component with six arguments.

### Method
`static TComponent Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument>(this GameObject<TComponent> @this, TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument, TFifthArgument fifthArgument, TSixthArgument sixthArgument)`
```

--------------------------------

### Scriptable Object Value Provider Example

Source: https://docs.sisus.co/init-args/initializers/value-providers

Implement a Scriptable Object that provides a random string value. This example includes custom implementations for TryGetFor and HasValueFor for optimal Inspector experience.

```csharp
using Sisus.Init;
using UnityEngine;

[CreateAssetMenu]
class RandomNameProvider : ScriptableObject, IValueProvider<string>
{
    [SerializeField] string[] names = { };

    public string Value => names.Length is 0 ? null : names[Random.Range(0, names.Length)];

    public bool TryGetFor(Component client, out string value)
    {
        if(names.Length is 0)
        {
            value = null;
            return false;
        }

        value = names[Random.Range(0, names.Length)];
        return true;
    }

    public bool HasValueFor(Component client) => names.Length > 0;
}
```

--------------------------------

### Sisus.Init.InitArgs.TryGet<TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument>

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_init_args_ac06e596bf7dbff21b79d3a415df98eff.html

Acquires the ten services that the client depends on and passes them to its IInitializable<...>.Init method. Returns true if successful, false otherwise.

```APIDOC
## static bool TryGet< TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument >()

### Description
Acquire the ten services that the depends on and pass them to its IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument>.Init method.

### Parameters
- **_client_** (TClient) - Required - The object to initialize. It must implement IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument>.
- **_context_** (Context) - Optional - The context from which a method is being called. Defaults to Context.MainThread. Many objects that implement IInitializable are only able to acquire their own dependencies when Context.EditMode or Context.Reset is used in Edit Mode. For performance and reliability reasons it is recommended to do these operations in Edit Mode only, and cache the results.

### Returns
`true` if was able to locate all dependencies and initialize the client with them; otherwise, `false`.

### Type Constraints
- **TClient** : IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument, TTenthArgument>
```

--------------------------------

### Init3 with four arguments

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t3_extensions.html

Initializes the second component using four arguments.

```APIDOC
## Init3<TFirstComponent, TSecondComponent, TThirdComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument>

### Description
Initializes the third added component of type _TSecondComponent_ using four arguments.

### Method Signature
static Components< TFirstComponent, TSecondComponent, TThirdComponent > Init3< TFirstComponent, TSecondComponent, TThirdComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument >(this GameObjectWithInit2Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > @this, TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_value_provider-1-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value provided by this provider.

### Method
(Implicitly a property access on an IValueProvider instance)

### Parameters
None

### Request Example
(Conceptual - actual usage depends on the context where IValueProvider is implemented)
```csharp
TValue currentValue = valueProvider.Value;
```

### Response
#### Success Response
- **TValue**: The value provided by this provider.

#### Response Example
(Conceptual - returns the value)
```json
"some value"
```
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_wrapper_initializer_base-5-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Method
Value { get; }

### Response
#### Success Response (object)
- The value.
```

--------------------------------

### Init2 with four arguments (variant 3)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t3_extensions.html

Initializes the second added component using the four provided arguments.

```APIDOC
## Init2<TFirstComponent, TSecondComponent, TThirdComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument>

### Description
Initializes the second added component of type _TSecondComponent_ using the four provided arguments.

### Method
static

### Endpoint
GameObjectWithInit2Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > | Init2< TFirstComponent, TSecondComponent, TThirdComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument > (this GameObjectWithInit1Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > @this, TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)
```

--------------------------------

### Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t1_extensions.html

Initializes the added component with four arguments.

```APIDOC
## Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)

### Description
Initializes the added component with four arguments.

### Method
`static TComponent Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument>(this GameObject<TComponent> @this, TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)`
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_wrapper_initializer_base-8-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Interface
Sisus.Init.IValueProvider<TValue>

### Signature
Value
```

--------------------------------

### Init Method

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_initializable-4-g-members.html

Initializes the object with the provided arguments.

```APIDOC
## Init Method

### Description
Initializes the object with the provided arguments.

### Signature
Init(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_initializer_base-7-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Interface
`Sisus.Init.IValueProvider<TValue>`
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_initializer-7-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Method
[Property signature, e.g., TValue Value { get; }]
```

--------------------------------

### Init Method

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_initializable-9-g-members.html

Initializes the object with the provided arguments.

```APIDOC
## Init

### Description
Initializes the object with the provided arguments.

### Method Signature
Init(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument, TFifthArgument fifthArgument, TSixthArgument sixthArgument, TSeventhArgument seventhArgument, TEighthArgument eighthArgument, TNinthArgument ninthArgument)
```

--------------------------------

### Sisus.Init.Any<T> Instance Methods

Source: https://docs.sisus.co/init-args-reference/struct_sisus_1_1_init_1_1_any-1-g-members.html

Instance methods for the Any<T> class.

```APIDOC
## Equals(object obj)

### Description
Determines whether the specified object is equal to the current object.

### Method
Instance Method

### Parameters
- **obj** (object) - The object to compare with the current object.
```

```APIDOC
## Equals(T other)

### Description
Indicates whether the current object is equal to another object of the same type.

### Method
Instance Method

### Parameters
- **other** (T) - An object to compare with this object.
```

```APIDOC
## Equals(Any<T> other)

### Description
Indicates whether the current object is equal to another Any<T> object.

### Method
Instance Method

### Parameters
- **other** (Any<T>) - An Any<T> object to compare with this object.
```

```APIDOC
## Equals(Object other, Context context=Context.MainThread)

### Description
Determines whether the specified object is equal to the current object, with an optional context.

### Method
Instance Method

### Parameters
- **other** (Object) - The object to compare with the current object.
- **context** (Context) - The context for the comparison (defaults to Context.MainThread).
```

```APIDOC
## GetHashCode()

### Description
Serves as the default hash function.

### Method
Instance Method
```

```APIDOC
## GetHasValue([AllowNull] Component client, Context context=Context.MainThread)

### Description
Gets whether the Any<T> instance has a value, with an optional client and context.

### Method
Instance Method

### Parameters
- **client** (Component) - The client component (optional).
- **context** (Context) - The context for the operation (defaults to Context.MainThread).
```

```APIDOC
## GetValue([DisallowNull] ScriptableObject client, Context context=Context.MainThread)

### Description
Gets the value of the Any<T> instance, requiring a ScriptableObject client and an optional context.

### Method
Instance Method

### Parameters
- **client** (ScriptableObject) - The client ScriptableObject.
- **context** (Context) - The context for the operation (defaults to Context.MainThread).
```

```APIDOC
## GetValue([AllowNull] Component client, Context context=Context.MainThread)

### Description
Gets the value of the Any<T> instance, with an optional client and context.

### Method
Instance Method

### Parameters
- **client** (Component) - The client component (optional).
- **context** (Context) - The context for the operation (defaults to Context.MainThread).
```

```APIDOC
## GetValueAsync(Component client=null, Context context=Context.MainThread)

### Description
Asynchronously gets the value of the Any<T> instance, with an optional client and context.

### Method
Instance Method

### Parameters
- **client** (Component) - The client component (optional).
- **context** (Context) - The context for the operation (defaults to Context.MainThread).
```

```APIDOC
## GetValueOrDefault([DisallowNull] object client, Context context=Context.MainThread)

### Description
Gets the default value of the Any<T> instance if it has no value, with an optional client and context.

### Method
Instance Method

### Parameters
- **client** (object) - The client object.
- **context** (Context) - The context for the operation (defaults to Context.MainThread).
```

```APIDOC
## ToString()

### Description
Returns a string that represents the current object.

### Method
Instance Method
```

```APIDOC
## TryGetValue(out T value)

### Description
Attempts to get the value of the Any<T> instance.

### Method
Instance Method

### Parameters
- **value** (out T) - When this method returns, contains the value of the Any<T> instance if the conversion succeeded, or a default value otherwise.
```

```APIDOC
## TryGetValue([AllowNull] Component client, Context context, out T result)

### Description
Attempts to get the value of the Any<T> instance with an optional client and context.

### Method
Instance Method

### Parameters
- **client** (Component) - The client component (optional).
- **context** (Context) - The context for the operation.
- **result** (out T) - When this method returns, contains the value of the Any<T> instance if the conversion succeeded, or a default value otherwise.
```

```APIDOC
## TryGetValue(Component client, out T value)

### Description
Attempts to get the value of the Any<T> instance with a client.

### Method
Instance Method

### Parameters
- **client** (Component) - The client component.
- **value** (out T) - When this method returns, contains the value of the Any<T> instance if the conversion succeeded, or a default value otherwise.
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_initializer-6-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Remarks
This is a property of the Sisus.Init.IValueProvider<TValue> interface.
```

--------------------------------

### Init<TComponent>(Action<TComponent> init)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t1_extensions.html

Initializes the added component using a delegate.

```APIDOC
## Init<TComponent>(Action<TComponent> init)

### Description
Initializes the added component using a delegate.

### Method
`static TComponent Init<TComponent>(this GameObject<TComponent> @this, [DisallowNull] Action<TComponent> init)`
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_initializer-8-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Returns
- (TValue) - The value.
```

--------------------------------

### Init2 with three arguments (variant 1)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t3_extensions.html

Initializes the second added component using three arguments, with specific component assignments.

```APIDOC
## Init2<TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument>

### Description
Initializes the second added component of type _TSecondComponent_ using three arguments. The third added component is treated as the first argument, and the first added component is treated as the second argument.

### Method
static

### Endpoint
GameObjectWithInit2Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > | Init2< TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument > (this GameObjectWithInit1Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > @this, Third firstArgument, TSecondArgument secondArgument, First thirdArgument)
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_initializer-11-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Method
N/A (Property signature provided)

### Response
#### Success Response (200)
- **TValue** (TValue) - Description not available
```

--------------------------------

### Value

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_custom_initializer-5-g-members.html

Gets the value.

```APIDOC
## Value

### Description
Gets the value.

### Type
Sisus.Init.IValueProvider< TValue >
```

--------------------------------

### Init2 with four arguments (variant 1)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t3_extensions.html

Initializes the second added component using three arguments, with specific component assignments.

```APIDOC
## Init2<TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument, TThirdArgument, TFourthArgument>

### Description
Initializes the second added component of type _TSecondComponent_ using three arguments. The third added component is treated as the first argument.

### Method
static

### Endpoint
GameObjectWithInit2Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > | Init2< TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument, TThirdArgument, TFourthArgument > (this GameObjectWithInit1Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > @this, Third firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)
```

--------------------------------

### Get<TService>()

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_service_a6f9da4b5b9980b631c0f9dbfe5db31e3.html

Gets a service of type TService for any client. The service can be retrieved from Services components in the active scenes, or failing that, from the globally shared Service<TService>.Instance. This method can only be called from the main thread.

```APIDOC
## ◆ Get<TService>()

### Description
Gets service of type _TService_ for any client. The service can be retrieved from Services components in the active scenes, or failing that, from the globally shared Service<TService>.Instance. This method can only be called from the main thread.

### Method
static TService Sisus.Init.Service.Get<TService>()

### Template Parameters
* **TService**: The defining type of the service.

### Returns
Service of type _TService_.

### Exceptions
* **NullReferenceException**: Thrown if no service of type _TService_ is found that is globally accessible to any client.
```

--------------------------------

### Initialize components with traditional DI frameworks

Source: https://docs.sisus.co/init-args/introduction/comparison

Shows the standard approach for dependency injection using a container and attribute-based injection, which typically relies on reflection.

```csharp
// The same unit test with a more typical DI framework:
[Test]
public void Client_Receives_Service()
{
  	 var gameObject = new GameObject();
  	 var service = new Service();
  	 using var container = new ContainerBuilder()
        .RegisterValue(service)
        .Build(); // <- build a container

  	 var client = gameObject.AddComponent<Client>();
    AttributeInjector.Inject(client, container); // <- inject dependencies

  	 Assert.That(client.Service, Is.EqualTo(service));
}
```

--------------------------------

### StartCoroutine

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_wrapper.html

Starts the provided coroutine.

```APIDOC
## StartCoroutine

### Description
Starts the provided _coroutine_ .

### Method
Coroutine

### Parameters
#### Query Parameters
- **coroutine** (IEnumerator) - Required - The coroutine to start.
```

--------------------------------

### Init(args)

Source: https://docs.sisus.co/init-args-reference/functions_n.html

Initializes a component with the provided arguments. This function is used for setting up initial states or configurations.

```APIDOC
## Init(args)

### Description
Initializes a component with the provided arguments. This function is used for setting up initial states or configurations.

### Method
Not applicable (Scripting Function)

### Endpoint
Not applicable (Scripting Function)

### Parameters
- **args** (System.Object[]) - Required - An array of objects to initialize the component with.
```

--------------------------------

### Sisus.Init.IInitializer and Sisus.Init.IServiceInitializerAsync

Source: https://docs.sisus.co/init-args-reference/functions_func_i.html

Asynchronous initialization methods for services and general initializers.

```APIDOC
## InitTargetAsync()

### Description
Performs asynchronous initialization.

### Return Type
- Sisus.Init.IInitializer< TClient >
- Sisus.Init.IInitializer
- Sisus.Init.IServiceInitializerAsync< TService >
- Sisus.Init.IServiceInitializerAsync< TService, in TArgument >
- Sisus.Init.IServiceInitializerAsync< TService, in TFirstArgument, in TSecondArgument >
- Sisus.Init.IServiceInitializerAsync< TService, in TFirstArgument, in TSecondArgument, in TThirdArgument >
- Sisus.Init.IServiceInitializerAsync< TService, in TFirstArgument, in TSecondArgument, in TThirdArgument, in TFourthArgument >
- Sisus.Init.IServiceInitializerAsync< TService, in TFirstArgument, in TSecondArgument, in TThirdArgument, in TFourthArgument, in TFifthArgument >
- Sisus.Init.IServiceInitializerAsync< TService, in TFirstArgument, in TSecondArgument, in TThirdArgument, in TFourthArgument, in TFifthArgument, in TSixthArgument >
```

--------------------------------

### Target

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_initializer-6-g-members.html

Gets or sets the target.

```APIDOC
## Target

### Description
Gets or sets the target.

### Type
Property

### Parameters
None.

### Response
None explicitly documented.
```

--------------------------------

### Sisus.Init.InitArgs.TryGet<TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument>()

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_init_args_a73fb1a20feb7635c1211e08ea78c35e9.html

Attempts to acquire the nine services that a client depends on and pass them to its IInitializable<...>.Init method. This method is recommended to be used in Edit Mode only for performance and reliability.

```APIDOC
## static bool TryGet< TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument >(this TClient _client_, Context _context_ = Context::MainThread)

### Description
Acquire the nine services that the depends on and pass them to its IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument>.Init method.

### Parameters
- **_client_** (TClient) - The object to initialize. It must implement IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument>.
- **_context_** (Context) - The context from which a method is being called. Many objects that implement IInitializable are only able to acquire their own dependencies when Context.EditMode or Context.Reset is used in Edit Mode. For performance and reliability reasons it is recommended to do these operations in Edit Mode only, and cache the results.

### Returns
`true` if was able to locate all dependencies and initialize the client with them; otherwise, `false`.

### Type Constraints
- **TClient** : IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument, TEighthArgument, TNinthArgument>
```

--------------------------------

### Target

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_initializer-3-g-members.html

Gets the target of the initializer.

```APIDOC
## Target

### Description
Gets the target object that this initializer operates on.

### Method
Property access (read-only implied).

### Endpoint
N/A

### Parameters
None.

### Request Example
N/A

### Response
The target object.
```

--------------------------------

### Init2 with three arguments (variant 2)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t3_extensions.html

Initializes the second added component using three arguments, with specific component assignments.

```APIDOC
## Init2<TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument, TThirdArgument>

### Description
Initializes the second added component of type _TSecondComponent_ using three arguments. The third added component is treated as the first argument, and the first added component is treated as the third argument.

### Method
static

### Endpoint
GameObjectWithInit2Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > | Init2< TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument, TThirdArgument > (this GameObjectWithInit1Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > @this, Third firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument)
```

--------------------------------

### Target

Source: https://docs.sisus.co/init-args-reference/interface_sisus_1_1_init_1_1_i_initializer-5-g-members.html

Gets the target of the initializer.

```APIDOC
## Target

### Description
Gets the target of the initializer.

### Type
(Type not explicitly documented, likely related to TClient)

### Access
(Access level not explicitly documented)
```

--------------------------------

### Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t1_extensions.html

Initializes the added component with three arguments.

```APIDOC
## Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument>(TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument)

### Description
Initializes the added component with three arguments.

### Method
`static TComponent Init<TComponent, TFirstArgument, TSecondArgument, TThirdArgument>(this GameObject<TComponent> @this, TFirstArgument firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument)`
```

--------------------------------

### GetValue()

Source: https://docs.sisus.co/init-args-reference/functions_g.html

Gets the value of an object.

```APIDOC
## GetValue()

### Description
Gets the value of an object.

### Signature
- `GetValue() : Sisus.Init.Any<T >, Sisus.Init.AnyGeneric<T >`
```

--------------------------------

### Init2 with four arguments (variant 2)

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_game_object_t3_extensions.html

Initializes the second added component using three arguments, with specific component assignments.

```APIDOC
## Init2<TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument, TThirdArgument, TFourthArgument>

### Description
Initializes the second added component of type _TSecondComponent_ using three arguments. The first added component is treated as the first argument.

### Method
static

### Endpoint
GameObjectWithInit2Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > | Init2< TFirstComponent, TSecondComponent, TThirdComponent, TSecondArgument, TThirdArgument, TFourthArgument > (this GameObjectWithInit1Of3Done< TFirstComponent, TSecondComponent, TThirdComponent > @this, First firstArgument, TSecondArgument secondArgument, TThirdArgument thirdArgument, TFourthArgument fourthArgument)
```

--------------------------------

### GetValue()

Source: https://docs.sisus.co/init-args-reference/functions_func_g.html

Gets the value of an object.

```APIDOC
## GetValue()

### Description
Gets the value of an object.

### Signature
- `Sisus.Init.Any<T>.GetValue()`
- `Sisus.Init.AnyGeneric<T>.GetValue()`
```

--------------------------------

### TryGet<TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument>

Source: https://docs.sisus.co/init-args-reference/class_sisus_1_1_init_1_1_init_args_a954fba63048dc75a5fa61f0a5dd00437.html

Attempts to acquire seven services and initialize the provided client object with them. This method is recommended to be used in Edit Mode for performance and reliability.

```APIDOC
## TryGet< TClient, TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument >()

### Description
Acquires the seven services that the client depends on and passes them to its `IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument>.Init` method.

### Parameters
#### Path Parameters
- **client** (TClient) - Required - The object to initialize. It must implement `IInitializable<TFirstArgument, TSecondArgument, TThirdArgument, TFourthArgument, TFifthArgument, TSixthArgument, TSeventhArgument>`.
- **context** (Context) - Optional - The context from which a method is being called. Defaults to `Context::MainThread`.

### Returns
- `true` if was able to locate all dependencies and initialize the client with them; otherwise, `false`.

### Type Constraints
- `TClient` must implement `IInitializable`.
- `TClient` must implement `TFirstArgument`.
- `TClient` must implement `TSecondArgument`.
- `TClient` must implement `TThirdArgument`.
- `TClient` must implement `TFourthArgument`.
- `TClient` must implement `TFifthArgument`.
- `TClient` must implement `TSixthArgument`.
- `TClient` must implement `TSeventhArgument`.
```

--------------------------------

### Get()

Source: https://docs.sisus.co/init-args-reference/functions_g.html

Retrieves a service or utility.

```APIDOC
## Get()

### Description
Retrieves a service or utility.

### Signature
- `Get() : Sisus.Init.ServiceUtility`
```
Tokens:
Raw