%global _empty_manifest_terminate_build 0
Name: python-pincer
Version: 0.16.1
Release: 1
Summary: Discord API wrapper rebuilt from scratch.
License: MIT
URL: https://pincer.dev
Source0: https://mirrors.nju.edu.cn/pypi/web/packages/2c/79/6f6e8914c7ba4e8ef709728004c81e30a991c693297c9d18be89080ef81e/pincer-0.16.1.tar.gz
BuildArch: noarch
Requires: python3-Brotli
Requires: python3-Pillow
Requires: python3-aiodns
Requires: python3-aiohttp
Requires: python3-cchardet
Requires: python3-orjson
Requires: python3-types-Pillow
%description
# Pincer
[](https://pypi.org/project/Pincer)
[](https://scrutinizer-ci.com/g/Pincer-org/pincer/?branch=main)
[](https://scrutinizer-ci.com/g/Pincer-org/Pincer/build-status/main)
[](https://pincer.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/gh/Pincer-org/Pincer)
[](https://github.com/psf/black)
## :pushpin: Links
> 
｜Join the Discord server: https://discord.gg/pincer
> 
｜The PyPI package: https://pypi.org/project/Pincer
> 
｜Our website: https://pincer.dev
> 📝 | ReadTheDocs: https://pincer.readthedocs.io
## ☄️ Installation
Use the following command to install Pincer into your Python environment:
```sh
pip install pincer
```
To install our version with Aiohttp Speedup, use:
```sh
pip install pincer[speed]
```
⚙️ Didn't work?
Depending on your Python installation, you might need to use one of the
following:
- Python is not in PATH
```sh
path/to/python.exe -m pip install pincer
```
- Python is in PATH but pip is not
```sh
python -m pip install pincer
```
- Unix systems can use pip3/python3 commands
```sh
pip3 install pincer
```
```sh
python3 -m pip install pincer
```
- Using multiple Python versions
```sh
py -m pip install pincer
```
**Client base class example:**
```py
from pincer.client import Bot
# Note that both `Bot` and `Client` are valid!
bot = Bot("YOUR_TOKEN_HERE")
bot.run()
```
**An example on the `on_ready` event**
Pincer bots are required to inherit from the Client.
```py
from time import perf_counter
from pincer import Client
marker = perf_counter()
class Bot(Client):
@Client.event
async def on_ready():
print(f"Logged in as {client.bot} after {perf_counter() - marker} seconds")
client = Bot("YOUR_TOKEN_HERE")
client.run()
```
### Interactions
Pincer makes developing application commands intuitive and fast.
```py
from typing import Annotation # python 3.9+
from typing_extensions import Annotation # python 3.8
from pincer import Client
from pincer.commands import command, CommandArg, Description
from pincer.objects import UserMessage, User
class Bot(Client):
@Client.event
async def on_ready(self) -> None:
...
@command(description="Say something as the bot!")
async def say(self, message: str):
return message
@user_command
async def user_command(self, user: User):
return f"The user is {user}"
@message_command(name="Message command")
async def message_command(self, message: UserMessage):
return f"The message read '{message.content}'"
@command(description="Add two numbers!")
async def add(
self,
first: Annotation[int, Description("The first number")],
second: Annotation[int, Description("The second number")]
):
return f"The addition of `{first}` and `{second}` is `{first + second}`"
```
For more examples, you can take a look at the examples folder or check out our
bot:
>
You can also read the interactions guide for more information:
>
### Advanced Usage
#### Enable the debug mode
_If you want to see everything that is happening under the hood, either out of
curiosity or to get a deeper insight into the implementation of some features,
we provide debug logging!_
```py
import logging
logging.basicConfig(level=logging.DEBUG)
```
#### Middleware
_The middleware system was introduced in version `0.4.0-dev`. This system gives you the
freedom to create custom events and remove the already existing middleware created by
the developers. Your custom middleware directly receives the payload from
Discord. You can't do anything wrong without accessing the `override` attribute, but if
you do access it, the Pincer team will not provide any support for weird behavior.
So, in short, only use this if you know what you're doing. An example of using
the middleware system with a custom `on_ready` event can be found
[in our docs](https://pincer.readthedocs.io/en/latest/pincer.html#pincer.client.middleware).
._
## 🏷️ License
`© 2021 copyright Pincer`
This repository is licensed under the MIT License.
See LICENSE for details.
%package -n python3-pincer
Summary: Discord API wrapper rebuilt from scratch.
Provides: python-pincer
BuildRequires: python3-devel
BuildRequires: python3-setuptools
BuildRequires: python3-pip
%description -n python3-pincer
# Pincer
[](https://pypi.org/project/Pincer)
[](https://scrutinizer-ci.com/g/Pincer-org/pincer/?branch=main)
[](https://scrutinizer-ci.com/g/Pincer-org/Pincer/build-status/main)
[](https://pincer.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/gh/Pincer-org/Pincer)
[](https://github.com/psf/black)
## :pushpin: Links
> ｜Join the Discord server: https://discord.gg/pincer
> ｜The PyPI package: https://pypi.org/project/Pincer
> ｜Our website: https://pincer.dev
> 📝 | ReadTheDocs: https://pincer.readthedocs.io
## ☄️ Installation
Use the following command to install Pincer into your Python environment:
```sh
pip install pincer
```
To install our version with Aiohttp Speedup, use:
```sh
pip install pincer[speed]
```
⚙️ Didn't work?
Depending on your Python installation, you might need to use one of the
following:
- Python is not in PATH
```sh
path/to/python.exe -m pip install pincer
```
- Python is in PATH but pip is not
```sh
python -m pip install pincer
```
- Unix systems can use pip3/python3 commands
```sh
pip3 install pincer
```
```sh
python3 -m pip install pincer
```
- Using multiple Python versions
```sh
py -m pip install pincer
```
**Client base class example:**
```py
from pincer.client import Bot
# Note that both `Bot` and `Client` are valid!
bot = Bot("YOUR_TOKEN_HERE")
bot.run()
```
**An example on the `on_ready` event**
Pincer bots are required to inherit from the Client.
```py
from time import perf_counter
from pincer import Client
marker = perf_counter()
class Bot(Client):
@Client.event
async def on_ready():
print(f"Logged in as {client.bot} after {perf_counter() - marker} seconds")
client = Bot("YOUR_TOKEN_HERE")
client.run()
```
### Interactions
Pincer makes developing application commands intuitive and fast.
```py
from typing import Annotation # python 3.9+
from typing_extensions import Annotation # python 3.8
from pincer import Client
from pincer.commands import command, CommandArg, Description
from pincer.objects import UserMessage, User
class Bot(Client):
@Client.event
async def on_ready(self) -> None:
...
@command(description="Say something as the bot!")
async def say(self, message: str):
return message
@user_command
async def user_command(self, user: User):
return f"The user is {user}"
@message_command(name="Message command")
async def message_command(self, message: UserMessage):
return f"The message read '{message.content}'"
@command(description="Add two numbers!")
async def add(
self,
first: Annotation[int, Description("The first number")],
second: Annotation[int, Description("The second number")]
):
return f"The addition of `{first}` and `{second}` is `{first + second}`"
```
For more examples, you can take a look at the examples folder or check out our
bot:
>
You can also read the interactions guide for more information:
>
### Advanced Usage
#### Enable the debug mode
_If you want to see everything that is happening under the hood, either out of
curiosity or to get a deeper insight into the implementation of some features,
we provide debug logging!_
```py
import logging
logging.basicConfig(level=logging.DEBUG)
```
#### Middleware
_The middleware system was introduced in version `0.4.0-dev`. This system gives you the
freedom to create custom events and remove the already existing middleware created by
the developers. Your custom middleware directly receives the payload from
Discord. You can't do anything wrong without accessing the `override` attribute, but if
you do access it, the Pincer team will not provide any support for weird behavior.
So, in short, only use this if you know what you're doing. An example of using
the middleware system with a custom `on_ready` event can be found
[in our docs](https://pincer.readthedocs.io/en/latest/pincer.html#pincer.client.middleware).
._
## 🏷️ License
`© 2021 copyright Pincer`
This repository is licensed under the MIT License.
See LICENSE for details.
%package help
Summary: Development documents and examples for pincer
Provides: python3-pincer-doc
%description help
# Pincer
[](https://pypi.org/project/Pincer)
[](https://scrutinizer-ci.com/g/Pincer-org/pincer/?branch=main)
[](https://scrutinizer-ci.com/g/Pincer-org/Pincer/build-status/main)
[](https://pincer.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/gh/Pincer-org/Pincer)
[](https://github.com/psf/black)
## :pushpin: Links
> ｜Join the Discord server: https://discord.gg/pincer
> ｜The PyPI package: https://pypi.org/project/Pincer
> ｜Our website: https://pincer.dev
> 📝 | ReadTheDocs: https://pincer.readthedocs.io
## ☄️ Installation
Use the following command to install Pincer into your Python environment:
```sh
pip install pincer
```
To install our version with Aiohttp Speedup, use:
```sh
pip install pincer[speed]
```
⚙️ Didn't work?
Depending on your Python installation, you might need to use one of the
following:
- Python is not in PATH
```sh
path/to/python.exe -m pip install pincer
```
- Python is in PATH but pip is not
```sh
python -m pip install pincer
```
- Unix systems can use pip3/python3 commands
```sh
pip3 install pincer
```
```sh
python3 -m pip install pincer
```
- Using multiple Python versions
```sh
py -m pip install pincer
```
**Client base class example:**
```py
from pincer.client import Bot
# Note that both `Bot` and `Client` are valid!
bot = Bot("YOUR_TOKEN_HERE")
bot.run()
```
**An example on the `on_ready` event**
Pincer bots are required to inherit from the Client.
```py
from time import perf_counter
from pincer import Client
marker = perf_counter()
class Bot(Client):
@Client.event
async def on_ready():
print(f"Logged in as {client.bot} after {perf_counter() - marker} seconds")
client = Bot("YOUR_TOKEN_HERE")
client.run()
```
### Interactions
Pincer makes developing application commands intuitive and fast.
```py
from typing import Annotation # python 3.9+
from typing_extensions import Annotation # python 3.8
from pincer import Client
from pincer.commands import command, CommandArg, Description
from pincer.objects import UserMessage, User
class Bot(Client):
@Client.event
async def on_ready(self) -> None:
...
@command(description="Say something as the bot!")
async def say(self, message: str):
return message
@user_command
async def user_command(self, user: User):
return f"The user is {user}"
@message_command(name="Message command")
async def message_command(self, message: UserMessage):
return f"The message read '{message.content}'"
@command(description="Add two numbers!")
async def add(
self,
first: Annotation[int, Description("The first number")],
second: Annotation[int, Description("The second number")]
):
return f"The addition of `{first}` and `{second}` is `{first + second}`"
```
For more examples, you can take a look at the examples folder or check out our
bot:
>
You can also read the interactions guide for more information:
>
### Advanced Usage
#### Enable the debug mode
_If you want to see everything that is happening under the hood, either out of
curiosity or to get a deeper insight into the implementation of some features,
we provide debug logging!_
```py
import logging
logging.basicConfig(level=logging.DEBUG)
```
#### Middleware
_The middleware system was introduced in version `0.4.0-dev`. This system gives you the
freedom to create custom events and remove the already existing middleware created by
the developers. Your custom middleware directly receives the payload from
Discord. You can't do anything wrong without accessing the `override` attribute, but if
you do access it, the Pincer team will not provide any support for weird behavior.
So, in short, only use this if you know what you're doing. An example of using
the middleware system with a custom `on_ready` event can be found
[in our docs](https://pincer.readthedocs.io/en/latest/pincer.html#pincer.client.middleware).
._
## 🏷️ License
`© 2021 copyright Pincer`
This repository is licensed under the MIT License.
See LICENSE for details.
%prep
%autosetup -n pincer-0.16.1
%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-pincer -f filelist.lst
%dir %{python3_sitelib}/*
%files help -f doclist.lst
%{_docdir}/*
%changelog
* Fri May 05 2023 Python_Bot - 0.16.1-1
- Package Spec generated