{"id":23664,"library":"efoli","title":"efoli - EDIFACT Enums for German Utilities","description":"Provides enums and helper functions modeling EDIFACT-relevant data for German utilities, including format versions, process types, and document types. Current version 2.3.0, requires Python >=3.9. Released under MIT license, maintained by Hochfrequenz. New releases appear every few months.","status":"active","version":"2.3.0","language":"python","source_language":"en","source_url":"https://github.com/Hochfrequenz/efoli","tags":["EDIFACT","enum","German utilities","format version","Hochfrequenz"],"install":[{"cmd":"pip install efoli","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"for timezone-aware date calculations","package":"pytz","optional":false}],"imports":[{"note":"Top-level import is recommended, enum moved in v2.0?","wrong":"from efoli.enums import EDIFACTFormatVersion","symbol":"EDIFACTFormatVersion","correct":"from efoli import EDIFACTFormatVersion"},{"note":"","wrong":"","symbol":"get_edifact_format_version_valid_from","correct":"from efoli import get_edifact_format_version_valid_from"}],"quickstart":{"code":"from efoli import EDIFACTFormatVersion, get_edifact_format_version_valid_from\n\nfv = EDIFACTFormatVersion.FV2504\nprint(fv)\nprint(get_edifact_format_version_valid_from(fv))","lang":"python","description":"Basic usage: import enum and helper, then call the function."},"warnings":[{"fix":"Update code if you relied on older mapping for 44xxx/55xxx document numbers.","message":"v2.0.0 broke UTILMDG/UTILMDS degeneracy: 44xxx now maps to UTILMDG, 55xxx to UTILMDS (not UTILMD).","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Use .value or str() to get the string; do not assume integer.","message":"Enum values like FV2504 have string representations (e.g., '2504'), not integers.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `from efoli import EDIFACTFormatVersion` (top-level).","cause":"Old import path after restructuring","error":"AttributeError: module 'efoli' has no attribute 'EDIFACTFormatVersion'"},{"fix":"Convert enum to string: `str(EDIFACTFormatVersion.FV2504)` or `fv.value`.","cause":"Passing enum value directly where a string is expected","error":"TypeError: expected string or bytes-like object"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}