telegraph-next 1.2.0

Modernized Asynchronous Telegraph API wrapper (revived fork)

🚀 Telegraph-Next

Modern, High-Performance Asynchronous Telegraph API Wrapper

---

Quick Start • Key Features • Installation • Bug Report

🌟 Why Telegraph-Next?

Telegraph-Next is a revitalized, async-first wrapper for the Telegra.ph API. We took the robust foundation of the original project and upgraded it for the modern era of high-load Telegram bots and scalable services.

✨ Key Features

• ⚡ Fully Asynchronous: Built from the ground up on aiohttp for non-blocking performance.
• 🛡️ Pydantic-Powered: Every response is a validated object. Get full IDE autocompletion and type safety.
• 🌐 Native DPI Bypass: Built-in direct IP routing (149.154.164.13) bypasses ISP SNI blocks natively without proxies.
• 🖼️ Universal Image Uploads: upload_file() uses catbox.moe as a highly-reliable fallback due to Telegraph's global upload restrictions.
• 🎞️ Smart HTML Middlewares: Automatic YouTube iframe handling and HTML tag filtering out of the box.
• 🧼 Clean & Fixed: Zero resource leaks, fixed YouTube parsing bugs, and restored missing dependencies.
• 🧩 Easy Integration: Designed as a drop-in modernization for high-load systems.

---

📦 Installation

Install the latest version via pip:

pip install telegraph-next

---

🛠 Quick Start

1. Basic Usage (Classic)

import asyncio
from telegraph import Telegraph

async def main():
    # Initialize the client
    telegraph = Telegraph()
    
    # Create an account
    await telegraph.create_account(short_name='Abbasxan', author_name='Abbasxan')
    
    # Create a new page with HTML content
    page = await telegraph.create_page(
        title='My First Page',
        content_html='<h1>Hello!</h1><p>Created using <b>Telegraph-Next</b>.</p>'
    )
    
    print(f"Page live at: {page.url}")

asyncio.run(main())

2. Using Context Manager (Recommended)

async with Telegraph() as tg:
    await tg.create_account(short_name='Abbasxan')
    page = await tg.create_page('Modern Way', content_html='<i>Seamless!</i>')
    print(page.url)

3. File Uploading (Catbox Fallback)

Due to Telegraph's servers blocking native uploads globally, telegraph-next natively falls back to catbox.moe for ultra-reliable image uploads.

async def upload_demo():
    # Returns an UploadedFile object containing the full URL
    uploaded = await telegraph.upload_file('photo.jpg')
    
    # Note: Returns the FULL url, so do not prepend https://telegra.ph!
    print(f"File uploaded to: {uploaded.src}") 

---

🚀 Advanced: HTML Middlewares

Telegraph-Next automatically processes your HTML to ensure it matches Telegra.ph's strict rules:

• Converts YouTube links to supported embeds.
• Strips unsupported attributes while keeping src and href.
• Unwraps unsupported tags to preserve content.

---

🤝 Credits & Support

Developed and maintained by Abbasxan (Neon Group).
Original concept by IvanProgramming.

If you find this project useful, please give it a ⭐ on GitHub!

---

Licensed under MIT.