Uploadgrampyapi

EN
- Added new exception `UploadgramInvalidLengthPattern` that will be show if you are using incorrect length of pattern in `UploadgramPyAPI.Random`.
- Edited arg `pattern_id` in class `Random`.
- Corrected `README.md`.
- Added new attributes in `UploadgramPyAPI.NewFile`:
* `name`
* `size`
* `scanned`
* `userTelegramId` if available
* `userIp` if available

RU
- Добавлена новая ошибка `UploadgramInvalidLengthPattern`, которая будет возникать если вы используете неправильную длину вашего шаблона для `UploadgramPyAPI.Random`.
- Изменен аргумент `pattern_id` в классе `UploadgramPyAPI.Random`
- Изменен `README.md`
- Добавлены новые атрибуты класса в `UploadgramPyAPI.NewFile`:
* `name`
* `size`
* `scanned`
* `userTelegramId` если доступен
* `userIp` если доступен

Добавлен класс `Random`, благодаря которому вы можете сгенерировать случайный `ID` или `KEY`. Причем, если вы хотите импортировать какой-либой файл **(в то числе и чужой)** из Uploadgram себе в [Dashboard]("https://uploadgram.me/upload/#/"), вам нужно в качестве параметра `KEY` класса `UploadgramPyAPI.File` указать этот случайный `KEY`. Пример:
py
import UploadgramPyAPI
import webbrowser

генерация случайного KEY
fake_key = UploadgramPyAPI.Random("key").get()

подключение к файлу с использованием сгенерированного случайного ключа
up_file = UploadgramPyAPI.File("614e0729b6279g", fake_key)

этой строкой вы открываете url_import у себя в браузере и необходимый файл появится у вас в Dashboard
webbrowser.open_new_tab(up_file.url_import)


- Добавлен новый атрибут `scanned` класса `UploadgramPyAPI.File`. Он равен `True`, если в файле подтверждено отсутствие вирусов или каких-либо нарушений
- Теперь `url_import` будет становится равным `None`, если его невозможно сгенерировать
- Добавлен класс `UploadgramPyAPI.Random`, благодаря которому можно сгенерировать случайный `id` или `key`
- Добавлен класс `UploadgramPyAPI.ServiceRules` для получения актуального текста из [Terms of Service](https://uploadgram.me/terms.html) и [DMCA Policy](https://uploadgram.me/dmca.html)
- Добавлена ошибка `UploadgramInvalidKey`, которая возникает, если вы используете неподходящий или неправильный `key` для файла
- Добавлена ошибка `UploadgramInvalidValue`, которая возникает, если вы используете неправильное или неподходящее значение для какого либо параметра
- Исправлена ошибка, при которой неудачный результат удаления или переименования файла никак не отражался в ходе выполнения программы
- Исправлена ошибка в названии переменной `self.check_to_available`
- Добавлены ссылки на [Terms of Service](https://uploadgram.me/terms.html), [DMCA Policy](https://uploadgram.me/dmca.html), [PyPi](https://pypi.org/project/uploadgrampyapi/), [PePy](https://pepy.tech/project/UploadgramPyAPI) и на [Telegram автора](https://t.me/tankalxat34)
- Добавлено описание проекта на [PyPi](https://pypi.org/project/uploadgrampyapi/)
- Теперь информация об изменениях будет дублироваться и на русском языке

Обновить:
bat
pip install --upgrade UploadgramPyAPI


Скачать:
bat
pip install UploadgramPyAPI

- Simplified error classes.
- Added the `LENGTH_ID` constant.
- Now the `KEY` parameter has become optional. To delete or rename a file, it is enough to specify the `KEY` in the `ID` parameter.
- Now the `ID` and `URL` parameters are determined directly from the server response.
- The `URL_IMPORT` parameter no longer receives a link if the file `ID` is specified instead of the `KEY` parameter.
- The `UploadgramUsingKeyError` error now has an updated description.
- Now the `userTelegramId` and `userId` parameters can take the value `None` of the "None" type if they are not in the response from the server.
- The variable `self.json` has been renamed on the `self.readfile` of the `UploadgramPyAPI.NewFile` class.
- Minor edits have been made to `__doc__`.
- Other edits have been made to the code.

VERSION CHANGES:
1. Added this exceptions: `UploadgramConnectionError`, `UploadgramUsingKeyError` and `UploadgramFileIsNotAvalible`;
1.1. `UploadgramConnectionError`: if uploadgram.me will fall down, you will get this error
1.2. `UploadgramUsingKeyError`: if you set key parameter equal "none" string and you will try to rename or delete the file, you will get this error
1.3. `UploadgramFileIsNotAvalible`: if you trying to connection to file that does not exists, you will get this error

2. Added `example of use` into `__doc__`;

3. Some other edits;
____________________
INSTALL:

pip install uploadgrampyapi


UPGRADE:

pip install --upgrade uploadgrampyapi