hccinfhir 0.1.1__tar.gz → 0.1.2__tar.gz

{hccinfhir-0.1.1 → hccinfhir-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hccinfhir
-Version: 0.1.1
+Version: 0.1.2
 Summary: HCC Algorithm for FHIR Resources
 Project-URL: Homepage, https://github.com/mimilabs/hccinfhir
 Project-URL: Issues, https://github.com/mimilabs/hccinfhir/issues
@@ -69,6 +69,34 @@ result = calculate_raf(
 
 For more details on the SLD format, see the `datamodels.py` file.
 
+## Sample Data
+
+The package includes comprehensive sample data for testing and demonstration purposes:
+
+```python
+from hccinfhir import (
+    get_eob_sample,
+    get_eob_sample_list,
+    get_837_sample,
+    get_837_sample_list,
+    list_available_samples
+)
+
+# Get individual EOB samples (cases 1, 2, or 3)
+eob_data = get_eob_sample(1)
+
+# Get multiple EOB samples (up to 200 available)
+eob_list = get_eob_sample_list(limit=10)
+
+# Get 837 claim samples (cases 0 through 11)
+claim_data = get_837_sample(0)
+
+# Get information about available samples
+info = list_available_samples()
+```
+
+For detailed usage examples, see the `examples/sample_data_usage.py` file.
+
 ## Core Components
 
 ### 1. Extractor Module
@@ -352,9 +380,10 @@ WHERE is_included = 'yes' AND YEAR(mimi_src_file_date) = 2025;
 Join us at [mimilabs](https://mimilabs.ai/signup). Reference data available in MIMILabs data lakehouse.
 
 ## Publishing (only for those maintainers...)
+Inside the hatch
 ```bash
-$ python3 -m hatch build
-$ python3 -m hatch publish
+$ hatch build
+$ hatch publish
 ```
 
 ## License

{hccinfhir-0.1.1 → hccinfhir-0.1.2}/README.md

@@ -55,6 +55,34 @@ result = calculate_raf(
 
 For more details on the SLD format, see the `datamodels.py` file.
 
+## Sample Data
+
+The package includes comprehensive sample data for testing and demonstration purposes:
+
+```python
+from hccinfhir import (
+    get_eob_sample,
+    get_eob_sample_list,
+    get_837_sample,
+    get_837_sample_list,
+    list_available_samples
+)
+
+# Get individual EOB samples (cases 1, 2, or 3)
+eob_data = get_eob_sample(1)
+
+# Get multiple EOB samples (up to 200 available)
+eob_list = get_eob_sample_list(limit=10)
+
+# Get 837 claim samples (cases 0 through 11)
+claim_data = get_837_sample(0)
+
+# Get information about available samples
+info = list_available_samples()
+```
+
+For detailed usage examples, see the `examples/sample_data_usage.py` file.
+
 ## Core Components
 
 ### 1. Extractor Module
@@ -338,9 +366,10 @@ WHERE is_included = 'yes' AND YEAR(mimi_src_file_date) = 2025;
 Join us at [mimilabs](https://mimilabs.ai/signup). Reference data available in MIMILabs data lakehouse.
 
 ## Publishing (only for those maintainers...)
+Inside the hatch
 ```bash
-$ python3 -m hatch build
-$ python3 -m hatch publish
+$ hatch build
+$ hatch publish
 ```
 
 ## License

hccinfhir-0.1.2/hccinfhir/__init__.py

@@ -0,0 +1,47 @@
+"""
+HCCInFHIR - HCC Algorithm for FHIR Resources
+
+A Python library for processing FHIR EOB resources and calculating HCC risk scores.
+"""
+
+# Main classes
+from .hccinfhir import HCCInFHIR
+from .extractor import extract_sld, extract_sld_list
+from .filter import apply_filter
+from .model_calculate import calculate_raf
+from .datamodels import Demographics, ServiceLevelData, RAFResult, ModelName
+
+# Sample data functions
+from .sample_utils import (
+    SampleData,
+    get_eob_sample,
+    get_eob_sample_list,
+    get_837_sample,
+    get_837_sample_list,
+    list_available_samples
+)
+
+__version__ = "0.1.2"
+__author__ = "Yubin Park"
+__email__ = "yubin.park@mimilabs.ai"
+
+__all__ = [
+    # Main classes
+    "HCCInFHIR",
+    "extract_sld",
+    "extract_sld_list", 
+    "apply_filter",
+    "calculate_raf",
+    "Demographics",
+    "ServiceLevelData",
+    "RAFResult",
+    "ModelName",
+    
+    # Sample data
+    "SampleData",
+    "get_eob_sample",
+    "get_eob_sample_list",
+    "get_837_sample",
+    "get_837_sample_list",
+    "list_available_samples"
+]