https://github.com/nightblade9/dragon

Dragon is a universal Python translater.
https://github.com/nightblade9/dragon

haxe prototype python3 transpiler

Last synced: 2 months ago
JSON representation

Dragon is a universal Python translater.

• Host: GitHub
• URL: https://github.com/nightblade9/dragon
• Owner: nightblade9
• Created: 2018-01-02T17:28:21.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2021-08-13T05:59:55.000Z (over 3 years ago)
• Last Synced: 2024-05-01T17:06:00.970Z (9 months ago)
• Topics: haxe, prototype, python3, transpiler
• Language: Python
• Homepage:
• Size: 161 KB
• Stars: 27
• Watchers: 5
• Forks: 3
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Dragon

[![Build status](https://travis-ci.org/nightblade9/dragon.svg?branch=master)](https://travis-ci.org/nightblade9/dragon/)

Dragon transpiles Python 3 code to [Haxe](http://haxe.org), which can then be transpiled and compiled to various platforms and languages (C++, Javascript, Java, C#, Ruby, Python, Lua, etc. for browser/web, desktop, Android, iOS, etc.)

# Usage

- Create some Python code

- Create a file like `compiler.py`

- Add the import `from dragon.transpiler.python_to_haxe_transpiler import PythonToHaxeTranspiler`

- Invoke `PythonToHaxeTranspiler(source_path, files).transpile()` passing in the directory root of the source files (important for package names!) and a list of files to transpile (eg. `os.glob.glob("**/*.py"))`).

- Check the outputted Haxe code. Invoke the Haxe compiler as usual.

For constructs that don't exist in Python (eg. `override`, `@:...`), add them to your Python code and prefix them with `@haxe:`.

# Caveats

- When importing Haxe code, use the Haxe-style `from package.subpackage import ClassName`

- Make sure all Python files have a final empty line

# Limitations

Dragon was created in order to be able to write HaxeFlixel games in Python. Python supports complex features (eg. generator functions, decorators) and ships with a vast collection of functionality (eg. `itertools`, `decimal`, etc.); it would be impossible to keep Dragon up to date.

Instead, Dragon supports just enough functionality to build games. If you find your favourite feature or module missing, feel free to open an issue or send us a PR.

# Roadmap

Currently, Dragon is in a very early stage of development. We're using Lark to generate the parse tree, and then generate the resulting Haxe code. 

Our roadmap:

- [X] Transpile the default HaxeFlixel "hello world" template (v0.1)

- [ ] Transpile a more complicated HaxeFlixel template

- [ ] Transpile an actual HaxeFlixel game

    

Once we achieve these goals, we plan to release the `v1.0.0` version of Dragon.

You may also be interested in [Mars](https://github.com/nightblade9/mars), our companion project which handles generating, compiling, and running Python-based HaxeFlixel projects (via Dragon).