Homebrew Tap for Eurostep EXPRESS Parser (Eep)

Table of Contents

• Purpose
• Installation
  • Add the tap
  • Install eep
  • Verify installation
  • Update to latest version
• Supported Platforms
• How It Works
  • Automated Updates
  • Manual Formula Generation
• Repository Structure
• Development
  • Prerequisites
  • Setup
  • Testing
• Contributing
• License

Purpose

This repository provides a Homebrew tap for installing the Eurostep EXPRESS Parser (Eep) on macOS and Linux systems.

Eep is a command-line tool for working with EXPRESS schemas that enables EXPRESS models to be verified against the published EXPRESS language (ISO 10303-11:2004 or ISO 10303-11:1994).

Installation

Add the tap

brew tap expresslang/eep

Install eep

brew install eep

Verify installation

eep -h

Update to latest version

brew upgrade eep

Supported Platforms

The formula supports the following platforms:

• macOS (Apple Silicon)

• macOS (Intel)

• Linux (x86-64)

• Linux (ARM64)

The formula automatically detects your platform and installs the appropriate binary.

How It Works

Automated Updates

This tap is automatically updated when new Eep releases are published:

1. A new release is created in eep-releases

2. The release workflow triggers a repository_dispatch event to this repository

3. The update-formula.yml workflow runs generate-formula.rb to:

   • Download all platform binaries from the release

   • Calculate SHA256 checksums

   • Update formula-metadata.json

   • Generate Formula/eep.rb from the ERB template

4. A pull request is created with the updated formula

5. After review and merge, the new version is available via Homebrew

Manual Formula Generation

To manually update the formula (for testing or maintenance):

# Install dependencies
bundle install

# Generate formula for a specific version
bundle exec ruby generate-formula.rb --version v1.4.45

# Dry run (preview changes without writing files)
bundle exec ruby generate-formula.rb --version v1.4.45 --dry-run

Repository Structure

homebrew-eep/
├── .github/workflows/
│   └── update-formula.yml       # Automated formula update workflow
├── Formula/
│   └── eep.rb                   # Generated Homebrew formula
├── templates/
│   └── eep.rb.erb               # ERB template for formula
├── formula-metadata.json        # Version and SHA256 metadata
├── generate-formula.rb          # Formula generator script
├── Gemfile                      # Ruby dependencies
└── README.adoc                  # This file

Development

Prerequisites

• Ruby 3.2 or later

• Bundler

Setup

# Install dependencies
bundle install

# Set GitHub token for testing (optional)
export GITHUB_TOKEN=your_token_here

Testing

Test the formula locally before publishing:

# Install from local tap
brew install --build-from-source Formula/eep.rb

# Test the installation
eep -h

# Uninstall
brew uninstall eep

Contributing

This repository is primarily maintained through automated workflows. Manual updates should only be necessary for:

• Updating the formula template (templates/eep.rb.erb)

• Modifying the generator script (generate-formula.rb)

• Fixing workflow issues

License

This tap is provided as-is for distributing Eep via Homebrew. Refer to the eep-releases repository for license information about Eep itself.