mahmoudimus / py2star Goto Github PK

View Code? Open in Web Editor NEW

8.0 2.0 3.0 238 KB

Converts python files to starlark (or Larky) compatible scripts.

License: Apache License 2.0

Dockerfile 0.89% Shell 0.02% Python 99.09%

starlark python transpiler source-to-source starlark-files

py2star's Introduction

py2star's People

Contributors

Stargazers

Watchers

Forkers

la-luo moehajj aslepakurov

py2star's Issues

slice mutation with list

`setslice(i, j, sequence)` i.e. `seq[i:j] = sequence`

    def __setslice__(i, j, sequence):
        for atom in sequence:
            if i >= j:
                break
            _seq.remove(i)
            _seq.insert(i, atom)
            i += 1

Checklist

raise XXXX => fail()
self => callablestruct (?)
is => ==
is not => !=

Convert ** to pow(left, right)

Desugar decorators

Remove and desugar decorators. In python, a decorator is syntactic sugar for: func = decorator(func), we can just desugar this.

Also, built-in decorators such as @classmethod and @staticmethod do not exist and may be safely re-written.

multiple test cases in same file should be prefixed with the outdented class name to avoid collision

class A(unittest.TestCase):
   def test_1(self):
         pass

class B(unittest.TestCase):
   def test_1(self):
         pass

should be

def A_test_1(self):
    pass
def B_test_1(self):
    pass

Some misc issues

codecs.encode() transform can mess up
while True: ... does not transform properly
dict.fromkeys(p256_names, p256) => {k: p256 for k in p256_names}

change bytearray(n) to bytearray(r" ") * len(term1)

Option to automatically unwrap errors

raise ValueError("Foo")

becomes:

return Error("Foo")

but we would like it to be:

return Error("Foo").unwrap() # notice the unwrap

This should be an option that we pass in to disable/enable this behavior as sometimes Result/Error object pattern is not desired and immediate fail is necessary.

Remove non test asserts

assert foo != None

should be converted to:

if foo == None:
    fail('Foo equals None!')

replace bytes(b'\x00') with list of ints so bytes([0x00])

Convert constructors

Class

class BytesIO_EOF(object):
    """This class differs from BytesIO in that a ValueError exception is
    raised whenever EOF is reached."""

    def __init__(initial_bytes):
        _buffer = initial_bytes
        _index = 0
        _bookmark  = None
  
    def set_bookmark():
        _bookmark = _index

Converting to this function

def BytesIO_EOF(initial_bytes):
    """This class differs from BytesIO in that a ValueError exception is
    raised whenever EOF is reached."""

       self = larky.mutablestruct(
             _buffer = initial_bytes
             _index = 0
             _bookmark  = None
         )

    def set_bookmark(self):
           self._bookmark = self._index

    return larky.struct(
             self = self,
             set_bookmark=larky.partial(set_bookmark, self)
             __class__='BytesIO_EOF'
         )
    return self

Missing prefixes when using `@property` annotation

Missing larky. prefix for property() method, and self. prefix for internal method variable.

Example:

input .py:

@property
def name(self):
    return self.get_name()

output .star:

def name():
    return self.get_name()
self.name = name
name = property(name)

should be:
~~~ ~name = larky.property(name)~ ~~~

(edit by @mahmoudimus ):

def name():
    return self.get_name()
self.name = larky.property(name)

Converting exception with format strings does not work

raise TypeError(
                "{} takes at most 1 positional argument"
                " ({} given)".format(name, len(args))
            )

is converted to:

return Error()

Escaped docstring sequences should be prefixed with `r` representing a raw string.

'del' not supported, use '.pop()' to delete an item from a dictionary or a list

Remove del with .pop() where appropriate.

for/else

for i in range(len(s)):
     if i < 5:
        break
else:
    print("s has length >= 5!")

to:

didbreak = False
for i in range(len(s)):
     if i < 5:
        didbreak = True
        break
if not didbreak:
    print("s has length >= 5!")

mahmoudimus / py2star Goto Github PK

py2star's Introduction

py2star

Get started quickly

Setup

Run

Differences with Python

Some High-level Differences

The following Python features are attempted to be automatically converted:

Automatic Conversion

py2star's People

Contributors

Stargazers

Watchers

Forkers

py2star's Issues

__setslice__(i, j, sequence) i.e. seq[i:j] = sequence

Class

Converting to this function

Recommend Projects

Recommend Topics

Recommend Org

`setslice(i, j, sequence)` i.e. `seq[i:j] = sequence`