Description

Extends the Store to support associating newly created shared objects with a Lifetime, and adds two Lifetime implementations: the ContextLifetime and LeasedLifetime.

The original issue for this PR (#482) discussed supporting lifetimes in the context of proxy references (e.g., OwnedProxy, RefProxy, and RefMutProxy), but after working through the implementation, I decided it was better to take the approach of lifetimes being an alternate to proxy references because proxy references already encode a notion of lifetime.

It would be interesting to unify these in the future, so I've opened another issue to track that.

A new guide, "Object Lifetimes," has been created which discusses differences between and gives examples of the three mechanisms in ProxyStore for managing objects.

Fixes

• Fixes Extend ownership model with custom lifetimes #482

Type of Change

• Breaking Change (fix or enhancement which changes existing semantics of the public interface)
• Enhancement (new features or improvements to existing functionality)
• Bug (fixes for a bug or issue)
• Internal (refactoring, style changes, testing, optimizations)
• Documentation update (changes to documentation or examples)
• Package (dependencies, versions, package metadata)
• Development (CI workflows, pre-commit, linters, templates)
• Security (security related changes)

Testing

Added new unit tests.

Pull Request Checklist

• I have read the Contributing and PR submission guides.

Please confirm the PR meets the following requirements.

• Tags added to PR (e.g., breaking, bug, enhancement, internal, documentation, package, development, security).
• Code changes pass pre-commit (e.g., mypy, ruff, etc.).
• Tests have been added to show the fix is effective or that the new feature works.
• New and existing unit tests pass locally with the changes.
• Docs have been updated and reviewed if relevant.