Pretty print

.github/workflows/ci.yml

@@ -5,7 +5,7 @@ on:
   workflow_dispatch:
 
 permissions:
-  contents: read
+  contents: write
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -29,6 +29,53 @@ jobs:
         with:
           python-version: ${{ matrix.python }}
 
+      - name: Setup TeX Live
+        uses: teatimeguest/setup-texlive-action@v3
+        with:
+          packages: |
+            scheme-basic
+            standalone
+            xypic
+            qcircuit
+
+      - name: Update and install dependencies on Ubuntu
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get upgrade -y
+          sudo apt-get install -y poppler-utils
+
+      - name: Update and install dependencies on macOS
+        if: runner.os == 'macOS'
+        run: |
+          brew update
+          brew install poppler
+
+# Installation and setup of poppler for Windows seems not to work.
+# Here, we try to install poppler-windows and update PATH environment variable. This process seems to work, as the command `pdftocairo.exe -v` executes as expected.
+# Though, when running the tests, pdftocairo still seems not found. Thus, we are skipping latex related tests on Windows OS for now. 
+
+#      - name: Update and install dependencies on Windows
+#        if: runner.os == 'Windows'
+#        # Download latest binary of poppler-windows
+#        # Update PATH with poppler's binary folder
+#        run: |
+#          Write-Host "Downloading Poppler..."
+#          Invoke-RestMethod -Uri https://github.com/oschwartz10612/poppler-windows/releases/download/v24.08.0-0/Release-24.08.0-0.zip -OutFile .\Release-24.08.0-0.zip
+#          Expand-Archive -Path .\Release-24.08.0-0.zip -DestinationPath .\
+#
+#          $addPath = (Resolve-Path .\poppler-24.08.0\Library\bin).Path
+#          $regexAddPath = [regex]::Escape($addPath)
+#
+#          $arrPath = $env:Path -split ';' | Where-Object {$_ -notMatch "^$regexAddPath\\?"}
+#          $arrPath += $addPath
+#          $env:Path = -join ($arrPath -join ';')
+#
+#          [System.Environment]::SetEnvironmentVariable('Path', $env:Path, [System.EnvironmentVariableTarget]::User)
+#
+#          $env:Path -split ';'
+#          pdftocairo.exe -v
+
       - run: python -m pip install --upgrade pip
 
       - name: Setup nox

.github/workflows/cov.yml

@@ -18,11 +18,26 @@ jobs:
         with:
           python-version: "3.12"
 
+      - name: Setup TeX Live
+        uses: teatimeguest/setup-texlive-action@v3
+        with:
+          packages: |
+            scheme-basic
+            standalone
+            xypic
+            qcircuit
+
+      - name: Update and install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get upgrade -y
+          sudo apt-get install -y poppler-utils
+
       - name: Upgrade pip
         run: python -m pip install --upgrade pip
 
       - name: Install graphix with dev deps.
-        run: pip install .[dev]
+        run: pip install .[dev,extra]
 
       - name: Run pytest
         run: pytest --cov=./graphix --cov-report=xml --cov-report=term

CHANGELOG.md

@@ -5,7 +5,6 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-
 ## [Unreleased]
 
 ### Added
@@ -31,6 +30,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+## [0.3.1]
+
+This version brings nice ways to visualize both circuit and patterns. 
+
+### Added
+
+- Both `Circuit` and `Pattern` classes now have a `draw` method with an argument corresponding to the format the user wants to visualize the object and that returns the appropriate visualization object.
+- `Circuit.draw()` is based on `qiskit.QuantumCircuit.draw()` method that takes a qasm3 circuit as input to generate the `QuantumCircuit` object and call its local `draw` method.
+- Added the `Circuit.to_qasm3()` method to generate the appropriate qasm3 representation of a `Circuit` object.
+- Added `Circuit.__str__()` method overload that calls `Circuit.draw()` with the default `text` argument.
+- `Pattern.draw()` relates on its own, with the 4 following visualization formats: `ascii`, `latex`, `unicode` or `png`, respectively returning `str`, `str`, `str` or `PIL.Image.Image`.
+- Added `command_to_latex(Command)`, `command_to_str(Command)`/`Command.__str__()` and `command_to_unicode(Command)` methods to generate the appropriate visualizations of a `Command` object.
+- Added `Pattern.to_png()`, `Pattern.to_unicode()`, `Pattern.to_latex()` and `Pattern._str__()` methods.
+
+### Fixed
+
+### Changed
+
 ## [0.3.0] - 2025-02-04
 
 ### Changed
@@ -56,6 +73,8 @@ This version introduces several important interface changes, aimed at secure exp
   - Added `class Instruction` for the gate network expression in quantum circuit model. Every instruction can be instanciated using this class by passing its name as defined in the Enum `InstructionName`.
 - `class graphix.OpenGraph` to transpile between graphix patterns and pyzx graphs.
 - `class graphix.pauli.PauliMeasurement` as a new Pauli measurement checks (used in `pattern.perform_pauli_measurements`).
+- Now variables, functions, and classes are named based on PEP8.
+- `KrausChannel` class now uses `KrausData` class (originally `dict`) to store Kraus operators.
 
 ### Fixed