aspid-profiler-marker

aspid-profiler-marker

Instrument code with a ProfilerMarker using this.Marker(). The Aspid.FastTools source generator replaces every this.Marker() call site with a unique ProfilerMarker.Auto scope keyed by (EnclosingType, Method, Line).

When this skill applies

Trigger when the user asks for any of:

• "add a profiler marker to X"
• "profile this method" / "instrument this hot path"
• references to this.Marker() or .WithName(...)
• "show this in the Unity Profiler"

Do not trigger for Profiler.BeginSample / EndSample — that's the lower-level Unity API and not what this package provides.

How this.Marker() works

The extension method lives in the global namespace (intentional — no using required at the call site):

public static ProfilerMarker.AutoScope Marker(this object _);
public static ProfilerMarker.AutoScope WithName(this in ProfilerMarker.AutoScope marker, string name);

At runtime the global-namespace methods above are never actually called. For every enclosing type that contains this.Marker() call sites, the source generator emits a companion internal static class __TypeNameProfilerMarkerExtensions with:

• a nested Markers class holding a static readonly ProfilerMarker per call site, named "TypeName.MethodName (Line)" (for properties — TypeName.PropertyName, for constructors — TypeName.Ctor);
• a more specific Marker(this TypeName _, [CallerLineNumber] int line = -1) overload that dispatches on the line number:

internal static class __FooBarProfilerMarkerExtensions
{
    private static class Markers
    {
        public static readonly ProfilerMarker UpdateGrid_42 = new("FooBar.UpdateGrid (42)");
    }

    public static ProfilerMarker.AutoScope Marker(this FooBar _, [CallerLineNumber] int line = -1)
    {
#if ENABLE_PROFILER
        if (line is 42) return Markers.UpdateGrid_42.Auto();
#endif
        return default;
    }
}

Because the overload is more specific than the global one, the compiler picks it whenever this is of the right enclosing type. The marker is unique per (EnclosingType, Method, Line). Identity is line-based.