plcopen 0.3.1

# plcopen

Parser for PLCopen TC6 XML files - the IEC 61131-3 standard exchange format for PLC programs.

## Features

- Type-safe parsing using quick-xml and serde
- Generated types from the official PLCopen TC6 XML schema (v2.01)
- **Full support for all 5 IEC 61131-3 languages:**
  - ST (Structured Text) - Text-based
  - IL (Instruction List) - Text-based
  - FBD (Function Block Diagram) - Graphical
  - LD (Ladder Diagram) - Graphical
  - SFC (Sequential Function Chart) - Graphical
- Complete element extraction from graphical languages:
  - FBD: blocks, variables, labels, jumps
  - LD: contacts, coils, power rails, blocks
  - SFC: steps, transitions, actions, jump steps
- ST code extraction and parsing via `iec61131`

## Installation

```bash
cargo add plcopen
```

Or add to your `Cargo.toml`:

```toml
[dependencies]
plcopen = "0.3"
```

## Usage

```rust
use plcopen::Project;

// Parse PLCopen XML file
let xml = std::fs::read_to_string("project.xml")?;
let project: Project = plcopen::from_str(&xml)?;
println!("Project: {:?}", project);
```

## ST Code Extraction

```rust
use plcopen::st::{extract_all_st_from_xml, parse_st};

let xml = std::fs::read_to_string("project.xml")?;

// Extract all ST code blocks from POUs
for (pou_name, st_code) in extract_all_st_from_xml(&xml) {
    // Parse ST code into AST
    let statements = parse_st(&st_code)?;
    println!("{}: {} statements", pou_name, statements.len());
}
```

## PLCopen TC6 XML Format

PLCopen TC6 is an XML-based exchange format defined by the PLCopen organization 
for transferring PLC programs between different development environments.

This parser handles:
- **Program Organization Units (POUs)**: Programs, Functions, Function Blocks
- **Data Types**: Elementary types (BOOL, INT, REAL, etc.) and user-defined types
- **Variables**: Input, Output, InOut, Local, Global, External
- **All IEC 61131-3 Languages**: Full parsing support for ST, IL, FBD, LD, and SFC
- **ST Code Extraction**: Extracts and parses Structured Text (ST) code using `iec61131`
- **Graphical Elements**: Access to all graphical language components (blocks, contacts, coils, steps, etc.)

## License

MIT