Feature/future past datetime methods

[rodrigobnogueira]

I have made things!

Checklist

• I'm sure that I did not unrelated changes in this pull request
• I have created at least one test case for the changes I have made
• I have updated the documentation for the changes I have made
• I have added my changes to the CHANGELOG.rst

Related issues

• Closes Add future and past providers to datetime #775

Description

Add methods to generate dates and datetimes relative to the current time for the Datetime provider:

Method	Description
future_date(days=30)	Random date between tomorrow and N days in the future
future_datetime(days=30, timezone=None)	Random datetime from now+1s to N days ahead
past_date(days=30)	Random date between N days ago and yesterday
past_datetime(days=30, timezone=None)	Random datetime from N days ago to now-1s

Usage Examples

from mimesis import Datetime

dt = Datetime()

# Future dates
dt.future_date()            # Random date 1-30 days from now
dt.future_date(days=7)      # Random date 1-7 days from now
dt.future_datetime()        # Random datetime 1s-30d from now
dt.future_datetime(timezone="Europe/Paris")

# Past dates
dt.past_date()              # Random date 1-30 days ago
dt.past_date(days=7)        # Random date 1-7 days ago
dt.past_datetime()          # Random datetime 1s-30d ago
dt.past_datetime(timezone="Europe/Paris")

Tests

All 8765 tests pass, including:

• Functional tests for all 4 methods (parameterized for different days values and timezones)
• Seeded reproducibility tests

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.92%. Comparing base (876b939) to head (73d1613).

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1693      +/-   ##
==========================================
+ Coverage   98.91%   98.92%   +0.01%     
==========================================
  Files          50       50              
  Lines        2114     2144      +30     
==========================================
+ Hits         2091     2121      +30     
  Misses         23       23              

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.