DCFApixels/DragonECS-AutoInjections

Automatic dependency injections for DragonECS

Auto Injections for DragonECS

Languages:	Русский	English(WIP)

The extension is designed to reduce the amount of code by simplifying dependency injection by doing injections automatically.

NOTICE: The project is a work in progress, API may change.
While the English version of the README is incomplete, you can view the Russian version.

Installation

Versioning semantics - Open

Environment

Requirements:

• Dependency: DragonECS
• Minimum version of C# 7.3;

Optional:

• Game engines with C#: Unity, Godot, MonoGame, etc.

Tested with:

• Unity: Minimum version 2020.1.0;

Unity Installation

• Unity Package

The framework can be installed as a Unity package by adding the Git URL in the PackageManager or manually adding it to Packages/manifest.json:

https://github.com/DCFApixels/DragonECS-AutoInjections.git

• Source Code

The framework can also be added to the project as source code.

Code Example

class VelocitySystemDI : IEcsRun
{
    class Aspect : EcsAspectAuto
    {
        [ExcImplicit(typeof(FreezedTag))]
        [Inc] public EcsPool<Pose> poses;
        [Inc] public EcsPool<Velocity> velocities;
    }

    [EcsInject] EcsDefaultWorld _world;
    [EcsInject] TimeService _time;

    public void Run()
    {
        foreach (var e in _world.Where(out Aspect a))
        {
            a.poses.Get(e).position += a.velocities.Read(e).value * _time.DeltaTime;
        }
    }
}

Same code but without AutoInjections

class VelocitySystem : IEcsRun, IEcsInject<EcsDefaultWorld>, IEcsInject<TimeService>
{
    class Aspect : EcsAspect
    {
        public EcsPool<Pose> poses;
        public EcsPool<Velocity> velocities;
        public Aspect(Builder b)
        {
            b.Exclude<FreezedTag>();
            poses = b.Include<Pose>();
            velocities = b.Include<Velocity>();
        }
    }

    EcsDefaultWorld _world;
    TimeService _time;

    public void Inject(EcsDefaultWorld obj) => _world = obj;
    public void Inject(TimeService obj) => _time = obj;

    public void Run()
    {
        foreach (var e in _world.Where(out Aspect a))
        {
            a.poses.Get(e).position += a.velocities.Read(e).value * _time.DeltaTime;
        }
    }
}