Padlock 1.0.0

<img src="https://github.com/jchristn/padlock/blob/main/assets/icon.ico?raw=true" alt="Padlock" width="128px" height="128px" />

Padlock

Description

Padlock is a lightweight, high-performance library that provides key-based locking for multithreaded applications. It enables granular locking on specific resources identified by keys of any type, allowing for efficient concurrency control without unnecessary blocking.

Core features:

• Create locks based on any key type (string, int, GUID, custom objects, etc.)
• Support for both synchronous and asynchronous locking patterns
• Efficient memory usage with automatic resource cleanup
• Cancellation support via standard CancellationToken
• Simple, intuitive API with IDisposable pattern for lock release

Simple Example

using System;
using System.Threading;
using System.Threading.Tasks;
using Padlocks;

var padlock = new Padlock<string>(); // using string keys

using (padlock.Lock("resource1")) // synchronous
{
    Console.WriteLine("Resource 1 is locked and being accessed");
}

await Task.Run(async () => // asynchronous
{
    using (await padlock.LockAsync("resource2"))
    {
        Console.WriteLine("Resource 2 is locked and being accessed");
    }
});

var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
try
{
    using (await padlock.LockAsync("resource3", cts.Token))
    {
        Console.WriteLine("Resource 3 is locked and being accessed");
    }
}
catch (OperationCanceledException)
{
    Console.WriteLine("Lock acquisition was cancelled");
}

bool isLocked = padlock.IsLocked("resource1");
Console.WriteLine($"Resource 1 is {(isLocked ? "locked" : "available")}");

Padlock supports mixing both synchronous and asynchronous lock operations on the same resource:

Lock With Custom Types

Padlock works with any type that properly implements equality comparison:

// Custom type with custom equality logic
public class ResourceKey : IEquatable<ResourceKey>
{
    public string Name { get; }
    public int Id { get; }

    public ResourceKey(string name, int id)
    {
        Name = name;
        Id = id;
    }

    public bool Equals(ResourceKey other)
    {
        if (other is null) return false;
        return Name == other.Name && Id == other.Id;
    }

    public override bool Equals(object obj)
    {
        return obj is ResourceKey key && Equals(key);
    }

    public override int GetHashCode()
    {
        return HashCode.Combine(Name, Id);
    }
}

var padlock = new Padlock<ResourceKey>();
var resourceKey = new ResourceKey("UserProfile", 42);

using (padlock.Lock(resourceKey))
{
    Console.WriteLine("Resource is locked and being accessed");
}

Performance

Padlock is designed for high performance with minimal overhead:

• Uses SemaphoreSlim for efficient lock management
• Automatically cleans up unused lock objects to reduce memory usage
• Avoids unnecessary blocking when possible
• Handles high-contention scenarios gracefully

Installation

Install-Package Padlock

Or via the .NET CLI:

dotnet add package Padlock

Version History

Refer to CHANGELOG.md.

Icon

Many thanks to Vector Stall for creating the icon.