Metadata-Version: 2.4
Name: minipy-tools
Version: 0.1.2
Author-email: Noé Ballieu <nonobal2812@gmail.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: inquirer
Requires-Dist: click
Requires-Dist: python-dotenv
Requires-Dist: requests
Requires-Dist: PyPDF2
Requires-Dist: Pillow
Requires-Dist: qrcode
Requires-Dist: yt-dlp

![Static Badge](https://img.shields.io/badge/github-repo-blue?logo=github)

# **Minipy**

Minipy is a CLI tool that combines small/big python tools and games in one big tool.

---
## Table of contents

- [**Minipy**](#minipy)
  - [Table of contents](#table-of-contents)
  - [Installation](#installation)
  - [File structure](#file-structure)
  - [Configuration](#configuration)
  - [Support](#support)
  - [License](#license)
  - [Status](#status)

---

## Installation

To install minipy run this command in your terminal:

```bash
pip install minipy-tools

```

---

## File structure

This is the file structure of the package:

```md
└── 📁minipy
    └── 📁games
        ├── snake.py
    └── 📁tools
        ├── dice.py
        ├── link_shortner.py
        ├── send_email.py
    ├── __init__.py
    └── main.py
```

---

## Configuration

For some tools/games you need some configuration. The configuration will redirect you to README for instructions. You can find those here:

>### Link shortner

You need to have a cuttly API key to be able to shorten links.
To create one follow these steps:

1. Go to [https://cutt.ly](https://cutt.ly)
2. Create an account / login
3. In your dashboard, go to **API** and then **API key** on the left menu

  ![menu](image-1.png)

4. You can find your API key on the right side of that page
5. Copy it and Paste it in the configuration when asked

>### Send email

You need to have a Google App-password to be able to send an email.
This is a second password to your Google account, we can use it in our app to send an mail with Gmail.
To create one follow these steps:

1. Go to your [Google account settings](https://myaccount.google.com/)
2. In the menu on the left click **Security**
3. Click on  **2-step verification** and ensure it is turned **ON**, if not turn it on
4. Scroll down untill you see **App passwords** and click on it
5. Type a name for your new App password (this can be anything, like *Email sender*)
6. Click on make
7. Copy or write down the 16 chars password you see (This is important, because you can't see it again later!)
8. Enter it in the configuration when asked

---

## Support

For support you can make an **Issue** on the Github repo, thanks for helping with my project.

---

## License

[MIT](https://choosealicense.com/licenses/mit/)

---

## Status

Ongoing: I'm still working on this project and constantly adding new tools and features...

---
