Add Persistence#bitemporal_at and ActiveRecord::Bitemporal.bitemporal_at

[wata727]

This PR introduces Persistence#bitemporal_at and ActiveRecord::Bitemporal.bitemporal_at, which help you set a valid time and a transaction time at the same time.

This is inspired by the already existing bitemporal_at scope and improves the consistency of the interface:

users = User.bitemporal_at("2024/01/01")
# => SELECT "users".*
#      FROM "users"
#     WHERE "users"."transaction_from" <= '2024-01-01 00:00:00'
#       AND "users"."transaction_to"   >  '2024-01-01 00:00:00'
#       AND "users"."valid_from"       <= '2024-01-01 00:00:00'
#       AND "users"."valid_to"         >  '2024-01-01 00:00:00'

user = users.first
user.bitemporal_at("2024/01/02") { _1.reload }
# => SELECT "users".*
#      FROM "users"
#     WHERE "users"."transaction_from" <= '2024-01-02 00:00:00'
#       AND "users"."transaction_to"   >  '2024-01-02 00:00:00'
#       AND "users"."valid_from"       <= '2024-01-02 00:00:00'
#       AND "users"."valid_to"         >  '2024-01-02 00:00:00'

ActiveRecord::Bitemporal.bitemporal_at("2024/01/03") { User.all }
# => SELECT "users".*
#      FROM "users"
#     WHERE "users"."transaction_from" <= '2024-01-03 00:00:00'
#       AND "users"."transaction_to"   >  '2024-01-03 00:00:00'
#       AND "users"."valid_from"       <= '2024-01-03 00:00:00'
#       AND "users"."valid_to"         >  '2024-01-03 00:00:00'

[Dooor]

🚀

[krororo]

Wouldn't it be better to use create_address ?
In the current code, the address.employee_id is updated after the Address is created.

Suggested change

	emp.address = Address.create(name: "Address")
	emp.create_address(name: "Address")

[wata727]

🤦 You're right.

[wata727]

Fixed https://github.com/kufu/activerecord-bitemporal/compare/8660a03f19d2f7c09d25ecd81175f2f24eaa8114..7d7cb6df0757eb1950ca0d3d7506f999e2316aae

[krororo]

LGTM!