Skip to content
Tracon

AgentSkillStoreContract

Namespace Tracon.Testing.Contracts.Storage · Assembly Tracon.Testing.Contracts.Xunit.dll

Behavior tests for the IAgentSkillStore contract.

public abstract class AgentSkillStoreContract : TenantIsolationContract<IAgentSkillStore>, IAsyncLifetime, IAsyncDisposable
Inheritance
object ← StoreCancellationContract<IAgentSkillStore> ← TenantIsolationContract<IAgentSkillStore> ← AgentSkillStoreContract
Implements
IAsyncLifetime, IAsyncDisposable
Inherited Members
TenantIsolationContract<IAgentSkillStore>.TenantA, TenantIsolationContract<IAgentSkillStore>.TenantB, TenantIsolationContract<IAgentSkillStore>.UseAmbientTenant(MutableTenantContext), TenantIsolationContract<IAgentSkillStore>.SeedAsync(string, string, CancellationToken), TenantIsolationContract<IAgentSkillStore>.ExistsAsync(string, object), TenantIsolationContract<IAgentSkillStore>.CountAsync(string, CancellationToken), TenantIsolationContract<IAgentSkillStore>.TryDeleteAsync(string, object), TenantIsolationContract<IAgentSkillStore>.TryOverwriteAsync(string, string), TenantIsolationContract<IAgentSkillStore>.CancellableReadAsync(CancellationToken), TenantIsolationContract<IAgentSkillStore>.CancellableWriteAsync(CancellationToken), TenantIsolationContract<IAgentSkillStore>.WroteAnythingAsync(), TenantIsolationContract<IAgentSkillStore>.Tenant_cannot_read_another_tenants_record(), TenantIsolationContract<IAgentSkillStore>.Tenant_reads_its_own_record(), TenantIsolationContract<IAgentSkillStore>.Tenant_does_not_see_another_tenants_record_in_the_list(), TenantIsolationContract<IAgentSkillStore>.Tenant_cannot_delete_another_tenants_record(), TenantIsolationContract<IAgentSkillStore>.Same_name_lives_independently_across_two_tenants(), TenantIsolationContract<IAgentSkillStore>.AmbientTenant, StoreCancellationContract<IAgentSkillStore>.CreateStoreAsync(), StoreCancellationContract<IAgentSkillStore>.InitializeAsync(), StoreCancellationContract<IAgentSkillStore>.DisposeAsync(), StoreCancellationContract<IAgentSkillStore>.OnDisposeAsync(), StoreCancellationContract<IAgentSkillStore>.CancellableReadAsync(CancellationToken), StoreCancellationContract<IAgentSkillStore>.CancellableWriteAsync(CancellationToken), StoreCancellationContract<IAgentSkillStore>.WroteAnythingAsync(), StoreCancellationContract<IAgentSkillStore>.Canceled_token_throws_on_read(), StoreCancellationContract<IAgentSkillStore>.The_write_this_contract_checks_can_be_read_back(), StoreCancellationContract<IAgentSkillStore>.Canceled_token_throws_on_write_and_leaves_no_trace(), StoreCancellationContract<IAgentSkillStore>.Store, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Protects both behavior parity across implementations and tenant isolation.

protected AgentSkillStoreContract()

Reports how many records the given tenant sees through the listing endpoint.

protected override ValueTask<int> CountAsync(string tenantId, CancellationToken cancellationToken)

tenantId string

The reading tenant.

cancellationToken CancellationToken

The token every store call inside the hook must be handed; see TenantIsolationContract.SeedAsync.

ValueTask<int>

The number of records seen.

Deleting_a_missing_record_returns_false()

Section titled “ Deleting_a_missing_record_returns_false()”
[Fact]
public Task Deleting_a_missing_record_returns_false()

Task

[Fact]
public Task Disabled_skill_reads_back_disabled()

Task

Reports whether the record is visible from the given tenant’s viewpoint.

protected override ValueTask<bool> ExistsAsync(string tenantId, object key)

tenantId string

The reading tenant.

key object

The key returned by TenantIsolationContract.SeedAsync.

ValueTask<bool>

true if the record is visible.

[Fact]
public Task List_is_sorted_by_name()

Task

[Fact]
public Task Missing_skill_returns_null()

Task

[Fact]
public Task Saved_skill_is_read_back()

Task

Saving_the_same_name_again_increments_version()

Section titled “ Saving_the_same_name_again_increments_version()”
[Fact]
public Task Saving_the_same_name_again_increments_version()

Task

SeedAsync(string, string, CancellationToken)

Section titled “ SeedAsync(string, string, CancellationToken)”

Writes a sample record for the given tenant.

protected override ValueTask<object> SeedAsync(string tenantId, string name, CancellationToken cancellationToken)

tenantId string

The tenant that owns the record.

name string

The name distinguishing the record. The same name may be used by two tenants.

cancellationToken CancellationToken

The token every store call inside the hook must be handed. The cancellation contract calls this hook with a token that is already cancelled, so a hook that drops the token reports a store as sound when it is not.

ValueTask<object>

The key to use for reading the record back.

Attempts to delete the record on behalf of the given tenant.

protected override ValueTask<bool?> TryDeleteAsync(string tenantId, object key)

tenantId string

The tenant attempting the delete.

key object

The key returned by TenantIsolationContract.SeedAsync.

ValueTask<bool?>

true if the delete succeeded, false if the record was not found; null if the store does not offer deletion.