Update CHANGELOG for v0.2.0: add parameters to concepts.get_by_code() for synonyms and relationships, and update User-Agent header format.

Author: alex-omophub

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2025-12-09
+
+### Added
+
+- `include_synonyms` and `include_relationships` parameters to `concepts.get_by_code()` method for retrieving concept synonyms and relationships in a single request.
+
+### Changed
+
+- User-Agent header updated to `OMOPHub-SDK-Python/{version}`.
+
 ## [0.1.0] - 2025-12-01
 
 ### Added
@@ -27,5 +37,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Full type hints and PEP 561 compliance
 - HTTP/2 support via httpx
 
-[Unreleased]: https://github.com/omopHub/omophub-python/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/omopHub/omophub-python/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/omopHub/omophub-python/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/omopHub/omophub-python/releases/tag/v0.1.0

src/omophub/_http.py

@@ -103,7 +103,7 @@ def _get_default_headers(self) -> dict[str, str]:
         return {
             "Accept": "application/json",
             "Content-Type": "application/json",
-            "User-Agent": f"omophub-python/{get_version()}",
+            "User-Agent": f"OMOPHub-SDK-Python/{get_version()}",
         }
 
     def request(
@@ -186,7 +186,7 @@ def _get_default_headers(self) -> dict[str, str]:
         return {
             "Accept": "application/json",
             "Content-Type": "application/json",
-            "User-Agent": f"omophub-python/{get_version()}",
+            "User-Agent": f"OMOPHub-SDK-Python/{get_version()}",
         }
 
     async def request(

src/omophub/resources/concepts.py

@@ -94,17 +94,31 @@ def get_by_code(
         self,
         vocabulary_id: str,
         concept_code: str,
+        *,
+        include_relationships: bool = False,
+        include_synonyms: bool = False,
     ) -> Concept:
         """Get a concept by vocabulary and code.
 
         Args:
             vocabulary_id: The vocabulary ID (e.g., "SNOMED", "ICD10CM")
             concept_code: The concept code within the vocabulary
+            include_relationships: Include related concepts
+            include_synonyms: Include concept synonyms
 
         Returns:
-            The concept data with mappings
+            The concept data with optional relationships and synonyms
         """
-        return self._request.get(f"/concepts/by-code/{vocabulary_id}/{concept_code}")
+        params: dict[str, Any] = {}
+        if include_relationships:
+            params["include_relationships"] = "true"
+        if include_synonyms:
+            params["include_synonyms"] = "true"
+
+        return self._request.get(
+            f"/concepts/by-code/{vocabulary_id}/{concept_code}",
+            params=params or None,
+        )
 
     def batch(
         self,
@@ -274,10 +288,30 @@ async def get_by_code(
         self,
         vocabulary_id: str,
         concept_code: str,
+        *,
+        include_relationships: bool = False,
+        include_synonyms: bool = False,
     ) -> Concept:
-        """Get a concept by vocabulary and code."""
+        """Get a concept by vocabulary and code.
+
+        Args:
+            vocabulary_id: The vocabulary ID (e.g., "SNOMED", "ICD10CM")
+            concept_code: The concept code within the vocabulary
+            include_relationships: Include related concepts
+            include_synonyms: Include concept synonyms
+
+        Returns:
+            The concept data with optional relationships and synonyms
+        """
+        params: dict[str, Any] = {}
+        if include_relationships:
+            params["include_relationships"] = "true"
+        if include_synonyms:
+            params["include_synonyms"] = "true"
+
         return await self._request.get(
-            f"/concepts/by-code/{vocabulary_id}/{concept_code}"
+            f"/concepts/by-code/{vocabulary_id}/{concept_code}",
+            params=params or None,
         )
 
     async def batch(

tests/conftest.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import os
+import time
 from typing import Any
 
 import pytest
@@ -135,6 +136,15 @@ def mock_error_response() -> dict[str, Any]:
     }
 
 
+@pytest.fixture(autouse=True)
+def rate_limit_delay(request: pytest.FixtureRequest) -> None:
+    """Add delay between integration tests to avoid rate limiting."""
+    yield
+    # Only delay for integration tests
+    if "integration" in request.keywords:
+        time.sleep(1)
+
+
 # Well-known test concept IDs for integration tests
 DIABETES_CONCEPT_ID = 201826  # Type 2 diabetes mellitus (SNOMED)
 ASPIRIN_CONCEPT_ID = 1112807  # Aspirin (RxNorm)

tests/unit/test_http.py

@@ -201,7 +201,7 @@ def test_default_headers(self) -> None:
         assert "Content-Type" in headers
         assert headers["Content-Type"] == "application/json"
         assert "User-Agent" in headers
-        assert "omophub-python" in headers["User-Agent"]
+        assert "OMOPHub-SDK-Python" in headers["User-Agent"]
 
         client.close()
 
@@ -350,7 +350,7 @@ async def test_default_headers(self) -> None:
         assert "Accept" in headers
         assert headers["Accept"] == "application/json"
         assert "User-Agent" in headers
-        assert "omophub-python" in headers["User-Agent"]
+        assert "OMOPHub-SDK-Python" in headers["User-Agent"]
 
         await client.close()