fix: close claim spelling variants (#85)

Author: karlwaldman

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.12.3] - 2026-08-11
+
+### Fixed
+
+- Match hyphenated free-tier wording and universal catalog claims in every
+  readable wheel surface, and replace the remaining packaged docstrings with
+  current-account and runtime-response terminology.
+
 ## [1.12.2] - 2026-08-11
 
 ### Fixed

EXAMPLES.md

@@ -629,7 +629,7 @@ Ready to build with these examples?
 ## 📖 More Resources
 
 - **[Complete API Documentation](https://docs.oilpriceapi.com)** - Full REST API reference
-- **[Available Commodities](https://docs.oilpriceapi.com/commodities)** - List of all supported commodities
+- **[Available Commodities](https://docs.oilpriceapi.com/commodities)** - Query the current commodity catalog
 - **[GitHub Repository](https://github.com/oilpriceapi/python-sdk)** - Source code and issues
 - **[Support](mailto:support@oilpriceapi.com)** - Get help from our team
 

docs/DATAFRAMES.md

@@ -54,8 +54,8 @@ It accepts the same `per_page` range and automatically fetches every page.
 
 ## Current prices
 
-Calling `client.prices.to_dataframe()` with no commodity returns all current
-prices and automatically follows the API's pagination headers:
+Calling `client.prices.to_dataframe()` with no commodity returns the current
+price records available to the account and follows the API's pagination headers:
 
 ```python
 df = client.prices.to_dataframe(per_page=250)

docs/index.md

@@ -49,7 +49,7 @@ prices = client.prices.get_multiple([
 ])
 ```
 
-**[View all available commodities →](https://docs.oilpriceapi.com/commodities)**
+**[View the current commodity catalog →](https://docs.oilpriceapi.com/commodities)**
 
 ### Historical Data
 

oilpriceapi/async_client.py

@@ -429,7 +429,7 @@ async def get_multiple(
         return prices
 
     async def get_all(self) -> List[Price]:
-        """Get all available prices."""
+        """Get price records available to the current account."""
         response = await self.client.request(method="GET", path="/v1/prices/all")
 
         if isinstance(response, dict) and "data" in response:

oilpriceapi/resources/bunker_fuels.py

@@ -22,10 +22,10 @@ def __init__(self, client):
         self.client = client
 
     def all(self) -> List[Dict[str, Any]]:
-        """Get all bunker fuel prices.
+        """Get the available bunker fuel price records.
 
         Returns:
-            List of bunker fuel prices across all ports
+            List of bunker fuel price records returned by the API
 
         Example:
             >>> bunker_prices = client.bunker_fuels.all()

oilpriceapi/resources/commodities.py

@@ -21,7 +21,7 @@ def __init__(self, client):
         self.client = client
 
     def list(self) -> List[Dict[str, Any]]:
-        """Get list of all available commodities.
+        """Get commodities available to the current account.
 
         Returns:
             List of commodity objects with code, name, and metadata

oilpriceapi/resources/data_quality.py

@@ -22,7 +22,7 @@ def summary(self) -> Dict[str, Any]:
         """Get data quality summary.
 
         Returns:
-            Summary of data quality metrics across all commodities
+            Summary of data quality metrics returned by the API
 
         Example:
             >>> summary = client.data_quality.summary()
@@ -41,10 +41,10 @@ def summary(self) -> Dict[str, Any]:
         return response
 
     def reports(self) -> List[Dict[str, Any]]:
-        """Get all data quality reports.
+        """Get the available data quality reports.
 
         Returns:
-            List of data quality reports for all commodities
+            List of data quality reports returned by the API
 
         Example:
             >>> reports = client.data_quality.reports()

oilpriceapi/resources/demo.py

@@ -2,8 +2,8 @@
 Demo Resource
 
 Public, no-authentication demo endpoints (``/v1/demo/*``). These power the
-"time to first call" experience: a developer can fetch real free-tier prices
-and the full commodity catalog without an API key.
+"time to first call" experience: a developer can fetch the current demo price
+set and catalog metadata without an API key.
 
 The demo endpoints ignore authentication entirely, so :class:`DemoResource`
 works both as an attribute of an authenticated client (``client.demo``) and
@@ -68,11 +68,11 @@ def _get(self, path: str) -> Dict[str, Any]:
         return data
 
     def prices(self, codes: Optional[List[str]] = None) -> Dict[str, Any]:
-        """Get latest demo prices for free-tier commodities.
+        """Get the latest price records currently exposed by the demo endpoint.
 
         Args:
             codes: Optional list of commodity codes to request. When omitted,
-                the API returns all free-tier commodities.
+                the API returns its current demo set.
 
         Returns:
             The ``data`` payload: ``{"prices": [...], "meta": {...}, "examples": {...}}``.
@@ -85,7 +85,7 @@ def prices(self, codes: Optional[List[str]] = None) -> Dict[str, Any]:
         return data
 
     def commodities(self) -> Dict[str, Any]:
-        """Get the full demo commodity catalog grouped by category.
+        """Get current demo commodity metadata grouped by category.
 
         Returns:
             The ``data`` payload: ``{"commodities": {category: [...]}, "meta": {...}}``.

oilpriceapi/resources/prices.py

@@ -108,16 +108,16 @@ def get_multiple(
         return prices
 
     def get_all(self, per_page: int = 100) -> List[Price]:
-        """Get current prices for all available commodities.
+        """Get current price records available to the account.
 
-        Auto-paginates using X-Has-Next response headers until all records
-        are retrieved.
+        Auto-paginates using X-Has-Next response headers until the API reports
+        no additional records.
 
         Args:
             per_page: Number of records per page (default 100, matches API default)
 
         Returns:
-            List of Price objects for all commodities
+            List of Price objects returned for the current account
 
         Example:
             >>> all_prices = client.prices.get_all()