/PydMagic

IPython/Jupyter magic for inline D code

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

PydMagic

Ipython/Jupyter magic for inline D code in a python notebook

Liable to change. Depends on pyd (https://github.com/ariovistus/pyd), mergedict (https://pypi.python.org/pypi/mergedict) and dub (http://code.dlang.org)

Example on colab:

To install, just enter

in [1]: %install_ext https://raw.githubusercontent.com/DlangScience/PydMagic/master/pyd_magic.py

in any ipython instance.

To use, first enter

in [2]: %load_ext pyd_magic

then write your pyd extension in a cell marked with %%pyd e.g.

in [3]: %%pyd

        @pdef!() string hello() {
            return "Hello World!";
        }

        @pdef!(Docstring!"takes a single int, returns that int converted to a string")
        string intToStr(int b)
        {
            import std.conv;
            return b.to!string;
        }

        @pdef!(PyName!"binary_zebra") int zebra()
        {
            return 101010101;
        }

        @pdef!() long[] whereExactlyIntegral(double[] data)
        {
            import std.algorithm, std.array;
            return data.filter!(x => x == cast(long)x).map!(x => cast(long)x).array;
        }

        @pdef!()
        struct S
        {
            @pdef!() string bleep = "bloop";
            @pdef!() int bar(int w) { return w * 42; }
        }

and run. After it has finished building, your extension should be automatically imported and ready to use, like so:

in [4]: hello()
out[4]: 'Hello World!'

in [5]: intToStr(435)
out[5]: '435'

in [6]: whereExactlyIntegral([3.0, 2.4, 7.0, 1.001])
out[6]: [3, 7]

in [7]: s = S();
        s.bleep
out[7]: 'bloop'

in [8]: s.bleep = 'blah'
        s.bleep
out[8]: 'blah'

in [9]: s.bar(2)
out[9]: 84

see examples/test.ipynb for an example using numpy arrays.

Builds are cached just like with cython magic. Some basic flags are supported as arguments to %%pyd such as --dub_args, run %%pyd? for more info.

The pdef UDA instructs the extension to wrap the function/type/member for use in python. It takes any template arguments that pyd.pyd.def takes.

dub integration

Adding a dependency on a dub package or any other part of a dub.json is as easy as %%pyd --dub_config={"dependencies":{"someDubPackage":"~>1.2.5"}} and command line arguments to dub can similarly by added with --dub_args. See %%pyd? for more info.

PydMagic provides its own PydMain, so you can't define your own. You can, however, define 2 functions preInit() and postInit(), which PydMagic will call before and after calling pyd's module_init() respectively. You can use this to manually wrap functions, types, anything else pyd supports.

I have tested on OS X and linux. Everything works fine on linux, but on OS X you can't import more than one extension per python instance (including modifications of the same extension) or python will crash. This is due to shared libraries not being supported on OS X. Windows is almost but not quite working.

This code is heavily based on the %%cython magic implementation.