Pythonx

Python Interpreter in Elixir

Important

Pythonx is still very much a work in progress and is mainly intended for some proof of concept at current stage.

Proof of Concept

Low-Level

iex>aliasPythonx.Ciex>aliasPythonx.C.PyDictiex>aliasPythonx.C.PyLongiex>aliasPythonx.C.PyRuniex>aliasPythonx.C.PyUnicodeiex>Pythonx.initialize_once()iex>globals=PyDict.new()#Reference<0.1798353731.1418330114.239105>iex>locals=PyDict.new()#Reference<0.1798353731.1418330114.239123>iex>a=PyLong.from_long(1)#Reference<0.1798353731.1418330114.239141>iex>b=PyLong.from_long(2)#Reference<0.1798353731.1418330114.239155>iex>PyDict.set_item_string(locals,"a",a)trueiex>PyDict.set_item_string(locals,"b",b)trueiex>PyRun.string("c = a + b",C.py_file_input(),globals,locals)#Reference<0.1798353731.1418330117.241204>iex>c=PyUnicode.from_string("c")#Reference<0.1798353731.1418330117.241222>iex>val_c=PyDict.get_item_with_error(locals,c)#Reference<0.1798353731.1418330117.241236>iex>PyLong.as_long(val_c)3

BEAM Level

iex>Pythonx.initialize_once()iex>globals=Pythonx.Beam.encode(%{})#PyObject<type: "dict",repr: "{}">iex>locals=Pythonx.Beam.encode([a: 1,b: 2])#PyObject<type: "dict",repr: "{'a': 1, 'b': 2}">iex>Pythonx.Beam.PyRun.string("c = a + b",Pythonx.Beam.py_file_input(),globals,locals)#PyObject<type: "NoneType",repr: "None">iex>locals#PyObject<type: "dict",repr: "{'a': 1, 'b': 2, 'c': 3}">

High-Level

iex>Pythonx.initialize_once()iex>state=Pythonx.State.new(locals: [a: 1,b: 2])%Pythonx.State{globals: %{},locals: [a: 1,b: 2]}iex>{result,state}=Pythonx.PyRun.string("c = a + b",Pythonx.py_file_input(),state)iex>state.locals%{"a"=>1,"b"=>2,"c"=>3}

Very High Level

Python Code Evaluation

defmoduleMyModuledoimportPythonxdefdo_stuff_in_pythondoa=1b=2pyinline("c = a + b",return: [:c])dbg(c)endend

Or in IEx

iex>Pythonx.initialize_once()iex>importPythonxiex>a=11iex>b=22iex>pyinline("c = a + b",return: [:c])iex>c3

Executes a command with the embedded python3 executable

iex>importPythonxiex>python3!"path/to/script.py"iex>python3!["path/to/script.py","arg1","arg2"]

Executes a command with the embedded pip module

iex>importPythonxiex>pip!["install","-U","numpy"]iex>pip!["install","-U","yt-dlp"]

Use an external python library

iex>importPythonxiex>video_id="dQw4w9WgXcQ"iex>pyeval(...> """
...> from yt_dlp import YoutubeDL
...> import json
...> with YoutubeDL(params={'quiet': True}) as ytb_dl:
...> info = ytb_dl.extract_info('https://www.youtube.com/watch?v=#{video_id}', download=False)
...> info = json.dumps(info, indent=2)
...> """,
...> return: [:info]
...> )
[youtube] Extracting URL: https://www.youtube.com/watch?v=dQw4w9WgXcQ
[youtube] dQw4w9WgXcQ: Downloading webpage
[youtube] dQw4w9WgXcQ: Downloading ios player API JSON
[youtube] dQw4w9WgXcQ: Downloading player a95aa57a
[youtube] dQw4w9WgXcQ: Downloading m3u8 information
iex> IO.puts(info)

Installation

If available in Hex, the package can be installed by adding pythonx to your list of dependencies in mix.exs:

defdepsdo[{:pythonx,"~> 0.1.0"}]end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/pythonx.