https://github.com/connorbritain/hl7parser
HL7 Local Parser is an open-source, cross-platform application designed to parse HL7 messages on any system (Windows, macOS, or Linux) without persisting protected health information (PHI). This project aims to make it easy to view and inspect the structure and contents of HL7 messages in a transient manner, ensuring privacy and security.
https://github.com/connorbritain/hl7parser
Last synced: over 1 year ago
JSON representation
HL7 Local Parser is an open-source, cross-platform application designed to parse HL7 messages on any system (Windows, macOS, or Linux) without persisting protected health information (PHI). This project aims to make it easy to view and inspect the structure and contents of HL7 messages in a transient manner, ensuring privacy and security.
- Host: GitHub
- URL: https://github.com/connorbritain/hl7parser
- Owner: ConnorBritain
- Created: 2025-03-07T15:59:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-07T17:20:41.000Z (over 1 year ago)
- Last Synced: 2025-03-07T17:27:59.486Z (over 1 year ago)
- Language: Python
- Size: 20.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HL7 Parser
A cross-platform, privacy-focused HL7 message parser with GUI for viewing message structure.
## Features
- Parse HL7 messages into hierarchical structures
- View segments, fields, components, and subcomponents
- No data persistence - all processing happens in memory
- Cross-platform support (Windows, macOS, Linux)
- Simple export options with privacy warnings
## Installation
### Windows Installer
Download the latest installer from the releases page and run it to install HL7 Parser with all required dependencies.
### Quick Start (All Platforms)
```bash
# Clone repository
git clone https://github.com/ConnorBritain/hl7parser.git
cd hl7parser
# Install dependencies and run
python hl7parser.py install
python hl7parser.py
```
### Platform-Specific Scripts
The application includes platform-specific scripts for installation and running:
#### Windows
```
bin\install.py # Install dependencies
bin\run.py # Run the application
```
#### macOS/Linux
```
chmod +x bin/install.py bin/run.py
./bin/install.py # Install dependencies
./bin/run.py # Run the application
```
## Project Structure
- `/app.py` - Standalone application file (single-file version)
- `/bin/` - Platform-specific install/run scripts
- `/docs/` - Documentation
- `/examples/` - Sample HL7 messages
- `/packaging/` - Packaging scripts for different platforms
- `/windows/` - Windows packaging
- `/config/` - Configuration files
- `/scripts/` - Build scripts
- `/resources/` - Application resources (icons, etc.)
- `/src/` - Source code
- `/gui/` - UI components
- `/parser/` - HL7 parsing logic
- `/tests/` - Test files
## Building the Windows Installer
To create a standalone Windows executable with installer:
```bash
# Option 1: Using the unified script
python hl7parser.py build
# Option 2: Using the batch file directly
cd packaging/windows/scripts
build.bat
```
The installer will be created in the `dist/installer` directory. For detailed build instructions, see [docs/BUILD.md](docs/BUILD.md).
## Examples
Sample HL7 messages are provided in the `examples` directory.
## Privacy Warning
This tool may be used to process messages containing Protected Health Information (PHI).
Always handle such data in compliance with HIPAA regulations and your organization's policies.
HL7 Parser does not transmit any data over networks.
## License
MIT