https://github.com/vallentin/pylua

Source-to-source compiler that compiles Python into Lua
https://github.com/vallentin/pylua

Last synced: 24 days ago
JSON representation

Source-to-source compiler that compiles Python into Lua

• Host: GitHub
• URL: https://github.com/vallentin/pylua
• Owner: vallentin
• License: mit
• Created: 2016-03-21T17:33:50.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2016-04-13T20:30:44.000Z (over 8 years ago)
• Last Synced: 2023-02-27T14:22:14.098Z (over 1 year ago)
• Homepage:
• Size: 58.6 KB
• Stars: 20
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

**Status:** In development.

*Information is chronologically added to this README.md file. When enough is implemented

and fleshed out, then the library will be released.*

# PyLua - Python into Lua

[PyLua][PyLua] is a [source-to-source compiler][ss-compiler]

that compiles [Python][Python] into [Lua][Lua].

*[PyLua][PyLua] is developed and tested using Python 3.5.1,

Lua 5.1 and Lua 5.2.*

## Supported Functionality

*The following list, is the features that __currently__ can be successfully

translated from [Python][Python] to [Lua][Lua].*

*Features in development has a strike-through.*

- Variables

 - ~~Global & Local Variables (Differentiation)~~

- [Types](#types)

- [Operators](#operators)

- [Functions](#functions)

 - Nested Functions

- ~~Classes~~

- ~~Importing~~

### Types

*Supported [Python][Python] types, that __currently__ can be successfully

translated from [Python][Python] to [Lua][Lua].*

#### Example - Python (left), Lua (right)

*Excluding functions.*

![Supported Python Types](examples/types.png)

### Operators

*Supported [Python][Python] operators, that __currently__ can be successfully

translated from [Python][Python] to [Lua][Lua].*

- Arithmetic (`+`, `-`, `*`, `/`, `%`, `**`, `//`)

- Comparison  (`==`, `!=`, `<>`, `>`, `<`, `>=`, `<=`)

- Assignment (`=`, `+=`, `-=`, `*=`, `/=`, `%=`, `**=`, `//=`)

- Bitwise (`~`, `&`, `|`, `^`, `<<`, `>>`)

- Logical (`not`, `and`, `or`)

- Membership (`in`, `not in`)

- Identity (`is`, `is not`)

#### Example - Python (left), Lua (right)

![Supported Python Operators](examples/operators.png)

### Functions

*Supported [Python][Python] function declarations, that __currently__ can be successfully

translated from [Python][Python] to [Lua][Lua].*

Note that while [Python][Python] supports multiple `*args` and `**kwargs` in function declarations,

[Lua][Lua] does not. [Lua][Lua] doesn't as it represents varargs with `...` (which is unnamed).

#### Example - Python (left), Lua (right)

![Supported Python Function Declarations](examples/functions.png)

### License

This module is shared under the MIT license, and is therefore free to use, share, distribute and modify.

See [LICENSE](https://github.com/MrVallentin/PyLua/blob/master/LICENSE) for more details.

[PyLua]: https://github.com/MrVallentin/PyLua

[Python]: https://www.python.org

[Lua]: http://www.lua.org

[ss-compiler]: https://en.wikipedia.org/wiki/Source-to-source_compiler