STRling 2.5.9

Next-gen string pattern DSL & compiler

STRling for Python (Quick Start)

🗺️ Overview

This is the Python binding for STRling, a next-generation production-grade syntax designed as a user interface for writing powerful regular expressions (RegEx).

STRling makes string validation and matching readable, safe, and consistent across environments. Instead of cryptic regex syntax, you build patterns using a clean, object-oriented DSL. Under the hood, STRling compiles to native RegEx engines — but adds instructional error handling and consistent semantics.

🗝️ Key Features

• Beginner Friendly: No regex jargon required.
• Reliable: Built only on standard libraries.
• Instructional Errors: Explains what went wrong and how to fix it.
• Consistent: Works across frameworks and libraries without custom validators.
• Multilingual: Available across popular programming languages (JavaScript, and more coming soon).

💾 Installation

Install STRling via pip:

pip install STRling

✨ STRling in action!

Basic Example: US Phone Number

from STRling import simply as s
import re

# Define parts of a US phone number pattern
separator = s.in_chars(" -")
area_code = s.merge(
    s.may("("),
    s.group("area_code", s.digit(3)),
    s.may(")")
)
central_part = s.group("central_part", s.digit(3))
last_part = s.group("last_part", s.digit(4))

phone_number_pattern = s.merge(
    area_code,
    s.may(separator),
    central_part,
    s.may(separator),
    last_part
)

# Compile to RegEx
example_text = "[phone] and 123-456-7890"
pattern = re.compile(str(phone_number_pattern))
matches = pattern.finditer(example_text)

for match in matches:
    print("Full Match:", match.group())
    print("Area Code:", match.group("area_code"))
    print("Central Part:", match.group("central_part"))
    print("Last Part:", match.group("last_part"))

📚 Complete API Documentation

For comprehensive syntax reference and all available features, see the Python API Reference.

📖 Related Documentation

• Python API Reference: Complete API documentation for Python
• Developer Documentation Hub: Architecture, philosophy, and development workflow
• Formal Specification: Grammar and semantics reference
• JavaScript Binding: STRling for JavaScript/Node.js

💖 Support

If you find STRling useful, consider buying me a coffee.