spulec/freezegun
Freezegun
Freezegun ist eine Python-Time-Mocking-Bibliothek und ein System-Clock-Emulator, der dazu verwendet wird, die Systemuhr auf ein festes Datum und eine feste Uhrzeit einzufrieren. Sie dient als Test-Utility, um sicherzustellen, dass zeitabhängige Logik während der Softwareverifizierung konsistente und vorhersagbare Ergebnisse liefert.
Die Bibliothek bietet einen Asyncio-kompatiblen Mock, der reale monotone Uhrwerte bewahrt, um zu verhindern, dass Event-Loops hängen bleiben, während andere Systemzeitfunktionen eingefroren bleiben. Sie unterstützt die Simulation des Zeitverlaufs durch manuelles Vorrücken der Uhr, Springen zu bestimmten Daten oder die Verwendung einer tickenden Uhr-Simulation, die die Zeit automatisch zwischen Aufrufen inkrementiert.
Das Tool enthält eine Mocking-Ausschlussliste, um zu verhindern, dass spezifische Bibliotheken abgefangen werden, wodurch sichergestellt wird, dass interne Abhängigkeiten und Drittanbieter-Integrationen stabil bleiben.
Features
- Time Mocking Libraries - Acts as a specialized Python library for freezing the system clock to ensure consistent test results.
- Asyncio Monotonic Clock Preservation - Maintains the real monotonic clock for asyncio event loops while keeping other system time functions frozen.
- Deterministic Testing Clocks - Provides deterministic testing by decoupling time measurement from the actual system clock.
- Monotonic Time Measurement - Preserves the real monotonic clock to ensure asyncio event loops remain functional while the wall-clock is frozen.
- Clock Overrides - Replaces the internal system clock with a custom, predictable time source.
- Asyncio Timing Simulation - Controls the system clock while maintaining the real monotonic clock to prevent asyncio event loops from stalling.
- Clock Freezing - Mocks the system clock to return a fixed date and time to ensure consistent, deterministic test outcomes.
- System Clock Mocks - Intercepts system-level clock calls to return predefined, frozen timestamps for testing.
- Time Simulation Utilities - Provides utility functions to intercept and control native timing for synchronous testing of asynchronous code.
- Manual Time Advancement - Freezegun enables moving the frozen clock forward by a specific increment or jumping to a designated date and time during test execution.
- Mocking Exclusions - Freezegun prevents specific libraries from having their time functions intercepted to avoid breaking internal dependencies and third-party integrations.
- Standard Library Monkey Patching - Overrides standard library time functions at runtime to replace them with mocked implementations.
- Dynamic Function Interception - Intercepts calls to the datetime and time modules to route them to a central mocked state.
- Ticking Clock Simulations - Simulates the continuous passage of time by automatically incrementing the mocked clock between calls.
- Mocking and Fixtures - Mocks the datetime module for time-based testing.
- Mocking Libraries - Time-travel testing by mocking date modules.
- Test-Frameworks - Mocks the system clock to test time-dependent logic.
- Testing Tools - Listed in the “Testing Tools” section of the Awesome Python awesome list.
