automatic import of python-blynclight

3 files changed, 699 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..c201efa 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/blynclight-0.12.0.tar.gz
diff --git a/python-blynclight.spec b/python-blynclight.spec
new file mode 100644
index 0000000..cb1eeaa
--- /dev/null
+++ b/python-blynclight.spec
@@ -0,0 +1,697 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-blynclight
+Version:	0.12.0
+Release:	1
+Summary:	Python language bindings for Embrava BlyncLight devices.
+License:	Apache-2.0
+URL:		https://github.com/JnyJny/blynclight.git
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/70/85/eceac425c593c5ab3effd5286fc5ba9669d589dfc4e449709924c46f0820/blynclight-0.12.0.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-typer
+Requires:	python3-hidapi
+Requires:	python3-loguru
+Requires:	python3-bitvector-for-humans
+
+%description
+# `blync`
+
+Control your Embrava BlyncLight from the command-line!
+
+## Usage
+
+Use the `blync` utility to directly control your Embrava BlyncLight:
+
+
+```console
+$ blync -R        # turn the light on with red color and leave it on
+$ blync --off     # turn the light off
+$ blync -RG --dim # turn the light on with yellow color and dim
+$ blync -RBG      # turn the light on with white color
+```
+
+Colors can be specified by values between 0 and 255 using the lower-case
+color options or using the upper-case full value options.
+
+
+```console
+$ blync -r 127                # half intensity red
+$ blync -r 255                # full intensity red
+$ blync -R                    # also full intensity red
+$ blync -r 255 -b 255 -g 255  # full intensity white
+$ blync -RBG                  # full intensity white
+```
+
+
+If that's not enough fun, there are three builtin color modes:
+`fli`, `throbber`, and `rainbow`. All modes continue until the
+user terminates with a Control-C or platform equivalent.
+
+
+```console
+$ blync fli
+$ blync throbber
+$ blync rainbow
+```
+
+## Installation
+
+
+```console
+$ python3 -m pip install blynclight
+$ python3 -m pip install git+https://github.com/JnyJny/blynclight.git # latest
+```
+
+This module depends on
+[hidapi](https://github.com/trezor/cython-hidapi), which supports
+Windows, Linux, FreeBSD and MacOS via a Cython module.
+
+**Usage**:
+
+```console
+$ blync [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `-l, --light-id INTEGER`: Light identifier  [default: 0]
+* `-r, --red INTEGER`: Red color value range: 0 - 255  [default: 0]
+* `-b, --blue INTEGER`: Blue color value range: 0 - 255  [default: 0]
+* `-g, --green INTEGER`: Green color value range: 0 - 255  [default: 0]
+* `-R, --RED`: Full value red [255]
+* `-B, --BLUE`: Full value blue [255]
+* `-G, --GREEN`: Full value green [255]
+* `-o, --off / -n, --on`: Turn the light off/on.  [default: False]
+* `-d, --dim`: Toggle bright/dim mode.  [default: False]
+* `-f, --flash`: Enable flash mode.
+* `-p, --play INTEGER`: Select song: 1-15
+* `--repeat`: Repeat the selected song.  [default: False]
+* `--volume INTEGER`: Set the volume: 1-10  [default: 5]
+* `-a, --list-available`
+* `-v, --verbose`
+* `-V, --version`
+* `--install-completion`: Install completion for the current shell.
+* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `fli`: Flash Light Impressively.
+* `rainbow`: BlyncLights Love Rainbows.
+* `throbber`: BlyncLight Intensifies.
+* `udev-rules`: Generate a Linux udev rules file.
+
+## `blync fli`
+
+Flash Light Impressively.
+
+This mode cycles light color red, blue, green and then repeats. The
+user can specify the interval between color changes and the intesity
+of the colors. Color values specified on the command-line are ignored.
+
+## Examples
+
+
+```console
+$ blync fli -n 1      # one second between color changes
+$ blync fli -i 128    # light intensity is half as bright
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync fli [OPTIONS]
+```
+
+**Options**:
+
+* `-n, --interval FLOAT`: Seconds between flashes.  [default: 0.1]
+* `-i, --intensity INTEGER`: Integer range: 0 - 255  [default: 255]
+* `--help`: Show this message and exit.
+
+## `blync rainbow`
+
+BlyncLights Love Rainbows.
+
+Smoothly transition the color of the light using a rainbow sequence.
+The user can slow the speed of the color cycling by adding more
+--slow options to the command line:
+
+## Examples
+
+
+```console
+$ blync rainbow -s   # slow cycling by 0.1 seconds
+$ blync rainbow -ss  # slow cycling by 0.15 seconds
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync rainbow [OPTIONS]
+```
+
+**Options**:
+
+* `-s, --slow`: Increase color cycle interval by 0.1 seconds.
+* `--help`: Show this message and exit.
+
+## `blync throbber`
+
+BlyncLight Intensifies.
+
+This mode increases the intensity of the light color starting with
+the specified red, green and blue values and ramping the color
+intensity up and down and repeating. The user can increase the rate
+of ramp by adding more -f options to the command line:
+
+## Examples
+
+
+```console
+$ blync throbber -f   # a little faster
+$ blync throbber -ff  # a little more faster
+$ blync -G throbber   # throb with a green color
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync throbber [OPTIONS]
+```
+
+**Options**:
+
+* `-f, --faster`: Increases speed.
+* `--help`: Show this message and exit.
+
+## `blync udev-rules`
+
+Generate a Linux udev rules file.
+
+Linux uses the udev subsystem to manage USB devices as they are
+plugged and unplugged. By default, only the root user has read and
+write access. The rules generated grant read/write access to all users
+for all known Embrava device vendor ids. Modify the rules to suit your
+particular environment.
+
+Example:
+
+
+```
+$ blync udev-rules -o 99-blynclight.rules
+$ sudo cp 99-blynclight.rules /etc/udev/rules.d
+$ sudo udevadm control -R
+# unplug/plug USB devices
+```
+
+**Usage**:
+
+```console
+$ blync udev-rules [OPTIONS]
+```
+
+**Options**:
+
+* `-o, --output PATH`: Save udev rules to this file.
+* `--help`: Show this message and exit.
+
+
+%package -n python3-blynclight
+Summary:	Python language bindings for Embrava BlyncLight devices.
+Provides:	python-blynclight
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-blynclight
+# `blync`
+
+Control your Embrava BlyncLight from the command-line!
+
+## Usage
+
+Use the `blync` utility to directly control your Embrava BlyncLight:
+
+
+```console
+$ blync -R        # turn the light on with red color and leave it on
+$ blync --off     # turn the light off
+$ blync -RG --dim # turn the light on with yellow color and dim
+$ blync -RBG      # turn the light on with white color
+```
+
+Colors can be specified by values between 0 and 255 using the lower-case
+color options or using the upper-case full value options.
+
+
+```console
+$ blync -r 127                # half intensity red
+$ blync -r 255                # full intensity red
+$ blync -R                    # also full intensity red
+$ blync -r 255 -b 255 -g 255  # full intensity white
+$ blync -RBG                  # full intensity white
+```
+
+
+If that's not enough fun, there are three builtin color modes:
+`fli`, `throbber`, and `rainbow`. All modes continue until the
+user terminates with a Control-C or platform equivalent.
+
+
+```console
+$ blync fli
+$ blync throbber
+$ blync rainbow
+```
+
+## Installation
+
+
+```console
+$ python3 -m pip install blynclight
+$ python3 -m pip install git+https://github.com/JnyJny/blynclight.git # latest
+```
+
+This module depends on
+[hidapi](https://github.com/trezor/cython-hidapi), which supports
+Windows, Linux, FreeBSD and MacOS via a Cython module.
+
+**Usage**:
+
+```console
+$ blync [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `-l, --light-id INTEGER`: Light identifier  [default: 0]
+* `-r, --red INTEGER`: Red color value range: 0 - 255  [default: 0]
+* `-b, --blue INTEGER`: Blue color value range: 0 - 255  [default: 0]
+* `-g, --green INTEGER`: Green color value range: 0 - 255  [default: 0]
+* `-R, --RED`: Full value red [255]
+* `-B, --BLUE`: Full value blue [255]
+* `-G, --GREEN`: Full value green [255]
+* `-o, --off / -n, --on`: Turn the light off/on.  [default: False]
+* `-d, --dim`: Toggle bright/dim mode.  [default: False]
+* `-f, --flash`: Enable flash mode.
+* `-p, --play INTEGER`: Select song: 1-15
+* `--repeat`: Repeat the selected song.  [default: False]
+* `--volume INTEGER`: Set the volume: 1-10  [default: 5]
+* `-a, --list-available`
+* `-v, --verbose`
+* `-V, --version`
+* `--install-completion`: Install completion for the current shell.
+* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `fli`: Flash Light Impressively.
+* `rainbow`: BlyncLights Love Rainbows.
+* `throbber`: BlyncLight Intensifies.
+* `udev-rules`: Generate a Linux udev rules file.
+
+## `blync fli`
+
+Flash Light Impressively.
+
+This mode cycles light color red, blue, green and then repeats. The
+user can specify the interval between color changes and the intesity
+of the colors. Color values specified on the command-line are ignored.
+
+## Examples
+
+
+```console
+$ blync fli -n 1      # one second between color changes
+$ blync fli -i 128    # light intensity is half as bright
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync fli [OPTIONS]
+```
+
+**Options**:
+
+* `-n, --interval FLOAT`: Seconds between flashes.  [default: 0.1]
+* `-i, --intensity INTEGER`: Integer range: 0 - 255  [default: 255]
+* `--help`: Show this message and exit.
+
+## `blync rainbow`
+
+BlyncLights Love Rainbows.
+
+Smoothly transition the color of the light using a rainbow sequence.
+The user can slow the speed of the color cycling by adding more
+--slow options to the command line:
+
+## Examples
+
+
+```console
+$ blync rainbow -s   # slow cycling by 0.1 seconds
+$ blync rainbow -ss  # slow cycling by 0.15 seconds
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync rainbow [OPTIONS]
+```
+
+**Options**:
+
+* `-s, --slow`: Increase color cycle interval by 0.1 seconds.
+* `--help`: Show this message and exit.
+
+## `blync throbber`
+
+BlyncLight Intensifies.
+
+This mode increases the intensity of the light color starting with
+the specified red, green and blue values and ramping the color
+intensity up and down and repeating. The user can increase the rate
+of ramp by adding more -f options to the command line:
+
+## Examples
+
+
+```console
+$ blync throbber -f   # a little faster
+$ blync throbber -ff  # a little more faster
+$ blync -G throbber   # throb with a green color
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync throbber [OPTIONS]
+```
+
+**Options**:
+
+* `-f, --faster`: Increases speed.
+* `--help`: Show this message and exit.
+
+## `blync udev-rules`
+
+Generate a Linux udev rules file.
+
+Linux uses the udev subsystem to manage USB devices as they are
+plugged and unplugged. By default, only the root user has read and
+write access. The rules generated grant read/write access to all users
+for all known Embrava device vendor ids. Modify the rules to suit your
+particular environment.
+
+Example:
+
+
+```
+$ blync udev-rules -o 99-blynclight.rules
+$ sudo cp 99-blynclight.rules /etc/udev/rules.d
+$ sudo udevadm control -R
+# unplug/plug USB devices
+```
+
+**Usage**:
+
+```console
+$ blync udev-rules [OPTIONS]
+```
+
+**Options**:
+
+* `-o, --output PATH`: Save udev rules to this file.
+* `--help`: Show this message and exit.
+
+
+%package help
+Summary:	Development documents and examples for blynclight
+Provides:	python3-blynclight-doc
+%description help
+# `blync`
+
+Control your Embrava BlyncLight from the command-line!
+
+## Usage
+
+Use the `blync` utility to directly control your Embrava BlyncLight:
+
+
+```console
+$ blync -R        # turn the light on with red color and leave it on
+$ blync --off     # turn the light off
+$ blync -RG --dim # turn the light on with yellow color and dim
+$ blync -RBG      # turn the light on with white color
+```
+
+Colors can be specified by values between 0 and 255 using the lower-case
+color options or using the upper-case full value options.
+
+
+```console
+$ blync -r 127                # half intensity red
+$ blync -r 255                # full intensity red
+$ blync -R                    # also full intensity red
+$ blync -r 255 -b 255 -g 255  # full intensity white
+$ blync -RBG                  # full intensity white
+```
+
+
+If that's not enough fun, there are three builtin color modes:
+`fli`, `throbber`, and `rainbow`. All modes continue until the
+user terminates with a Control-C or platform equivalent.
+
+
+```console
+$ blync fli
+$ blync throbber
+$ blync rainbow
+```
+
+## Installation
+
+
+```console
+$ python3 -m pip install blynclight
+$ python3 -m pip install git+https://github.com/JnyJny/blynclight.git # latest
+```
+
+This module depends on
+[hidapi](https://github.com/trezor/cython-hidapi), which supports
+Windows, Linux, FreeBSD and MacOS via a Cython module.
+
+**Usage**:
+
+```console
+$ blync [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `-l, --light-id INTEGER`: Light identifier  [default: 0]
+* `-r, --red INTEGER`: Red color value range: 0 - 255  [default: 0]
+* `-b, --blue INTEGER`: Blue color value range: 0 - 255  [default: 0]
+* `-g, --green INTEGER`: Green color value range: 0 - 255  [default: 0]
+* `-R, --RED`: Full value red [255]
+* `-B, --BLUE`: Full value blue [255]
+* `-G, --GREEN`: Full value green [255]
+* `-o, --off / -n, --on`: Turn the light off/on.  [default: False]
+* `-d, --dim`: Toggle bright/dim mode.  [default: False]
+* `-f, --flash`: Enable flash mode.
+* `-p, --play INTEGER`: Select song: 1-15
+* `--repeat`: Repeat the selected song.  [default: False]
+* `--volume INTEGER`: Set the volume: 1-10  [default: 5]
+* `-a, --list-available`
+* `-v, --verbose`
+* `-V, --version`
+* `--install-completion`: Install completion for the current shell.
+* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `fli`: Flash Light Impressively.
+* `rainbow`: BlyncLights Love Rainbows.
+* `throbber`: BlyncLight Intensifies.
+* `udev-rules`: Generate a Linux udev rules file.
+
+## `blync fli`
+
+Flash Light Impressively.
+
+This mode cycles light color red, blue, green and then repeats. The
+user can specify the interval between color changes and the intesity
+of the colors. Color values specified on the command-line are ignored.
+
+## Examples
+
+
+```console
+$ blync fli -n 1      # one second between color changes
+$ blync fli -i 128    # light intensity is half as bright
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync fli [OPTIONS]
+```
+
+**Options**:
+
+* `-n, --interval FLOAT`: Seconds between flashes.  [default: 0.1]
+* `-i, --intensity INTEGER`: Integer range: 0 - 255  [default: 255]
+* `--help`: Show this message and exit.
+
+## `blync rainbow`
+
+BlyncLights Love Rainbows.
+
+Smoothly transition the color of the light using a rainbow sequence.
+The user can slow the speed of the color cycling by adding more
+--slow options to the command line:
+
+## Examples
+
+
+```console
+$ blync rainbow -s   # slow cycling by 0.1 seconds
+$ blync rainbow -ss  # slow cycling by 0.15 seconds
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync rainbow [OPTIONS]
+```
+
+**Options**:
+
+* `-s, --slow`: Increase color cycle interval by 0.1 seconds.
+* `--help`: Show this message and exit.
+
+## `blync throbber`
+
+BlyncLight Intensifies.
+
+This mode increases the intensity of the light color starting with
+the specified red, green and blue values and ramping the color
+intensity up and down and repeating. The user can increase the rate
+of ramp by adding more -f options to the command line:
+
+## Examples
+
+
+```console
+$ blync throbber -f   # a little faster
+$ blync throbber -ff  # a little more faster
+$ blync -G throbber   # throb with a green color
+```
+
+This mode runs until the user interrupts.
+
+**Usage**:
+
+```console
+$ blync throbber [OPTIONS]
+```
+
+**Options**:
+
+* `-f, --faster`: Increases speed.
+* `--help`: Show this message and exit.
+
+## `blync udev-rules`
+
+Generate a Linux udev rules file.
+
+Linux uses the udev subsystem to manage USB devices as they are
+plugged and unplugged. By default, only the root user has read and
+write access. The rules generated grant read/write access to all users
+for all known Embrava device vendor ids. Modify the rules to suit your
+particular environment.
+
+Example:
+
+
+```
+$ blync udev-rules -o 99-blynclight.rules
+$ sudo cp 99-blynclight.rules /etc/udev/rules.d
+$ sudo udevadm control -R
+# unplug/plug USB devices
+```
+
+**Usage**:
+
+```console
+$ blync udev-rules [OPTIONS]
+```
+
+**Options**:
+
+* `-o, --output PATH`: Save udev rules to this file.
+* `--help`: Show this message and exit.
+
+
+%prep
+%autosetup -n blynclight-0.12.0
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-blynclight -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Wed May 31 2023 Python_Bot <Python_Bot@openeuler.org> - 0.12.0-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..c6e1085
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+8c28dd0ff39c6858156782367fd32829  blynclight-0.12.0.tar.gz