https://github.com/wwj718/cocube

https://github.com/wwj718/cocube

Last synced: 11 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/wwj718/cocube
• Owner: wwj718
• License: mit
• Created: 2024-07-11T13:17:16.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-10-28T12:26:24.000Z (22 days ago)
• Last Synced: 2024-10-31T00:22:18.770Z (19 days ago)
• Language: Jupyter Notebook
• Size: 13.7 KB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# cocube

## Table of Contents

- [Installation](#installation)

- [Usage](#Usage)

- [License](#license)

## Installation

```console

pip install cocube

```

## Usage

Save [this project(same as Snap!)](https://microblocksfun.cn/run/microblocks.html#project=https://wwj718.github.io/post/img/CoCube-server-dynatalk-v2.ubp) to your MicroBlocks device.

```py

# pip install -U cocube

from cocube import CoCube

client = CoCube()

found_devices = client.discover(timeout=3) # timeout=5 in windows

print("found devices:", found_devices)

client.connect("MicroBlocks QCQ", timeout=3)

client.display_character("c")

while True:

    position_x = client.position_x

    print(position_x)

```

ref: [Snap! 中的 CoCube 库](https://wwj718.github.io/post/%E7%BC%96%E7%A8%8B/snap-cocube/)

### Connect multiple devices

```py

from cocube import CoCube

client = CoCube()

found_devices = client.discover(timeout=5)

print("found devices:", found_devices)

# connect all discovered devices

devices = [CoCube(i) for i in found_devices]

for index, device in enumerate(devices):

    device.display_character(index)

```

### Parallel Control

```py

from concurrent.futures import ThreadPoolExecutor

# Launching parallel tasks: https://docs.python.org/3/library/concurrent.futures.html

with ThreadPoolExecutor() as executor:

    for client in devices:

        executor.submit(client.scroll_text, "hello")

```

## demo

ref: [notebooks](./notebooks)

## License

`cocube` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.