curlypy 0.0.3

A preprocessor to turn python code with braces into python

CurlyPy: Python with Brackets

CurlyPy is a preprocessor that translates Python code written using curly braces ({}) into standard Python, making indentation obsolete. It provides the flexibility to use semicolons (;) as optional statement separators, making Python syntax more familiar to developers accustomed to languages like C, Java, or JavaScript.

With CurlyPy, you can write Python code using braces to define code blocks, eliminating the need for indentation while still retaining Python's powerful features.

Key Features

• Curly Braces for Code Blocks: Use {} to denote the start and end of code blocks, removing the need for indentation.
• Semi-Mandatory Semicolons: Semicolons (;) are supported as optional separators between statements, but they are still not strictly required after every statement. They will, however, be required if you are writing multiple instructions in the same line.
• Flexible Syntax: Write Python code with a more structured format, closer to languages like C, Java, or JavaScript, while keeping all the strengths of Python.
• Compatible with Python: CurlyPy preprocesses your code into standard Python, so it can be executed by any Python interpreter.
• Dictionary and Set Types: The standard Python dictionary and set types are available in CurlyPy, using type hints.

Valid CurlyPy syntax:

# Dictionaries and sets are defined using type hints
dictionary_test: dict[str, str] = {
   "foo":"bar", 
   "baz":{
      "qux":"quux"
   }
}
set_test: set[str] = {"foo", "bar", "baz"}
print(dictionary_test["foo"], set_test)

CurlyPy makes even this syntax possible!

def check_even_odd(num) { print(f"{num} is {'even' if num % 2 == 0 else 'odd'};"); }; check_even_odd(10); check_even_odd(7);

Installation

Install from PyPI:

pip install curlypy

Usage

Once you have CurlyPy installed, you can preprocess your Python files written with curly braces and optional semicolons into standard Python.

Module usage:

# some_file.py
from curlypy import CurlyPyTranslator

translator = CurlyPyTranslator(filename="curlypython.cpy")
translated_code: str = translator.translate()

with open("translated.py", "+w") as out:
    out.write(translated_code)
# Then run translated.py using python

Command line usage:

# Example usage
>> python -m curlypy --run path/to/cpy/file --output path/to/output/python/file --keep

# To get help
>> python -m curlypy --h
usage: python -m curlypy [-h] [--output OUTPUT] [--run] [--comments] [--force] [--delete] filename

Translate and run python code with braces

positional arguments:
  filename         The filename to translate.

options:
  -h, --help       show this help message and exit
  --output OUTPUT  The output filename. Defaults to <filename>.py
  --run            Set this flag if you want to run the translated code directly after translating.
  --comments       Set this flag if you want to keep comments in the translated code.
  --force          Set this flag if you want to force the translation. i.e. dont perform any checks. Can output non working code. Defaults to False.
  --delete         Set this flag if you want to delete the translated file after running it.

CurlyPy will convert your code with brackets into traditional Python with correct indentation and block structures.

Example

Here’s how Python code with curly braces and semicolons looks with CurlyPy:

def HelloWorld(name: str) {
	if name {
		print (f"Hello {name}!")
	}
	else {
		print ("Hello World!")
	}
}

After running CurlyPy, it will be converted into regular Python:

def HelloWorld(name: str) :
   if name :
      print (f"Hello {name}!")
   else :
      print ("Hello World!")

Why CurlyPy?

Python’s indentation-based syntax is great for readability but may feel unfamiliar to developers used to brace-based languages like C, Java, or JavaScript. CurlyPy gives you the freedom to write Python code with curly braces, making it easier for those developers to transition to Python without abandoning the structured code block formatting they’re used to.

CurlyPy doesn't take away Python’s flexibility—if you love type hints and it's strong typing, you can keep using them as is. CurlyPy opens up new possibilities for those who prefer braces.

CurlyPy:

# For loop
for n in range(10){
    if n % 3 == 0 and n % 5 == 0 {
        print("FizzBuzz")
	}
    elif n % 3 == 0 {
		print("Fizz")
	}
    elif n % 5 == 0 {
		print("Buzz")
	}
    else{
        print(n)
	}
}

Translated Python:

# For loop
for n in range(10):
   if n % 3 == 0 and n % 5 == 0 :
      print("FizzBuzz")
   elif n % 3 == 0 :
      print("Fizz")
   elif n % 5 == 0 :
      print("Buzz")
   else:
      print(n)

Upcoming improvements

• Better documentation
• Documentation on using CurlyPy as a python module
• Script to directly run the translated python code
• Possibly a new name
• Better command line argument parsing
• Error checking

Current Limitations

• Empty blocks are not supported, leading to a syntax error in python.

x = 5;
if x == 5 {
    ;       # Will cause python code to be problematic
}

# Use this instead
if x == 5 {
   pass;
}

• Error checking is not implemented

def incomplete_func() {
    print("This will fail");
# Missing closing bracket, but translated code will work. (Rare case)

• Complex typehints for dictionary and set types are not supported and will lead to a syntax error in the generated python code.

complex_type: dict[str, set[int]] = {"evens": {0, 2, 4}, "odds": {1, 3, 5}};  # Complex type hint with sets and dicts

Contributing

Contributions are welcome! If you want to contribute to CurlyPy or report an issue, please feel free to open an issue or submit a pull request.

Steps to Contribute:

1. Fork the repository
2. Create a new branch for your feature or bug fix
3. Submit a pull request with a clear description of the change

Why not bython?

I wanted to make my own version of a preprocessor for Python with braces, that's all.

License

This project is licensed under the GNU General Public License. See the LICENSE file for details.

---

Enjoy writing Python with the structure and familiarity of braces with CurlyPy!