Metadata-Version: 2.0
Name: elm-magic
Version: 0.1.0
Summary: Elm Magic provides IPython magic commands that execute elm-lang code
Home-page: https://github.com/ali--/elm_magic
Author: Ali Rathore
Author-email: ali1rathore@gmail.com
License: GNU General Public License v3
Keywords: elm_magic
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: Click (>=6.0)
Requires-Dist: ipython (>=1.0)

=========
Elm Magic
=========

:Author: Ali Rathore

Introduces a %%elm magic.

Compile and display Elm code in IPython and Jupyter notebooks

.. image:: https://raw.github.com/ali--/elm_magic/master/docs/screenshot1.png

.. image:: https://img.shields.io/pypi/v/elm_magic.svg
        :target: https://pypi.python.org/pypi/elm_magic

.. image:: https://img.shields.io/travis/ali--/elm_magic.svg
        :target: https://travis-ci.org/ali--/elm_magic

.. image:: https://readthedocs.org/projects/elm-magic/badge/?version=latest
        :target: https://elm-magic.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/ali--/elm_magic/shield.svg
     :target: https://pyup.io/repos/github/ali--/elm_magic/
     :alt: Updates

Elm Magic provides IPython magic commands that execute elm-lang code

SYNOPSYS
--------

.. code-block:: python

    In [1]: %load_ext elm_magic

    In [2]: %%elm
       ...: import Html exposing (text)
       ...: main =
       ...:   text "Hello World"
    Out[2]:
       ...: Hello World

    In [3]: %%elm -i elm-lang/http elm-lang/mouse -w /tmp/myelmdir
       ...: <elm source code>

This magic will:
  (1) use working dir as /tmp/myelmdir (or a new temporary dir)
  (2) install elm-lang/http and elm-lang/mouse with elm-package install
  (3) compile the cell input with elm-make 
  (4) display the cell output as html

The -r flag renders the cell contents with elm-static-html
The cell must look exactly like this: 

.. code-block:: python

    In [4]: %%elm -r
       ...: module Main exposing (..)
       ...: import Html exposing (text)
       ...: view = 
       ...:   text "Hello World"
    Out[4]:
       ...: Hello World


USAGE
-----

Install using github::

    git clone git@github.com:ali--/elm_magic.git
    cd elm_magic
    pip install -e .
..


If elm and nodejs are not installed, you can try::

    elm_magic install --target <install-dir>

where <install-dir> is writable by the current user.
and in the user's PATH (e.g /usr/local/ or /opt/conda)

Load the magic extension in IPython or Jupyter::

        %load_ext elm_magic

then start using the %%elm magic::

        %%elm 
          ... elm-lang code ...


CONFIGURATION
-------------

see or set configuration parameters::

        %config ElmMagic

Features
--------

* provides %%elm magic that executes elm-lang and displayes the result
* can be used with any jupyter kernel
* directory used by elm-make is configurable
* provides cli for installing nodejs and elm

Credits
---------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
Started with the help of https://github.com/abingham/jupyter-elm-kernel

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage

* Free software: GNU General Public License v3
* Documentation: https://elm-magic.readthedocs.io.




=======
History
=======

0.1.0 (2017-06-11)
------------------

* First release on PyPI.


