Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• Highlights for the most attractive new features.
• BREAKING for breaking changes.
• Added for new features.
• Changed for changes in existing functionality.
• Deprecated for soon-to-be removed features.
• Removed for now removed features.
• Fixed for any bug fixes.
• Security in case of vulnerabilities.
• Docs for documentation changes.
• YANKED for deprecated releases.
• Internal for internal changes. Only for maintainers.

Tip

This homepage is used to provide a blog-like changelog and BREAKING CHANGE migration guide.

You can expand sub-projects to view detailed changelogs.

Unreleased

0.5.0

Highlights

Wheel on Windows Arm64

• #139 - feat: add support for the windows-11-arm platform wheel.

You can now install pytauri-wheel from PyPI on Windows 11 Arm64.

Using Unreleased Commits

• #147 - feat: support installation from git repository.

See: https://pytauri.github.io/pytauri/0.5/usage/using-unreleased-commits/

Accessing the request headers

• #136 - feat(pytauri): accessing the request headers in Commands.

See: https://pytauri.github.io/pytauri/0.5/usage/concepts/ipc/#accessing-request-headers

Protect source code

• #134 - docs: add tutorial on using Cython to protect source code.

See: https://pytauri.github.io/pytauri/0.5/usage/tutorial/build-standalone-cython/

BREAKING

• #136 - tauri v2.5 requires upgrading @tauri-apps/api: ^2.5 and tauri-plugin-pytauri-api: ^0.5.
• #141 - feat(pytauri)!: pytauri.path.PathResolver now returns a pathlib.Path object instead of a str.

• #133 - fix(pytauri)!: make BuilderArgs.invoke_handler as required parameter for #110.

  If you do not specify invoke_handler, pytauri will not register the tauri-plugin-pytauri plugin, which means you cannot use pyInvoke in the frontend to call Commands (you will receive an error like "plugin pytauri not found"). If this is indeed the behavior you expect, explicitly pass None.

Added

• #141 - chore: bump pyo3 to 0.24.1.
• #124 - #136 - chore: bump tauri dependencies:
  • tauri to 2.5.1
  • tauri-utils to ~2.4
  • tauri-build to 2.2
  • tauri-plugin to 2.2
  • tauri-plugin-notification to 2.2
  • tauri-plugin-opener to 2.2
  • @tauri-apps/api to ^2.5
  • @tauri-apps/plugin-opener to ^2.2
  • @tauri-apps/plugin-dialog to ^2.2

Docs

• #124 - docs: update example to use App.run_return instead of App.run, allowing cleanup tasks to be performed after the app exits (e.g., shutting down the nicegui server) and retrieving the exit code.

0.4.0

Highlights

Precompiled python wheel (goodbye Rust compiler)

• #117 - docs: add usage docs for pytauri-wheel
• #108 - feat: initial precompiled python wheel support

In v0.4.0, we have introduced an exciting new feature: precompiled Python wheel support! 🎉

This means you can use PyTauri without writing any Rust code or needing a Rust compiler.

This allows you to perform full-stack development in pure Python (like pywebview but battery-included 🤓).

Please refer to the PyTauri Wheel documentation for more information.

New logo for PyTauri

Thanks to @ISOR3X in #111! PyTauri now has its own logo 🎉:

It is indeed a snake, but not eating a bean, or perhaps it was not intended to be. It is more so a combination of the Tauri logo (two dots with rings around them) and the Python logo (the snake, specifically the head). The left part is more intended to visualize the snake curling around. Perhaps it is a bit too abstract.

Changed

• #63 - chore: bump tauri to v2.3.

Internal

• #119 - ci(rs/release): add --no-verify to cargo publish so that we can release parallelly.
• #113 - ci: add macos-latest os in lint-test CI.
• #111 - docs: added PyTauri logo and updated documentation colors
• #103 - chore: transfer repo to pytauri org.

0.3.0

Highlights

• menu and tray python API bindings, see pytauri changelog for more details.

  tray	menu

Changed

• #79 - bump rust-version = "1.82"

Docs

• #88 - docs: add rust api reference section.
• #85 - docs: add concepts IPC and using multiprocessing sections.
• #80 - example/nicegui-app:
  • Use BuilderArgs.setup for initialization instead of listening to the RunEvent.Ready event.
  • Rewrite the FrontServer startup/shutdown event hook logic.
  • Modularize the code.
• #79 - example/nicegui-app:
  • use tray and menu feature
  • use python3.10 match statement instead of if-else statement
  • bump requires-python = ">=3.10"

Internal

• #81 - ci: add clear-cache.yml workflow.

0.2.0

BREAKING

• #70 - feat(notification): removed NotificationBuilderArgs. See CHANGELOG.md of py/pytauri-plugin-notification for how to migrate.
• #57 - refactor(py/pytauri): remove RunEventEnum, use matched RunEvent directly. See CHANGELOG.md of py/pytauri for how to migrate.
• #56 - perf(pytauri): all IPC methods that previously accepted bytearray as a parameter now only accept bytes as a parameter.
• #52 - refactor(standalone)!: new API for preparing python interpreter. The pytauri::standalone module has been completely rewritten. Previously, you used prepare_freethreaded_python_with_executable and append_ext_mod. Now, you need to use PythonInterpreterBuilder. See the pytauri crate rust API docs and tutorial (examples/tauri-app) main.rs code for more information on how to migrate.

Docs

• #60 - update examples main.rs to remove resource_dir() UNC path prefix \\?\ for PythonInterpreterEnv::Standalone. Fix pallets/jinja#1675 for nicegui-app standalone example.
• #55 - Add integrate with nicegui example nicegui-app. See examples/nicegui-app.
• #52 - update examples/tauri-app main.rs for new API to prepare python interpreter.
• #52 - add the usage of multiprocessing.freeze_support in examples/tauri-app __main__.py.

Changed

• #46 - bump tauri to v2.2

Internal

• #83 - chore: bump pyo3 to v0.23.4 in Cargo.lock to fix PyO3/pyo3#4828.
• #64 - test: add integration tests for command and channel ipc

0.1.0-beta