line-markdown-parser 0.1.2__tar.gz

line_markdown_parser-0.1.2/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 0.1.2 — 2026-10-18
+
+- Publish distributions to PyPI with Trusted Publishing and update installation instructions.
+
+## 0.1.1 — 2026-10-18
+
+- Avoid excessive parsing time for unfinished links and emphasis.
+- Preserve inline code, brackets in link labels, punctuation-only text, and URL delimiters; reject malformed action URLs.
+- Improve internal-URL checks, archive error reporting, and source-distribution file permissions.
+- Clarify alpha status and simplify usage and contribution guides.
+
+## 0.1.0 — 2026-10-18
+
+- Initial dependency-free Python library for converting Markdown into LINE Flex Message dictionaries.
+- Support for headings, paragraphs, emphasis, lists, quotes, separators, fenced code, links, and code-style tables.
+- Long-output splitting by source length and rendered bubble size, preserving recognized links.
+- UTF-16-bounded alternative text and a 200,000-byte UTF-8 input limit.
+- APIs for complete messages, body components, text splitting, and rendered-size estimation.

line_markdown_parser-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 line-markdown-parser contributors
+
+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.

line_markdown_parser-0.1.2/MANIFEST.in

@@ -0,0 +1,12 @@
+include LICENSE README.md README-ja.md CHANGELOG.md
+include _build_backend.py
+include docs/spec.md
+recursive-include line_markdown_parser *.py py.typed
+prune tests
+prune scripts
+prune examples
+prune .github
+prune .private
+prune docs/_internal
+exclude CONTRIBUTING.md SECURITY.md AGENTS.md
+global-exclude __pycache__ *.py[cod] .DS_Store

line_markdown_parser-0.1.2/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: line-markdown-parser
+Version: 0.1.2
+Summary: Convert LLM Markdown into readable LINE Flex Messages without runtime dependencies.
+Author: line-markdown-parser contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/darkgaldragon/line-markdown-parser
+Project-URL: Source, https://github.com/darkgaldragon/line-markdown-parser
+Project-URL: Issues, https://github.com/darkgaldragon/line-markdown-parser/issues
+Keywords: line,markdown,flex-message,llm,chatbot
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.11; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=6; extra == "dev"
+Dynamic: license-file
+
+# line-markdown-parser
+
+Convert LLM Markdown into readable LINE Flex Message dictionaries with no runtime dependencies.
+
+[日本語](README-ja.md)
+
+Headings, paragraphs, lists, quotes, code, and links receive a chat-friendly layout. Long output is split into separate messages. Sending remains the responsibility of your application.
+
+## Installation
+
+Requires Python 3.10 or later.
+
+```bash
+python -m pip install line-markdown-parser
+```
+
+## Quick start
+
+```python
+import json
+
+from line_markdown_parser import convert_markdown_to_line_messages
+
+markdown = """# Project update
+
+The **first draft** is ready.
+
+- Review the examples
+- Read the [guide](https://example.com/guide)
+"""
+
+messages = convert_markdown_to_line_messages(markdown)
+print(json.dumps(messages, ensure_ascii=False, indent=2))
+```
+
+Each item has `type: "flex"`, `altText`, and one `bubble` in `contents`. Pass these dictionaries to your LINE API integration. The library makes no network requests and does not require the LINE SDK.
+
+The converter returns all generated messages. LINE accepts up to five message objects per [reply](https://developers.line.biz/en/reference/messaging-api/#send-reply-message) or [push](https://developers.line.biz/en/reference/messaging-api/#send-push-message) request, so your application must handle longer results and reply-token restrictions.
+
+## API
+
+All functions are exported from `line_markdown_parser`.
+
+| Function | Purpose |
+| --- | --- |
+| `convert_markdown_to_line_messages` | Split Markdown and return a `list[dict]` of Flex Messages. |
+| `build_flex_message` | Build one message without splitting; reject oversized input. |
+| `build_flex_contents` | Build body components for a custom bubble, without a bubble size check. |
+| `split_long_text` | Return Markdown chunks as a `list[str]`. |
+| `estimate_flex_payload_size` | Measure the rendered bubble's compact UTF-8 JSON size. |
+
+The converter defaults to 1,600 source characters and 28,000 rendered bytes per chunk. See the [API specification](docs/spec.md) for signatures, limits, alternative text, and error behavior.
+
+## Limitations
+
+- Markdown tables use code-style text boxes; column alignment varies by client font.
+- Images appear as labels and links, without fetching or embedding images.
+- Only `http` and `https` links receive URI actions; destinations are not verified.
+- Full CommonMark support, arbitrary nesting, and every code-fence style are outside the scope.
+- This is an alpha release with automated tests. Live LINE delivery and client appearance have not been verified. Check integration with the [Flex Message Simulator](https://developers.line.biz/flex-simulator/) and your target LINE clients.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and checks, [SECURITY.md](SECURITY.md) for vulnerability reporting, and [CHANGELOG.md](CHANGELOG.md) for release history.
+
+## License
+
+[MIT](LICENSE). This independent project is not an official LINE product.

line_markdown_parser-0.1.2/README-ja.md

@@ -0,0 +1,68 @@
+# line-markdown-parser
+
+LLMが生成したMarkdownを、LINEで読みやすいFlex Messageの辞書に変換するPythonライブラリです。実行時の外部依存はありません。
+
+[English](README.md)
+
+見出し、段落、リスト、引用、コード、リンクをチャットに適したレイアウトに変換し、長文を複数メッセージに分割します。送信処理はアプリケーション側で実装してください。
+
+## インストール
+
+Python 3.10以上が必要です。
+
+```bash
+python -m pip install line-markdown-parser
+```
+
+## 使い方
+
+```python
+import json
+
+from line_markdown_parser import convert_markdown_to_line_messages
+
+markdown = """# プロジェクトの状況
+
+**初稿**ができました。
+
+- サンプルを確認する
+- [ガイド](https://example.com/guide)を読む
+"""
+
+messages = convert_markdown_to_line_messages(markdown)
+print(json.dumps(messages, ensure_ascii=False, indent=2))
+```
+
+各要素は `type: "flex"`、`altText`、1つの `bubble` を含む `contents` で構成されます。この辞書をLINE APIとの連携処理に渡してください。ライブラリはネットワーク通信を行わず、LINE SDKにも依存しません。
+
+変換結果は省略せずすべて返します。LINEの[reply](https://developers.line.biz/ja/reference/messaging-api/#send-reply-message)・[push](https://developers.line.biz/ja/reference/messaging-api/#send-push-message)リクエストで一度に送れるメッセージは最大5件です。これを超える場合の送信方法とリプライトークンの制約には、呼び出し側で対応してください。
+
+## API
+
+すべての関数は `line_markdown_parser` からインポートできます。
+
+| 関数 | 用途 |
+| --- | --- |
+| `convert_markdown_to_line_messages` | Markdownを分割し、Flex Messageの `list[dict]` を返す。 |
+| `build_flex_message` | 分割せずに1件のメッセージを生成する。サイズ超過はエラー。 |
+| `build_flex_contents` | 独自のbubble用に本文コンポーネントを生成する。bubbleのサイズ検査は行わない。 |
+| `split_long_text` | 分割したMarkdownを `list[str]` で返す。 |
+| `estimate_flex_payload_size` | 生成したbubbleをコンパクトなJSONにしたときのUTF-8バイト数を返す。 |
+
+既定では、1チャンクあたり元テキスト1,600文字、bubbleのJSONサイズ28,000バイトを上限に分割します。引数、上限値、代替テキスト、エラー条件は[API仕様書](docs/spec.md)を参照してください。
+
+## 制約
+
+- 表はコード風のテキスト枠で表示します。列の揃い方はクライアントのフォントに依存します。
+- 画像はラベルとリンクで表示し、取得や埋め込みは行いません。
+- URIアクションは `http` と `https` のみに対応します。リンク先の検証は行いません。
+- 完全なCommonMark互換と任意のネストには対応していません。コードフェンスもすべての形式に対応しているわけではありません。
+- 自動テストで検証したアルファ版です。実際のLINEでの送信・表示は未確認のため、導入時に[Flex Message Simulator](https://developers.line.biz/flex-simulator/)と対象のLINEクライアントで確認してください。
+
+## 開発への参加
+
+開発環境と確認コマンドは [CONTRIBUTING.md](CONTRIBUTING.md)、脆弱性報告は [SECURITY.md](SECURITY.md)、変更履歴は [CHANGELOG.md](CHANGELOG.md) を参照してください。
+
+## ライセンス
+
+[MIT](LICENSE)。本プロジェクトは独立したOSSであり、LINEの公式製品ではありません。

line_markdown_parser-0.1.2/README.md

@@ -0,0 +1,68 @@
+# line-markdown-parser
+
+Convert LLM Markdown into readable LINE Flex Message dictionaries with no runtime dependencies.
+
+[日本語](README-ja.md)
+
+Headings, paragraphs, lists, quotes, code, and links receive a chat-friendly layout. Long output is split into separate messages. Sending remains the responsibility of your application.
+
+## Installation
+
+Requires Python 3.10 or later.
+
+```bash
+python -m pip install line-markdown-parser
+```
+
+## Quick start
+
+```python
+import json
+
+from line_markdown_parser import convert_markdown_to_line_messages
+
+markdown = """# Project update
+
+The **first draft** is ready.
+
+- Review the examples
+- Read the [guide](https://example.com/guide)
+"""
+
+messages = convert_markdown_to_line_messages(markdown)
+print(json.dumps(messages, ensure_ascii=False, indent=2))
+```
+
+Each item has `type: "flex"`, `altText`, and one `bubble` in `contents`. Pass these dictionaries to your LINE API integration. The library makes no network requests and does not require the LINE SDK.
+
+The converter returns all generated messages. LINE accepts up to five message objects per [reply](https://developers.line.biz/en/reference/messaging-api/#send-reply-message) or [push](https://developers.line.biz/en/reference/messaging-api/#send-push-message) request, so your application must handle longer results and reply-token restrictions.
+
+## API
+
+All functions are exported from `line_markdown_parser`.
+
+| Function | Purpose |
+| --- | --- |
+| `convert_markdown_to_line_messages` | Split Markdown and return a `list[dict]` of Flex Messages. |
+| `build_flex_message` | Build one message without splitting; reject oversized input. |
+| `build_flex_contents` | Build body components for a custom bubble, without a bubble size check. |
+| `split_long_text` | Return Markdown chunks as a `list[str]`. |
+| `estimate_flex_payload_size` | Measure the rendered bubble's compact UTF-8 JSON size. |
+
+The converter defaults to 1,600 source characters and 28,000 rendered bytes per chunk. See the [API specification](docs/spec.md) for signatures, limits, alternative text, and error behavior.
+
+## Limitations
+
+- Markdown tables use code-style text boxes; column alignment varies by client font.
+- Images appear as labels and links, without fetching or embedding images.
+- Only `http` and `https` links receive URI actions; destinations are not verified.
+- Full CommonMark support, arbitrary nesting, and every code-fence style are outside the scope.
+- This is an alpha release with automated tests. Live LINE delivery and client appearance have not been verified. Check integration with the [Flex Message Simulator](https://developers.line.biz/flex-simulator/) and your target LINE clients.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and checks, [SECURITY.md](SECURITY.md) for vulnerability reporting, and [CHANGELOG.md](CHANGELOG.md) for release history.
+
+## License
+
+[MIT](LICENSE). This independent project is not an official LINE product.

line_markdown_parser-0.1.2/_build_backend.py

@@ -0,0 +1,59 @@
+"""Setuptools build hooks with anonymous source-archive ownership metadata."""
+
+from __future__ import annotations
+
+import gzip
+import os
+import stat
+import tarfile
+import tempfile
+from pathlib import Path
+
+from setuptools import build_meta as _backend
+
+build_wheel = _backend.build_wheel
+build_editable = _backend.build_editable
+get_requires_for_build_wheel = _backend.get_requires_for_build_wheel
+get_requires_for_build_sdist = _backend.get_requires_for_build_sdist
+get_requires_for_build_editable = _backend.get_requires_for_build_editable
+prepare_metadata_for_build_wheel = _backend.prepare_metadata_for_build_wheel
+prepare_metadata_for_build_editable = _backend.prepare_metadata_for_build_editable
+
+
+def _normalize_sdist(path: Path) -> None:
+    """Remove builder account names, numeric IDs, and local archive timestamps."""
+    mode = stat.S_IMODE(path.stat().st_mode)
+    descriptor, temporary = tempfile.mkstemp(suffix=".tar.gz", dir=path.parent)
+    try:
+        with os.fdopen(descriptor, "wb") as output:
+            with gzip.GzipFile(
+                filename="", mode="wb", fileobj=output, mtime=0
+            ) as compressed:
+                with (
+                    tarfile.open(path, "r:gz") as source,
+                    tarfile.open(
+                        fileobj=compressed, mode="w", format=tarfile.PAX_FORMAT
+                    ) as target,
+                ):
+                    for member in source.getmembers():
+                        payload = (
+                            source.extractfile(member) if member.isfile() else None
+                        )
+                        member.uid = member.gid = 0
+                        member.uname = member.gname = "root"
+                        member.mtime = 0
+                        member.pax_headers = {}
+                        target.addfile(member, payload)
+                        if payload is not None:
+                            payload.close()
+        os.chmod(temporary, mode)
+        os.replace(temporary, path)
+    finally:
+        if os.path.exists(temporary):
+            os.unlink(temporary)
+
+
+def build_sdist(sdist_directory, config_settings=None):
+    name = _backend.build_sdist(sdist_directory, config_settings)
+    _normalize_sdist(Path(sdist_directory) / name)
+    return name

line_markdown_parser-0.1.2/docs/spec.md

@@ -0,0 +1,75 @@
+# API specification
+
+`line-markdown-parser` converts Markdown strings into LINE Flex Message dictionaries without runtime dependencies or network requests. The API below applies to version 0.1.2.
+
+## Functions
+
+All functions are exported from `line_markdown_parser`. Names beginning with `_` are implementation details.
+
+```python
+convert_markdown_to_line_messages(
+    text,
+    *,
+    alt_text=None,
+    max_length=1600,
+    max_payload_bytes=28000,
+) -> list[dict]
+
+build_flex_message(text, *, alt_text=None) -> dict
+build_flex_contents(text) -> list[dict]
+split_long_text(text, max_length=1600, max_payload_bytes=28000) -> list[str]
+estimate_flex_payload_size(text) -> int
+```
+
+| Function | Behavior |
+| --- | --- |
+| `convert_markdown_to_line_messages` | Split and render every chunk in input order. Each item contains `type: "flex"`, `altText`, and one bubble in `contents`. Return `[]` for empty or whitespace-only input when other arguments are valid. |
+| `build_flex_message` | Render one message without splitting. Empty or whitespace-only input, or a bubble exceeding 30,000 bytes, raises `ValueError`. |
+| `build_flex_contents` | Return the body component list without a bubble or message wrapper. Empty or whitespace-only input returns `[]`. No splitting or bubble size check; the caller must validate the custom bubble. |
+| `split_long_text` | Return Markdown chunks within both source-length and rendered-byte limits. Empty or whitespace-only input returns `[]` after argument validation. |
+| `estimate_flex_payload_size` | Return the rendered bubble's compact UTF-8 JSON size, including for empty input. |
+
+Visual properties and exact component nesting may change without changing this contract.
+
+## Limits and splitting
+
+- `max_length` is a positive integer measured in Python string characters. It is a source-length limit, not a LINE API character limit.
+- `max_payload_bytes` is an integer from 1 to 30,000. Its default is 28,000, below LINE's [30 KB bubble limit](https://developers.line.biz/en/reference/messaging-api/#flex-message).
+- Booleans, invalid limit values, or budgets too small for a rendered fragment raise `ValueError`. No oversized fragment is returned.
+
+The byte budget and size estimator use the bubble's compact JSON with non-ASCII characters encoded directly as UTF-8. They exclude the Flex wrapper, alternative text, recipients, other messages, and HTTP headers. Layout components add overhead, so source length alone does not predict rendered size.
+
+Splitting prefers paragraph, line, and word boundaries. Closed triple-backtick code fences are repeated around each fragment, even when splitting a single code line. Other inline formatting may become ordinary text across a split; arbitrary nesting and all fence styles are not preserved.
+
+Outside fenced code, recognized URLs and Markdown links remain intact. A link that cannot fit either limit raises `ValueError` instead of producing a partial link. URLs inside fenced code may split as ordinary code text.
+
+## Alternative text and input validation
+
+`alt_text` supplies notification and chat-list text. When omitted, each message uses its source chunk. Explicit alternative text is reused for every message. Surrounding whitespace is removed; an empty result raises `ValueError`.
+
+Alternative text is limited to 1,500 UTF-16 code units. Supplementary Unicode characters count as two units. Truncation includes an ellipsis within that limit and preserves whole Unicode characters.
+
+All text arguments must be strings; other types raise `TypeError`. Every public function rejects text exceeding 200,000 UTF-8 bytes with `ValueError`. This also applies to explicit `alt_text` before truncation. Lone surrogate code points raise `ValueError`.
+
+## Markdown rendering
+
+| Input | Output |
+| --- | --- |
+| Headings and paragraphs | Text with spacing and visual hierarchy. |
+| Emphasis and inline code | Styled text components or spans. |
+| Unordered and ordered lists | List text and indentation. |
+| Quotes | Visually separated text. |
+| Horizontal rules | Divider text. |
+| Fenced code and tables | Code-style text boxes; no syntax highlighting or interactive tables. |
+| Links | Labels and supported URI actions. |
+| Images | Labels and links; no fetching or image components. |
+
+Full CommonMark conformance, HTML rendering, arbitrary nesting, and exact browser-style layout are outside the scope. Malformed input or unusual fences may render as ordinary text or lose formatting. Table alignment depends on client fonts and display width.
+
+Only `http` and `https` receive [URI actions](https://developers.line.biz/en/reference/messaging-api/#uri-action). Unsupported schemes retain their labels without an action. Malformed HTTP(S) destinations and URLs exceeding the action URI length limit remain text. Existing percent escapes and URL delimiters are preserved when encoding destinations. Destinations are not verified.
+
+## Integration
+
+The converter returns all messages without sending or truncating them. LINE [reply](https://developers.line.biz/en/reference/messaging-api/#send-reply-message) and [push](https://developers.line.biz/en/reference/messaging-api/#send-push-message) requests accept at most five messages. Applications handle batching, reply-token restrictions, authentication, recipients, and retries.
+
+Version 0.1.2 is covered by automated tests; live LINE delivery and client rendering have not been verified. Validate integrations using the [Flex Message Simulator](https://developers.line.biz/flex-simulator/), [message validation endpoints](https://developers.line.biz/en/reference/messaging-api/#message-objects), and target LINE clients.

line_markdown_parser-0.1.2/line_markdown_parser/__init__.py

@@ -0,0 +1,20 @@
+"""Markdown to LINE Flex Messages, with no network or SDK dependencies."""
+
+from .converter import (
+    DEFAULT_MAX_FLEX_PAYLOAD_BYTES,
+    build_flex_contents,
+    build_flex_message,
+    convert_markdown_to_line_messages,
+    estimate_flex_payload_size,
+    split_long_text,
+)
+
+__version__ = "0.1.2"
+__all__ = [
+    "DEFAULT_MAX_FLEX_PAYLOAD_BYTES",
+    "build_flex_contents",
+    "build_flex_message",
+    "convert_markdown_to_line_messages",
+    "estimate_flex_payload_size",
+    "split_long_text",
+]