usethatapp 2.2.0__tar.gz → 2.3.0__tar.gz

{usethatapp-2.2.0 → usethatapp-2.3.0}/CHANGELOG.md

@@ -6,6 +6,16 @@ format inspired by "Keep a Changelog".
 
 ## [Unreleased]
 
+## [2.3.0] - 2026-10-29
+
+### Added
+
+- `Entitlement.is_trial` and `LicenseState.is_trial`: true while the user is in a free
+  trial of a paid plan (entitled, nothing charged yet; `period_end` is the conversion
+  date). Explicit so integrations never string-match `status == "trialing"`. Both are
+  trailing fields with a `False` default, so positional construction and servers that
+  predate the field keep working.
+
 ## [2.2.0] - 2026-08-25
 
 ### Fixed (pre-release code review)

{usethatapp-2.2.0/usethatapp.egg-info → usethatapp-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usethatapp
-Version: 2.2.0
+Version: 2.3.0
 Summary: Python SDK for usethatapp.com — OpenID Connect login and live license entitlement queries.
 Author-email: UseThatApp <support@usethatapp.com>
 License-Expression: MIT
@@ -106,7 +106,7 @@ from usethatapp import (
     get_prices,         # () -> AppPrices      (anonymous public API)
     get_prices_async,
     UtaSession,         # sub, access_token, refresh_token, id_token, expires_at, ...
-    Entitlement,        # entitled, version, product_id, product_public_id, status, ...
+    Entitlement,        # entitled, version, product_id, product_public_id, status, is_trial, ...
     AppInfo,            # client_id, name, tagline, listing_mode, url, marketplace_url
     Price,              # public_id, product_id, product_name, amount, currency, ...
     AppPrices,          # client_id, app_name, has_free_tier, prices
@@ -186,6 +186,8 @@ your_db.save(user=current_user, license_key=order.license_key,
 # 2) Any time you need the truth (app start, feature gate, cron):
 state = validate_license_key(stored_key)      # LicenseState
 if state.entitled: ...                        # cache against state.period_end
+# state.is_trial: in a free trial — entitled, nothing charged yet, and
+# period_end is the conversion date. Show a banner; gate nothing extra.
 # canceled purchases return entitled=False, status="canceled" — an
 # answer, not an exception. UtaNotFoundError means a key that was
 # never issued for your app.

{usethatapp-2.2.0 → usethatapp-2.3.0}/README.md

@@ -73,7 +73,7 @@ from usethatapp import (
     get_prices,         # () -> AppPrices      (anonymous public API)
     get_prices_async,
     UtaSession,         # sub, access_token, refresh_token, id_token, expires_at, ...
-    Entitlement,        # entitled, version, product_id, product_public_id, status, ...
+    Entitlement,        # entitled, version, product_id, product_public_id, status, is_trial, ...
     AppInfo,            # client_id, name, tagline, listing_mode, url, marketplace_url
     Price,              # public_id, product_id, product_name, amount, currency, ...
     AppPrices,          # client_id, app_name, has_free_tier, prices
@@ -153,6 +153,8 @@ your_db.save(user=current_user, license_key=order.license_key,
 # 2) Any time you need the truth (app start, feature gate, cron):
 state = validate_license_key(stored_key)      # LicenseState
 if state.entitled: ...                        # cache against state.period_end
+# state.is_trial: in a free trial — entitled, nothing charged yet, and
+# period_end is the conversion date. Show a banner; gate nothing extra.
 # canceled purchases return entitled=False, status="canceled" — an
 # answer, not an exception. UtaNotFoundError means a key that was
 # never issued for your app.

{usethatapp-2.2.0 → usethatapp-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "usethatapp"
-version = "2.2.0"
+version = "2.3.0"
 description = "Python SDK for usethatapp.com — OpenID Connect login and live license entitlement queries."
 readme = { file = "README.md", content-type = "text/markdown" }
 authors = [{ name = "UseThatApp", email = "support@usethatapp.com"}]

{usethatapp-2.2.0 → usethatapp-2.3.0}/tests/test_client.py

@@ -148,9 +148,23 @@ def test_get_entitlement_licensed(oidc_routes):
     assert ent.entitled and ent.version == "Pro" and ent.product_id == "p-1"
     assert ent.product_public_id == "prod_abc123"
     assert ent.status == "active" and ent.is_free is False
+    assert ent.is_trial is False
     assert ent.period_end == "2026-07-01"
 
 
+def test_get_entitlement_trialing(oidc_routes):
+    oidc_routes.get(API_URL + "/licensing/entitlement/").mock(
+        return_value=httpx.Response(200, json={
+            "entitled": True, "version": "Pro", "product_id": "prod_abc",
+            "product_public_id": "prod_abc", "status": "trialing",
+            "is_free": False, "is_trial": True, "period_end": "2026-11-11",
+        })
+    )
+    ent = get_entitlement("at-123")
+    assert ent.entitled and ent.is_trial and ent.status == "trialing"
+    assert ent.period_end == "2026-11-11"
+
+
 def test_get_entitlement_free(oidc_routes):
     oidc_routes.get(API_URL + "/licensing/entitlement/").mock(
         return_value=httpx.Response(200, json={

{usethatapp-2.2.0 → usethatapp-2.3.0}/tests/test_license_keys.py

@@ -44,6 +44,7 @@ def test_validate_sends_client_credentials(respx_mock):
     )
     state = validate_license_key("key_abc")
     assert state.entitled and state.status == "active"
+    assert state.is_trial is False
     assert state.license_id == STATE["license_id"]
     assert state.license_key is None
     request = route.calls.last.request

{usethatapp-2.2.0 → usethatapp-2.3.0}/usethatapp/__init__.py

@@ -67,7 +67,7 @@ from .types import (
     UtaSession,
 )
 
-__version__ = "2.2.0"
+__version__ = "2.3.0"
 
 __all__ = [
     "__version__",

{usethatapp-2.2.0 → usethatapp-2.3.0}/usethatapp/client.py

@@ -694,6 +694,7 @@ def _parse_entitlement(data: Mapping[str, Any]) -> Entitlement:
         period_end=data.get("period_end"),
         product_public_id=data.get("product_public_id"),
         raw=dict(data),
+        is_trial=bool(data.get("is_trial", False)),
     )
 
 
@@ -870,6 +871,7 @@ def _parse_license_state(data: Mapping[str, Any]) -> LicenseState:
         canceled_at=data.get("canceled_at"),
         license_key=data.get("license_key"),
         rotated_at=data.get("rotated_at"),
+        is_trial=bool(data.get("is_trial", False)),
         # Alias pair: fall back to product_public_id against a server
         # that predates the identifier cutover.
         product_id=str(

{usethatapp-2.2.0 → usethatapp-2.3.0}/usethatapp/types.py

@@ -87,6 +87,15 @@ class Entitlement:
     :attr:`Price.product_id` from the pricing API. New integrations should
     gate on this field."""
 
+    is_trial: bool = False
+    """True while the user is in a free trial of a paid plan: entitled to
+    the plan's real functionality, nothing charged yet. While true,
+    :attr:`period_end` is the date the trial converts (the first charge).
+    A canceled trial keeps ``entitled`` until that date and then drops it
+    — never cache past ``period_end``. Explicit so you never string-match
+    :attr:`status`. Trailing with a default (see the note above) so
+    positional construction predating it still works."""
+
 
 @dataclass(frozen=True)
 class AppInfo:
@@ -211,3 +220,7 @@ class LicenseState:
     gating code works identically in both verification modes. Trailing
     with a default so positional construction predating it still
     works."""
+
+    is_trial: bool = False
+    """True while the license is in its free trial — see
+    :attr:`Entitlement.is_trial`."""

{usethatapp-2.2.0 → usethatapp-2.3.0/usethatapp.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usethatapp
-Version: 2.2.0
+Version: 2.3.0
 Summary: Python SDK for usethatapp.com — OpenID Connect login and live license entitlement queries.
 Author-email: UseThatApp <support@usethatapp.com>
 License-Expression: MIT
@@ -106,7 +106,7 @@ from usethatapp import (
     get_prices,         # () -> AppPrices      (anonymous public API)
     get_prices_async,
     UtaSession,         # sub, access_token, refresh_token, id_token, expires_at, ...
-    Entitlement,        # entitled, version, product_id, product_public_id, status, ...
+    Entitlement,        # entitled, version, product_id, product_public_id, status, is_trial, ...
     AppInfo,            # client_id, name, tagline, listing_mode, url, marketplace_url
     Price,              # public_id, product_id, product_name, amount, currency, ...
     AppPrices,          # client_id, app_name, has_free_tier, prices
@@ -186,6 +186,8 @@ your_db.save(user=current_user, license_key=order.license_key,
 # 2) Any time you need the truth (app start, feature gate, cron):
 state = validate_license_key(stored_key)      # LicenseState
 if state.entitled: ...                        # cache against state.period_end
+# state.is_trial: in a free trial — entitled, nothing charged yet, and
+# period_end is the conversion date. Show a banner; gate nothing extra.
 # canceled purchases return entitled=False, status="canceled" — an
 # answer, not an exception. UtaNotFoundError means a key that was
 # never issued for your app.