nc-gcode-interpreter 0.1.8__tar.gz → 0.1.10__tar.gz

{nc_gcode_interpreter-0.1.8 → nc_gcode_interpreter-0.1.10}/.github/workflows/build-and-release.yml

@@ -7,7 +7,7 @@
 # - build using binary bindings
 # - extract the binaries from the wheel
 # - upload both the wheel and the binary to the release
-# - disable some platforms
+# - disable some platforms 
 
 name: Build and Release
 
@@ -33,7 +33,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: 3.13
       - name: Install Python linter
         run: pip install ruff
       - name: Lint Python code with ruff
@@ -47,11 +47,12 @@ jobs:
         platform:
           - runner: ubuntu-latest
             target: x86_64
+        python-version: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: ${{ matrix.python-version }}
       - name: Update Cargo.toml Version
         if: startsWith(github.ref, 'refs/tags/')
         run: |
@@ -68,25 +69,40 @@ jobs:
       - name: Upload wheels
         uses: actions/upload-artifact@v4
         with:
-          name: wheels-linux-${{ matrix.platform.target }}
+          name: wheels-linux-${{ matrix.platform.target }}-py${{ matrix.python-version }}
           path: dist
 
   test:
     needs: [linux-x64]
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/download-artifact@v4
         with:
-          name: wheels-linux-x86_64
+          name: wheels-linux-x86_64-py${{ matrix.python-version }}
           path: dist
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: ${{ matrix.python-version }}
       - name: Install py_opw_kinematics
+        shell: bash
         run: |
-          WHL_FILE=$(ls dist/*cp312*.whl)
-          pip install "${WHL_FILE}[test]"
+          set -e  # Exit on error
+          PY_VERSION="${{ matrix.python-version }}"
+          PY_VERSION_NO_DOT="${PY_VERSION//./}"
+          WHL_FILES=(dist/*cp${PY_VERSION_NO_DOT}*.whl)
+          if [ ${#WHL_FILES[@]} -eq 0 ]; then
+            echo "No matching wheel files found!"
+            exit 1
+          fi
+          if [ ${#WHL_FILES[@]} -gt 1 ]; then
+            echo "Multiple wheel files found: ${WHL_FILES[*]}"
+            exit 1
+          fi
+          pip install "${WHL_FILES[0]}[test]"
       - name: Run tests with pytest
         run: pytest
       - name: Type checking with mypy
@@ -102,23 +118,23 @@ jobs:
           #   target: x86
           - runner: ubuntu-latest
             target: aarch64
-          # - runner: ubuntu-latest
-          #   target: armv7
-          # - runner: ubuntu-latest
-          #   target: s390x
-          # - runner: ubuntu-latest
-          #   target: ppc64le
+        python-version: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: ${{ matrix.python-version }}
       - name: Update Cargo.toml Version
         if: startsWith(github.ref, 'refs/tags/')
+        shell: bash
         run: |
+          set -e  # Exit on error
           VERSION=${GITHUB_REF#refs/tags/v}
           echo "Setting version to $VERSION"
-          sed -i "s/^version = \".*\"/version = \"$VERSION\"/" Cargo.toml          
+          if ! sed -i "s/^version = \".*\"/version = \"$VERSION\"/" Cargo.toml; then
+            echo "Failed to update version in Cargo.toml"
+            exit 1
+          fi
       - name: Build wheels
         uses: PyO3/maturin-action@v1
         with:
@@ -129,42 +145,9 @@ jobs:
       - name: Upload wheels
         uses: actions/upload-artifact@v4
         with:
-          name: wheels-linux-${{ matrix.platform.target }}
+          name: wheels-linux-${{ matrix.platform.target }}-py${{ matrix.python-version }}
           path: dist
 
-
-  # musllinux:
-  #   needs: [lint, test]
-  #   runs-on: ${{ matrix.platform.runner }}
-  #   strategy:
-  #     matrix:
-  #       platform:
-  #         - runner: ubuntu-latest
-  #           target: x86_64
-  #         # - runner: ubuntu-latest
-  #         #   target: x86
-  #         # - runner: ubuntu-latest
-  #         #   target: aarch64
-  #         # - runner: ubuntu-latest
-  #         #   target: armv7
-  #   steps:
-  #     - uses: actions/checkout@v4
-  #     - uses: actions/setup-python@v5
-  #       with:
-  #         python-version: '>=3.12'
-  #     - name: Build wheels
-  #       uses: PyO3/maturin-action@v1
-  #       with:
-  #         target: ${{ matrix.platform.target }}
-  #         args: --release --out dist --find-interpreter
-  #         sccache: 'true'
-  #         manylinux: musllinux_1_2
-  #     - name: Upload wheels
-  #       uses: actions/upload-artifact@v4
-  #       with:
-  #         name: wheels-musllinux-${{ matrix.platform.target }}
-  #         path: dist
-
   windows:
     if: startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch'
     needs: [lint, test]
@@ -174,21 +157,42 @@ jobs:
         platform:
           - runner: windows-latest
             target: x64
-          # - runner: windows-latest
-          #   target: x86
+        python-version: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: ${{ matrix.python-version }}
           architecture: ${{ matrix.platform.target }}
       - name: Update Cargo.toml Version
         if: startsWith(github.ref, 'refs/tags/')
         shell: pwsh
         run: |
-          $VERSION = $env:GITHUB_REF -replace 'refs/tags/v',''
-          Write-Host "Setting version to $VERSION"
-          (Get-Content Cargo.toml) -replace '^version = ".*"', ('version = "' + $VERSION + '"') | Set-Content Cargo.toml
+          $ErrorActionPreference = "Stop"
+          try {
+            $VERSION = $env:GITHUB_REF -replace 'refs/tags/v',''
+            Write-Host "Setting version to $VERSION"
+
+            # Read Cargo.toml as UTF-8
+            $path = Resolve-Path Cargo.toml
+            $content = [System.IO.File]::ReadAllText($path, [System.Text.Encoding]::UTF8)
+
+            # Update version using multiline regex to match "version ="
+            $newContent = $content -replace '(?m)^\s*version\s*=\s*".*"', "version = `"$VERSION`""
+
+            if ($newContent -eq $content) {
+                throw "Version pattern not found in Cargo.toml"
+            }
+
+            # Write back with UTF-8 encoding
+            [System.IO.File]::WriteAllText($path, $newContent, [System.Text.Encoding]::UTF8)
+            Write-Host "Cargo.toml version updated successfully."
+          }
+          catch {
+            Write-Error "Failed to update version in Cargo.toml: $_"
+            exit 1
+          }
+
       - name: Build wheels
         uses: PyO3/maturin-action@v1
         with:
@@ -198,7 +202,7 @@ jobs:
       - name: Upload wheels
         uses: actions/upload-artifact@v4
         with:
-          name: wheels-windows-${{ matrix.platform.target }}
+          name: wheels-windows-${{ matrix.platform.target }}-py${{ matrix.python-version }}
           path: dist
 
   macos:
@@ -208,20 +212,27 @@ jobs:
     strategy:
       matrix:
         platform:
-          - runner: macos-12
+          - runner: macos-latest
             target: x86_64
-          - runner: macos-14
+          - runner: macos-latest
             target: aarch64
+        python-version: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: ${{ matrix.python-version }}
       - name: Update Cargo.toml Version
+        if: startsWith(github.ref, 'refs/tags/')
+        shell: bash
         run: |
+          set -e  # Exit on error
           VERSION=${GITHUB_REF#refs/tags/v}
           echo "Setting version to $VERSION"
-          sed -i '' "s/^version = \".*\"/version = \"$VERSION\"/" Cargo.toml
+          if ! sed -i '' "s/^version = \".*\"/version = \"$VERSION\"/" Cargo.toml; then
+            echo "Failed to update version in Cargo.toml"
+            exit 1
+          fi
       - name: Build wheels
         uses: PyO3/maturin-action@v1
         with:
@@ -231,7 +242,7 @@ jobs:
       - name: Upload wheels
         uses: actions/upload-artifact@v4
         with:
-          name: wheels-macos-${{ matrix.platform.target }}
+          name: wheels-macos-${{ matrix.platform.target }}-py${{ matrix.python-version }}
           path: dist
 
   sdist:
@@ -245,10 +256,15 @@ jobs:
           python-version: 3.12
       - name: Update Cargo.toml Version
         if: startsWith(github.ref, 'refs/tags/')
+        shell: bash
         run: |
+          set -e  # Exit on error
           VERSION=${GITHUB_REF#refs/tags/v}
           echo "Setting version to $VERSION"
-            sed -i "s/^version = \".*\"/version = \"$VERSION\"/" Cargo.toml              
+          if ! sed -i "s/^version = \".*\"/version = \"$VERSION\"/" Cargo.toml; then
+            echo "Failed to update version in Cargo.toml"
+            exit 1
+          fi
       - name: Build sdist
         uses: PyO3/maturin-action@v1
         with:

{nc_gcode_interpreter-0.1.8 → nc_gcode_interpreter-0.1.10}/Cargo.lock

@@ -1,6 +1,6 @@
 # This file is automatically @generated by Cargo.
 # It is not intended for manual editing.
-version = 3
+version = 4
 
 [[package]]
 name = "ahash"
@@ -724,7 +724,7 @@ dependencies = [
 
 [[package]]
 name = "nc-gcode-interpreter"
-version = "0.1.8"
+version = "0.1.10"
 dependencies = [
  "clap",
  "csv",
@@ -819,9 +819,9 @@ checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
 
 [[package]]
 name = "pest"
-version = "2.7.13"
+version = "2.7.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fdbef9d1d47087a895abd220ed25eb4ad973a5e26f6a4367b038c25e28dfc2d9"
+checksum = "879952a81a83930934cbf1786752d6dedc3b1f29e8f8fb2ad1d0a36f377cf442"
 dependencies = [
  "memchr",
  "thiserror",

{nc_gcode_interpreter-0.1.8 → nc_gcode_interpreter-0.1.10}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "nc-gcode-interpreter"
-version = "0.1.8"
+version = "0.1.10"
 edition = "2021"
 
 [lib]

{nc_gcode_interpreter-0.1.8 → nc_gcode_interpreter-0.1.10}/PKG-INFO

@@ -1,24 +1,24 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: nc-gcode-interpreter
-Version: 0.1.8
+Version: 0.1.10
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: maturin >=1.7.4
-Requires-Dist: polars >=1.9.0
-Requires-Dist: jupyter >=1.1.1 ; extra == 'dev'
-Requires-Dist: pytest >=8.3.3 ; extra == 'test'
+Requires-Dist: maturin>=1.7.4
+Requires-Dist: polars[pyarrow]>=1.9.0
+Requires-Dist: jupyter>=1.1.1 ; extra == 'dev'
+Requires-Dist: pytest>=8.3.3 ; extra == 'test'
 Requires-Dist: mypy ; extra == 'test'
 Provides-Extra: dev
 Provides-Extra: test
 License-File: LICENSE
 Summary: A interpreter for NC (Numerical Control) GCode
 Author-email: CEAD Group <software@ceadgroup.com>
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Homepage, https://github.com/CEAD-group/nc-gcode-interpreter
 Project-URL: Repository, https://github.com/CEAD-group/nc-gcode-interpreter.git
@@ -26,44 +26,42 @@ Project-URL: Documentation, https://github.com/CEAD-group/nc-gcode-interpreter/b
 
 # NC-GCode-Interpreter
 
-A robust interpreter tailored for processing Sinumerik-flavored NC G-code, designed to convert MPF files into CSV outputs or Polars dataframes when used with Python bindings.
+A robust interpreter designed for processing Sinumerik-flavored NC G-code, capable of converting MPF files into CSV outputs or Polars DataFrames via Python bindings.
 
 ## Overview
 
-The NC-GCode-Interpreter provides a streamlined and efficient solution for interpreting G-code specifically designed with Sinumerik specifications in mind. This tool caters to both CLI users and those preferring a Python environment, ensuring versatility and ease of use in processing NC programming commands into structured formats like CSV files or Polars dataframes.
+The **NC-GCode-Interpreter** offers a streamlined and efficient solution for interpreting G-code specifically tailored to Sinumerik specifications. This tool caters to both command-line interface (CLI) users and those preferring a Python environment, ensuring versatility and ease of use in processing NC programming commands into structured formats like CSV files or Polars DataFrames.
 
 ## Features
 
 ### Supported G-code Features
 
-- **G Group Commands**: Recognizes G-code groups and modal gcode commands.
-- **Global Translations**: Supports commands like TRANS and ATRANS for adjusting coordinates globally.
-- **Looping Constructs**: Handles loops using WHILE and FOR statements.
+- **G Group Commands**: Recognizes G-code groups and modal G-code commands.
+- **Global Transformations**: Supports commands like `TRANS` and `ATRANS` for adjusting coordinates globally.
+- **Looping Constructs**: Handles loops using `WHILE` and `FOR` statements.
 - **Variable Handling**: Supports definition and manipulation of local variables.
-- **Conditional Logic**: Implements conditional execution with IF, ELSE, and ENDIF.
-- **Arithmetic Operations**: Basic operations such as addition, subtraction, multiplication, and division are supported.
+- **Conditional Logic**: Implements conditional execution with `IF`, `ELSE`, and `ENDIF`.
+- **Arithmetic Operations**: Supports basic operations such as addition, subtraction, multiplication, and division.
 - **Array Operations**: Manages arrays and allows operations on them.
-- **Incremental Changes**: Facilitates incremental changes in axes positions like X=IC(2).
+- **Incremental Changes**: Facilitates incremental changes in axes positions like `X=IC(2)`.
 
 ### Additional Functionality
 
-- **Custom Axes**: Allows users to define additional axes beyond the standard X, Y, Z.
+- **Custom Axes**: Allows users to define additional axes beyond the standard `X`, `Y`, `Z`.
 - **Initial State Configuration**: Enables the use of an initial state MPF file to set default values for multiple runs.
-- **CLI Options**: Numerous command-line options to customize the processing like axis overriding, loop limits, and more.
-
-
+- **CLI Options**: Numerous command-line options to customize the processing, such as axis overriding, loop limits, and more.
 
 ## Example Usage
 
-
 Consider this example program to generate a square in two layers:
+
 ```scheme
-;Example.MPF
-DEF INT n_layers = 2, layer=1
-DEF REAL size = 100 ;size of the square
-DEF REAL layer_height = 4 ;size of the square
-TRANS Z = 0.5 ; move up all z coordinates by 0.5
-G1 F=1000; Set feed rate in millimeters per minute
+; Example.MPF
+DEF INT n_layers = 2, layer = 1
+DEF REAL size = 100 ; size of the square
+DEF REAL layer_height = 4 ; height of each layer
+TRANS Z = 0.5 ; move up all Z coordinates by 0.5
+G1 F=1000 ; Set feed rate in millimeters per minute
 G1 X0 Y500 Z0 ; move to the starting point
 WHILE (layer <= n_layers)
     X=IC(size)
@@ -72,13 +70,12 @@ WHILE (layer <= n_layers)
     Y=IC(-size) Z=IC(layer_height)
     layer = layer + 1
 ENDWHILE
-M31; end of program
-```
+M31 ; end of program
 
 
 ### CLI Usage
 ```bash
-> cargo run -- --help
+$ cargo run -- --help
 A G-code interpreter
 
 Usage: nc-gcode-interpreter [OPTIONS] <input>
@@ -89,13 +86,13 @@ Arguments:
 Options:
   -a, --axes <AXIS>                    Override default axis identifiers (comma-separated, e.g., "X,Y,Z")
   -e, --extra-axes <EXTRA_AXIS>        Add extra axis identifiers (comma-separated, e.g., "RA1,RA2")
-  -i, --initial_state <INITIAL_STATE>  Optional initial_state file to initialize state
+  -i, --initial_state <INITIAL_STATE>  Optional initial state file to e.g. define global variables or set axis positions
   -l, --iteration_limit <LIMIT>        Maximum number of iterations for loops [default: 10000]
   -f, --disable-forward-fill           Disable forward-filling of null values in axes columns
   -h, --help                           Print help
   -V, --version                        Print version
 
-> cargo run -- Example.MPF
+$ cargo run -- Example.MPF
 ```
 
 ```csv
@@ -119,6 +116,13 @@ X			,Y			,Z			,F			,M	 ,gg01_motion	,comment
 
 ### python example
 
+To install the Python bindings, run:
+```bash
+pip install nc-gcode-interpreter
+```
+
+Then, you can use the Python bindings to convert an MPF file to a DataFrame:
+
 ```bash
 python -c "\
 from nc_gcode_interpreter import nc_to_dataframe; \
@@ -145,6 +149,17 @@ shape: (14, 7)
 └───────┴───────┴──────┴────────┴───────────┴─────────────┴─────────────────────────────────┘
 ```
 
+The Python bindings also return the state of the program after execution, which can be used for inspection.
+
+Additionally, conversion from a Polars DataFrame back to an MPF (NC) program is also supported:
+
+```bash
+python -c "\
+from nc_gcode_interpreter import nc_to_dataframe, dataframe_to_nc; \
+from pathlib import Path; \
+df, state = nc_to_dataframe(Path('Example.MPF').open(), extra_axes=['ELX']); \
+dataframe_to_nc(df, Path('Example_out.MPF').open('w'))" 
+```
 
 ```bash
 target/release/nc-gcode-interpreter --help
@@ -167,7 +182,7 @@ Options:
 
 ## Why?
 
-The Sinumerik NC programming guide is extensive, and some of it's functionality can be very convenient for  making on the fly improvements to cde. However to better uderstand, visualize and simulate the code, it is often necessary to convert it to a more structured format like CSV or a dataframe. This tool aims to provide a simple and efficient way to convert Sinumerik-flavored G-code to a structured format, making it easier to analyze and visualize the code.
+The Sinumerik NC programming guide is extensive, and some of its functionality can be very convenient for making on-the-fly improvements to code. However, to better understand, visualize, and simulate the code, it is often necessary to convert it to a more structured format like CSV or a DataFrame. This tool aims to provide a simple and efficient way to convert Sinumerik-flavored G-code to a structured format, making it easier to analyze and visualize.
 
 Only a limited subset is supported, but the tool is designed to be easily extensible to support more features in the future.
 

{nc_gcode_interpreter-0.1.8 → nc_gcode_interpreter-0.1.10}/README.md

@@ -1,43 +1,41 @@
 # NC-GCode-Interpreter
 
-A robust interpreter tailored for processing Sinumerik-flavored NC G-code, designed to convert MPF files into CSV outputs or Polars dataframes when used with Python bindings.
+A robust interpreter designed for processing Sinumerik-flavored NC G-code, capable of converting MPF files into CSV outputs or Polars DataFrames via Python bindings.
 
 ## Overview
 
-The NC-GCode-Interpreter provides a streamlined and efficient solution for interpreting G-code specifically designed with Sinumerik specifications in mind. This tool caters to both CLI users and those preferring a Python environment, ensuring versatility and ease of use in processing NC programming commands into structured formats like CSV files or Polars dataframes.
+The **NC-GCode-Interpreter** offers a streamlined and efficient solution for interpreting G-code specifically tailored to Sinumerik specifications. This tool caters to both command-line interface (CLI) users and those preferring a Python environment, ensuring versatility and ease of use in processing NC programming commands into structured formats like CSV files or Polars DataFrames.
 
 ## Features
 
 ### Supported G-code Features
 
-- **G Group Commands**: Recognizes G-code groups and modal gcode commands.
-- **Global Translations**: Supports commands like TRANS and ATRANS for adjusting coordinates globally.
-- **Looping Constructs**: Handles loops using WHILE and FOR statements.
+- **G Group Commands**: Recognizes G-code groups and modal G-code commands.
+- **Global Transformations**: Supports commands like `TRANS` and `ATRANS` for adjusting coordinates globally.
+- **Looping Constructs**: Handles loops using `WHILE` and `FOR` statements.
 - **Variable Handling**: Supports definition and manipulation of local variables.
-- **Conditional Logic**: Implements conditional execution with IF, ELSE, and ENDIF.
-- **Arithmetic Operations**: Basic operations such as addition, subtraction, multiplication, and division are supported.
+- **Conditional Logic**: Implements conditional execution with `IF`, `ELSE`, and `ENDIF`.
+- **Arithmetic Operations**: Supports basic operations such as addition, subtraction, multiplication, and division.
 - **Array Operations**: Manages arrays and allows operations on them.
-- **Incremental Changes**: Facilitates incremental changes in axes positions like X=IC(2).
+- **Incremental Changes**: Facilitates incremental changes in axes positions like `X=IC(2)`.
 
 ### Additional Functionality
 
-- **Custom Axes**: Allows users to define additional axes beyond the standard X, Y, Z.
+- **Custom Axes**: Allows users to define additional axes beyond the standard `X`, `Y`, `Z`.
 - **Initial State Configuration**: Enables the use of an initial state MPF file to set default values for multiple runs.
-- **CLI Options**: Numerous command-line options to customize the processing like axis overriding, loop limits, and more.
-
-
+- **CLI Options**: Numerous command-line options to customize the processing, such as axis overriding, loop limits, and more.
 
 ## Example Usage
 
-
 Consider this example program to generate a square in two layers:
+
 ```scheme
-;Example.MPF
-DEF INT n_layers = 2, layer=1
-DEF REAL size = 100 ;size of the square
-DEF REAL layer_height = 4 ;size of the square
-TRANS Z = 0.5 ; move up all z coordinates by 0.5
-G1 F=1000; Set feed rate in millimeters per minute
+; Example.MPF
+DEF INT n_layers = 2, layer = 1
+DEF REAL size = 100 ; size of the square
+DEF REAL layer_height = 4 ; height of each layer
+TRANS Z = 0.5 ; move up all Z coordinates by 0.5
+G1 F=1000 ; Set feed rate in millimeters per minute
 G1 X0 Y500 Z0 ; move to the starting point
 WHILE (layer <= n_layers)
     X=IC(size)
@@ -46,13 +44,12 @@ WHILE (layer <= n_layers)
     Y=IC(-size) Z=IC(layer_height)
     layer = layer + 1
 ENDWHILE
-M31; end of program
-```
+M31 ; end of program
 
 
 ### CLI Usage
 ```bash
-> cargo run -- --help
+$ cargo run -- --help
 A G-code interpreter
 
 Usage: nc-gcode-interpreter [OPTIONS] <input>
@@ -63,13 +60,13 @@ Arguments:
 Options:
   -a, --axes <AXIS>                    Override default axis identifiers (comma-separated, e.g., "X,Y,Z")
   -e, --extra-axes <EXTRA_AXIS>        Add extra axis identifiers (comma-separated, e.g., "RA1,RA2")
-  -i, --initial_state <INITIAL_STATE>  Optional initial_state file to initialize state
+  -i, --initial_state <INITIAL_STATE>  Optional initial state file to e.g. define global variables or set axis positions
   -l, --iteration_limit <LIMIT>        Maximum number of iterations for loops [default: 10000]
   -f, --disable-forward-fill           Disable forward-filling of null values in axes columns
   -h, --help                           Print help
   -V, --version                        Print version
 
-> cargo run -- Example.MPF
+$ cargo run -- Example.MPF
 ```
 
 ```csv
@@ -93,6 +90,13 @@ X			,Y			,Z			,F			,M	 ,gg01_motion	,comment
 
 ### python example
 
+To install the Python bindings, run:
+```bash
+pip install nc-gcode-interpreter
+```
+
+Then, you can use the Python bindings to convert an MPF file to a DataFrame:
+
 ```bash
 python -c "\
 from nc_gcode_interpreter import nc_to_dataframe; \
@@ -119,6 +123,17 @@ shape: (14, 7)
 └───────┴───────┴──────┴────────┴───────────┴─────────────┴─────────────────────────────────┘
 ```
 
+The Python bindings also return the state of the program after execution, which can be used for inspection.
+
+Additionally, conversion from a Polars DataFrame back to an MPF (NC) program is also supported:
+
+```bash
+python -c "\
+from nc_gcode_interpreter import nc_to_dataframe, dataframe_to_nc; \
+from pathlib import Path; \
+df, state = nc_to_dataframe(Path('Example.MPF').open(), extra_axes=['ELX']); \
+dataframe_to_nc(df, Path('Example_out.MPF').open('w'))" 
+```
 
 ```bash
 target/release/nc-gcode-interpreter --help
@@ -141,7 +156,7 @@ Options:
 
 ## Why?
 
-The Sinumerik NC programming guide is extensive, and some of it's functionality can be very convenient for  making on the fly improvements to cde. However to better uderstand, visualize and simulate the code, it is often necessary to convert it to a more structured format like CSV or a dataframe. This tool aims to provide a simple and efficient way to convert Sinumerik-flavored G-code to a structured format, making it easier to analyze and visualize the code.
+The Sinumerik NC programming guide is extensive, and some of its functionality can be very convenient for making on-the-fly improvements to code. However, to better understand, visualize, and simulate the code, it is often necessary to convert it to a more structured format like CSV or a DataFrame. This tool aims to provide a simple and efficient way to convert Sinumerik-flavored G-code to a structured format, making it easier to analyze and visualize.
 
 Only a limited subset is supported, but the tool is designed to be easily extensible to support more features in the future.
 

nc_gcode_interpreter-0.1.10/examples/function_calls.csv

@@ -0,0 +1,3 @@
+gg01_motion,X,function_call
+,,SETAL(12345)
+G1,1.000,

nc_gcode_interpreter-0.1.10/examples/if_statement.mpf

@@ -0,0 +1,13 @@
+DEF INT aa=1
+IF TRUE
+    X1
+ELSE
+    IF aa
+        X5
+    ELSE
+        X3
+        Y32
+    ENDIF
+ENDIF
+
+