hccinfhir 0.2.2__tar.gz → 0.2.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/PKG-INFO +7 -5
  2. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/README.md +6 -4
  3. hccinfhir-0.2.4/hccinfhir/data/ph_race_and_ethnicity_cdc_v1.3.csv +1325 -0
  4. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/datamodels.py +123 -6
  5. hccinfhir-0.2.4/hccinfhir/extractor_834.py +756 -0
  6. hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_02.txt +1 -0
  7. hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_03.txt +1 -0
  8. hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_04.txt +1 -0
  9. hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_05.txt +1 -0
  10. hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_06.txt +1 -0
  11. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/utils.py +40 -0
  12. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/pyproject.toml +1 -1
  13. hccinfhir-0.2.2/hccinfhir/extractor_834.py +0 -511
  14. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/.gitignore +0 -0
  15. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/LICENSE +0 -0
  16. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/__init__.py +0 -0
  17. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/constants.py +0 -0
  18. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/__init__.py +0 -0
  19. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/hcc_is_chronic.csv +0 -0
  20. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/hcc_is_chronic_without_esrd_model.csv +0 -0
  21. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_coefficients_2025.csv +0 -0
  22. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_coefficients_2026.csv +0 -0
  23. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_dx_to_cc_2025.csv +0 -0
  24. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_dx_to_cc_2026.csv +0 -0
  25. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2023.csv +0 -0
  26. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2024.csv +0 -0
  27. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2025.csv +0 -0
  28. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2026.csv +0 -0
  29. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_hierarchies_2025.csv +0 -0
  30. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_hierarchies_2026.csv +0 -0
  31. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_labels_2026.csv +0 -0
  32. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/defaults.py +0 -0
  33. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/extractor.py +0 -0
  34. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/extractor_837.py +0 -0
  35. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/extractor_fhir.py +0 -0
  36. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/filter.py +0 -0
  37. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/hccinfhir.py +0 -0
  38. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_calculate.py +0 -0
  39. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_coefficients.py +0 -0
  40. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_demographics.py +0 -0
  41. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_dx_to_cc.py +0 -0
  42. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_hierarchies.py +0 -0
  43. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_interactions.py +0 -0
  44. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/__init__.py +0 -0
  45. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_834_01.txt +0 -0
  46. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_0.txt +0 -0
  47. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_1.txt +0 -0
  48. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_10.txt +0 -0
  49. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_11.txt +0 -0
  50. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_12.txt +0 -0
  51. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_2.txt +0 -0
  52. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_3.txt +0 -0
  53. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_4.txt +0 -0
  54. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_5.txt +0 -0
  55. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_6.txt +0 -0
  56. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_7.txt +0 -0
  57. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_8.txt +0 -0
  58. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_9.txt +0 -0
  59. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_1.json +0 -0
  60. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_2.json +0 -0
  61. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_200.ndjson +0 -0
  62. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_3.json +0 -0
  63. {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/samples.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: hccinfhir
3
- Version: 0.2.2
3
+ Version: 0.2.4
4
4
  Summary: HCC Algorithm for FHIR Resources
5
5
  Project-URL: Homepage, https://github.com/mimilabs/hccinfhir
6
6
  Project-URL: Issues, https://github.com/mimilabs/hccinfhir/issues
@@ -80,7 +80,7 @@ print(f"HCCs: {result.hcc_list}")
80
80
  - **Custom Data Files**: Full support for custom coefficients, mappings, and hierarchies
81
81
  - **Flexible File Resolution**: Absolute paths, relative paths, or bundled data files
82
82
  - **Type-Safe**: Built on Pydantic with full type hints
83
- - **Well-Tested**: 181 comprehensive tests covering all features
83
+ - **Well-Tested**: 189 comprehensive tests covering all features
84
84
 
85
85
  ## 📊 Data Sources & Use Cases
86
86
 
@@ -95,6 +95,7 @@ print(f"HCCs: {result.hcc_list}")
95
95
  - **Use Case**: Extract dual eligibility status, detect Medicaid coverage loss
96
96
  - **Features**: California DHCS aid code mapping, Medicare status codes, coverage tracking
97
97
  - **Output**: Demographics with accurate dual eligibility for risk calculations
98
+ - **Architecture**: See [834 Parsing Documentation](./README_PARSING834.md) for transaction structure and parsing logic
98
99
 
99
100
  ### 3. **FHIR ExplanationOfBenefit Resources**
100
101
  - **Input**: FHIR EOB from CMS Blue Button 2.0 / BCDA API
@@ -1037,8 +1038,8 @@ result = processor.run([eob], demographics) # Note: [eob] not eob
1037
1038
  claim = get_837_sample(0) # Cases 0-12 (returns string)
1038
1039
  claims = get_837_sample_list([0, 1, 2]) # Returns list
1039
1040
 
1040
- # X12 834 enrollment samples
1041
- enrollment_834 = get_834_sample(1) # Currently only case 1 available (returns string)
1041
+ # X12 834 enrollment samples (6 CA DHCS scenarios)
1042
+ enrollment_834 = get_834_sample(1) # Cases 1-6 available (returns string)
1042
1043
 
1043
1044
  # List all available samples
1044
1045
  info = list_available_samples()
@@ -1056,7 +1057,7 @@ hatch shell
1056
1057
  # Install in development mode
1057
1058
  pip install -e .
1058
1059
 
1059
- # Run all tests (181 tests)
1060
+ # Run all tests (189 tests)
1060
1061
  pytest tests/
1061
1062
 
1062
1063
  # Run specific test file
@@ -1073,6 +1074,7 @@ Apache License 2.0. See [LICENSE](LICENSE) for details.
1073
1074
  ## 📞 Support
1074
1075
 
1075
1076
  - **Claude Code Documentation**: [CLAUDE.md](./CLAUDE.md) - Comprehensive developer guide
1077
+ - **834 Parsing Architecture**: [README_PARSING834.md](./README_PARSING834.md) - X12 834 transaction structure and parsing logic
1076
1078
  - **Issues**: [GitHub Issues](https://github.com/mimilabs/hccinfhir/issues)
1077
1079
 
1078
1080
  ## 👥 Contributors
@@ -65,7 +65,7 @@ print(f"HCCs: {result.hcc_list}")
65
65
  - **Custom Data Files**: Full support for custom coefficients, mappings, and hierarchies
66
66
  - **Flexible File Resolution**: Absolute paths, relative paths, or bundled data files
67
67
  - **Type-Safe**: Built on Pydantic with full type hints
68
- - **Well-Tested**: 181 comprehensive tests covering all features
68
+ - **Well-Tested**: 189 comprehensive tests covering all features
69
69
 
70
70
  ## 📊 Data Sources & Use Cases
71
71
 
@@ -80,6 +80,7 @@ print(f"HCCs: {result.hcc_list}")
80
80
  - **Use Case**: Extract dual eligibility status, detect Medicaid coverage loss
81
81
  - **Features**: California DHCS aid code mapping, Medicare status codes, coverage tracking
82
82
  - **Output**: Demographics with accurate dual eligibility for risk calculations
83
+ - **Architecture**: See [834 Parsing Documentation](./README_PARSING834.md) for transaction structure and parsing logic
83
84
 
84
85
  ### 3. **FHIR ExplanationOfBenefit Resources**
85
86
  - **Input**: FHIR EOB from CMS Blue Button 2.0 / BCDA API
@@ -1022,8 +1023,8 @@ result = processor.run([eob], demographics) # Note: [eob] not eob
1022
1023
  claim = get_837_sample(0) # Cases 0-12 (returns string)
1023
1024
  claims = get_837_sample_list([0, 1, 2]) # Returns list
1024
1025
 
1025
- # X12 834 enrollment samples
1026
- enrollment_834 = get_834_sample(1) # Currently only case 1 available (returns string)
1026
+ # X12 834 enrollment samples (6 CA DHCS scenarios)
1027
+ enrollment_834 = get_834_sample(1) # Cases 1-6 available (returns string)
1027
1028
 
1028
1029
  # List all available samples
1029
1030
  info = list_available_samples()
@@ -1041,7 +1042,7 @@ hatch shell
1041
1042
  # Install in development mode
1042
1043
  pip install -e .
1043
1044
 
1044
- # Run all tests (181 tests)
1045
+ # Run all tests (189 tests)
1045
1046
  pytest tests/
1046
1047
 
1047
1048
  # Run specific test file
@@ -1058,6 +1059,7 @@ Apache License 2.0. See [LICENSE](LICENSE) for details.
1058
1059
  ## 📞 Support
1059
1060
 
1060
1061
  - **Claude Code Documentation**: [CLAUDE.md](./CLAUDE.md) - Comprehensive developer guide
1062
+ - **834 Parsing Architecture**: [README_PARSING834.md](./README_PARSING834.md) - X12 834 transaction structure and parsing logic
1061
1063
  - **Issues**: [GitHub Issues](https://github.com/mimilabs/hccinfhir/issues)
1062
1064
 
1063
1065
  ## 👥 Contributors