telepress 0.1.0__tar.gz

telepress-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 zoidberg-xgd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

telepress-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: telepress
+Version: 0.1.0
+Summary: Publish Markdown, images and zip archives to Telegraph
+Home-page: https://github.com/zoidberg-xgd/telepress
+Author: zoidberg-xgd
+Author-email: 
+Project-URL: Bug Reports, https://github.com/zoidberg-xgd/telepress/issues
+Project-URL: Source, https://github.com/zoidberg-xgd/telepress
+Keywords: telegraph,markdown,publishing,gallery
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: telegraph
+Requires-Dist: markdown
+Requires-Dist: requests
+Provides-Extra: api
+Requires-Dist: fastapi; extra == "api"
+Requires-Dist: uvicorn; extra == "api"
+Requires-Dist: python-multipart; extra == "api"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: httpx; extra == "dev"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# TelePress
+
+[中文文档](README_CN.md)
+
+Publish Markdown, images and zip archives to [Telegraph](https://telegra.ph). Handles large files by auto-splitting into multiple linked pages.
+
+## Install
+
+```bash
+pip install telepress
+
+# with REST API
+pip install telepress[api]
+```
+
+## Usage
+
+```python
+from telepress import publish, publish_text
+
+url = publish("article.md")
+url = publish_text("# Hello\n\nWorld!", title="Test")
+```
+
+CLI:
+```bash
+telepress article.md --title "My Post"
+telepress photos.zip --title "Album"
+```
+
+REST API:
+```bash
+telepress-server --port 8000
+
+curl -X POST localhost:8000/publish/text \
+  -H "Content-Type: application/json" \
+  -d '{"content": "# Title\n\nBody", "title": "Test"}'
+```
+
+## How it works
+
+Text files are converted to Telegraph format (Markdown supported). Large content is split at ~40KB boundaries into multiple pages with prev/next navigation.
+
+Zip files are treated as image galleries. Images are sorted naturally (1, 2, 10 not 1, 10, 2) and paginated at 100 per page.
+
+Token is auto-created on first run and saved to `~/.telegraph_token`.
+
+## Limits
+
+- 100MB max file size
+- 100 pages max (~4M chars text, or 5000 images)
+- 5MB per image (Telegraph limit)
+
+Supported: `.txt` `.md` `.markdown` `.rst` `.jpg` `.png` `.gif` `.webp` `.zip`
+
+Not supported: PDF, DOCX (convert first)
+
+## Project structure
+
+```
+telepress/
+├── core.py       # TelegraphPublisher
+├── auth.py       # token management
+├── converter.py  # markdown to telegraph nodes
+├── uploader.py   # image upload with retry
+├── server.py     # FastAPI service
+└── cli.py        # command line
+```
+
+## Error handling
+
+```python
+from telepress import publish, ValidationError, TelePressError
+
+try:
+    url = publish("file.md")
+except ValidationError as e:
+    # bad input: wrong format, too large, etc
+    print(e)
+except TelePressError as e:
+    # other errors: upload failed, auth failed, etc
+    print(e)
+```
+
+## Integration
+
+```python
+# Flask
+@app.route('/publish', methods=['POST'])
+def api_publish():
+    url = publish_text(request.json['content'], title=request.json['title'])
+    return {'url': url}
+
+# async
+async def async_publish(content, title):
+    return await asyncio.to_thread(publish_text, content, title)
+```
+
+## Dev
+
+```bash
+git clone https://github.com/zoidberg-xgd/telepress
+cd telepress && pip install -e .[dev]
+pytest tests/ -v
+```
+
+## License
+
+MIT

telepress-0.1.0/README.md

@@ -0,0 +1,109 @@
+# TelePress
+
+[中文文档](README_CN.md)
+
+Publish Markdown, images and zip archives to [Telegraph](https://telegra.ph). Handles large files by auto-splitting into multiple linked pages.
+
+## Install
+
+```bash
+pip install telepress
+
+# with REST API
+pip install telepress[api]
+```
+
+## Usage
+
+```python
+from telepress import publish, publish_text
+
+url = publish("article.md")
+url = publish_text("# Hello\n\nWorld!", title="Test")
+```
+
+CLI:
+```bash
+telepress article.md --title "My Post"
+telepress photos.zip --title "Album"
+```
+
+REST API:
+```bash
+telepress-server --port 8000
+
+curl -X POST localhost:8000/publish/text \
+  -H "Content-Type: application/json" \
+  -d '{"content": "# Title\n\nBody", "title": "Test"}'
+```
+
+## How it works
+
+Text files are converted to Telegraph format (Markdown supported). Large content is split at ~40KB boundaries into multiple pages with prev/next navigation.
+
+Zip files are treated as image galleries. Images are sorted naturally (1, 2, 10 not 1, 10, 2) and paginated at 100 per page.
+
+Token is auto-created on first run and saved to `~/.telegraph_token`.
+
+## Limits
+
+- 100MB max file size
+- 100 pages max (~4M chars text, or 5000 images)
+- 5MB per image (Telegraph limit)
+
+Supported: `.txt` `.md` `.markdown` `.rst` `.jpg` `.png` `.gif` `.webp` `.zip`
+
+Not supported: PDF, DOCX (convert first)
+
+## Project structure
+
+```
+telepress/
+├── core.py       # TelegraphPublisher
+├── auth.py       # token management
+├── converter.py  # markdown to telegraph nodes
+├── uploader.py   # image upload with retry
+├── server.py     # FastAPI service
+└── cli.py        # command line
+```
+
+## Error handling
+
+```python
+from telepress import publish, ValidationError, TelePressError
+
+try:
+    url = publish("file.md")
+except ValidationError as e:
+    # bad input: wrong format, too large, etc
+    print(e)
+except TelePressError as e:
+    # other errors: upload failed, auth failed, etc
+    print(e)
+```
+
+## Integration
+
+```python
+# Flask
+@app.route('/publish', methods=['POST'])
+def api_publish():
+    url = publish_text(request.json['content'], title=request.json['title'])
+    return {'url': url}
+
+# async
+async def async_publish(content, title):
+    return await asyncio.to_thread(publish_text, content, title)
+```
+
+## Dev
+
+```bash
+git clone https://github.com/zoidberg-xgd/telepress
+cd telepress && pip install -e .[dev]
+pytest tests/ -v
+```
+
+## License
+
+MIT

telepress-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

telepress-0.1.0/setup.py

@@ -0,0 +1,55 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="telepress",
+    version="0.1.0",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    install_requires=[
+        "telegraph",
+        "markdown",
+        "requests"
+    ],
+    extras_require={
+        "api": [
+            "fastapi",
+            "uvicorn",
+            "python-multipart"
+        ],
+        "dev": [
+            "pytest",
+            "pytest-cov",
+            "httpx"  # For FastAPI TestClient
+        ]
+    },
+    entry_points={
+        'console_scripts': [
+            'telepress=telepress.cli:main',
+            'telepress-server=telepress.server:main',
+        ],
+    },
+    author="zoidberg-xgd",
+    author_email="",
+    description="Publish Markdown, images and zip archives to Telegraph",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    python_requires=">=3.7",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    url="https://github.com/zoidberg-xgd/telepress",
+    project_urls={
+        "Bug Reports": "https://github.com/zoidberg-xgd/telepress/issues",
+        "Source": "https://github.com/zoidberg-xgd/telepress",
+    },
+    keywords=["telegraph", "markdown", "publishing", "gallery"],
+)

telepress-0.1.0/src/telepress/__init__.py

@@ -0,0 +1,116 @@
+"""
+TelePress - Publish content to Telegraph easily.
+
+Basic usage:
+    >>> from telepress import publish, TelegraphPublisher
+    >>> 
+    >>> # Quick publish (one-liner)
+    >>> url = publish("article.md", title="My Article")
+    >>> 
+    >>> # Or use the class for more control
+    >>> publisher = TelegraphPublisher()
+    >>> url = publisher.publish("article.md")
+    >>> url = publisher.publish_text("# Hello\n\nWorld!", title="Test")
+"""
+
+from .core import TelegraphPublisher
+from .exceptions import (
+    TelePressError,
+    ValidationError,
+    UploadError,
+    AuthenticationError,
+    SecurityError,
+    DependencyError,
+    ConversionError
+)
+from .utils import (
+    MAX_FILE_SIZE,
+    MAX_PAGES,
+    MAX_TOTAL_IMAGES,
+    MAX_IMAGES_PER_PAGE,
+    ALLOWED_TEXT_EXTENSIONS,
+    ALLOWED_IMAGE_EXTENSIONS,
+    ALLOWED_ARCHIVE_EXTENSIONS
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    # Main class
+    'TelegraphPublisher',
+    
+    # Convenience function
+    'publish',
+    'publish_text',
+    
+    # Exceptions
+    'TelePressError',
+    'ValidationError', 
+    'UploadError',
+    'AuthenticationError',
+    'SecurityError',
+    'DependencyError',
+    'ConversionError',
+    
+    # Constants
+    'MAX_FILE_SIZE',
+    'MAX_PAGES',
+    'MAX_TOTAL_IMAGES',
+    'MAX_IMAGES_PER_PAGE',
+    'ALLOWED_TEXT_EXTENSIONS',
+    'ALLOWED_IMAGE_EXTENSIONS',
+    'ALLOWED_ARCHIVE_EXTENSIONS',
+]
+
+# Singleton publisher for convenience functions
+_default_publisher = None
+
+def _get_publisher(token=None):
+    """Get or create default publisher instance."""
+    global _default_publisher
+    if token:
+        return TelegraphPublisher(token=token)
+    if _default_publisher is None:
+        _default_publisher = TelegraphPublisher()
+    return _default_publisher
+
+
+def publish(file_path: str, title: str = None, token: str = None) -> str:
+    """
+    Convenience function to publish a file to Telegraph.
+    
+    Args:
+        file_path: Path to file (.md, .txt, .jpg, .png, .zip, etc.)
+        title: Optional title (defaults to filename)
+        token: Optional Telegraph token (uses cached token if not provided)
+    
+    Returns:
+        str: URL of the published Telegraph page
+    
+    Example:
+        >>> from telepress import publish
+        >>> url = publish("article.md", title="My Article")
+        >>> print(url)
+        https://telegra.ph/My-Article-12-07
+    """
+    return _get_publisher(token).publish(file_path, title=title)
+
+
+def publish_text(content: str, title: str, token: str = None) -> str:
+    """
+    Convenience function to publish text content directly to Telegraph.
+    
+    Args:
+        content: Markdown or plain text content
+        title: Page title (required)
+        token: Optional Telegraph token
+    
+    Returns:
+        str: URL of the published Telegraph page
+    
+    Example:
+        >>> from telepress import publish_text
+        >>> url = publish_text("# Hello\n\nThis is my article.", title="Hello World")
+        >>> print(url)
+        https://telegra.ph/Hello-World-12-07
+    """
+    return _get_publisher(token).publish_text(content, title=title)

telepress-0.1.0/src/telepress/auth.py

@@ -0,0 +1,57 @@
+import os
+from typing import Optional
+from .exceptions import DependencyError, AuthenticationError
+
+try:
+    from telegraph import Telegraph
+except ImportError:
+    Telegraph = None
+
+DEFAULT_TOKEN_FILE = os.path.expanduser("~/.telegraph_token")
+
+class TelegraphAuth:
+    def __init__(self, token_file: str = DEFAULT_TOKEN_FILE):
+        if Telegraph is None:
+            raise DependencyError("telegraph library is required")
+        self.token_file = token_file
+
+    def get_client(self, token: Optional[str] = None, short_name: str = "TelegraphClient") -> Telegraph:
+        """
+        Returns an authenticated Telegraph client.
+        Priorities:
+        1. Explicit token argument
+        2. Stored token in file
+        3. Create new account and store token
+        """
+        # 1. Explicit token
+        if token:
+            return Telegraph(access_token=token)
+
+        # 2. Stored token
+        if os.path.exists(self.token_file):
+            try:
+                with open(self.token_file, 'r') as f:
+                    stored_token = f.read().strip()
+                client = Telegraph(access_token=stored_token)
+                # Verify token
+                client.get_account_info(['short_name'])
+                return client
+            except Exception:
+                # Log or just proceed to create new
+                pass
+
+        # 3. Create new
+        try:
+            client = Telegraph()
+            response = client.create_account(short_name=short_name)
+            new_token = response['access_token']
+            
+            # Ensure directory exists
+            os.makedirs(os.path.dirname(self.token_file), exist_ok=True)
+            
+            with open(self.token_file, 'w') as f:
+                f.write(new_token)
+            
+            return Telegraph(access_token=new_token)
+        except Exception as e:
+            raise AuthenticationError(f"Failed to create new Telegraph account: {e}")

telepress-0.1.0/src/telepress/cli.py

@@ -0,0 +1,26 @@
+import argparse
+import sys
+from .core import TelegraphPublisher
+from .exceptions import TelePressError
+
+def main():
+    parser = argparse.ArgumentParser(description="TelePress: Publish files (txt, md, images, zip) to Telegraph.")
+    parser.add_argument("file", help="Path to the file to convert")
+    parser.add_argument("--title", help="Custom title for the page", default=None)
+    parser.add_argument("--token", help="Telegraph access token (optional)", default=None)
+    
+    args = parser.parse_args()
+
+    try:
+        publisher = TelegraphPublisher(token=args.token)
+        url = publisher.publish(args.file, title=args.title)
+        print(f"\n✅ Success! Page created: {url}")
+    except TelePressError as e:
+        print(f"\n❌ Error: {e}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n❌ Unexpected Error: {e}")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

telepress-0.1.0/src/telepress/converter.py

@@ -0,0 +1,36 @@
+import re
+from typing import List, Dict, Union
+from .utils import sanitize_nodes
+from .exceptions import DependencyError
+
+try:
+    import markdown
+    from telegraph.utils import html_to_nodes
+except ImportError:
+    markdown = None
+    html_to_nodes = None
+
+class MarkdownConverter:
+    def __init__(self):
+        if markdown is None:
+            raise DependencyError("markdown library is required")
+
+    def convert(self, md_content: str) -> List[Dict]:
+        """Converts Markdown content to Telegraph DOM nodes."""
+        html_content = markdown.markdown(md_content)
+        
+        # Pre-process HTML string for headers
+        # Telegraph doesn't support h1/h2
+        html_content = re.sub(r'<h1', '<h3', html_content)
+        html_content = re.sub(r'</h1>', '</h3>', html_content)
+        html_content = re.sub(r'<h2', '<h4', html_content)
+        html_content = re.sub(r'</h2>', '</h4>', html_content)
+        html_content = re.sub(r'<h[56]', '<h4', html_content)
+        html_content = re.sub(r'</h[56]>', '</h4>', html_content)
+
+        if html_to_nodes:
+            nodes = html_to_nodes(html_content)
+            return sanitize_nodes(nodes)
+        else:
+            # Fallback (though utils should be present if telegraph is installed)
+            return [{'tag': 'p', 'children': [md_content]}]