[WIP] write readme

[Copilot]

Analysis and README Creation Plan

• Explore repository structure and codebase
• Run tests to understand functionality
• Analyze core components and architecture
• Create comprehensive README with:
  • Overview and key features
  • Architecture explanation
  • Usage examples
  • Installation instructions
  • API reference
  • Development setup

Code Analysis Summary

Duron is a Python framework for running durable, fault-tolerant async functions. Key findings:

Core Components (~1070 lines of Python):

• TaskRunner: Orchestrates task execution with persistence
• EventLoop: Custom event loop for deterministic replay
• Context: API for running operations within tasks
• LogStorage: Persistent storage for task execution logs
• Codec: Serialization/deserialization for state and results

Key Features:

• Deterministic task execution with replay capability
• Fault tolerance through event logging
• Custom async event loop for precise control
• Support for Pydantic models
• Memory and file-based log storage

Test Coverage: 6 passing tests covering basic functionality, error handling, and Pydantic integration

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.