A robust Rust parser for Linear Programming (LP) files, built on the NOM parsing framework. This crate provides comprehensive support for parsing and analysing LP files according to major industry specifications.

• IBM CPLEX v22.1.1
• FICO Xpress
• Gurobi
• Mosek

• Problem Definition

  • Problem name and sense specification
  • Single and multi-objective optimisation support
  • Comprehensive constraint handling

• Variable Support

  • Integer, general, bounded, free, semi-continuous variables

• LP File Comparison (diff feature)

  • Identify added, removed, and modified elements
  • Useful for model version control and validation

• Serialisation (serde feature)

  • Full serialisation support for all model structures
  • Compatible with various data formats
  • Enables integration with other tools and systems

Add to your Cargo.toml:

[dependencies]
lp_parser_rs = "2.4.1"

Clone and run with a sample file:

git clone https://github.com/dandxy89/lp_parser_rs.git
# Parse a single LP file
cargo run --bin lp_parser --release -- {{ /path/to/your/file.lp }}
# Compare two LP files (enabling the 'diff' feature)
cargo run --bin lp_parser --release --features diff -- {{ /path/to/your/file.lp }} {{ /path/to/your/other/file.lp }}

Using the library directly:

use lp_parser::{parser::parse_file, LpProblem};
use std::path::Path;
fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Parse LP file content
    let content = parse_file(Path::new("problem.lp"))?;
    // Parse into LP problem structure
    let problem = LpProblem::parse(&content)?;
    // Access problem components
    println!("Problem name: {:?}", problem.name());
    println!("Objective count: {}", problem.objective_count());
    println!("Constraint count: {}", problem.constraint_count());
    println!("Variable count: {}", problem.variable_count());
    Ok(())
}

[dependencies]
lp_parser_rs = { version = "2.4.1", features = ["serde", "diff"] }

The project uses snapshot testing via insta for reliable test management:

# Run all tests with all features enabled
cargo insta test --all-features
# Review snapshot changes
cargo insta review

The test suite includes data from various open-source projects:

• Jplex
• LPWriter.jl
• Lp-Parser

Contributions are welcome! Please feel free to submit a Pull Request.