pixeldrain-reloaded 0.3

Description:

pixeldrainreloaded 0.3

Pixeldrain Reloaded
This is a Python library for interacting with Pixeldrain, a simple file sharing service. It provides synchronous and asynchronous functions for uploading, downloading, and retrieving information about files on Pixeldrain; anonymously and with an API key.
Installation
pip install pixeldrain-reloaded

Documentation
get_info(file_id)
Get information about a file on Pixeldrain.


Parameters:

file_id (str): The ID of the file.



Returns:

dict: A dictionary containing file information.



upload_file(file_path, returns=None, filename=None, api_key=None)
Upload a file to Pixeldrain synchronously.


Parameters:

file_path (str): The path to the file to be uploaded.
returns (str, optional): Specifies what to return.
filename (str, optional): Name of the file to upload.
api_key (str, optional): Pixeldrain API key for authorized uploads.



Returns:

dict or str: Depending on the 'returns' parameter, returns a dictionary or a string.



download_file(file_id, path, filename=None)
Download a file from Pixeldrain synchronously.


Parameters:

file_id (str): The ID of the file or a Pixeldrain URL.
path (str): The local path to save the downloaded file.
filename (str, optional): Name to save the file as (default is Pixeldrain filename).



Returns:

str: The path to the downloaded file.



Asynchronous functions
The asynchronous version of the library provides the same functionality but is designed for use with asyncio and aiohttp for non-blocking asynchronous operations.
Usage
Synchronous Version
Import the library
import pixeldrain_reloaded as pixeldrain

Get Information about a File
file_info = pixeldrain.Sync.get_info(file_id="your_file_id")
print(file_info)

Upload a File
file_path = "path/to/your/file.txt"
response = pixeldrain.Sync.upload_file(file_path, returns="dict", filename="custom_filename", api_key="your_api_key")
print(response)

Download a File
file_id = "your_file_id"
download_path = "path/to/download"
downloaded_file = pixeldrain.Sync.download_file(file_id, download_path, filename="custom_filename")
print(f"File downloaded to: {downloaded_file}")

Asynchronous Version
Import the library
import pixeldrain_reloaded as pixeldrain

Get Information about a File (Async)
file_info = await pixeldrain.Async.get_info(file_id="your_file_id")
print(file_info)

Upload a File (Async)
file_path = "path/to/your/file.txt"
response = await pixeldrain.Async.upload_file(file_path, returns="dict", filename="custom_filename", api_key="your_api_key")
print(response)

Download a File (Async)
file_id = "your_file_id"
download_path = "path/to/download"
downloaded_file = await pixeldrain.Async.download_file(file_id, download_path, filename="custom_filename")
print(f"File downloaded to: {downloaded_file}")

Special Thanks
FayasNoushad for the original library
License
This library is licensed under the MIT License - see the LICENSE file for details.