pi-usereq 0.49.0 → 0.50.0

package/tests/fixtures/fixture_csharp.cs

@@ -1,411 +0,0 @@
-/// @file fixture_csharp.cs
-/// @brief Comprehensive C# test fixture for parser validation.
-/// @details Covers records, pattern matching, LINQ, extension methods,
-///          async streams, nullable reference types, init-only setters,
-///          generic constraints, events, delegates, and indexers.
-// Single line comment
-/* Multi-line
-   comment */
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
-using System.Threading;
-
-namespace MyApp {
-
-/* ── Delegates and events ─────────────────────────────────────────────── */
-
-/// @brief Delegate for handling data change notifications.
-/// @details Emits sender and payload when tracked data changes.
-/// @param sender The object raising the event.
-/// @param data The changed data payload.
-/// @return Void delegate invocation.
-public delegate void DataChangedHandler(object sender, string data);
-
-/// @brief Delegate for value transformation operations.
-/// @details Applies a deterministic conversion from input to output.
-/// @param value The value to transform.
-/// @return Transformed value.
-/// @details Generic type parameter T defines input and output type.
-/// @param value Input value bound to type T.
-public delegate T Transform<T>(T value);
-
-/* ── Attributes ───────────────────────────────────────────────────────── */
-
-/// <summary>
-/// Custom attribute marking classes that require auditing.
-/// </summary>
-[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
-public class AuditableAttribute : Attribute {
-    /// <summary>The audit level (1=low, 3=high).</summary>
-    public int Level { get; set; } = 1;
-}
-
-/* ── Main class ───────────────────────────────────────────────────────── */
-
-/// <summary>
-/// Primary class demonstrating various C# constructs including
-/// properties, events, indexers, and async patterns.
-/// </summary>
-[Serializable]
-[Auditable(Level = 2)]
-public class Person : IComparable<Person>, IDisposable {
-    /// <summary>Maximum age constraint for validation.</summary>
-    public const int MAX_AGE = 150;
-
-    /// <summary>Instance counter tracking total allocations.</summary>
-    private static int _instanceCount = 0;
-
-    /// <summary>Internal name storage with backing field.</summary>
-    private string _name;
-
-    /// <summary>
-    /// Full name with validation on set.
-    /// </summary>
-    /// <value>Non-null, non-empty person name.</value>
-    /// <exception cref="ArgumentException">Thrown when value is empty.</exception>
-    public string Name {
-        get => _name;
-        set {
-            // Validate non-empty name
-            if (string.IsNullOrWhiteSpace(value))
-                throw new ArgumentException("Name cannot be empty");
-            _name = value;
-        }
-    }
-
-    /// <summary>Person's age with init-only setter.</summary>
-    public int Age { get; init; }
-
-    /// <summary>Optional email address (nullable reference type).</summary>
-    public string? Email { get; set; }
-
-    /// <summary>Read-only unique identifier generated at construction.</summary>
-    public Guid Id { get; } = Guid.NewGuid();
-
-    /// <summary>
-    /// Event raised when person data changes.
-    /// </summary>
-    public event DataChangedHandler? OnDataChanged;
-
-    /// @brief Construct a new Person with name and age.
-    /// @details Initializes backing fields and updates instance counters.
-    /// @param name Display name (required).
-    /// @param age Age in years (must be 0..MAX_AGE).
-    /// @return Constructed Person instance.
-    public Person(string name, int age) {
-        _name = name;
-        Age = age;
-        Interlocked.Increment(ref _instanceCount);
-    }
-
-    /// <summary>
-    /// Greet this person on the console.
-    /// </summary>
-    public void Greet() {
-        // Fire data changed event
-        OnDataChanged?.Invoke(this, $"Greeted {Name}");
-        Console.WriteLine($"Hello, {Name}!");
-    }
-
-    /// @brief Fetch person data asynchronously with cancellation support.
-    /// @details Waits asynchronously and returns a deterministic payload.
-    /// @param token Cancellation token for cooperative cancellation.
-    /// @return Formatted data string.
-    /// @details Supports cancellation through token propagation.
-    public static async Task<string> FetchAsync(CancellationToken token = default) {
-        await Task.Delay(100, token);
-        return "data";
-    }
-
-    /// @brief Compare persons by age for sorting.
-    /// @details Implements IComparable ordering semantics.
-    /// @param other Person to compare with.
-    /// @return Comparison result: negative, zero, or positive.
-    /// @details Null values are ordered after non-null instances.
-    public int CompareTo(Person? other) {
-        if (other is null) return 1;
-        return Age.CompareTo(other.Age);
-    }
-
-    /// <summary>
-    /// Dispose of managed resources.
-    /// </summary>
-    public void Dispose() {
-        // Cleanup managed resources
-        Interlocked.Decrement(ref _instanceCount);
-        GC.SuppressFinalize(this);
-    }
-
-    /// <summary>
-    /// Indexer for accessing person properties by name.
-    /// </summary>
-    /// <param name="propertyName">Name of the property to access.</param>
-    /// <returns>Property value as object, or null.</returns>
-    public object? this[string propertyName] {
-        get {
-            return propertyName switch {
-                "Name" => Name,
-                "Age" => Age,
-                "Email" => Email,
-                _ => null,
-            };
-        }
-    }
-
-    /// <summary>
-    /// Deconstruct for pattern matching support.
-    /// </summary>
-    /// <param name="name">Output: person name.</param>
-    /// <param name="age">Output: person age.</param>
-    public void Deconstruct(out string name, out int age) {
-        name = Name;
-        age = Age;
-    }
-
-    /// <summary>
-    /// Get total number of Person instances created.
-    /// </summary>
-    /// <returns>Instance count.</returns>
-    public static int GetInstanceCount() => _instanceCount;
-}
-
-/* ── Interface ────────────────────────────────────────────────────────── */
-
-/// <summary>
-/// Interface for greeting operations with default implementation.
-/// </summary>
-public interface IGreeter {
-    /// <summary>
-    /// Say hello to a named person.
-    /// </summary>
-    /// <param name="name">Person's name.</param>
-    void SayHello(string name);
-
-    /// <summary>
-    /// Default farewell implementation.
-    /// </summary>
-    /// <param name="name">Person's name.</param>
-    void SayGoodbye(string name) {
-        Console.WriteLine($"Goodbye, {name}");
-    }
-}
-
-/// <summary>
-/// Generic repository interface with covariant type parameter.
-/// </summary>
-/// <typeparam name="T">Entity type, must be a class with parameterless ctor.</typeparam>
-public interface IRepository<T> where T : class, new() {
-    /// <summary>Find entity by ID.</summary>
-    Task<T?> FindByIdAsync(int id);
-
-    /// <summary>Get all entities as async stream.</summary>
-    IAsyncEnumerable<T> GetAllAsync(CancellationToken token = default);
-
-    /// <summary>Save an entity.</summary>
-    Task<bool> SaveAsync(T entity);
-}
-
-/* ── Struct ───────────────────────────────────────────────────────────── */
-
-/// <summary>
-/// Immutable 2D point struct with operator overloading.
-/// </summary>
-public readonly struct Point {
-    /// <summary>Horizontal coordinate.</summary>
-    public double X { get; init; }
-    /// <summary>Vertical coordinate.</summary>
-    public double Y { get; init; }
-
-    /// <summary>
-    /// Add two points component-wise.
-    /// </summary>
-    public static Point operator +(Point a, Point b) => new() { X = a.X + b.X, Y = a.Y + b.Y };
-
-    /// <summary>
-    /// Compute distance from origin.
-    /// </summary>
-    public double Magnitude => Math.Sqrt(X * X + Y * Y);
-}
-
-/* ── Enum ─────────────────────────────────────────────────────────────── */
-
-/// <summary>
-/// Color flags enum supporting bitwise combinations.
-/// </summary>
-[Flags]
-public enum Color {
-    /// <summary>No color selected.</summary>
-    None = 0,
-    /// <summary>Red channel.</summary>
-    Red = 1,
-    /// <summary>Green channel.</summary>
-    Green = 2,
-    /// <summary>Blue channel.</summary>
-    Blue = 4,
-    /// <summary>All channels combined.</summary>
-    All = Red | Green | Blue,
-}
-
-/* ── Record types ─────────────────────────────────────────────────────── */
-
-/// <summary>
-/// Immutable record for configuration entries.
-/// </summary>
-/// <param name="Key">Configuration key.</param>
-/// <param name="Value">Configuration value.</param>
-public record ConfigEntry(string Key, string Value);
-
-/// <summary>
-/// Record struct for lightweight value records (C# 10).
-/// </summary>
-/// <param name="X">X coordinate.</param>
-/// <param name="Y">Y coordinate.</param>
-public record struct Vector2(double X, double Y);
-
-/* ── Extension methods ────────────────────────────────────────────────── */
-
-/// <summary>
-/// Extension methods for string manipulation.
-/// </summary>
-public static class StringExtensions {
-    /// <summary>
-    /// Truncate a string to the specified maximum length.
-    /// </summary>
-    /// <param name="str">Source string.</param>
-    /// <param name="maxLength">Maximum characters to keep.</param>
-    /// <returns>Truncated string with ellipsis if shortened.</returns>
-    public static string Truncate(this string str, int maxLength) {
-        if (str.Length <= maxLength) return str;
-        return str[..maxLength] + "...";
-    }
-
-    /// <summary>
-    /// Check if a string contains only ASCII characters.
-    /// </summary>
-    /// <param name="str">The string to check.</param>
-    /// <returns>True if all characters are ASCII.</returns>
-    public static bool IsAscii(this string str) {
-        return str.All(c => c < 128);
-    }
-}
-
-/* ── Generic class with constraints ───────────────────────────────────── */
-
-/// <summary>
-/// Generic collection with filtering and transformation support.
-/// </summary>
-/// <typeparam name="T">Element type, must be comparable.</typeparam>
-public class SortedCollection<T> where T : IComparable<T> {
-    private readonly List<T> _items = new();
-
-    /// <summary>
-    /// Add an item maintaining sorted order.
-    /// </summary>
-    /// <param name="item">Item to insert.</param>
-    public void Add(T item) {
-        // Binary search for insertion point
-        var index = _items.BinarySearch(item);
-        if (index < 0) index = ~index;
-        _items.Insert(index, item);
-    }
-
-    /// <summary>
-    /// Get items matching a predicate using LINQ.
-    /// </summary>
-    /// <param name="predicate">Filter condition.</param>
-    /// <returns>Filtered enumerable.</returns>
-    public IEnumerable<T> Where(Func<T, bool> predicate) {
-        return _items.Where(predicate);
-    }
-}
-
-/* ── Pattern matching utility ─────────────────────────────────────────── */
-
-/// <summary>
-/// Utility class demonstrating advanced pattern matching.
-/// </summary>
-public static class PatternMatcher {
-    /// <summary>
-    /// Describe any object using C# pattern matching expressions.
-    /// </summary>
-    /// <param name="obj">Object to describe.</param>
-    /// <returns>Description string.</returns>
-    public static string Describe(object? obj) {
-        return obj switch {
-            null => "null",
-            int i when i > 0 => $"positive int: {i}",
-            int i => $"non-positive int: {i}",
-            string { Length: 0 } => "empty string",
-            string s => $"string({s.Length}): {s}",
-            Person { Age: >= 18 } p => $"adult: {p.Name}",
-            Person p => $"minor: {p.Name}",
-            _ => $"unknown: {obj.GetType().Name}",
-        };
-    }
-}
-
-} // namespace MyApp
-
-/* coverage extension block */
-namespace MyApp.Services {}
-namespace MyApp.Core {}
-namespace MyApp.Data {}
-namespace MyApp.Api {}
-public interface ILogger {}
-public interface IParser {}
-public interface IRunner {}
-public enum ModeCs { Fast, Safe }
-public enum PhaseCs { Init, Done }
-public enum StateCs { Open, Closed }
-public enum SignalCs { On, Off }
-public struct Size { public int W; public int H; }
-public readonly struct Vector { public readonly int X; public readonly int Y; }
-public struct Limits { public int Max; }
-public struct Cursor { public int Index; }
-[DebuggerDisplay("{Value}")]
-public const int MIN_AGE = 10;
-public const int RETRY_LIMIT = 3;
-public const int CACHE_SIZE = 128;
-public const int DEFAULT_PAGE = 1;
-
-// REQ-COVER-SRS-231 START
-public static class ReqCoverCsharp {
-    /// @REQ-COVER-SRS-231 block 1
-    /// @brief Coverage helper construct 1.
-    /// @details Provides deterministic fixture-level Doxygen coverage block 1.
-    /// @param value Input value for helper construct 1.
-    /// @return Output value for helper construct 1.
-    public static int ReqCoverCsharp1(int value) { return value + 1; }
-
-    /// @REQ-COVER-SRS-231 block 2
-    /// @brief Coverage helper construct 2.
-    /// @details Provides deterministic fixture-level Doxygen coverage block 2.
-    /// @param value Input value for helper construct 2.
-    /// @return Output value for helper construct 2.
-    public static int ReqCoverCsharp2(int value) { return value + 2; }
-
-    /// @REQ-COVER-SRS-231 block 3
-    /// @brief Coverage helper construct 3.
-    /// @details Provides deterministic fixture-level Doxygen coverage block 3.
-    /// @param value Input value for helper construct 3.
-    /// @return Output value for helper construct 3.
-    public static int ReqCoverCsharp3(int value) { return value + 3; }
-
-    /// @REQ-COVER-SRS-231 block 4
-    /// @brief Coverage helper construct 4.
-    /// @details Provides deterministic fixture-level Doxygen coverage block 4.
-    /// @param value Input value for helper construct 4.
-    /// @return Output value for helper construct 4.
-    public static int ReqCoverCsharp4(int value) { return value + 4; }
-
-    /// @REQ-COVER-SRS-231 block 5
-    /// @brief Coverage helper construct 5.
-    /// @details Provides deterministic fixture-level Doxygen coverage block 5.
-    /// @param value Input value for helper construct 5.
-    /// @return Output value for helper construct 5.
-    public static int ReqCoverCsharp5(int value) { return value + 5; }
-
-}
-// REQ-COVER-SRS-231 END