Skip to main content

Transpiles Bython to Python

Project description

Bython

Python with braces. Because Python is awesome, but whitespace is awful.

Bython is a Python preprosessor which translates curly braces into indentation.

Key features

  • Write Python using braces instead of whitespace, and use the transpiler to convert it to valid Python code
    • Transpiles curly braces while keeping maps, fstrings, and curlies inside strings intact
  • Allows for translation of && and || to and and or
  • Can optionally translate true and false to True and False

Code example

myMap = {
    "status": "awesome!"
}

def print_message(num_of_times) {
    for i in range(num_of_times) {
        print(f"Bython is {myMap["status"]}");
    }
}

if __name__ == "__main__" {
    print_message(10);
}

Installation

Install from pip

$ python -m pip install bython-prushton

Quick intro

Bython works by first translating Bython-files (required file ending: .by) into Python-files, and then using Python to run them. You therefore need a working installation of Python for Bython to work.

To run a Bython program, simply type

$ python -m bython-prushton source.by 

to run source.by. If you want more details on how to run Bython files (flags, etc), type

$ python -m bython-prushton -h

To transpile an entire directory, run bython with the -o to specify the output directory, and -e to specify the entry point.

$ python -m bython-prushton -o dist -e main.py src

To transpile without running, omit the -e argument. You can also include -t to translate lowercase booleans to uppercase and null to None

$ python -m bython-prushton -o dist -t src

Contributing

Code

If you want to contribute, make sure to install

  • Python
  • Colorama

All source code is located in src

  • src/bython-prushton/bython.py handles the command line arguments
  • src/bython-prushton/parser.py handles tokenizing and parsing files
  • src/bython-prushton/py2by.py parses python to bython and could use some help

testcases have two structures for testing the parser and the cli:

bython
|-<test name>
|  |-src                  Bython code to convert
|  |-expected_out.txt     Expected out when running the bython
|  |-info.json            Info on how to run the test
|  |-build/               Dir for transpiled python code
parser
|-<test name> 
|  |-main.by              Bython code to convert<br>
|  |-expected_out.txt     Expected out when running the bython
|  |-build/               Dir for transpiled python code

run make test to run bython tests

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bython_prushton-1.3.2.tar.gz (35.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bython_prushton-1.3.2-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

Details for the file bython_prushton-1.3.2.tar.gz.

File metadata

  • Download URL: bython_prushton-1.3.2.tar.gz
  • Upload date:
  • Size: 35.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for bython_prushton-1.3.2.tar.gz
Algorithm Hash digest
SHA256 8b97321b25231d1a8adedc756b689edbd13a8bc880227bb2227de905ec8f0133
MD5 298e86bb5acbabe81be20c51effaa44f
BLAKE2b-256 fae78772cf5f0a5f09484f3cf01c2d123bec0e48a03d127cfa4bc95f820ce833

See more details on using hashes here.

File details

Details for the file bython_prushton-1.3.2-py3-none-any.whl.

File metadata

File hashes

Hashes for bython_prushton-1.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 14b80e53d5e73d5d80ee91e41297f9efcb2660962dbba18f264975b62bf1dfa9
MD5 d274be358b1aff05e53bd050c847d4c2
BLAKE2b-256 1d9ca06b3422d10cfc382ffe875f9e900c41d3648aff36715c8992648f89bdd9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page