toio-py-fork 1.1.0.post2.dev1__tar.gz

toio_py_fork-1.1.0.post2.dev1/.flake8

@@ -0,0 +1,5 @@
+[flake8]
+max-line-length = 88
+extend-ignore = E203
+exclude = pythonista3corebluetooth
+

toio_py_fork-1.1.0.post2.dev1/.gitignore

@@ -0,0 +1,20 @@
+# General Python ignores
+build/
+dist/
+__pycache__/
+__pypackages__/
+.ipynb_checkpoints/
+*.pyc
+*~
+*/.mypy_cache/
+.venv*/
+.idea/
+.DS_Store
+
+.vscode/*
+!.vscode/extensions.json
+
+# Project ignores
+.coverage
+
+.codex

toio_py_fork-1.1.0.post2.dev1/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## [1.1.0]
+
+### Added
+
+- Support for toio BLE protocol version v2.4.0
+- Compatibility with Python 3.8 and later versions
+- Support for Pythonista3 application (#1)
+- `py.typed` file for enhanced type hinting
+- `AsyncSimpleCube` class to facilitate simple API usage with asyncio
+- `MultipleToioCoreCubes` class for simplified control of multiple cubes
+- `is_connect()` method in `CubeInterface` class to check connection status
+- Initialization with `Sequence` in `cube.api.indicator` functions
+- Initialization with `Sequence` in `cube.api.motor_control` functions
+- `DummyInterface` class for debugging purposes
+- `NotificationHandlerInfo` class as a second argument for notification handlers
+
+### Changed
+
+- `ToioCoreCube` class now verifies protocol version during connection
+
+### Fixed
+
+- Issue where `cube.api.sound.stop()` did not function (#3)
+- Inability of `SimpleCube.play_sound()` to play sounds longer than 250ms
+- Potential failures when using `concurrent.futures` or `threading.Thread`
+
+## [1.0.2]
+
+### Changed
+
+- Updated document
+- Changed minimum `bleak` version to 0.20.1
+
+## [1.0.1]
+
+- First Release

toio_py_fork-1.1.0.post2.dev1/CHANGELOG_FORK.ja.md

@@ -0,0 +1,67 @@
+# toio.py-fork の変更履歴
+
+このファイルは、独自の `toio.py-fork` ブランチで行った変更をまとめたものです。
+公式プロジェクトの変更履歴については [CHANGELOG.md](./CHANGELOG.md) を参照してください。
+
+## [未リリース]
+
+### 追加
+
+- toioコアキューブ技術仕様 v2.5.0 で追加されたAPIへの対応を追加しました：
+  - スピーカー消音設定：`SetSpeakerMute` (command 0x33) および `ResponseSpeakerMuteSettings` (response 0xB3)。
+  - 保存した設定の初期化：`ResetConfiguration` (command 0x0F) および `ResponseConfigurationReset` (response 0x8F)。
+  - リモート電源オフ：`RequestRemotePowerOff` (command 0x34) および `ResponseRemotePowerOff` (response 0xB4)。
+  - 現在のコネクションインターバル値の取得：`GetCurrentConnectionIntervalValue` (command 0x32) および `ResponseGettingCurrentConnectionInterval` (response 0xB2)。
+  - ランプのなめらかな点滅：`SmoothFlashing` (command 0x70)。
+  - これらの機能を `AsyncSimpleCube` に統合しました。
+- `ToioCoreCube` の `SUPPORTED_MINOR_VERSION` を `5` に更新しました。
+- import package 名 `toio` は維持したまま、PyPI distribution 名を `toio-py-fork` とする独自 fork 配布を開始しました。
+- scanner に scan strategy を追加しました。
+  - `strategy="best"` は timeout まで scan を続け、sort 後の最良候補を返します。
+  - `strategy="quick"` は指定数の cube が見つかった時点で scan を終了して返します。
+- `MultipleToioCoreCubes` および `ToioCoreCube` の `__init__` にキーワード引数（`**kwargs`）のサポートを追加しました。これにより、`strategy="quick"` などのスキャン設定を直感的に指定できるようになりました。
+- scanner strategy は、`scan(num=N)` が常に timeout まで待つ一方で、cube ID や BLE address を指定した scan は対象がすべて見つかった時点で終了することを指摘した [toio/toio.py#15](https://github.com/toio/toio.py/issues/15) への対応として追加しました。
+- `UniversalBleScanner.scan_best()` と `UniversalBleScanner.scan_quick()` の helper を追加しました。
+- scanner strategy 値の validation を追加しました。
+- 実機 cube を必要としない definition-level test を追加しました。
+  - `connect()` / `disconnect()` が `None` を返す Bleak version 向けの BLE connection state handling。
+  - `set_collision_detection_threshold()` の configuration command byte。
+  - `best` / `quick` の scanner strategy 動作。
+  - `CubeInfo` からの `ToioCoreCube` 初期化。
+- この fork 専用の changelog を追加しました。
+
+### 変更
+
+- package management を Poetry から uv に移行し、build backend を Hatchling に変更しました。
+- `poetry.lock` と `poetry.toml` を削除し、`uv.lock` を追加しました。
+- `pyproject.toml` を Poetry metadata 形式から PEP 621 project metadata 形式に移行しました。
+- PyPI distribution 名を `toio.py` / `toio-py` から `toio-py-fork` に変更しました。
+- `toio.py-fork` repository 用に project metadata と documentation link を更新しました。
+- 対応 Python version の metadata を Python 3.8.1 以上から Python 3.10 以上に変更しました。
+- Bleak の requirement を `bleak>=3,<4` に更新しました。
+- development dependency group から Poetry 自体を削除しました。
+- uv ベースの project layout に合わせて tests と tooling metadata を更新しました。
+
+### 修正
+
+- `Configuration.set_collision_detection_threshold()` が horizontal detection threshold command ではなく `SetCollisionDetectionThreshold` を送信するよう修正しました。
+- `connect()` / `disconnect()` が `None` を返す Bleak version に対応するため、`BleCube.connect()` と `BleCube.disconnect()` の handling を修正しました。
+- `BleCube` の connection state tracking を修正し、connect / disconnect 後に `self.connected` が `BleakClient.is_connected` に追従するようにしました。
+- `CubeInfo` を使った `ToioCoreCube` 初期化を修正しました。
+  - `CubeInfo.interface` を実際の cube interface として使うようにしました。
+  - 明示的に name が指定されていない場合は `CubeInfo.name` を default cube name として使うようにしました。
+- 説明文では `CubeInfo` で初期化できると読める一方で、実際には `CubeInfo` 自体を cube interface として扱ってしまい `connect()` に失敗する [toio/toio.py#14](https://github.com/toio/toio.py/issues/14) への対応として、`ToioCoreCube` の `CubeInfo` 初期化を修正しました。
+- README の sample code で `ToioCoreCube` に `CubeInfo` を直接渡す例を追加しました。
+- README の motor notification example で `Motor.is_my_data()` を使って notification を parse するよう修正しました。
+- README sample の古い argument や末尾の不要な空行を修正しました。
+- definition-only test 実行時に、実機 cube の setup を skip するよう修正しました。
+- `_cubes.py` を生成する test helper command で、正しい script path を使い path を安全に quote するよう修正しました。
+
+### ドキュメント
+
+- この repository が Sony Interactive Entertainment Inc. または toio(tm) と提携、承認、支援関係にない独立した非公式 fork であることを README に追記しました。
+- setup guide と contribution instruction を `toio.py-fork` repository URL と `toio-py-fork` distribution 名に更新しました。
+- README の installation example を `toio-py-fork` に更新しました。
+- fork distribution に合わせて repository、package、contribution 関連の参照を更新しました。
+- [toio/toio.py#14](https://github.com/toio/toio.py/issues/14) に対する `CubeInfo` 初期化修正の説明を追加しました。
+- [toio/toio.py#15](https://github.com/toio/toio.py/issues/15) に対する scanner strategy の使い方と対応関係を説明しました。

toio_py_fork-1.1.0.post2.dev1/CHANGELOG_FORK.md

@@ -0,0 +1,66 @@
+# Changelog for toio.py-fork
+
+This file summarizes changes made in the independent `toio.py-fork` branch.
+For the upstream project changelog, see [CHANGELOG.md](./CHANGELOG.md).
+
+## [Unreleased]
+
+### Added
+
+- Added support for toio core cube technical specification v2.5.0:
+  - Added Speaker Mute settings: `SetSpeakerMute` (command 0x33) and `ResponseSpeakerMuteSettings` (response 0xB3).
+  - Added Configuration Reset: `ResetConfiguration` (command 0x0F) and `ResponseConfigurationReset` (response 0x8F).
+  - Added Remote Power Off: `RequestRemotePowerOff` (command 0x34) and `ResponseRemotePowerOff` (response 0xB4).
+  - Added Get Current Connection Interval: `GetCurrentConnectionIntervalValue` (command 0x32) and `ResponseGettingCurrentConnectionInterval` (response 0xB2).
+  - Added Smooth Indicator Flashing: `SmoothFlashing` (command 0x70).
+  - Integrated these features into `AsyncSimpleCube`.
+- Updated `SUPPORTED_MINOR_VERSION` to `5` in `ToioCoreCube`.
+- Added scanner scan strategies:
+  - `strategy="best"` keeps scanning until timeout and returns the best sorted candidates.
+  - `strategy="quick"` returns as soon as the requested number of cubes are found.
+- Added keyword argument (`**kwargs`) support to `MultipleToioCoreCubes` and `ToioCoreCube` initialization. This allows intuitive configuration of scan settings, such as `strategy="quick"`.
+- Added the scanner strategies in response to [toio/toio.py#15](https://github.com/toio/toio.py/issues/15), which reported that `scan(num=N)` always waited for the full timeout while scans by cube ID or BLE address terminated early.
+- Added `UniversalBleScanner.scan_best()` and `UniversalBleScanner.scan_quick()` helpers.
+- Added validation for scanner strategy values.
+- Added definition-level tests that do not require physical cubes:
+  - BLE connection state handling for Bleak versions whose `connect()` and `disconnect()` methods return `None`.
+  - Configuration command bytes for `set_collision_detection_threshold()`.
+  - Scanner strategy behavior for `best` and `quick`.
+  - `ToioCoreCube` initialization from `CubeInfo`.
+- Added this fork-specific changelog.
+
+### Changed
+
+- Migrated package management from Poetry to uv with Hatchling as the build backend.
+- Replaced `poetry.lock` and `poetry.toml` with `uv.lock`.
+- Converted `pyproject.toml` from Poetry metadata to PEP 621 project metadata.
+- Changed the PyPI distribution name from `toio.py` / `toio-py` to `toio-py-fork`.
+- Updated project metadata and documentation links for the `toio.py-fork` repository.
+- Updated the supported Python requirement metadata from Python 3.8.1 or later to Python 3.10 or later.
+- Updated the Bleak requirement to `bleak>=3,<4`.
+- Removed Poetry itself from the development dependency group.
+- Updated tests and tooling metadata for the uv-based project layout.
+
+### Fixed
+
+- Fixed `Configuration.set_collision_detection_threshold()` to send `SetCollisionDetectionThreshold` instead of the horizontal detection threshold command.
+- Fixed `BleCube.connect()` and `BleCube.disconnect()` handling for Bleak versions whose connect and disconnect methods return `None`.
+- Fixed `BleCube` connection state tracking so `self.connected` follows `BleakClient.is_connected` after connect and disconnect operations.
+- Fixed `ToioCoreCube` initialization with `CubeInfo`:
+  - `CubeInfo.interface` is now used as the actual cube interface.
+  - `CubeInfo.name` is used as the default cube name when no explicit name is provided.
+- Fixed `ToioCoreCube` initialization in response to [toio/toio.py#14](https://github.com/toio/toio.py/issues/14), where the documentation described `CubeInfo` initialization but `connect()` failed because the `CubeInfo` object itself was used as the cube interface.
+- Updated README examples to pass `CubeInfo` directly to `ToioCoreCube`.
+- Fixed README motor notification examples to parse notifications with `Motor.is_my_data()`.
+- Fixed README sample cleanup issues, including outdated arguments and trailing blank lines.
+- Fixed definition-only test runs so they skip physical cube setup.
+- Fixed the test helper command that generates `_cubes.py` to use the correct script path and safely quote paths.
+
+### Documentation
+
+- Added a README notice that this repository is an independent, unofficial fork and is not affiliated with, endorsed by, or sponsored by Sony Interactive Entertainment Inc. or toio(tm).
+- Updated setup guides and contribution instructions to use `toio.py-fork` repository URLs and the `toio-py-fork` distribution name.
+- Updated README installation examples to use `toio-py-fork`.
+- Updated repository, package, and contribution references for the fork distribution.
+- Documented the `CubeInfo` initialization fix for issue [toio/toio.py#14](https://github.com/toio/toio.py/issues/14).
+- Documented scanner strategy usage and the relation to issue [toio/toio.py#15](https://github.com/toio/toio.py/issues/15).

toio_py_fork-1.1.0.post2.dev1/CODE_OF_CONDUCT.md

@@ -0,0 +1,78 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+  advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at
+[this form](https://www.jp.playstation.com/form/toio/inquiry/).
+All complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq
+

toio_py_fork-1.1.0.post2.dev1/CONTRIBUTING.md

@@ -0,0 +1,57 @@
+# Contributing to toio.py
+
+Welcome to toio.py! We appreciate your interest in contributing to our project.
+Before contributing to toio.py, please read our [Code of Conduct](./CODE_OF_CONDUCT.md)
+
+## Getting started with development
+
+### Setup
+
+1. [Install poetry](https://python-poetry.org/docs/#installing-with-the-official-installer)
+
+2. Clone the toio.py repository
+
+```
+git clone https://github.com/kaz399/toio.py-fork
+```
+
+3. Run `poetry install` in toio.py repository
+
+```
+cd toio.py-fork
+poetry install
+```
+
+### Lint and format
+
+#### Mandatory:
+
+[`black`](https://black.readthedocs.io/en/stable/) and [`isort`](https://pycqa.github.io/isort/) is used in this project.
+
+```
+poetry run black
+poetry run isort
+```
+
+#### Optional:
+
+Checking with [`flake8`](https://flake8.pycqa.org/en/latest/) or [`mypy`](https://www.mypy-lang.org/) is recommended.
+
+```
+poetry run flake8
+```
+
+```
+poetry run mypy
+```
+
+
+### 
+
+
+## License
+
+By contributing your code,
+- you agree to license your contribution under the MIT License; and
+- you represent that (i) your contribution is entirely your original work, and (ii) you are legally entitled to make your contribution.
+Please note if your employer has rights to intellectual property in your contribution, partially or wholly, you must secure permission from your employer to make your contribution on behalf of that employer before submitting your contribution.

toio_py_fork-1.1.0.post2.dev1/LICENSE

@@ -0,0 +1,7 @@
+©2023 Sony Interactive Entertainment Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.