TestMu Conference is Back! Future of Testing + AI LambdaTest G2 Announcement

How to use EventQueue class of Microsoft.Coyote.Actors package

Best Coyote code snippet using Microsoft.Coyote.Actors.EventQueue

ActorExecutionContext.cs

Source:ActorExecutionContext.cs

...206            {207                eventGroup = creator.EventGroup;208            }209            Actor actor = ActorFactory.Create(type);210            IEventQueue eventQueue = new EventQueue(actor);211            actor.Configure(this, id, null, eventQueue, eventGroup);212            actor.SetupEventHandlers();213            if (!this.ActorMap.TryAdd(id, actor))214            {215                this.Assert(false, $"An actor with id '{id.Value}' was already created by another runtime instance.");216            }217            return actor;218        }219        /// <inheritdoc/>220        public virtual void SendEvent(ActorId targetId, Event initialEvent, EventGroup eventGroup = default, SendOptions options = null) =>221            this.SendEvent(targetId, initialEvent, null, eventGroup, options);222        /// <inheritdoc/>223        public virtual Task<bool> SendEventAndExecuteAsync(ActorId targetId, Event initialEvent,224            EventGroup eventGroup = null, SendOptions options = null) =>225            this.SendEventAndExecuteAsync(targetId, initialEvent, null, eventGroup, options);226        /// <summary>227        /// Sends an asynchronous <see cref="Event"/> to an actor.228        /// </summary>229        internal virtual void SendEvent(ActorId targetId, Event e, Actor sender, EventGroup eventGroup, SendOptions options)230        {231            EnqueueStatus enqueueStatus = this.EnqueueEvent(targetId, e, sender, eventGroup, out Actor target);232            if (enqueueStatus is EnqueueStatus.EventHandlerNotRunning)233            {234                this.RunActorEventHandler(target, null, false);235            }236        }237        /// <summary>238        /// Sends an asynchronous <see cref="Event"/> to an actor. Returns immediately if the target was239        /// already running. Otherwise blocks until the target handles the event and reaches quiescense.240        /// </summary>241        internal virtual async Task<bool> SendEventAndExecuteAsync(ActorId targetId, Event e, Actor sender,242            EventGroup eventGroup, SendOptions options)243        {244            EnqueueStatus enqueueStatus = this.EnqueueEvent(targetId, e, sender, eventGroup, out Actor target);245            if (enqueueStatus is EnqueueStatus.EventHandlerNotRunning)246            {247                await this.RunActorEventHandlerAsync(target, null, false);248                return true;249            }250            return enqueueStatus is EnqueueStatus.Dropped;251        }252        /// <summary>253        /// Enqueues an event to the actor with the specified id.254        /// </summary>255        private EnqueueStatus EnqueueEvent(ActorId targetId, Event e, Actor sender, EventGroup eventGroup, out Actor target)256        {257            if (e is null)258            {259                string message = sender != null ?260                    string.Format("{0} is sending a null event.", sender.Id.ToString()) :261                    "Cannot send a null event.";262                this.Assert(false, message);263            }264            if (targetId is null)265            {266                string message = (sender != null) ?267                    string.Format("{0} is sending event {1} to a null actor.", sender.Id.ToString(), e.ToString())268                    : string.Format("Cannot send event {0} to a null actor.", e.ToString());269                this.Assert(false, message);270            }271            target = this.GetActorWithId<Actor>(targetId);272            // If no group is provided we default to passing along the group from the sender.273            if (eventGroup is null && sender != null)274            {275                eventGroup = sender.EventGroup;276            }277            Guid opId = eventGroup is null ? Guid.Empty : eventGroup.Id;278            if (target is null || target.IsHalted)279            {280                this.LogWriter.LogSendEvent(targetId, sender?.Id.Name, sender?.Id.Type,281                    (sender as StateMachine)?.CurrentStateName ?? default, e, opId, isTargetHalted: true);282                this.HandleDroppedEvent(e, targetId);283                return EnqueueStatus.Dropped;284            }285            this.LogWriter.LogSendEvent(targetId, sender?.Id.Name, sender?.Id.Type,286                (sender as StateMachine)?.CurrentStateName ?? default, e, opId, isTargetHalted: false);287            EnqueueStatus enqueueStatus = target.Enqueue(e, eventGroup, null);288            if (enqueueStatus == EnqueueStatus.Dropped)289            {290                this.HandleDroppedEvent(e, targetId);291            }292            return enqueueStatus;293        }294        /// <summary>295        /// Runs a new asynchronous actor event handler.296        /// This is a fire and forget invocation.297        /// </summary>298        private void RunActorEventHandler(Actor actor, Event initialEvent, bool isFresh)299        {300            Task.Run(async () =>301            {302                try303                {304                    if (isFresh)305                    {306                        await actor.InitializeAsync(initialEvent);307                    }308                    await actor.RunEventHandlerAsync();309                }310                catch (Exception ex)311                {312                    this.Scheduler.IsProgramExecuting = false;313                    this.RaiseOnFailureEvent(ex);314                }315                finally316                {317                    if (actor.IsHalted)318                    {319                        this.ActorMap.TryRemove(actor.Id, out Actor _);320                    }321                }322            });323        }324        /// <summary>325        /// Runs a new asynchronous actor event handler.326        /// </summary>327        private async Task RunActorEventHandlerAsync(Actor actor, Event initialEvent, bool isFresh)328        {329            try330            {331                if (isFresh)332                {333                    await actor.InitializeAsync(initialEvent);334                }335                await actor.RunEventHandlerAsync();336            }337            catch (Exception ex)338            {339                this.Scheduler.IsProgramExecuting = false;340                this.RaiseOnFailureEvent(ex);341                return;342            }343        }344        /// <summary>345        /// Creates a new timer that sends a <see cref="TimerElapsedEvent"/> to its owner actor.346        /// </summary>347        internal virtual IActorTimer CreateActorTimer(TimerInfo info, Actor owner) => new ActorTimer(info, owner);348        /// <inheritdoc/>349        public virtual EventGroup GetCurrentEventGroup(ActorId currentActorId)350        {351            Actor actor = this.GetActorWithId<Actor>(currentActorId);352            return actor?.CurrentEventGroup;353        }354        /// <summary>355        /// Gets the actor of type <typeparamref name="TActor"/> with the specified id,356        /// or null if no such actor exists.357        /// </summary>358        internal TActor GetActorWithId<TActor>(ActorId id)359            where TActor : Actor =>360            id != null && this.ActorMap.TryGetValue(id, out Actor value) &&361            value is TActor actor ? actor : null;362        /// <summary>363        /// Returns the next available unique operation id.364        /// </summary>365        /// <returns>Value representing the next available unique operation id.</returns>366        internal ulong GetNextOperationId() => this.Runtime.GetNextOperationId();367        /// <inheritdoc/>368        public bool RandomBoolean() => this.GetNondeterministicBooleanChoice(2, null, null);369        /// <inheritdoc/>370        public bool RandomBoolean(int maxValue) => this.GetNondeterministicBooleanChoice(maxValue, null, null);371        /// <summary>372        /// Returns a controlled nondeterministic boolean choice.373        /// </summary>374        internal virtual bool GetNondeterministicBooleanChoice(int maxValue, string callerName, string callerType)375        {376            bool result = false;377            if (this.ValueGenerator.Next(maxValue) is 0)378            {379                result = true;380            }381            this.LogWriter.LogRandom(result, callerName, callerType);382            return result;383        }384        /// <inheritdoc/>385        public int RandomInteger(int maxValue) => this.GetNondeterministicIntegerChoice(maxValue, null, null);386        /// <summary>387        /// Returns a controlled nondeterministic integer choice.388        /// </summary>389        internal virtual int GetNondeterministicIntegerChoice(int maxValue, string callerName, string callerType)390        {391            var result = this.ValueGenerator.Next(maxValue);392            this.LogWriter.LogRandom(result, callerName, callerType);393            return result;394        }395        /// <summary>396        /// Logs that the specified actor invoked an action.397        /// </summary>398        internal virtual void LogInvokedAction(Actor actor, MethodInfo action, string handlingStateName, string currentStateName)399        {400            if (this.Configuration.IsVerbose)401            {402                this.LogWriter.LogExecuteAction(actor.Id, handlingStateName, currentStateName, action.Name);403            }404        }405        /// <summary>406        /// Logs that the specified actor enqueued an <see cref="Event"/>.407        /// </summary>408        internal virtual void LogEnqueuedEvent(Actor actor, Event e, EventGroup eventGroup, EventInfo eventInfo)409        {410            if (this.Configuration.IsVerbose)411            {412                this.LogWriter.LogEnqueueEvent(actor.Id, e);413            }414        }415        /// <summary>416        /// Logs that the specified actor dequeued an <see cref="Event"/>.417        /// </summary>418        internal virtual void LogDequeuedEvent(Actor actor, Event e, EventInfo eventInfo, bool isFreshDequeue)419        {420            if (this.Configuration.IsVerbose)421            {422                string stateName = actor is StateMachine stateMachine ? stateMachine.CurrentStateName : default;423                this.LogWriter.LogDequeueEvent(actor.Id, stateName, e);424            }425        }426        /// <summary>427        /// Logs that the specified actor dequeued the default <see cref="Event"/>.428        /// </summary>429        [MethodImpl(MethodImplOptions.AggressiveInlining)]430        internal virtual void LogDefaultEventDequeued(Actor actor)431        {432        }433        /// <summary>434        /// Notifies that the inbox of the specified actor is about to be435        /// checked to see if the default event handler should fire.436        /// </summary>437        [MethodImpl(MethodImplOptions.AggressiveInlining)]438        internal virtual void LogDefaultEventHandlerCheck(Actor actor)439        {440        }441        /// <summary>442        /// Logs that the specified actor raised an <see cref="Event"/>.443        /// </summary>444        internal virtual void LogRaisedEvent(Actor actor, Event e, EventGroup eventGroup, EventInfo eventInfo)445        {446            if (this.Configuration.IsVerbose)447            {448                string stateName = actor is StateMachine stateMachine ? stateMachine.CurrentStateName : default;449                this.LogWriter.LogRaiseEvent(actor.Id, stateName, e);450            }451        }452        /// <summary>453        /// Logs that the specified actor is handling a raised <see cref="Event"/>.454        /// </summary>455        [MethodImpl(MethodImplOptions.AggressiveInlining)]456        internal virtual void LogHandleRaisedEvent(Actor actor, Event e)457        {458        }459        /// <summary>460        /// Logs that the specified actor called <see cref="Actor.ReceiveEventAsync(Type[])"/>461        /// or one of its overloaded methods.462        /// </summary>463        [MethodImpl(MethodImplOptions.AggressiveInlining)]464        internal virtual void LogReceiveCalled(Actor actor)465        {466        }467        /// <summary>468        /// Logs that the specified actor enqueued an event that it was waiting to receive.469        /// </summary>470        internal virtual void LogReceivedEvent(Actor actor, Event e, EventInfo eventInfo)471        {472            if (this.Configuration.IsVerbose)473            {474                string stateName = actor is StateMachine stateMachine ? stateMachine.CurrentStateName : default;475                this.LogWriter.LogReceiveEvent(actor.Id, stateName, e, wasBlocked: true);476            }477        }478        /// <summary>479        /// Logs that the specified actor received an event without waiting because the event480        /// was already in the inbox when the actor invoked the receive statement.481        /// </summary>482        internal virtual void LogReceivedEventWithoutWaiting(Actor actor, Event e, EventInfo eventInfo)483        {484            if (this.Configuration.IsVerbose)485            {486                string stateName = actor is StateMachine stateMachine ? stateMachine.CurrentStateName : default;487                this.LogWriter.LogReceiveEvent(actor.Id, stateName, e, wasBlocked: false);488            }489        }490        /// <summary>491        /// Logs that the specified actor is waiting to receive an event of one of the specified types.492        /// </summary>493        internal virtual void LogWaitEvent(Actor actor, IEnumerable<Type> eventTypes)494        {495            if (this.Configuration.IsVerbose)496            {497                string stateName = actor is StateMachine stateMachine ? stateMachine.CurrentStateName : default;498                var eventWaitTypesArray = eventTypes.ToArray();499                if (eventWaitTypesArray.Length is 1)500                {501                    this.LogWriter.LogWaitEvent(actor.Id, stateName, eventWaitTypesArray[0]);502                }503                else504                {505                    this.LogWriter.LogWaitEvent(actor.Id, stateName, eventWaitTypesArray);506                }507            }508        }509        /// <summary>510        /// Logs that the specified state machine entered a state.511        /// </summary>512        internal virtual void LogEnteredState(StateMachine stateMachine)513        {514            if (this.Configuration.IsVerbose)515            {516                this.LogWriter.LogStateTransition(stateMachine.Id, stateMachine.CurrentStateName, isEntry: true);517            }518        }519        /// <summary>520        /// Logs that the specified state machine exited a state.521        /// </summary>522        internal virtual void LogExitedState(StateMachine stateMachine)523        {524            if (this.Configuration.IsVerbose)525            {526                this.LogWriter.LogStateTransition(stateMachine.Id, stateMachine.CurrentStateName, isEntry: false);527            }528        }529        /// <summary>530        /// Logs that the specified state machine invoked pop.531        /// </summary>532        [MethodImpl(MethodImplOptions.AggressiveInlining)]533        internal virtual void LogPopState(StateMachine stateMachine)534        {535        }536        /// <summary>537        /// Logs that the specified state machine invoked an action.538        /// </summary>539        internal virtual void LogInvokedOnEntryAction(StateMachine stateMachine, MethodInfo action)540        {541            if (this.Configuration.IsVerbose)542            {543                this.LogWriter.LogExecuteAction(stateMachine.Id, stateMachine.CurrentStateName,544                    stateMachine.CurrentStateName, action.Name);545            }546        }547        /// <summary>548        /// Logs that the specified state machine invoked an action.549        /// </summary>550        internal virtual void LogInvokedOnExitAction(StateMachine stateMachine, MethodInfo action)551        {552            if (this.Configuration.IsVerbose)553            {554                this.LogWriter.LogExecuteAction(stateMachine.Id, stateMachine.CurrentStateName,555                    stateMachine.CurrentStateName, action.Name);556            }557        }558        /// <summary>559        /// Builds the coverage graph information, if any. This information is only available560        /// when <see cref="Configuration.ReportActivityCoverage"/> is enabled.561        /// </summary>562        internal CoverageInfo BuildCoverageInfo()563        {564            var result = this.CoverageInfo;565            if (result != null)566            {567                var builder = this.LogWriter.GetLogsOfType<ActorRuntimeLogGraphBuilder>().FirstOrDefault();568                if (builder != null)569                {570                    result.CoverageGraph = builder.SnapshotGraph(this.Configuration.IsDgmlBugGraph);571                }572                var eventCoverage = this.LogWriter.GetLogsOfType<ActorRuntimeLogEventCoverage>().FirstOrDefault();573                if (eventCoverage != null)574                {575                    result.EventInfo = eventCoverage.EventCoverage;576                }577            }578            return result;579        }580        /// <summary>581        /// Returns the current hashed state of the actors.582        /// </summary>583        /// <remarks>584        /// The hash is updated in each execution step.585        /// </remarks>586        internal virtual int GetHashedActorState() => 0;587        /// <summary>588        /// Returns the program counter of the specified actor.589        /// </summary>590        [MethodImpl(MethodImplOptions.AggressiveInlining)]591        internal virtual int GetActorProgramCounter(ActorId actorId) => 0;592        /// <inheritdoc/>593        public void RegisterMonitor<T>()594            where T : Monitor =>595            this.TryCreateMonitor(typeof(T));596        /// <inheritdoc/>597        public void Monitor<T>(Event e)598            where T : Monitor599        {600            // If the event is null then report an error and exit.601            this.Assert(e != null, "Cannot monitor a null event.");602            this.InvokeMonitor(typeof(T), e, null, null, null);603        }604        /// <summary>605        /// Tries to create a new <see cref="Specifications.Monitor"/> of the specified <see cref="Type"/>.606        /// </summary>607        protected bool TryCreateMonitor(Type type) => this.SpecificationEngine.TryCreateMonitor(608            type, this.CoverageInfo, this.LogWriter);609        /// <summary>610        /// Invokes the specified <see cref="Specifications.Monitor"/> with the specified <see cref="Event"/>.611        /// </summary>612        internal void InvokeMonitor(Type type, Event e, string senderName, string senderType, string senderStateName) =>613            this.SpecificationEngine.InvokeMonitor(type, e, senderName, senderType, senderStateName);614        /// <inheritdoc/>615        [MethodImpl(MethodImplOptions.AggressiveInlining)]616        public void Assert(bool predicate) => this.SpecificationEngine.Assert(predicate);617        /// <inheritdoc/>618        [MethodImpl(MethodImplOptions.AggressiveInlining)]619        public void Assert(bool predicate, string s, object arg0) => this.SpecificationEngine.Assert(predicate, s, arg0);620        /// <inheritdoc/>621        [MethodImpl(MethodImplOptions.AggressiveInlining)]622        public void Assert(bool predicate, string s, object arg0, object arg1) => this.SpecificationEngine.Assert(predicate, s, arg0, arg1);623        /// <inheritdoc/>624        [MethodImpl(MethodImplOptions.AggressiveInlining)]625        public void Assert(bool predicate, string s, object arg0, object arg1, object arg2) =>626            this.SpecificationEngine.Assert(predicate, s, arg0, arg1, arg2);627        /// <inheritdoc/>628        [MethodImpl(MethodImplOptions.AggressiveInlining)]629        public void Assert(bool predicate, string s, params object[] args) => this.SpecificationEngine.Assert(predicate, s, args);630        /// <summary>631        /// Asserts that the actor calling an actor method is also the actor that is currently executing.632        /// </summary>633        [MethodImpl(MethodImplOptions.AggressiveInlining)]634        internal virtual void AssertExpectedCallerActor(Actor caller, string calledAPI)635        {636        }637        /// <summary>638        /// Raises the <see cref="OnFailure"/> event with the specified <see cref="Exception"/>.639        /// </summary>640        internal void RaiseOnFailureEvent(Exception exception) => this.Runtime.RaiseOnFailureEvent(exception);641        /// <summary>642        /// Handle the specified dropped <see cref="Event"/>.643        /// </summary>644        internal void HandleDroppedEvent(Event e, ActorId id) => this.OnEventDropped?.Invoke(e, id);645        /// <summary>646        /// Throws an <see cref="AssertionFailureException"/> exception containing the specified exception.647        /// </summary>648#if !DEBUG649        [DebuggerHidden]650#endif651        internal void WrapAndThrowException(Exception exception, string s, params object[] args) =>652            this.SpecificationEngine.WrapAndThrowException(exception, s, args);653        /// <inheritdoc/>654        [Obsolete("Please set the Logger property directory instead of calling this method.")]655        public TextWriter SetLogger(TextWriter logger)656        {657            var result = this.LogWriter.SetLogger(new TextWriterLogger(logger));658            if (result != null)659            {660                return result.TextWriter;661            }662            return null;663        }664        /// <inheritdoc/>665        public void RegisterLog(IActorRuntimeLog log) => this.LogWriter.RegisterLog(log);666        /// <inheritdoc/>667        public void RemoveLog(IActorRuntimeLog log) => this.LogWriter.RemoveLog(log);668        /// <inheritdoc/>669        public void Stop() => this.Scheduler.ForceStop();670        /// <summary>671        /// Disposes runtime resources.672        /// </summary>673        protected virtual void Dispose(bool disposing)674        {675            if (disposing)676            {677                this.ActorMap.Clear();678            }679        }680        /// <inheritdoc/>681        public void Dispose()682        {683            this.Dispose(true);684            GC.SuppressFinalize(this);685        }686        /// <summary>687        /// The mocked execution context of an actor program.688        /// </summary>689        internal sealed class Mock : ActorExecutionContext690        {691            /// <summary>692            /// Map that stores all unique names and their corresponding actor ids.693            /// </summary>694            private readonly ConcurrentDictionary<string, ActorId> NameValueToActorId;695            /// <summary>696            /// Map of program counters used for state-caching to distinguish697            /// scheduling from non-deterministic choices.698            /// </summary>699            private readonly ConcurrentDictionary<ActorId, int> ProgramCounterMap;700            /// <summary>701            /// If true, the actor execution is controlled, else false.702            /// </summary>703            internal override bool IsExecutionControlled => true;704            /// <summary>705            /// Initializes a new instance of the <see cref="Mock"/> class.706            /// </summary>707            internal Mock(Configuration configuration, CoyoteRuntime runtime, OperationScheduler scheduler,708                SpecificationEngine specificationEngine, IRandomValueGenerator valueGenerator, LogWriter logWriter)709                : base(configuration, runtime, scheduler, specificationEngine, valueGenerator, logWriter)710            {711                this.NameValueToActorId = new ConcurrentDictionary<string, ActorId>();712                this.ProgramCounterMap = new ConcurrentDictionary<ActorId, int>();713            }714            /// <inheritdoc/>715            public override ActorId CreateActorIdFromName(Type type, string name)716            {717                // It is important that all actor ids use the monotonically incrementing718                // value as the id during testing, and not the unique name.719                return this.NameValueToActorId.GetOrAdd(name, key => this.CreateActorId(type, key));720            }721            /// <inheritdoc/>722            public override ActorId CreateActor(Type type, Event initialEvent = null, EventGroup eventGroup = null) =>723                this.CreateActor(null, type, null, initialEvent, eventGroup);724            /// <inheritdoc/>725            public override ActorId CreateActor(Type type, string name, Event initialEvent = null, EventGroup eventGroup = null) =>726                this.CreateActor(null, type, name, initialEvent, eventGroup);727            /// <inheritdoc/>728            public override ActorId CreateActor(ActorId id, Type type, Event initialEvent = null, EventGroup eventGroup = null)729            {730                this.Assert(id != null, "Cannot create an actor using a null actor id.");731                return this.CreateActor(id, type, null, initialEvent, eventGroup);732            }733            /// <inheritdoc/>734            public override Task<ActorId> CreateActorAndExecuteAsync(Type type, Event initialEvent = null, EventGroup eventGroup = null) =>735                this.CreateActorAndExecuteAsync(null, type, null, initialEvent, eventGroup);736            /// <inheritdoc/>737            public override Task<ActorId> CreateActorAndExecuteAsync(Type type, string name, Event initialEvent = null, EventGroup eventGroup = null) =>738                this.CreateActorAndExecuteAsync(null, type, name, initialEvent, eventGroup);739            /// <inheritdoc/>740            public override Task<ActorId> CreateActorAndExecuteAsync(ActorId id, Type type, Event initialEvent = null, EventGroup eventGroup = null)741            {742                this.Assert(id != null, "Cannot create an actor using a null actor id.");743                return this.CreateActorAndExecuteAsync(id, type, null, initialEvent, eventGroup);744            }745            /// <summary>746            /// Creates a new actor of the specified <see cref="Type"/> and name, using the specified747            /// unbound actor id, and passes the specified optional <see cref="Event"/>. This event748            /// can only be used to access its payload, and cannot be handled.749            /// </summary>750            internal ActorId CreateActor(ActorId id, Type type, string name, Event initialEvent = null, EventGroup eventGroup = null)751            {752                var creatorOp = this.Scheduler.GetExecutingOperation<ActorOperation>();753                return this.CreateActor(id, type, name, initialEvent, creatorOp?.Actor, eventGroup);754            }755            /// <summary>756            /// Creates a new <see cref="Actor"/> of the specified <see cref="Type"/>.757            /// </summary>758            internal override ActorId CreateActor(ActorId id, Type type, string name, Event initialEvent, Actor creator, EventGroup eventGroup)759            {760                this.AssertExpectedCallerActor(creator, "CreateActor");761                Actor actor = this.CreateActor(id, type, name, creator, eventGroup);762                this.RunActorEventHandler(actor, initialEvent, true, null);763                return actor.Id;764            }765            /// <summary>766            /// Creates a new actor of the specified <see cref="Type"/> and name, using the specified767            /// unbound actor id, and passes the specified optional <see cref="Event"/>. This event768            /// can only be used to access its payload, and cannot be handled. The method returns only769            /// when the actor is initialized and the <see cref="Event"/> (if any) is handled.770            /// </summary>771            internal Task<ActorId> CreateActorAndExecuteAsync(ActorId id, Type type, string name, Event initialEvent = null,772                EventGroup eventGroup = null)773            {774                var creatorOp = this.Scheduler.GetExecutingOperation<ActorOperation>();775                return this.CreateActorAndExecuteAsync(id, type, name, initialEvent, creatorOp?.Actor, eventGroup);776            }777            /// <summary>778            /// Creates a new <see cref="Actor"/> of the specified <see cref="Type"/>. The method779            /// returns only when the actor is initialized and the <see cref="Event"/> (if any)780            /// is handled.781            /// </summary>782            internal override async Task<ActorId> CreateActorAndExecuteAsync(ActorId id, Type type, string name, Event initialEvent,783                Actor creator, EventGroup eventGroup)784            {785                this.AssertExpectedCallerActor(creator, "CreateActorAndExecuteAsync");786                this.Assert(creator != null, "Only an actor can call 'CreateActorAndExecuteAsync': avoid calling " +787                    "it directly from the test method; instead call it through a test driver actor.");788                Actor actor = this.CreateActor(id, type, name, creator, eventGroup);789                this.RunActorEventHandler(actor, initialEvent, true, creator);790                // Wait until the actor reaches quiescence.791                await creator.ReceiveEventAsync(typeof(QuiescentEvent), rev => (rev as QuiescentEvent).ActorId == actor.Id);792                return await Task.FromResult(actor.Id);793            }794            /// <summary>795            /// Creates a new <see cref="Actor"/> of the specified <see cref="Type"/>.796            /// </summary>797            internal override Actor CreateActor(ActorId id, Type type, string name, Actor creator, EventGroup eventGroup)798            {799                this.Assert(type.IsSubclassOf(typeof(Actor)), "Type '{0}' is not an actor.", type.FullName);800                // Using ulong.MaxValue because a Create operation cannot specify801                // the id of its target, because the id does not exist yet.802                this.Scheduler.ScheduleNextOperation(AsyncOperationType.Create);803                this.ResetProgramCounter(creator);804                if (id is null)805                {806                    id = this.CreateActorId(type, name);807                }808                else809                {810                    this.Assert(id.Runtime is null || id.Runtime == this, "Unbound actor id '{0}' was created by another runtime.", id.Value);811                    this.Assert(id.Type == type.FullName, "Cannot bind actor id '{0}' of type '{1}' to an actor of type '{2}'.",812                        id.Value, id.Type, type.FullName);813                    id.Bind(this);814                }815                // If a group was not provided, inherit the current event group from the creator (if any).816                if (eventGroup is null && creator != null)817                {818                    eventGroup = creator.EventGroup;819                }820                Actor actor = ActorFactory.Create(type);821                ActorOperation op = new ActorOperation(id.Value, id.Name, actor, this.Scheduler);822                IEventQueue eventQueue = new MockEventQueue(actor);823                actor.Configure(this, id, op, eventQueue, eventGroup);824                actor.SetupEventHandlers();825                if (this.Configuration.ReportActivityCoverage)826                {827                    actor.ReportActivityCoverage(this.CoverageInfo);828                }829                bool result = this.Scheduler.RegisterOperation(op);830                this.Assert(result, "Actor id '{0}' is used by an existing or previously halted actor.", id.Value);831                if (actor is StateMachine)832                {833                    this.LogWriter.LogCreateStateMachine(id, creator?.Id.Name, creator?.Id.Type);834                }835                else836                {...

TestEventQueue.cs

Source:TestEventQueue.cs

...5using System.Linq;6using Microsoft.Coyote.IO;7namespace Microsoft.Coyote.Actors.Tests8{9    internal class TestEventQueue : EventQueue10    {11        internal enum Notification12        {13            EnqueueEvent = 0,14            RaiseEvent,15            WaitEvent,16            ReceiveEvent,17            ReceiveEventWithoutWaiting,18            IgnoreEvent,19            DeferEvent,20            DropEvent21        }22        private readonly Action<Notification, Event, EventInfo> Notify;23        private readonly Type[] IgnoredEvents;24        private readonly Type[] DeferredEvents;25        private readonly bool IsDefaultHandlerInstalled;26        private readonly ILogger Logger;27        protected override bool IsEventHandlerRunning { get; set; }28        internal TestEventQueue(ILogger logger, Action<Notification, Event, EventInfo> notify,29            Type[] ignoredEvents = null, Type[] deferredEvents = null, bool isDefaultHandlerInstalled = false)30            : base(null)31        {32            this.Logger = logger;33            this.Notify = notify;34            this.IgnoredEvents = ignoredEvents ?? Array.Empty<Type>();35            this.DeferredEvents = deferredEvents ?? Array.Empty<Type>();36            this.IsDefaultHandlerInstalled = isDefaultHandlerInstalled;37            this.IsEventHandlerRunning = true;38        }39        protected override bool IsEventIgnored(Event e) => this.IgnoredEvents.Contains(e.GetType());40        protected override bool IsEventDeferred(Event e) => this.DeferredEvents.Contains(e.GetType());41        protected override bool IsDefaultHandlerAvailable() => this.IsDefaultHandlerInstalled;42        protected override void OnEnqueueEvent(Event e, EventGroup eventGroup, EventInfo eventInfo)...

EventQueue

Using AI Code Generation

1using Microsoft.Coyote.Actors;2using Microsoft.Coyote.Runtime;3using System;4using System.Threading.Tasks;5{6    {7        static void Main(string[] args)8        {9            EventQueue eventQueue = new EventQueue();10            ActorRuntime runtime = new ActorRuntime();11            runtime.CreateActor(typeof(MyActor), eventQueue);12            eventQueue.Enqueue(new MyEvent());13            runtime.Start();14            Console.WriteLine("Hello World!");15        }16    }17    {18        protected override Task OnEventAsync(Event e)19        {20            if (e is MyEvent)21            {22                Console.WriteLine("MyEvent received");23            }24            return Task.CompletedTask;25        }26    }27    {28    }29}

EventQueue

Using AI Code Generation

1using Microsoft.Coyote.Actors;2using System;3using System.Collections.Generic;4using System.Threading.Tasks;5{6    {7        public static void Main(string[] args)8        {9            var queue = new EventQueue();10            queue.Enqueue(new EventA());11            queue.Enqueue(new EventB());12            queue.Enqueue(new EventC());13            queue.Enqueue(new EventD());14            queue.Enqueue(new EventE());15            queue.Enqueue(new EventF());16            queue.Enqueue(new EventG());17            queue.Enqueue(new EventH());18            queue.Enqueue(new EventI());19            queue.Enqueue(new EventJ());20            queue.Enqueue(new EventK());21            queue.Enqueue(new EventL());22            queue.Enqueue(new EventM());23            queue.Enqueue(new EventN());24            queue.Enqueue(new EventO());25            queue.Enqueue(new EventP());26            queue.Enqueue(new EventQ());27            queue.Enqueue(new EventR());28            queue.Enqueue(new EventS());29            queue.Enqueue(new EventT());30            queue.Enqueue(new EventU());31            queue.Enqueue(new EventV());32            queue.Enqueue(new EventW());33            queue.Enqueue(new EventX());34            queue.Enqueue(new EventY());35            queue.Enqueue(new EventZ());36            queue.Enqueue(new EventA());37            queue.Enqueue(new EventB());38            queue.Enqueue(new EventC());39            queue.Enqueue(new EventD());40            queue.Enqueue(new EventE());41            queue.Enqueue(new EventF());42            queue.Enqueue(new EventG());43            queue.Enqueue(new EventH());44            queue.Enqueue(new EventI());45            queue.Enqueue(new EventJ());46            queue.Enqueue(new EventK());47            queue.Enqueue(new EventL());48            queue.Enqueue(new EventM());49            queue.Enqueue(new EventN());50            queue.Enqueue(new EventO());51            queue.Enqueue(new EventP());52            queue.Enqueue(new EventQ());53            queue.Enqueue(new EventR());54            queue.Enqueue(new EventS());55            queue.Enqueue(new EventT());56            queue.Enqueue(new EventU());57            queue.Enqueue(new EventV());58            queue.Enqueue(new EventW());59            queue.Enqueue(new EventX());60            queue.Enqueue(new EventY());61            queue.Enqueue(new EventZ());62            queue.Enqueue(new EventA());63            queue.Enqueue(new EventB());64            queue.Enqueue(new EventC());65            queue.Enqueue(new EventD());66            queue.Enqueue(new EventE());67            queue.Enqueue(new EventF());68            queue.Enqueue(new EventG());69            queue.Enqueue(new EventH());70            queue.Enqueue(new EventI());71            queue.Enqueue(new EventJ());72            queue.Enqueue(new EventK());73            queue.Enqueue(new

EventQueue

Using AI Code Generation

1using System;2using System.Collections.Generic;3using System.Threading.Tasks;4using Microsoft.Coyote.Actors;5{6    {7        public static void Main(string[] args)8        {9            var runtime = new ActorRuntime();10            var queue = new EventQueue(runtime);11            var machine = new MyMachine(runtime, queue);12            machine.Run();13        }14    }15    {16        public MyMachine(ActorRuntime runtime, EventQueue queue) : base(runtime, queue)17        {18        }19        protected override Task OnInitializeAsync(Event initialEvent)20        {21            this.Queue.EnqueueEvent(new MyEvent());22            return Task.CompletedTask;23        }24        protected override Task OnEventHappenedAsync(Event e)25        {26            Console.WriteLine("Event happened: " + e.GetType().Name);27            return Task.CompletedTask;28        }29    }30    {31    }32}

EventQueue

Using AI Code Generation

1using Microsoft.Coyote.Actors;2using System;3using System.Threading.Tasks;4{5    {6        public static async Task Main(string[] args)7        {8            var eventQueue = new EventQueue();9            var actor = new Actor(eventQueue);10            await actor.Start();11            await eventQueue.EnqueueAsync(new Event1());12            await eventQueue.WaitAsync();13        }14    }15}16using Microsoft.Coyote.Actors;17using System;18using System.Threading.Tasks;19{20    {21        public static async Task Main(string[] args)22        {23            var eventQueue = new EventQueue();24            var actor = new Actor(eventQueue);25            await actor.Start();26            await eventQueue.EnqueueAsync(new Event1());27            await eventQueue.WaitAsync();28        }29    }30}31using Microsoft.Coyote.Actors;32using System;33using System.Threading.Tasks;34{35    {36        public static async Task Main(string[] args)37        {38            var eventQueue = new EventQueue();39            var actor = new Actor(eventQueue);40            await actor.Start();41            await eventQueue.EnqueueAsync(new Event1());42            await eventQueue.WaitAsync();43        }44    }45}46using Microsoft.Coyote.Actors;47using System;48using System.Threading.Tasks;49{50    {51        public static async Task Main(string[] args)52        {

EventQueue

Using AI Code Generation

1using Microsoft.Coyote.Actors;2using System;3using System.Threading.Tasks;4using System.Threading;5{6    {7        static void Main(string[] args)8        {9            var eventQueue = new EventQueue();10            var thread = new Thread(() => eventQueue.ProcessEvents());11            thread.Start();12            eventQueue.Enqueue(new MyEvent());13        }14    }15    {16        public int Value { get; set; }17    }18}19using Microsoft.Coyote.Actors;20using System;21using System.Threading.Tasks;22using System.Threading;23{24    {25        static void Main(string[] args)26        {27            var eventQueue = new EventQueue();28            var thread = new Thread(() => eventQueue.ProcessEvents());29            thread.Start();30            eventQueue.Enqueue(new MyEvent());31        }32    }33    {34        public int Value { get; set; }35    }36}37using Microsoft.Coyote.Actors;38using System;39using System.Threading.Tasks;40using System.Threading;41{42    {43        static void Main(string[] args)44        {45            var eventQueue = new EventQueue();46            var thread = new Thread(() => eventQueue.ProcessEvents());47            thread.Start();48            eventQueue.Enqueue(new MyEvent());49        }50    }51    {52        public int Value { get; set; }53    }54}

EventQueue

Using AI Code Generation

1using Microsoft.Coyote.Actors;2using System;3using System.Threading.Tasks;4{5    {6        public static async Task Main(string[] args)7        {8            EventQueue queue = new EventQueue();9            Actor actor = new Actor();10            queue.RegisterActor(actor);11            queue.EnqueueEvent(actor, new MyEvent());12            await queue.ProcessEventsAsync();13        }14        public class MyEvent : Event { }15        {16            protected override Task OnInitializeAsync(Event initialEvent)17            {18                this.RegisterEventHandler<MyEvent>(this.OnMyEvent);19                return Task.CompletedTask;20            }21            private Task OnMyEvent(Event e)22            {23                Console.WriteLine("Received MyEvent");24                return Task.CompletedTask;25            }26        }27    }28}29using Microsoft.Coyote.Actors;30using System;31using System.Threading.Tasks;32{33    {34        public static async Task Main(string[] args)35        {36            EventQueue queue = new EventQueue();37            Actor actor1 = new Actor();38            Actor actor2 = new Actor();39            queue.RegisterActor(actor1);40            queue.RegisterActor(actor2);41            queue.EnqueueEvent(actor1, new MyEvent());42            queue.EnqueueEvent(actor2, new MyEvent());

EventQueue

Using AI Code Generation

1using Microsoft.Coyote.Actors;2using System;3using System.Threading.Tasks;4{5    {6        public static void Main(string[] args)7        {8            var queue = new EventQueue();9            Task.Run(async () => await queue.RunAsync());10            queue.Enqueue(new MyEvent());11            Console.ReadLine();12        }13    }14    {15    }16}17using Microsoft.Coyote;18using System;19using System.Threading.Tasks;20{21    {22        public static void Main(string[] args)23        {24            var queue = new EventQueue();25            Task.Run(async () => await queue.RunAsync());26            queue.Enqueue(new MyEvent());27            Console.ReadLine();28        }29    }30    {31    }32}33using Microsoft.Coyote.Actors;34using System;35using System.Threading.Tasks;36{37    {38        public static void Main(string[] args)39        {40            var queue = new EventQueue();41            Task.Run(async () => await queue.RunAsync());42            queue.Enqueue(new MyEvent());43            Console.ReadLine();44        }45    }46    {47    }48}49using Microsoft.Coyote;50using System;51using System.Threading.Tasks;52{53    {54        public static void Main(string[] args)55        {56            var queue = new EventQueue();

EventQueue

Using AI Code Generation

1using Microsoft.Coyote.Actors;2using System;3using System.Threading.Tasks;4{5    {6        public static void Main(string[] args)7        {8            Counter counter = new Counter();9            EventQueue eq = new EventQueue();10            eq.Enqueue(counter, new IncrementEv

Automation Testing Tutorials

Learn to execute automation testing from scratch with LambdaTest Learning Hub. Right from setting up the prerequisites to run your first automation test, to following best practices and diving deeper into advanced test scenarios. LambdaTest Learning Hubs compile a list of step-by-step guides to help you be proficient with different test automation frameworks i.e. Selenium, Cypress, TestNG etc.