Skip to content

History.md

Latest commit

 

History

History
87 lines (63 loc) · 3 KB

History.md

File metadata and controls

87 lines (63 loc) · 3 KB
Raw

History

Releasing

PyPI releases are published automatically when a version tag is pushed to GitHub.

  1. Bump __version__ in tapsdk/__version__.py and update this file.

  2. Merge the release changes into develop, then into master as needed.

  3. Create and push an annotated tag whose name matches the package version (for example v0.7.0):

    git tag -a v0.7.0 -m "Release 0.7.0"
git push origin v0.7.0

The Publish to PyPI workflow runs the same lint and test matrix as CI, verifies that the tag (without the v prefix) matches tapsdk.__version__, builds the package with python -m build, and uploads it to PyPI using Trusted Publishing.

Maintainers must configure PyPI Trusted Publishing for the tap-python-sdk project name, the TapWithUs/tap-python-sdk repository, and a GitHub pypi environment before the first automated release.

0.7.0 (2026-06-09)

Main features

  • Unified cross-platform implementation in tapsdk/tap.py (removed separate posix/dotnet backends).
  • Windows rewritten to use Bleak/WinRT instead of TAPWin.dll.
  • InputMode API: TapInputMode("…") replaced by InputModeText, InputModeController, InputModeControllerText, InputModeRaw.
  • Raw mode: typed sensitivity enums and optional scaling to mg/mdps (scaled=True).
  • Connection and disconnection events implemented on all platforms.
  • Windows: BLE scan and reconnect polling for paired devices.
  • Python requirement raised to 3.9+.
  • CI: cross-platform pytest and flake8.
  • New AirGestures values (thumb and state gestures).

Breaking changes

  • Removed TapInputMode, loop constructor argument, tapsdk.models, and OS-specific examples.
  • Windows no longer uses bundled TAPWin.dll.

0.6.0 (2024-07-04)

Main features

  • Added Spatial features for TapXR.
  • Mac and Linux backends unified to posix backend.

Known Issues

  • Windows backend -
    • Raw sensor data rate might be lower than expected.
    • Sometimes a Tap strap wouldn't be detected upon connection. In this case try restarting your Tap and/or the Python application. In worst case scenario re-pair your Tap.
    • Spatial features are still not available for Windows backend.
  • MacOS & Linux backends -
    • Doesn't support multiple Tap strap connections.
    • OnConnect and OnDisconnect events are not implemented
    • Raw sensor data is given unscaled (i.e. unitless), therefore in order to scale to physical units need to multiply by the relevant scale factor

0.5.1 (2024-01-01)

Main features

  • Support TapXR Air Gesture pinch

0.5.0 (2021-08-03)

Main features

  • Support Bleak 0.12.1 for mac

0.3.0 (2020-09-07)

Main features

  • Linux support
  • Some bug fixes

0.2.0 (2020-02-22)

Main features

  • Added dll to enable windows backend.
  • fix parsers output types on gesture and tap messages

0.1.0 (2020-02-20)

Main features

  • SDK created.