semvec/pypi-packages huggingface dataset:
photo-slideshow 1.1.0
Simple tool to make a slideshow of your photos in selected directory and all the subdirectories.
License: MIT
Keywords: photo,slideshow,viewer,presentation

# Photo SlideShow

## Overview

1. [Description](#description)
2. [Main features](#main-features-)
3. [Installation](#installation)
4. [Usage](#usage)
5. [Possible errors](#possible-errors)
5. [About](#about)

## Description

It's simple and easy tool to make a slideshow on your computer with your photos.
![photo-slideshow window](resources/photo-slideshow_window.png)

## Main features:

1. Read all photos / images from current directory and from all subdirectories
2. Possibility to choose what file types should be presented
3. Fullscreen option
4. Possibility to run the slideshow in a random order
5. It's python based so it should run everywhere where python is present

## Installation

The fastest and easiest way is to install it via `pip`. `pip` is a command line program provided with [python](https://www.python.org/downloads/).
```
pip install photo-slideshow
```
Installing from the source. Download this project. Unpack it. Go to the folder with source files. Open the main folder. Execute that command:
```
pip3 install .
```

## Usage

Run the application with command:
```
photo-slideshow
```
Application window will show up.

Browse the folder where your pictures are stored. In the settings you may configure:

- background color if the picture doesn't fit to your screen
- the time for showing current picture before switching to next one
- turn on/off random order
- select file types to be read

Select the fullscreen checkbox if you want that mode and push the start button. If you want to stop, simply push the stop button. In the fullscreen mode, push the <esc> button.

## Possible errors
If you get error:
```
ModuleNotFoundError: No module named 'tkinter'
```
It tells that you have to install pythong GUI framework (Tcl/Tk). Depends on the operating systems the instruction may differ, for example:
1. In windows open `python installer -> modify -> select tcl/tk and IDLE`, go next and finalize installation.
2. Ubuntu / debian: `sudo apt-get install python3-tk`
3. Fedora: `sudo dnf install python3-tkinter`
4. CentOS: `sudo yum install python3-tkinter`
5. MacOS: `brew install python-tk@3.10`
6. For other, just check hot to install.

When tkinter is installed you can run photo-slideshow.

## License

MIT License.

## About
Author: Mateusz Poślednik. Experienced data engineer, but also photographer. I was missing an easy, light software to make a slideshow on my photos. Most of the applications can make the slideshow only for current directory, but my photos are organized in many subdirectories.

My other projects: [https://github.com/matipos](https://github.com/matipos) and [https://github.com/matipos2](https://github.com/matipos2)

Contact: [https://matpos.pythonanywhere.com/](https://matpos.pythonanywhere.com/)
translategram 0.4.0
Translategram is a Python library for translating messages are sent by your Bot in Telegram
License: MIT

# Translategram

Translategram is a Python package that provides translation capabilities for Telegram bots. It uses and supports multiple translation services.

## Installation

You can install Translategram using pip:

```
pip install translategram
```

## Usage

### First you need to add a parameter to your handler called whatever you want *(in this example we called it ```message```)* and its type should be the ```string```.
```python
@translator.handler_translator(message="Welcome to our community!")
async def login(update: Update, context: ContextTypes.DEFAULT_TYPE, message: str) -> None:
    await context.bot.send_message(
            chat_id=update.effective_chat.id if update.effective_chat else 0,
            text=message
            )
```

### And then just register your handler in handler class.
```python
login_handler = CommandHandler('login', login)
```

### As well as you should create translator instance based on the framework you are using *(in this case python-telegram-bot)*.

```python
from translategram import PythonTelegramBotTranslator, MtranslateTranslatorService

translator = PythonTelegramBotTranslator(MtranslateTranslatorService)
```

### And finally your file should looks like this:

```python
import logging
from telegram.ext import ApplicationBuilder, ContextTypes, CommandHandler
from telegram import Update
from translategram import PythonTelegramBotTranslator, MtranslateTranslatorService

translator = PythonTelegramBotTranslator(MtranslateTranslatorService)
TOKEN = 'YOUR_TOKEN'
logging.basicConfig(
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
    level=logging.INFO
)

logger = logging.getLogger(__name__)


@translator.handler_translator(message="Welcome to our community!")
async def login(update: Update, context: ContextTypes.DEFAULT_TYPE, message: str) -> None:
    await context.bot.send_message(
            chat_id=update.effective_chat.id if update.effective_chat else 0,
            text=message
            )


@translator.handler_translator(message="This bot is very simple. You can just login with the /login command and that is it!")
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE, message: str) -> None:
    await context.bot.send_message(
            chat_id=update.effective_chat.id if update.effective_chat else 0,
            text=message
            )

if __name__ == '__main__':
    application = ApplicationBuilder().token(TOKEN).build()

    login_handler = CommandHandler('login', login)
    start_handler = CommandHandler('start', start)
    application.add_handler(login_handler)
    application.add_handler(start_handler)

    application.run_polling()

```

## TODO

* Implement cache system
    - Cache System with Memcache.
    - Cache System with Redis.
* Add aiogram framework adapter.
* Add pyTelegramBotApi framework adapter.
* Add support for more translation services.


## License

This project is licensed under the terms of the MIT license.