flowmark 0.5.2__tar.gz → 0.5.4__tar.gz

{flowmark-0.5.2 → flowmark-0.5.4}/.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier. Do not edit manually.
-_commit: v0.2.15
+_commit: v0.2.19
 _src_path: gh:jlevy/simple-modern-uv
 package_author_email: joshua@cal.berkeley.edu
 package_author_name: Joshua Levy

{flowmark-0.5.2 → flowmark-0.5.4}/.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
 
         # Common platforms: ["ubuntu-latest", "macos-latest", "windows-latest"]
         os: ["ubuntu-latest"]
-        python-version: ["3.10","3.11", "3.12", "3.13"]
+        python-version: ["3.10","3.11", "3.12", "3.13", "3.14"]
 
     # Linux only by default. Use ${{ matrix.os }} for other OSes.
     runs-on: ${{ matrix.os }}
@@ -41,7 +41,7 @@ jobs:
         uses: astral-sh/setup-uv@v5
         with:
           # Update this as needed:
-          version: "0.8.0"
+          version: "0.9.5"
           enable-cache: true
           python-version: ${{ matrix.python-version }}
 

{flowmark-0.5.2 → flowmark-0.5.4}/.github/workflows/publish.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Install uv (official Astral action)
         uses: astral-sh/setup-uv@v5
         with:
-          version: "0.8.0"
+          version: "0.9.5"
           enable-cache: true
           python-version: "3.12"
 

{flowmark-0.5.2 → flowmark-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowmark
-Version: 0.5.2
+Version: 0.5.4
 Summary: Better auto-formatting for Markdown and plaintext
 Project-URL: Repository, https://github.com/jlevy/flowmark
 Author-email: Joshua Levy <joshua@cal.berkeley.edu>
@@ -11,9 +11,11 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 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: Typing :: Typed
 Requires-Python: <4.0,>=3.10
 Requires-Dist: marko>=2.1.3

flowmark-0.5.4/docs/bug1-example.md

@@ -0,0 +1,2 @@
+### Scalability Patterns
+- **Provider-based Rate Limiting**: Agents grouped by LLM provider to respect API limits

flowmark-0.5.4/docs/bug2-example.md

@@ -0,0 +1,4 @@
+> **BACKWARD COMPATIBILITY REQUIREMENTS:**
+> 
+> - **Code types, methods, and function signatures**: [DO NOT MAINTAIN or KEEP
+>   DEPRECATED, additional notes if necessary]

{flowmark-0.5.2 → flowmark-0.5.4}/pyproject.toml

@@ -26,9 +26,11 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Typing :: Typed",
     # Include this to avoid accidentally publishing to PyPI:
     # "Private :: Do Not Upload",
@@ -49,7 +51,7 @@ dev = [
     "ruff>=0.11.9",
     "codespell>=2.4.1",
     "rich>=14.0.0",
-    "basedpyright>=1.29.1",
+    "basedpyright==1.29.5",  # TODO: Upgrade when Cursor supports it.
     "funlog>=0.2.1",
 ]
 
@@ -78,7 +80,7 @@ source = "uv-dynamic-versioning"
 [tool.uv-dynamic-versioning]
 vcs = "git"
 style = "pep440"
-bump = "true"
+bump = true
 
 [tool.hatch.build.targets.wheel]
 # The source location for the package.

flowmark-0.5.4/src/flowmark/__init__.py

@@ -0,0 +1,34 @@
+__all__ = (
+    "fill_text",
+    "fill_markdown",
+    "first_sentence",
+    "first_sentences",
+    "flowmark_markdown",
+    "html_md_word_splitter",
+    "simple_word_splitter",
+    "line_wrap_by_sentence",
+    "line_wrap_to_width",
+    "reformat_file",
+    "reformat_text",
+    "split_sentences_regex",
+    "wrap_paragraph",
+    "wrap_paragraph_lines",
+    "Wrap",
+)
+
+from flowmark.formats.flowmark_markdown import flowmark_markdown
+from flowmark.linewrapping.line_wrappers import line_wrap_by_sentence, line_wrap_to_width
+from flowmark.linewrapping.markdown_filling import fill_markdown
+from flowmark.linewrapping.sentence_split_regex import (
+    first_sentence,
+    first_sentences,
+    split_sentences_regex,
+)
+from flowmark.linewrapping.text_filling import Wrap, fill_text
+from flowmark.linewrapping.text_wrapping import (
+    html_md_word_splitter,
+    simple_word_splitter,
+    wrap_paragraph,
+    wrap_paragraph_lines,
+)
+from flowmark.reformat_api import reformat_file, reformat_text

{flowmark-0.5.2 → flowmark-0.5.4}/src/flowmark/cli.py

@@ -19,6 +19,9 @@ Command-line usage examples:
   # Format a Markdown file to stdout
   flowmark README.md
 
+  # Format multiple Markdown files in-place
+  flowmark --inplace README.md CHANGELOG.md docs/*.md
+
   # Format a Markdown file in-place without backups and all auto-formatting
   # options enabled
   flowmark --auto README.md
@@ -40,19 +43,21 @@ Command-line usage examples:
 For more details, see: https://github.com/jlevy/flowmark
 """
 
+from __future__ import annotations
+
 import argparse
 import importlib.metadata
 import sys
 from dataclasses import dataclass
 
-from flowmark.reformat_api import reformat_file
+from flowmark.reformat_api import reformat_files
 
 
 @dataclass
 class Options:
     """Command-line options for the flowmark tool."""
 
-    file: str
+    files: list[str]
     output: str
     width: int
     plaintext: bool
@@ -79,11 +84,11 @@ def _parse_args(args: list[str] | None = None) -> Options:
         formatter_class=argparse.RawDescriptionHelpFormatter,
     )
     parser.add_argument(
-        "file",
-        nargs="?",
+        "files",
+        nargs="*",
         type=str,
-        default="-",
-        help="Input file (use '-' for stdin)",
+        default=["-"],
+        help="Input files (use '-' for stdin, multiple files supported)",
     )
     parser.add_argument(
         "-o",
@@ -161,7 +166,7 @@ def _parse_args(args: list[str] | None = None) -> Options:
         opts.ellipses = True
 
     return Options(
-        file=opts.file,
+        files=opts.files,
         output=opts.output,
         width=opts.width,
         plaintext=opts.plaintext,
@@ -197,8 +202,8 @@ def main(args: list[str] | None = None) -> int:
         return 0
 
     try:
-        reformat_file(
-            path=options.file,
+        reformat_files(
+            files=options.files,
             output=options.output,
             width=options.width,
             inplace=options.inplace,

flowmark-0.5.2/src/flowmark/custom_marko.py → flowmark-0.5.4/src/flowmark/formats/flowmark_markdown.py

@@ -14,7 +14,12 @@ from marko.parser import Parser
 from marko.source import Source
 from typing_extensions import override
 
-from flowmark.line_wrappers import LineWrapper
+from flowmark.linewrapping.line_wrappers import (
+    LineWrapper,
+    line_wrap_by_sentence,
+    line_wrap_to_width,
+)
+from flowmark.linewrapping.text_filling import DEFAULT_WRAP_WIDTH
 
 
 def _normalize_title_quotes(title: str) -> str:
@@ -327,17 +332,32 @@ class MarkdownNormalizer(Renderer):
         return element.dest
 
 
-def custom_marko(line_wrapper: LineWrapper) -> Markdown:
+DEFAULT_SEMANTIC_LINE_WRAPPER = line_wrap_by_sentence(width=DEFAULT_WRAP_WIDTH, is_markdown=True)
+"""
+Default line wrapper for semantic line wrapping.
+"""
+
+DEFAULT_FIXED_LINE_WRAPPER = line_wrap_to_width(width=DEFAULT_WRAP_WIDTH, is_markdown=True)
+"""
+Default line wrapper for fixed-width line wrapping.
+"""
+
+
+def flowmark_markdown(line_wrapper: LineWrapper = DEFAULT_SEMANTIC_LINE_WRAPPER) -> Markdown:
     """
-    Marko Markdown setup for GFM with minor customizations and a
-    renderer that normalizes Markdown.
+    Marko Markdown setup for GFM with a few customizations for Flowmark and a new
+    renderer that normalizes Markdown according to Flowmark's conventions.
     """
 
     class CustomRenderer(MarkdownNormalizer):
         def __init__(self) -> None:
             super().__init__(line_wrapper)
 
-    class CustomMarkdown(Markdown):
+    class FlowmarkMarkdown(Markdown):
+        """
+        Marko Markdown API with Flowmark customizations.
+        """
+
         def __init__(self) -> None:  # pyright: ignore[reportMissingSuperCall]
             pass
 
@@ -364,4 +384,4 @@ def custom_marko(line_wrapper: LineWrapper) -> Markdown:
 
             self._setup_done: bool = True
 
-    return CustomMarkdown()
+    return FlowmarkMarkdown()

{flowmark-0.5.2/src/flowmark → flowmark-0.5.4/src/flowmark/linewrapping}/line_wrappers.py

@@ -2,9 +2,13 @@ import re
 from collections.abc import Callable
 from typing import Protocol
 
-from flowmark.sentence_split_regex import split_sentences_regex
-from flowmark.text_filling import DEFAULT_WRAP_WIDTH
-from flowmark.text_wrapping import DEFAULT_LEN_FUNCTION, wrap_paragraph, wrap_paragraph_lines
+from flowmark.linewrapping.sentence_split_regex import split_sentences_regex
+from flowmark.linewrapping.text_filling import DEFAULT_WRAP_WIDTH
+from flowmark.linewrapping.text_wrapping import (
+    DEFAULT_LEN_FUNCTION,
+    wrap_paragraph,
+    wrap_paragraph_lines,
+)
 
 DEFAULT_MIN_LINE_LEN = 20
 """Default minimum line length for sentence breaking."""

{flowmark-0.5.2/src/flowmark → flowmark-0.5.4/src/flowmark/linewrapping}/markdown_filling.py

@@ -15,15 +15,19 @@ import re
 from collections.abc import Callable
 from textwrap import dedent
 
-from flowmark.custom_marko import custom_marko
-from flowmark.doc_cleanups import doc_cleanups
-from flowmark.doc_transforms import rewrite_text_content
-from flowmark.ellipses import ellipses as apply_ellipses
-from flowmark.frontmatter import split_frontmatter
-from flowmark.line_wrappers import LineWrapper, line_wrap_by_sentence, line_wrap_to_width
-from flowmark.sentence_split_regex import split_sentences_regex
-from flowmark.smartquotes import smart_quotes
-from flowmark.text_filling import DEFAULT_WRAP_WIDTH
+from flowmark.formats.flowmark_markdown import flowmark_markdown
+from flowmark.formats.frontmatter import split_frontmatter
+from flowmark.linewrapping.line_wrappers import (
+    LineWrapper,
+    line_wrap_by_sentence,
+    line_wrap_to_width,
+)
+from flowmark.linewrapping.sentence_split_regex import split_sentences_regex
+from flowmark.linewrapping.text_filling import DEFAULT_WRAP_WIDTH
+from flowmark.transforms.doc_cleanups import doc_cleanups
+from flowmark.transforms.doc_transforms import rewrite_text_content
+from flowmark.typography.ellipses import ellipses as apply_ellipses
+from flowmark.typography.smartquotes import smart_quotes
 
 
 def _normalize_html_comments(text: str, break_str: str = "\n\n") -> str:
@@ -126,7 +130,7 @@ def fill_markdown(
     markdown_text = _normalize_html_comments(markdown_text)
 
     # Parse and render.
-    marko = custom_marko(line_wrapper)
+    marko = flowmark_markdown(line_wrapper)
     document = marko.parse(markdown_text)
     if cleanups:
         doc_cleanups(document)

{flowmark-0.5.2/src/flowmark → flowmark-0.5.4/src/flowmark/linewrapping}/text_filling.py

@@ -2,7 +2,7 @@ import re
 from collections.abc import Callable
 from enum import Enum
 
-from flowmark.text_wrapping import (
+from flowmark.linewrapping.text_wrapping import (
     DEFAULT_LEN_FUNCTION,
     WordSplitter,
     html_md_word_splitter,

{flowmark-0.5.2 → flowmark-0.5.4}/src/flowmark/reformat_api.py

@@ -3,9 +3,9 @@ from pathlib import Path
 
 from strif import atomic_output_file
 
-from flowmark.markdown_filling import fill_markdown
-from flowmark.text_filling import Wrap, fill_text
-from flowmark.text_wrapping import html_md_word_splitter
+from flowmark.linewrapping.markdown_filling import fill_markdown
+from flowmark.linewrapping.text_filling import Wrap, fill_text
+from flowmark.linewrapping.text_wrapping import html_md_word_splitter
 
 
 def reformat_text(
@@ -102,3 +102,77 @@ def reformat_file(
         else:
             with atomic_output_file(output, make_parents=make_parents) as tmp_path:
                 tmp_path.write_text(result)
+
+
+def reformat_files(
+    files: list[str],
+    output: str | None = None,
+    width: int = 88,
+    inplace: bool = False,
+    nobackup: bool = False,
+    plaintext: bool = False,
+    semantic: bool = False,
+    cleanups: bool = True,
+    smartquotes: bool = False,
+    ellipses: bool = False,
+    make_parents: bool = True,
+) -> None:
+    """
+    Reformat multiple files with the same options.
+
+    Args:
+        files: List of file paths to process, or ["-"] for stdin.
+        output: Output file path (ignored when inplace=True, use "-" for stdout).
+        width: The width to wrap lines to.
+        inplace: Whether to write files back to their original paths.
+        nobackup: Whether to not make backups of original files.
+        plaintext: Use plaintext instead of Markdown mode wrapping.
+        semantic: Use semantic line breaks (based on sentences) heuristic.
+        cleanups: Enable (safe) cleanups for common issues.
+        smartquotes: Convert straight quotes to typographic quotes.
+        ellipses: Convert three dots to ellipsis character.
+        make_parents: Whether to make parent directories if they don't exist.
+    """
+    if len(files) == 1 and files[0] == "-":
+        # Single stdin case - use original function
+        reformat_file(
+            path=files[0],
+            output=output,
+            width=width,
+            inplace=inplace,
+            nobackup=nobackup,
+            plaintext=plaintext,
+            semantic=semantic,
+            cleanups=cleanups,
+            smartquotes=smartquotes,
+            ellipses=ellipses,
+            make_parents=make_parents,
+        )
+        return
+
+    # Multiple files case
+    if not inplace and output and output != "-":
+        raise ValueError(
+            "Cannot specify output file when processing multiple files (use --inplace instead)"
+        )
+
+    for file_path in files:
+        if inplace:
+            # Process each file in-place
+            output = None
+        else:
+            # Process each file to stdout
+            output = "-"
+        reformat_file(
+            path=file_path,
+            output=output,
+            width=width,
+            inplace=inplace,
+            nobackup=nobackup,
+            plaintext=plaintext,
+            semantic=semantic,
+            cleanups=cleanups,
+            smartquotes=smartquotes,
+            ellipses=ellipses,
+            make_parents=make_parents,
+        )

{flowmark-0.5.2/src/flowmark → flowmark-0.5.4/src/flowmark/transforms}/doc_cleanups.py

@@ -4,7 +4,7 @@ from marko import block, inline
 from marko.block import Document
 from marko.element import Element
 
-from flowmark.doc_transforms import transform_tree
+from flowmark.transforms.doc_transforms import transform_tree
 
 
 def _unbold_heading_transformer(element: Element) -> None:

{flowmark-0.5.2/src/flowmark → flowmark-0.5.4/src/flowmark/transforms}/doc_transforms.py

@@ -45,7 +45,7 @@ def coalesce_raw_text_nodes(doc: Document) -> None:
     This is useful for smart quotes processing which needs to see text that spans
     across line breaks as a single unit.
     """
-    from flowmark.doc_transforms import transform_tree
+    from flowmark.transforms.doc_transforms import transform_tree
 
     def transformer(element: Element) -> None:
         if hasattr(element, "children") and isinstance(element.children, list):  # pyright: ignore

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_cleanups.py

@@ -1,6 +1,6 @@
-from flowmark.custom_marko import custom_marko
-from flowmark.doc_cleanups import unbold_headings
-from flowmark.line_wrappers import line_wrap_by_sentence
+from flowmark.formats.flowmark_markdown import flowmark_markdown
+from flowmark.linewrapping.line_wrappers import line_wrap_by_sentence
+from flowmark.transforms.doc_cleanups import unbold_headings
 
 input_md = """
 # **Bold Heading 1**
@@ -53,7 +53,7 @@ Final text.
 
 
 def test_unbold_headings() -> None:
-    marko = custom_marko(line_wrap_by_sentence())
+    marko = flowmark_markdown(line_wrap_by_sentence())
 
     doc = marko.parse(input_md)
     unbold_headings(doc)

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_ellipses.py

@@ -1,4 +1,4 @@
-from flowmark.ellipses import ellipses
+from flowmark.typography.ellipses import ellipses
 
 
 def test_ellipses():

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_filling.py

@@ -2,7 +2,10 @@ from textwrap import dedent
 
 import marko
 
-from flowmark.markdown_filling import _normalize_html_comments, fill_markdown  # pyright: ignore
+from flowmark.linewrapping.markdown_filling import (
+    _normalize_html_comments,  # pyright: ignore[reportPrivateUsage]
+    fill_markdown,
+)
 
 
 def test_normalize_html_comments():

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_frontmatter.py

@@ -1,5 +1,5 @@
-from flowmark.frontmatter import has_frontmatter, split_frontmatter
-from flowmark.markdown_filling import fill_markdown
+from flowmark.formats.frontmatter import has_frontmatter, split_frontmatter
+from flowmark.linewrapping.markdown_filling import fill_markdown
 
 
 def test_split_frontmatter():

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_list_spacing.py

@@ -10,7 +10,7 @@ number of paragraphs in the list item.
 
 from textwrap import dedent
 
-from flowmark.markdown_filling import fill_markdown
+from flowmark.linewrapping.markdown_filling import fill_markdown
 
 
 def test_list_items_with_code_blocks():

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_ref_docs.py

@@ -1,7 +1,7 @@
 from dataclasses import dataclass
 from pathlib import Path
 
-from flowmark.markdown_filling import fill_markdown
+from flowmark.linewrapping.markdown_filling import fill_markdown
 
 testdoc_dir = Path("tests/testdocs")
 

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_smartquotes.py

@@ -1,4 +1,4 @@
-from flowmark.smartquotes import smart_quotes
+from flowmark.typography.smartquotes import smart_quotes
 
 
 def test_basic_double_quotes():

{flowmark-0.5.2 → flowmark-0.5.4}/tests/test_wrapping.py

@@ -1,6 +1,6 @@
 from textwrap import dedent
 
-from flowmark.text_wrapping import (
+from flowmark.linewrapping.text_wrapping import (
     _HtmlMdWordSplitter,  # pyright: ignore
     html_md_word_splitter,
     markdown_escape_word,
@@ -224,7 +224,7 @@ def test_wrap_width():
 
 
 def test_line_wrap_to_width_with_markdown_breaks():
-    from flowmark.line_wrappers import line_wrap_to_width
+    from flowmark.linewrapping.line_wrappers import line_wrap_to_width
 
     # Get a markdown-aware line wrapper
     wrapper = line_wrap_to_width(width=80, is_markdown=True)