openmeter 1.0.0b97__py3-none-any.whl → 1.0.0b99__py3-none-any.whl

openmeter/_operations/_operations.py

@@ -719,8 +719,8 @@ def build_get_entitlement_history_request(
     subject_id_or_key: str,
     entitlement_id: str,
     *,
-    from_parameter: datetime.datetime,
     window_size: str,
+    from_parameter: Optional[datetime.datetime] = None,
     to: Optional[datetime.datetime] = None,
     window_time_zone: str = "UTC",
     **kwargs: Any
@@ -740,7 +740,8 @@ def build_get_entitlement_history_request(
     _url: str = _url.format(**path_format_arguments)  # type: ignore
 
     # Construct parameters
-    _params["from"] = _SERIALIZER.query("from_parameter", from_parameter, "iso-8601")
+    if from_parameter is not None:
+        _params["from"] = _SERIALIZER.query("from_parameter", from_parameter, "iso-8601")
     if to is not None:
         _params["to"] = _SERIALIZER.query("to", to, "iso-8601")
     _params["windowSize"] = _SERIALIZER.query("window_size", window_size, "str")
@@ -3177,14 +3178,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                           was last updated. Required.
                         "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date
                           of the grant.
-                        "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum
-                          amount of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                          {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover
-                          * maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's
-                          balance will be the MAX(maxRollover, balance) + amount.
+                        "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "metadata": {
                             "str": "str"  # Optional. Dictionary of :code:`<string>`.
                         },
+                        "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time
                           the grant will recurr.
                         "priority": 1,  # Optional. Default value is 1. The priority of the
@@ -3765,14 +3771,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                           was last updated. Required.
                         "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date
                           of the grant.
-                        "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum
-                          amount of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                          {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover
-                          * maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's
-                          balance will be the MAX(maxRollover, balance) + amount.
+                        "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "metadata": {
                             "str": "str"  # Optional. Dictionary of :code:`<string>`.
                         },
+                        "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time
                           the grant will recurr.
                         "priority": 1,  # Optional. Default value is 1. The priority of the
@@ -3884,14 +3895,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                         "duration": "str"  # The expiration period duration like month.
                           Required. Known values are: "HOUR", "DAY", "WEEK", "MONTH", and "YEAR".
                     },
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
                       Grants with higher priority are applied first. Priority is a positive decimal
                       numbers. With lower numbers indicating higher importance. For example, a priority
@@ -3933,14 +3949,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                       last updated. Required.
                     "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date of the
                       grant.
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time the grant
                       will recurr.
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
@@ -4017,14 +4038,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                       last updated. Required.
                     "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date of the
                       grant.
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time the grant
                       will recurr.
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
@@ -4081,14 +4107,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                         "duration": "str"  # The expiration period duration like month.
                           Required. Known values are: "HOUR", "DAY", "WEEK", "MONTH", and "YEAR".
                     },
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
                       Grants with higher priority are applied first. Priority is a positive decimal
                       numbers. With lower numbers indicating higher importance. For example, a priority
@@ -4130,14 +4161,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                       last updated. Required.
                     "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date of the
                       grant.
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time the grant
                       will recurr.
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
@@ -4311,8 +4347,8 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
         subject_id_or_key: str,
         entitlement_id: str,
         *,
-        from_parameter: datetime.datetime,
         window_size: str,
+        from_parameter: Optional[datetime.datetime] = None,
         to: Optional[datetime.datetime] = None,
         window_time_zone: str = "UTC",
         **kwargs: Any
@@ -4329,13 +4365,14 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
         :type subject_id_or_key: str
         :param entitlement_id: A unique ULID for an entitlement. Required.
         :type entitlement_id: str
-        :keyword from_parameter: Start of time range to query entitlement: date-time in RFC 3339
-         format.
-         Gets truncated to the granularity of the underlying meter. Required.
-        :paramtype from_parameter: ~datetime.datetime
         :keyword window_size: Size of the time window to group the history by. Cannot be shorter than
          meter granularity. Known values are: "MINUTE", "HOUR", and "DAY". Required.
         :paramtype window_size: str
+        :keyword from_parameter: Start of time range to query entitlement: date-time in RFC 3339
+         format. Defaults to
+         the last reset.
+         Gets truncated to the granularity of the underlying meter. Default value is None.
+        :paramtype from_parameter: ~datetime.datetime
         :keyword to: End of time range to query entitlement: date-time in RFC 3339 format. Defaults to
          now.
          If not now then gets truncated to the granularity of the underlying meter. Default value is
@@ -4421,8 +4458,8 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
         _request = build_get_entitlement_history_request(
             subject_id_or_key=subject_id_or_key,
             entitlement_id=entitlement_id,
-            from_parameter=from_parameter,
             window_size=window_size,
+            from_parameter=from_parameter,
             to=to,
             window_time_zone=window_time_zone,
             headers=_headers,

openmeter/aio/_operations/_operations.py

@@ -2476,14 +2476,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                           was last updated. Required.
                         "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date
                           of the grant.
-                        "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum
-                          amount of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                          {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover
-                          * maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's
-                          balance will be the MAX(maxRollover, balance) + amount.
+                        "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "metadata": {
                             "str": "str"  # Optional. Dictionary of :code:`<string>`.
                         },
+                        "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time
                           the grant will recurr.
                         "priority": 1,  # Optional. Default value is 1. The priority of the
@@ -3064,14 +3069,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                           was last updated. Required.
                         "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date
                           of the grant.
-                        "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum
-                          amount of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                          {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover
-                          * maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's
-                          balance will be the MAX(maxRollover, balance) + amount.
+                        "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "metadata": {
                             "str": "str"  # Optional. Dictionary of :code:`<string>`.
                         },
+                        "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are
+                          rolled over at reset, after which they can have a different balance compared
+                          to what they had before the reset.  Balance after the reset is calculated as:
+                          Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                          MinRolloverAmount)).
                         "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time
                           the grant will recurr.
                         "priority": 1,  # Optional. Default value is 1. The priority of the
@@ -3183,14 +3193,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                         "duration": "str"  # The expiration period duration like month.
                           Required. Known values are: "HOUR", "DAY", "WEEK", "MONTH", and "YEAR".
                     },
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
                       Grants with higher priority are applied first. Priority is a positive decimal
                       numbers. With lower numbers indicating higher importance. For example, a priority
@@ -3232,14 +3247,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                       last updated. Required.
                     "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date of the
                       grant.
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time the grant
                       will recurr.
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
@@ -3316,14 +3336,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                       last updated. Required.
                     "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date of the
                       grant.
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time the grant
                       will recurr.
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
@@ -3380,14 +3405,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                         "duration": "str"  # The expiration period duration like month.
                           Required. Known values are: "HOUR", "DAY", "WEEK", "MONTH", and "YEAR".
                     },
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
                       Grants with higher priority are applied first. Priority is a positive decimal
                       numbers. With lower numbers indicating higher importance. For example, a priority
@@ -3429,14 +3459,19 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
                       last updated. Required.
                     "expiresAt": "2020-02-20 00:00:00",  # Optional. The expiration date of the
                       grant.
-                    "maxRolloverAmount": 0,  # Optional. Default value is 0. The maximum amount
-                      of the grant that can be rolled over. Defaults to 0.   * maxAmount =
-                      {original_amount} -> rollover original amount * maxAmount = 0 -> no rollover *
-                      maxAmount = 90 -> rollover 90 max  If it's larger than 0 then the grant's balance
-                      will be the MAX(maxRollover, balance) + amount.
+                    "maxRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "metadata": {
                         "str": "str"  # Optional. Dictionary of :code:`<string>`.
                     },
+                    "minRolloverAmount": 0,  # Optional. Default value is 0. Grants are rolled
+                      over at reset, after which they can have a different balance compared to what
+                      they had before the reset.  Balance after the reset is calculated as:
+                      Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset,
+                      MinRolloverAmount)).
                     "nextRecurrence": "2020-02-20 00:00:00",  # Optional. The next time the grant
                       will recurr.
                     "priority": 1,  # Optional. Default value is 1. The priority of the grant.
@@ -3610,8 +3645,8 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
         subject_id_or_key: str,
         entitlement_id: str,
         *,
-        from_parameter: datetime.datetime,
         window_size: str,
+        from_parameter: Optional[datetime.datetime] = None,
         to: Optional[datetime.datetime] = None,
         window_time_zone: str = "UTC",
         **kwargs: Any
@@ -3628,13 +3663,14 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
         :type subject_id_or_key: str
         :param entitlement_id: A unique ULID for an entitlement. Required.
         :type entitlement_id: str
-        :keyword from_parameter: Start of time range to query entitlement: date-time in RFC 3339
-         format.
-         Gets truncated to the granularity of the underlying meter. Required.
-        :paramtype from_parameter: ~datetime.datetime
         :keyword window_size: Size of the time window to group the history by. Cannot be shorter than
          meter granularity. Known values are: "MINUTE", "HOUR", and "DAY". Required.
         :paramtype window_size: str
+        :keyword from_parameter: Start of time range to query entitlement: date-time in RFC 3339
+         format. Defaults to
+         the last reset.
+         Gets truncated to the granularity of the underlying meter. Default value is None.
+        :paramtype from_parameter: ~datetime.datetime
         :keyword to: End of time range to query entitlement: date-time in RFC 3339 format. Defaults to
          now.
          If not now then gets truncated to the granularity of the underlying meter. Default value is
@@ -3720,8 +3756,8 @@ class ClientOperationsMixin(ClientMixinABC):  # pylint: disable=too-many-public-
         _request = build_get_entitlement_history_request(
             subject_id_or_key=subject_id_or_key,
             entitlement_id=entitlement_id,
-            from_parameter=from_parameter,
             window_size=window_size,
+            from_parameter=from_parameter,
             to=to,
             window_time_zone=window_time_zone,
             headers=_headers,

{openmeter-1.0.0b97.dist-info → openmeter-1.0.0b99.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: openmeter
-Version: 1.0.0b97
+Version: 1.0.0b99
 Summary: Client for OpenMeter: Real-Time and Scalable Usage Metering
 Home-page: https://openmeter.io
 License: Apache-2.0

{openmeter-1.0.0b97.dist-info → openmeter-1.0.0b99.dist-info}/RECORD

@@ -2,7 +2,7 @@ openmeter/__init__.py,sha256=7klRT7LAGDqBcZsl7LGZrgrABVwyncgVUlidfaPiJm4,702
 openmeter/_client.py,sha256=TIXIPi_UVO-d5BHra7_xIiKmLfZBrmc4L_Xq2gxi4lM,3982
 openmeter/_configuration.py,sha256=CIdMxPaIXwDLaCsnvmdmHTfplV_cRp24101RJCEWtes,1807
 openmeter/_operations/__init__.py,sha256=GVYObnS1nT-wbN8ONRxlAiH6NBeAXlOBi7olGJE9niA,682
-openmeter/_operations/_operations.py,sha256=YJMu82fQvF9qBz9LH13IgELdvfxRByqIMJBkB1ogay8,197546
+openmeter/_operations/_operations.py,sha256=UURUKik4RHiZxRJz7_Tx1bOsh3UIjzWSr4a8k_oC-zs,200397
 openmeter/_operations/_patch.py,sha256=ptSL-JhY1fbGT9Cw2cUkPF1TPz5qVgXwTMMT5h41XUc,4874
 openmeter/_patch.py,sha256=P7PMm3Gbjlk56lI6B_Ra43hSW5qGMEmN3cNYGH5uZ3s,674
 openmeter/_serialization.py,sha256=vQIv-wuCQabtiIq2DXOr7-InGADqxlXTGNEKv9OlDPs,78873
@@ -11,11 +11,11 @@ openmeter/aio/__init__.py,sha256=7klRT7LAGDqBcZsl7LGZrgrABVwyncgVUlidfaPiJm4,702
 openmeter/aio/_client.py,sha256=O0VpMfw42UuTN_ZTIL3dw944PviLIrBBCSp7UaexyKQ,4100
 openmeter/aio/_configuration.py,sha256=NtT-cxQWkt8q_FvMfwqqil18Tt9zJmWGVju4U9s7OsE,1817
 openmeter/aio/_operations/__init__.py,sha256=GVYObnS1nT-wbN8ONRxlAiH6NBeAXlOBi7olGJE9niA,682
-openmeter/aio/_operations/_operations.py,sha256=7uKmS9fMm02ZHEw9_j9ZjdBxC6IWQdcJHF0R1vZh5m0,171834
+openmeter/aio/_operations/_operations.py,sha256=LaG_mTB_2rJAmAC5IJbAcxY9pXKdrD25fZo567WLWb0,174629
 openmeter/aio/_operations/_patch.py,sha256=P7PMm3Gbjlk56lI6B_Ra43hSW5qGMEmN3cNYGH5uZ3s,674
 openmeter/aio/_patch.py,sha256=P7PMm3Gbjlk56lI6B_Ra43hSW5qGMEmN3cNYGH5uZ3s,674
 openmeter/aio/_vendor.py,sha256=CFsSbXOBydpg_f_uciu6Pe6cvF__6ofZ6KFEhkaMMEU,862
 openmeter/py.typed,sha256=dcrsqJrcYfTX-ckLFJMTaj6mD8aDe2u0tkQG-ZYxnEg,26
-openmeter-1.0.0b97.dist-info/METADATA,sha256=wktgeW91BYFqolW6Oc_gy4rt6ZwjX2FC09oTgeqNnK8,2257
-openmeter-1.0.0b97.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-openmeter-1.0.0b97.dist-info/RECORD,,
+openmeter-1.0.0b99.dist-info/METADATA,sha256=kayAadV0YY0WVINqQlLeRwX8lwhLQn4pxSsMbdNaPPs,2257
+openmeter-1.0.0b99.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+openmeter-1.0.0b99.dist-info/RECORD,,