pytwincatparser 0.1.0

TwinCAT PLC file parser using xsdata

pytwincatparser

A Python package for parsing TwinCAT PLC files (TcPOU, TcDUT, TcIO).

Description

This package provides tools to parse and work with TwinCAT PLC files. It uses xsdata to handle XML parsing. Be aware, that this is a python lib written by a beginner with help of AI assisted programming. My main work task is to design and program industrial machines, not develop python programms!

Features

• Parse TwinCAT PLC files (.TcPOU, .TcDUT, .TcIO)
• Access POU (Program Organization Units), DUT (Data Unit Types), and ITF (Interfaces)
• Extract declarations, implementations, methods, and properties
• Extract VAR Blocks
• Extract Return Values
• Extract Comments

Installation

This project uses uv as its package manager. To set up the development environment:

Windows

# Install uv if you don't have it
pip install uv

# Run the setup script
.\setup_uv.ps1

Usage

from pytwincatparser_xsdata.TwincatParser import TwinCatLoader

# Initialize the loader with the path to TwinCAT files
loader = TwinCatLoader(search_path="path/to/twincat/files")

# Load all TwinCAT files
loader.load()

# Get a specific object by name
pou = loader.getItemByName("FB_Base.TcPOU")

# Get all loaded objects
all_objects = loader.getAllItems()

Look in the example folder!

Requirements

• Python 3.11
• lxml >= 5.3.0
• xsdata[lxml] >= 24.12

License

MIT