diff options
Diffstat (limited to 'python-clickgen.spec')
| -rw-r--r-- | python-clickgen.spec | 672 |
1 files changed, 672 insertions, 0 deletions
diff --git a/python-clickgen.spec b/python-clickgen.spec new file mode 100644 index 0000000..6e60cad --- /dev/null +++ b/python-clickgen.spec @@ -0,0 +1,672 @@ +%global _empty_manifest_terminate_build 0 +Name: python-clickgen +Version: 2.1.3 +Release: 1 +Summary: The hassle-free cursor building toolbox. +License: MIT License +URL: https://github.com/ful1e5/clickgen +Source0: https://mirrors.aliyun.com/pypi/web/packages/29/6e/95f98c8f8eb4af847fc856a7f155f1ee3dc3fa20adda61561acf94c8ba84/clickgen-2.1.3.tar.gz +BuildArch: noarch + +Requires: python3-Pillow +Requires: python3-toml +Requires: python3-numpy +Requires: python3-wheel +Requires: python3-flake8 +Requires: python3-tox +Requires: python3-mypy +Requires: python3-pytest +Requires: python3-pytest-cov + +%description +# Clickgen + +[](https://github.com/ful1e5/clickgen/actions/workflows/ci.yml) +[](https://codecov.io/gh/ful1e5/clickgen) + +**Clickgen** is cross-platform python library for building **X11** and **Windows** Cursors. +Clickgen's core functionality is heavily inspired by **[quantum5/win2xcur](https://github.com/quantum5/win2xcur)** +from `clickgen v2.0.0` and onwards. + +##### Become Sponsor + +This library is funded by the community. I appreciate all these wonderful people who patronize and sponsoring me. + +Visit the [GitHub Sponsor](https://github.com/sponsors/ful1e5) page to become a partner. +DM me on [Twitter](https://twitter.com/ful1e5) if your company would like to sponsor this library, +I will gladly look into it and embed your logo in the README. + +##### Sponsors + +<!-- Add your name and avatar here with the Pull Request in case I missed it. --> + +Be you first. + +## Notices + +- **2022-06-15:** Docker Image support deprecated due to cross-platform compatibility. +- **2022-07-09:** :warning: All the **functionality and modules are removed from older versions in `v2.0.0`**. + I will be restricting any updates to the `>=v1.2.0` versions to security updates and hotfixes. + Check updated documentations for [building cursors from API](#api-examples) and [CLIs](#clis) usage. + +## Requirements + +- Python version 3.7 or higher +- [Pillow](https://pypi.org/project/Pillow) >= 8.1.1 +- [toml](https://pypi.org/project/toml) >= 0.10.2 +- [numpy](https://pypi.org/project/numpy) >= 1.21.6 + +## Install + +```bash +pip3 install clickgen +``` + +> **Note** +> Distributions' packages are not affiliated with clickgen developers. +> If you encounter any issues with the incorrect installation, you should contact the package maintainer first. + +### Arch Linux + +- [AUR](https://aur.archlinux.org/packages/python-clickgen) + +## Usage + +### `clickgen` CLI + +#### Linux Format (XCursor) + +For example, if you have to build [ponter.png](https://github.com/ful1e5/clickgen/blob/main/samples/pngs/pointer.png) +file to Linux Format: + +``` +clickgen samples/pngs/pointer.png -x 10 -y 10 -s 22 24 32 -p x11 +``` + +You also **build animated Xcursor** by providing multiple png files to argument and animation delay with `-d`: + +``` +clickgen samples/pngs/wait-001.png samples/pngs/wait-001.png -d 3 -x 10 -y 10 -s 22 24 32 -p x11 +``` + +#### Windows Formats (.cur and .ani) + +To build [ponter.png](https://github.com/ful1e5/clickgen/blob/main/samples/pngs/pointer.png) +file to Windows Format (`.cur`): + +> **Warning: Windows Cursor only support single size.** + +``` +clickgen samples/pngs/pointer.png -x 10 -y 10 -s 32 -p windows +``` + +For **animated Windows Cursor** (`.ani`): + +``` +clickgen samples/pngs/wait-001.png samples/pngs/wait-001.png -d 3 -x 10 -y 10 -s 32 -p windows +``` + +For more information, run `clickgen --help`. + +### `ctgen` CLI + +This CLI allow you to generate Windows and Linux Cursor themes from config (.toml) file. + +``` +ctgen theme.toml +``` + +You also provide multiple theme configuration file once as following: + +``` +ctgen theme1.toml theme2.toml +``` + +Override theme's `name` of theme with `-n` option: + +``` +ctgen theme1.toml -n "New Theme" +``` + +You can run `ctgen --help` to view all available options and you also check +[samples](https://github.com/ful1e5/clickgen/blob/main/samples) directory for more information. + +### API Examples + +### Static `XCursor` + +```python +from clickgen.parser import open_blob +from clickgen.writer import to_x11 + +with open("samples/pngs/pointer.png", "rb") as p: + cur = open_blob([p.read()], hotspot=(50, 50)) + + # save X11 static cursor + xresult = to_x11(cur.frames) + with open("xtest", "wb") as o: + o.write(xresult) +``` + +### Animated `XCursor` + +```python +from glob import glob + +from clickgen.parser import open_blob +from clickgen.writer import to_x11 + +# Get .png files from directory +fnames = glob("samples/pngs/wait-*.png") +pngs: List[bytes] = [] + +# Reading as bytes +for f in sorted(fnames): + with open(f, "rb") as p: + pngs.append(p.read()) + +cur = open_blob(pngs, hotspot=(100, 100)) + +# save X11 animated cursor +result = to_x11(cur.frames) +with open("animated-xtest", "wb") as o: + o.write(result) +``` + +### Static `Windows Cursor` (.cur) + +```python +from clickgen.parser import open_blob +from clickgen.writer import to_win + +with open("samples/pngs/pointer.png", "rb") as p: + cur = open_blob([p.read()], hotspot=(50, 50)) + + # save Windows static cursor + ext, result = to_win(cur.frames) + with open(f"test{ext}", "wb") as o: + o.write(result) +``` + +### Animated `Windows Cursor` (.ani) + +```python +from glob import glob + +from clickgen.parser import open_blob +from clickgen.writer import to_win + +# Get .png files from directory +fnames = glob("samples/pngs/wait-*.png") +pngs: List[bytes] = [] + +# Reading as bytes +for f in sorted(fnames): + with open(f, "rb") as p: + pngs.append(p.read()) + +cur = open_blob(pngs, hotspot=(100, 100)) + +# save Windows animated cursor +ext, result = to_win(cur.frames) +with open(f"test-ani{ext}", "wb") as o: + o.write(aresult) +``` + +### Documentation + +Check [wiki](https://github.com/ful1e5/clickgen/wiki) for documentation. + + +%package -n python3-clickgen +Summary: The hassle-free cursor building toolbox. +Provides: python-clickgen +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-clickgen +# Clickgen + +[](https://github.com/ful1e5/clickgen/actions/workflows/ci.yml) +[](https://codecov.io/gh/ful1e5/clickgen) + +**Clickgen** is cross-platform python library for building **X11** and **Windows** Cursors. +Clickgen's core functionality is heavily inspired by **[quantum5/win2xcur](https://github.com/quantum5/win2xcur)** +from `clickgen v2.0.0` and onwards. + +##### Become Sponsor + +This library is funded by the community. I appreciate all these wonderful people who patronize and sponsoring me. + +Visit the [GitHub Sponsor](https://github.com/sponsors/ful1e5) page to become a partner. +DM me on [Twitter](https://twitter.com/ful1e5) if your company would like to sponsor this library, +I will gladly look into it and embed your logo in the README. + +##### Sponsors + +<!-- Add your name and avatar here with the Pull Request in case I missed it. --> + +Be you first. + +## Notices + +- **2022-06-15:** Docker Image support deprecated due to cross-platform compatibility. +- **2022-07-09:** :warning: All the **functionality and modules are removed from older versions in `v2.0.0`**. + I will be restricting any updates to the `>=v1.2.0` versions to security updates and hotfixes. + Check updated documentations for [building cursors from API](#api-examples) and [CLIs](#clis) usage. + +## Requirements + +- Python version 3.7 or higher +- [Pillow](https://pypi.org/project/Pillow) >= 8.1.1 +- [toml](https://pypi.org/project/toml) >= 0.10.2 +- [numpy](https://pypi.org/project/numpy) >= 1.21.6 + +## Install + +```bash +pip3 install clickgen +``` + +> **Note** +> Distributions' packages are not affiliated with clickgen developers. +> If you encounter any issues with the incorrect installation, you should contact the package maintainer first. + +### Arch Linux + +- [AUR](https://aur.archlinux.org/packages/python-clickgen) + +## Usage + +### `clickgen` CLI + +#### Linux Format (XCursor) + +For example, if you have to build [ponter.png](https://github.com/ful1e5/clickgen/blob/main/samples/pngs/pointer.png) +file to Linux Format: + +``` +clickgen samples/pngs/pointer.png -x 10 -y 10 -s 22 24 32 -p x11 +``` + +You also **build animated Xcursor** by providing multiple png files to argument and animation delay with `-d`: + +``` +clickgen samples/pngs/wait-001.png samples/pngs/wait-001.png -d 3 -x 10 -y 10 -s 22 24 32 -p x11 +``` + +#### Windows Formats (.cur and .ani) + +To build [ponter.png](https://github.com/ful1e5/clickgen/blob/main/samples/pngs/pointer.png) +file to Windows Format (`.cur`): + +> **Warning: Windows Cursor only support single size.** + +``` +clickgen samples/pngs/pointer.png -x 10 -y 10 -s 32 -p windows +``` + +For **animated Windows Cursor** (`.ani`): + +``` +clickgen samples/pngs/wait-001.png samples/pngs/wait-001.png -d 3 -x 10 -y 10 -s 32 -p windows +``` + +For more information, run `clickgen --help`. + +### `ctgen` CLI + +This CLI allow you to generate Windows and Linux Cursor themes from config (.toml) file. + +``` +ctgen theme.toml +``` + +You also provide multiple theme configuration file once as following: + +``` +ctgen theme1.toml theme2.toml +``` + +Override theme's `name` of theme with `-n` option: + +``` +ctgen theme1.toml -n "New Theme" +``` + +You can run `ctgen --help` to view all available options and you also check +[samples](https://github.com/ful1e5/clickgen/blob/main/samples) directory for more information. + +### API Examples + +### Static `XCursor` + +```python +from clickgen.parser import open_blob +from clickgen.writer import to_x11 + +with open("samples/pngs/pointer.png", "rb") as p: + cur = open_blob([p.read()], hotspot=(50, 50)) + + # save X11 static cursor + xresult = to_x11(cur.frames) + with open("xtest", "wb") as o: + o.write(xresult) +``` + +### Animated `XCursor` + +```python +from glob import glob + +from clickgen.parser import open_blob +from clickgen.writer import to_x11 + +# Get .png files from directory +fnames = glob("samples/pngs/wait-*.png") +pngs: List[bytes] = [] + +# Reading as bytes +for f in sorted(fnames): + with open(f, "rb") as p: + pngs.append(p.read()) + +cur = open_blob(pngs, hotspot=(100, 100)) + +# save X11 animated cursor +result = to_x11(cur.frames) +with open("animated-xtest", "wb") as o: + o.write(result) +``` + +### Static `Windows Cursor` (.cur) + +```python +from clickgen.parser import open_blob +from clickgen.writer import to_win + +with open("samples/pngs/pointer.png", "rb") as p: + cur = open_blob([p.read()], hotspot=(50, 50)) + + # save Windows static cursor + ext, result = to_win(cur.frames) + with open(f"test{ext}", "wb") as o: + o.write(result) +``` + +### Animated `Windows Cursor` (.ani) + +```python +from glob import glob + +from clickgen.parser import open_blob +from clickgen.writer import to_win + +# Get .png files from directory +fnames = glob("samples/pngs/wait-*.png") +pngs: List[bytes] = [] + +# Reading as bytes +for f in sorted(fnames): + with open(f, "rb") as p: + pngs.append(p.read()) + +cur = open_blob(pngs, hotspot=(100, 100)) + +# save Windows animated cursor +ext, result = to_win(cur.frames) +with open(f"test-ani{ext}", "wb") as o: + o.write(aresult) +``` + +### Documentation + +Check [wiki](https://github.com/ful1e5/clickgen/wiki) for documentation. + + +%package help +Summary: Development documents and examples for clickgen +Provides: python3-clickgen-doc +%description help +# Clickgen + +[](https://github.com/ful1e5/clickgen/actions/workflows/ci.yml) +[](https://codecov.io/gh/ful1e5/clickgen) + +**Clickgen** is cross-platform python library for building **X11** and **Windows** Cursors. +Clickgen's core functionality is heavily inspired by **[quantum5/win2xcur](https://github.com/quantum5/win2xcur)** +from `clickgen v2.0.0` and onwards. + +##### Become Sponsor + +This library is funded by the community. I appreciate all these wonderful people who patronize and sponsoring me. + +Visit the [GitHub Sponsor](https://github.com/sponsors/ful1e5) page to become a partner. +DM me on [Twitter](https://twitter.com/ful1e5) if your company would like to sponsor this library, +I will gladly look into it and embed your logo in the README. + +##### Sponsors + +<!-- Add your name and avatar here with the Pull Request in case I missed it. --> + +Be you first. + +## Notices + +- **2022-06-15:** Docker Image support deprecated due to cross-platform compatibility. +- **2022-07-09:** :warning: All the **functionality and modules are removed from older versions in `v2.0.0`**. + I will be restricting any updates to the `>=v1.2.0` versions to security updates and hotfixes. + Check updated documentations for [building cursors from API](#api-examples) and [CLIs](#clis) usage. + +## Requirements + +- Python version 3.7 or higher +- [Pillow](https://pypi.org/project/Pillow) >= 8.1.1 +- [toml](https://pypi.org/project/toml) >= 0.10.2 +- [numpy](https://pypi.org/project/numpy) >= 1.21.6 + +## Install + +```bash +pip3 install clickgen +``` + +> **Note** +> Distributions' packages are not affiliated with clickgen developers. +> If you encounter any issues with the incorrect installation, you should contact the package maintainer first. + +### Arch Linux + +- [AUR](https://aur.archlinux.org/packages/python-clickgen) + +## Usage + +### `clickgen` CLI + +#### Linux Format (XCursor) + +For example, if you have to build [ponter.png](https://github.com/ful1e5/clickgen/blob/main/samples/pngs/pointer.png) +file to Linux Format: + +``` +clickgen samples/pngs/pointer.png -x 10 -y 10 -s 22 24 32 -p x11 +``` + +You also **build animated Xcursor** by providing multiple png files to argument and animation delay with `-d`: + +``` +clickgen samples/pngs/wait-001.png samples/pngs/wait-001.png -d 3 -x 10 -y 10 -s 22 24 32 -p x11 +``` + +#### Windows Formats (.cur and .ani) + +To build [ponter.png](https://github.com/ful1e5/clickgen/blob/main/samples/pngs/pointer.png) +file to Windows Format (`.cur`): + +> **Warning: Windows Cursor only support single size.** + +``` +clickgen samples/pngs/pointer.png -x 10 -y 10 -s 32 -p windows +``` + +For **animated Windows Cursor** (`.ani`): + +``` +clickgen samples/pngs/wait-001.png samples/pngs/wait-001.png -d 3 -x 10 -y 10 -s 32 -p windows +``` + +For more information, run `clickgen --help`. + +### `ctgen` CLI + +This CLI allow you to generate Windows and Linux Cursor themes from config (.toml) file. + +``` +ctgen theme.toml +``` + +You also provide multiple theme configuration file once as following: + +``` +ctgen theme1.toml theme2.toml +``` + +Override theme's `name` of theme with `-n` option: + +``` +ctgen theme1.toml -n "New Theme" +``` + +You can run `ctgen --help` to view all available options and you also check +[samples](https://github.com/ful1e5/clickgen/blob/main/samples) directory for more information. + +### API Examples + +### Static `XCursor` + +```python +from clickgen.parser import open_blob +from clickgen.writer import to_x11 + +with open("samples/pngs/pointer.png", "rb") as p: + cur = open_blob([p.read()], hotspot=(50, 50)) + + # save X11 static cursor + xresult = to_x11(cur.frames) + with open("xtest", "wb") as o: + o.write(xresult) +``` + +### Animated `XCursor` + +```python +from glob import glob + +from clickgen.parser import open_blob +from clickgen.writer import to_x11 + +# Get .png files from directory +fnames = glob("samples/pngs/wait-*.png") +pngs: List[bytes] = [] + +# Reading as bytes +for f in sorted(fnames): + with open(f, "rb") as p: + pngs.append(p.read()) + +cur = open_blob(pngs, hotspot=(100, 100)) + +# save X11 animated cursor +result = to_x11(cur.frames) +with open("animated-xtest", "wb") as o: + o.write(result) +``` + +### Static `Windows Cursor` (.cur) + +```python +from clickgen.parser import open_blob +from clickgen.writer import to_win + +with open("samples/pngs/pointer.png", "rb") as p: + cur = open_blob([p.read()], hotspot=(50, 50)) + + # save Windows static cursor + ext, result = to_win(cur.frames) + with open(f"test{ext}", "wb") as o: + o.write(result) +``` + +### Animated `Windows Cursor` (.ani) + +```python +from glob import glob + +from clickgen.parser import open_blob +from clickgen.writer import to_win + +# Get .png files from directory +fnames = glob("samples/pngs/wait-*.png") +pngs: List[bytes] = [] + +# Reading as bytes +for f in sorted(fnames): + with open(f, "rb") as p: + pngs.append(p.read()) + +cur = open_blob(pngs, hotspot=(100, 100)) + +# save Windows animated cursor +ext, result = to_win(cur.frames) +with open(f"test-ani{ext}", "wb") as o: + o.write(aresult) +``` + +### Documentation + +Check [wiki](https://github.com/ful1e5/clickgen/wiki) for documentation. + + +%prep +%autosetup -n clickgen-2.1.3 + +%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-clickgen -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Jun 20 2023 Python_Bot <Python_Bot@openeuler.org> - 2.1.3-1 +- Package Spec generated |