FunnyAPI
FunnyAPI — это библиотека на Python для генерации случайных шуток и забавных фактов. Она создана для того, чтобы добавить немного веселья в ваши проекты и поднять настроение!
Установка
Установить FunnyAPI можно через PyPI:
pip install funnyapi
Возможности
🎭 Случайные шутки: Получайте случайные шутки на тему программирования.
📚 Случайные забавные факты: Узнавайте интересные и неожиданные факты.
🔄 Поток шуток: Настройте периодический вывод шуток через определённый интервал времени.
Примеры использования
Ниже приведены примеры использования основных функций библиотеки.
Получение случайной шутки
python
Копировать код
from funnyapi import generate_joke
joke = generate_joke()
print("Случайная шутка:", joke)
Получение случайного забавного факта
python
Копировать код
from funnyapi import generate_funny_fact
fact = generate_funny_fact()
print("Забавный факт:", fact)
Запуск потока шуток
Эта функция позволяет выводить случайные шутки каждые N секунд в течение определённого времени.
python
Копировать код
from funnyapi import start_joke_stream
# Вывод шутки каждые 5 секунд в течение 15 секунд
start_joke_stream(interval=5, duration=15)
API функций
generate_joke()
Возвращает одну случайную шутку.
Пример:
python
Копировать код
joke = generate_joke()
print(joke)
generate_funny_fact()
Возвращает один случайный забавный факт.
Пример:
python
Копировать код
fact = generate_funny_fact()
print(fact)
start_joke_stream(interval, duration)
Запускает поток шуток, выводя случайную шутку через каждые interval секунд в течение duration секунд.
Параметры:
interval (int): Интервал времени в секундах между выводом шуток.
duration (int): Общая продолжительность работы потока в секундах.
Пример:
python
Копировать код
# Запуск потока, который выводит шутку каждые 3 секунды в течение 10 секунд
start_joke_stream(interval=3, duration=10)
Примеры шуток и фактов
Вот несколько примеров шуток и фактов, которые вы можете увидеть при использовании библиотеки:
Примеры шуток
"Почему программисты так любят осень? Потому что там есть 'сентябрь' и 'октябрь'."
"Какой любимый напиток у программистов? Java!"
"Почему программисты не ходят в лес? Потому что там слишком много 'веток'."
Примеры забавных фактов
"Мед никогда не портится. В древнеегипетских гробницах находили мед, которому больше 3000 лет, и он всё ещё съедобен!"
"Бананы — это ягоды, а вот клубника — нет!"
"У группы фламинго есть особое название — их называют 'фламбояс'!"
Требования
Для работы FunnyAPI требуется Python 3.6 или выше.
Участие в разработке
Если у вас есть идеи для новых функций или вы хотите улучшить библиотеку, буду рад вашему участию! Просто сделайте форк репозитория и отправьте pull request.
Лицензия
Этот проект лицензируется на условиях лицензии MIT. Полный текст лицензии можно найти в файле LICENSE.
markdown
Копировать код
### Инструкции
1. Создай файл `README.md` в корне проекта.
2. Скопируй и вставь текст выше в этот файл.
3. Сохрани файл.
Теперь у тебя есть качественный `README.md` с применённым форматированием, готовый для исп
Metadata
Release files for shoydokova 0.8.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| shoydokova-0.8.2.tar.gz | 3.6 kB | Without provenance | Details for shoydokova-0.8.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| shoydokova-0.8.2-py3-none-any.whl | Python 3 | none | any | Details for shoydokova-0.8.2-py3-none-any.whl |
Total release size: 7.6 kB
Release files / shoydokova-0.8.2.tar.gz
| Download URL | shoydokova-0.8.2.tar.gz |
|---|---|
| Size | 3.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c539287299e0e2eb31106372f98916ff926556fbfa9bb23c048af87c5575d07e
|
|
BLAKE2b-256 checksum How to use checksums |
c1781c43cb97ac316d0ab6a440e6234881028cabf9b92b8b374cde4e32ed0be4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.11.5
|
Release files / shoydokova-0.8.2-py3-none-any.whl
| Download URL | shoydokova-0.8.2-py3-none-any.whl |
|---|---|
| Size | 4.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb4c49d6fe6aff86eff59c41149ab6aea6f4aed1f2f82751c9e2ddcca7dd7a2c
|
|
BLAKE2b-256 checksum How to use checksums |
3f4e9e3992a6b9104f59a6d4526e0dd59d19d266d88d5758163f07f559ef4050
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.11.5
|
Security for shoydokova 0.8.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.