micron-builder 0.1.1

Fluent string builder for micron markup

micron-builder

micron-builder is a small Python library for building micron markup strings programmatically.
It provides a fluent API for composing text fragments, headers, separators, and styles without manually handling all the Micron markup symbols.

---

✨ Features

• Fluent API for building Micron markup strings
• Support for:
  • Text fragments with color, background color, and formatting (bold, italic, underline)
  • Headers with indent levels
  • Separators and line breaks
  • Links (address + page)
  • Alignment (center, right)
  • Padding around text
• Works with raw strings or the built-in Color enum
• Easy to extend and compose

---

📦 Installation

pip install micron-builder

🚀 Usage

Here’s a quick example of how to use MicronBuilder:

from micron import MicronBuilder
from micron.colors import Color

builder = (
    MicronBuilder()
    .header("Welcome!", indent_level=1)
    .text(
        "This is bold red text",
        bold=True,
        color=Color.RED,
    )
    .breakline()
    .text("Centered and underlined", center=True, underline=True)
    .separator("=")
    .text(
        "Clickable link",
        address_link="example.com",
        page_link="index.mu",
        italic=True,
    )
)

print(builder.build())

This would output Micron markup like:

>Welcome!

`!`Ff00This is bold red text`f`!

`c
_`Centered and underlined`_
`a

-=

`[*`Clickable link`example.com:/page/index.mu]

Which renders appropriately in Micron-compatible renderers.

🎨 Colors

Colors can be specified as:

• A 3-digit hex string (e.g. "f00", "0ff")

• A Color enum value:

  from micron.colors import Color
  
  MicronBuilder().text("Hello", color=Color.AQUA)
  

🛠 Development

Clone the repo and install in editable mode:

git clone https://github.com/neoemit/micron.git
cd micron
pip install -e .

Run tests (if you add them later):

pytest

📜 License

MIT License.

Feel free to use in your own projects.

🙌 Contributing

Pull requests, bug reports, and suggestions are welcome!

Open an issue or submit a PR on GitHub.