Metadata-Version: 1.1
Name: mio-lang
Version: 0.0.8
Summary: A Toy Programming Language written in Python
Home-page: http://bitbucket.org/prologic/mio-lang/
Author: James Mills
Author-email: James Mills, prologic at shortcircuit dot net dot au
License: MIT
Download-URL: http://bitbucket.org/prologic/mio-lang/downloads/
Description: .. _Python Programming Language: http://www.python.org/
        .. _How To Create Your Own Freaking Awesome Programming Language: http://createyourproglang.com/
        .. _Marc-Andre Cournoye: http://macournoyer.com/
        .. _Project Website: https://mio-lang.org/
        .. _PyPi Page: http://pypi.python.org/pypi/mio-lang
        .. _Read the Docs: http://mil-lang.readthedocs.org/en/latest/
        .. _Downloads Page: https://bitbucket.org/prologic/mio-lang/downloads
        
        
        mio is a minimalistic IO programming language written in the
        `Python Programming Language`_ based on MIo (*a port from Ruby to Python*)
        in the book `How To Create Your Own Freaking Awesome Programming Language`_ by
        `Marc-Andre Cournoye`_.
        
        This project is being developed for educational purposes only and should serve as
        a teaching tool for others wanting to learn how to implement your own programming
        language (*albeit in the style of Smalltalk, Io, etc*). Many thanks go to `Marc-Andre Cournoye`_
        and his wonderful book which was a great refresher and overview of the overall processing
        and techniques involved in programming language design and implementation. Thanks also go to the
        guys in the ``#io`` channel on the FreeNode IRC Network specifically **jer** nad **locks**
        for their many valuable tips and help.
        
        The overall goal for this project is to create a fully useable and working programming language
        implementation of a langauge quite similar to `Io <http://iolanguage.com>`_ with heavy influence
        from `Python <http://python.org>`_ (*because Python is awesome!*). This has already largely been
        achived in the current version. See the `RoadMap <http://mio-lang.readthedocs.org/en/latest/roadmap.html>`_
        for what might be coming up next.
        
        - **Website**: http://mio-lang.org/
        - **Docs**: http://packages.python.org/circuits or `Read the Docs`_.
        
        .. image:: https://pypip.in/v/mio-lang/badge.png
           :target: https://crate.io/packages/mio-lang/
           :alt: Latest PyPI version
        
        .. image:: https://pypip.in/d/mio-lang/badge.png
           :target: https://crate.io/packages/mio-lang/
           :alt: Number of PyPI downloads
        
        .. image:: https://jenkins.shiningpanda-ci.com/prologic/job/mio-lang/badge/icon
           :target: https://jenkins.shiningpanda-ci.com/prologic/job/mio-lang/
           :alt: Build Status
        
        
        Examples
        --------
        
        Factorial::
            
            Number fact = method(
                (self < 2) ifTrue(return self)
                return (self * ((self - 1) fact()))
            )
        
        Hello World::
            
            print("Hello World!")
            
        
        Features
        --------
        
        - Homoiconic
        - Message Passing
        - Higher Order Messages
        - Higher Order Functions
        - Full support for Traits
        - Object Orienated Language
        - Written in an easy to understand language
        - Supports Imperative, Functional, Object Oriented and Behavior Driven Development styles.
        
        
        Installation
        ------------
        
        The simplest and recommended way to install mio is with pip.
        You may install the latest stable release from PyPI with pip::
        
            > pip install mio-lang
        
        If you do not have pip, you may use easy_install::
        
            > easy_install mio-lang
        
        Alternatively, you may download the source package from the
        `PyPI Page`_ or the `Downloads page`_ on the `Project Website`_;
        extract it and install using::
        
            > python setup.py install
        
        You can also install the
        `latest-development version <https://bitbucket.org/prologic/mio-lang/get/tip.tar.gz#egg=mio-lang>`_ by using ``pip`` or ``easy_install``::
            
            > pip install mio-lang==dev
        
        or::
            
            > easy_install mio-lang==dev
        
        
        For further information see the `mio documentation <http://mio-lag.readthedocs.org/>`_.
        
        
        Changes
        -------
        
        
        mio 0.0.8 2013-11-07
        ....................
        
        - Removed operator precedence parsing.
        
          - Operator precedence is **HARD**
          - Operator precedence rules hare **HARD** to remember
          - Operator precedence is not the main goal of mio right now.
        
        - Tidied up the builtins module.
        - ``from foo import *`` works again (*operator precedence parsing broke it*).
        
        
        mio 0.0.7 (2013-11-06)
        ......................
        
        - Added rudamentary stack trace support to errors. A somewhat "okay" stack trace is displayed on error(s).
        - Added ``String format`` method for performing string iterpolation. Only supports ``{0}``, ``{1}``, etc.
        - Implemented ``ListIterator`` iterable object with ``iter`` added to mio std. lib. This works similiarly to Python's iterators:
        
        ::
            
            mio> xs = [1, 2, 3, 4]
            ===> list(1, 2, 3, 4)
            mio> it = iter(xs)
            ===> ListIterator(list(1, 2, 3, 4))
            mio> it next()
            ===> 1
            mio> it next()
            ===> 2
            mio> it next()
            ===> 3
            mio> it next()
            ===> 4
            
        A further iteration would result in:
        
        ::
            
            mio> it next()
        
              StopIteration: 
              --------------
              next
            ifFalse(
             raise(StopIteration) 
            ) 
        
            raise(StopIteration) 
            
        - Re-implemented ``return`` function as part of the mio std. lib.
        - Don't allow ``return`` to be called outside of a ``Block`` (*block/method*) as this is illegal.
        - Implemented ``while`` builtin as part of the mio std. lib.
          (*no break or continue support yet*)
        - Implemented ``loop`` builtin as part of the mio std. lib.
          (*no break or continue support yet*)
        - Implemented basic support for reshuffling messages before chaining to support ``x is not None`` --> ``not(x is None)``.
        - Finally implemented operator precedence support (*which seems to cover most edge cases*).
        
        .. note:: Need to write lots of unit tests for this!
        
        - Fixed all found edge cases with the new operator precedence lexer/parser.
        - Improved ``Error`` object and added ``Error catch`` method for catching errors.
        - Implemented ``reduce`` builtin.
        - Implemented TComparable trait
        - Implemented TCloneable trait
        - Iterpret ``call message args`` to mean "pass all args to the callable"
        - Imroved Dict and List objects.
        - Implemented ``__call__`` calling semantics whereby an object can implement this as a method and ``Foo()`` will invoke ``Foo __call__`` if it exists.
        - IMplemented the ``__get__`` part of the Data Descriptor protocol.
        
        
        mio 0.0.6 (2013-11-02)
        ......................
        
        - Allow an optional object to be passed to the ``Object id`` method.
        - Implemented ``hex`` builtin.
        - Implemented ``Bytes`` and ``Tuple`` objects.
        - Implemented ``State`` core object and sample ``loop`` builtin (*in testing*).
        - Refactored all of the context state management code (*stopStatus*) and exposed it to the end user.
        
          - This means we can now write flow based constructs such as loops directly in mio.
        
        - Fixed a minor bug in the parser where ``not(0) ifTrue(print("foo"))`` would parse as ``not(0, ifTrue(print("foo")))``
        - Fixed a minor bug in the parser where ``isError`` would parse as ``is(Error)``. Parse identifiers before operators.
        - Implemented basic excpetion handling and error object(s) (*no stack traces yet*).
        - Moved ``exit`` to builtins.
        - Moved the setting of ``.binding`` attribute to ``Object`` ``set/del`` methods.
        - Added support for ``..`` operator and added this to ``Number``. This allows you to write:
        
        ::
            
            x = 1 .. 5  # a Range from 1 to 5
            
        - Added ``+`` and ``-`` operators to the ``Range`` object so you can do things like:
        
        ::
            
            x = (1 .. 5) + 2  # a Range from 1 to 5 in increment of 2
            
        - Changed default REPL prompt to: 
        
        ::
            
            $ mio
            mio 0.0.6.dev
            mio>
            
        - Implemented ``sum`` builtin.
        - Added ``try`` and ``raise`` builtins. (*``raise`` is not implemented yet...*).
        - Added support for User level Error(s) and implemented ``Exception raise``
        - Replaced ``Continuation call`` with activatable object semantics. This means:
        
        ::
            
            c = Continuation current()
            print("foo")
            c()
            
        - ``Object evalArg`` should evaluate the argument with context as the receiver.
        - Added ``List __getitem__`` and ``List __len__`` methods.
        - Added ``TIterable`` trait to the mio bootstrap library and added this to ``List``.
        - Removed ``foreach``, ``whilte``, ``continue``, ``break`` and ``return`` ``Object`` methods. These will be re-implemented as traits and builtins.
        - Changed the way the parser parses and treats operators. They are no longer parsed in a deep right tree.
        
        Example::
            
            1 + 2 * 3
        
        OLD::
            
            1 +(2 *(3))
            
        NEW::
            
            1 +(2) *(3)
            
        - This will probably make reshuffling and therefore implementing operator precedence a lot easier.
        - This also makes the following expressions possible (*used in the builtins module*):
        
        ::
            
            from foo import *
            
        - Added ``TypeError``, ``KeyError`` and ``AttributeError`` to the mio std. lib.
        - Made it possible to import members from a module with: ``from foo import bar``
        
        
        mio 0.0.5 (2013-10-29)
        ......................
        
        - Split up core into core and types.
        - Re-implemented ``True``, ``False`` and ``None`` in mio.
        - Implemented ``bin`` builtin.
        - Implemented ``bool`` builtin.
        - Implemented ``callable`` builtin.
        - Implemented ``cha`` builtin.
        - IMplemented ``from`` and ``import`` builtins.
        - Make the ``Object pimitive`` ``:foo`` method return the internal Python data type.
        - Fixed the ``abs`` builtin to return an newly cloned Number.
        - Implemented support for packages ala Python.
        - Restructured the mio std. lib
        - mio nwo bootstraps itself via an import of the "bootstrap" package.
        - Reimplemented ``Object clone`` in the mio std. lib.
        
        
        mio 0.0.4 (*2013-10-27*)
        ........................
        
        - Moved the implementation of ``super`` to the mio std. lib
        - Only set ``_`` as the last result in the Root object (*the Lobby*)
        - Added support for ``()``, ``[]`` and ``{}`` special messages that can be used to define syntactic suguar for lists, dicts, etc.
        - Implemented ``Dict`` object type and ``{a=1, b=2}`` syntactic sugar to the builtint (*mio std. lib*) ``dict()`` method.
        - Refactored the ``File`` object implementation and made it's repr more consistent with other objects in mio.
        - Fixed keyword argument support.
        - Fixed a few minor bugs in the ``Message`` object and improved test coverage.
        - Added ``?`` as a valid operator and an implementation of ``Object ?message`` in the mio std. lib.
        - Fixed a bug with ``Range``'s internal iterator causing ``Range asList`` not to work.
        - Fixed a bug with ``Object foreach`` and ``continue``.
        - **Achived 100% test coverage!**
        - Implemented ``*args`` and ``**kwargs`` support for methods and blocks.
        - Removed ``Object`` methods ``print``, ``println``, ``write`` and ``writeln`` in favor of the new builtin ``print`` function in the mio std. lib
        - Added an implemenation of ``map`` to the mio std. lib
        - Fixed a bug with the parser where an argument's previous attribute was not getting set correctly.
        - Reimplemented ``not`` in the mio std. lib and added ``-=``, ``*=`` and ``/=`` operators.
        - Added a ``Object :foo`` (*primitive*) method using the ``:`` operator. This allows us to dig into the host object's internal methods.
        - Added an implementation of ``abs`` builtin using the primitive method.
        - Changed the ``import`` function to return the imported module (*instead of ``None``*) so you can bind imported modules to explicitly bound names.
        - Added ``from`` an alias to ``import`` and ``Module import`` so you can do:
        
        ::
            
            bar = from(foo) import(bar)
            
        - Fixed some minor bugs in ``Object foreach`` and ``Object while`` where a ReturnState was not passed up to the callee.
        - Added implementations of ``all`` and ``any`` to the mio std. lib.
        - Added this.mio (The Zen of mio ala Zen of Python)
        - Added List insert method and internal __len__.
        - Moved the implementations of the ``Importer`` and ``Module`` objects to the host language (*Python*).
        - Added support for modifying the ``Importer`` search path.
        - Restructured the mio std. library and moved all bootstrap modules into ./lib/bootstrap
        - Added (almost) Python-style string literal support. Triple Quote, Double, Quote, Single Quote, Short and Long Strings
        - Added support for exponents with number literals.
        - Added internal ``tomio`` and ``frommio`` type converion function.
        - Added an ``FFI`` implementation that hooks directly into the host language (*Python*).
        - Implemented the ``antigravity`` module in mio.
        - Added support for exposing builtin functions as well in the FFI.
        - Simplified the two examples used in the docs and readme and write a simple bash script to profile the factorial example.
        - Changed the calling semantics so that calls to methods/blocks are explicitly made with ``()``.
        - Added a new internal attribute to ``Object`` called ``binding`` used to show the binding of a bound object in repr(s).
        
        
        mio 0.0.3 (*2013-10-20*)
        ........................
        
        - Improved test coverage
        - Improved the ``Range`` object
        - Fixed the scoping of ``block`` (s).
        - Fixed the ``write`` and ``writeln`` methods of ``Object`` to not join arguments by a single space.
        - Don't display ``None`` results in the REPL.
        - Improved the ``__repr__`` of the ``File`` object.
        - Added ``open`` and ``with`` builtins to the mio standard library.
        - Implemented a basic import system in the mio standard library.
        - Implemented ``Dict items`` method.
        
        
        mio 0.0.2 (*2013-10-19*)
        ........................
        
        - Include lib as package data
        - Allow mio modules to be loaded from anywhere so mio can be more usefully run from anywhere
        - Added bool type converion
        - Improved the documentation and added docs for the grammar
        - Changed Lobby object to be called Root
        - Added an -S option (don't load system libraries).
        - Added unit test around testing for last value with return
        - Refactored Message.eval to be non-recursive
        - Set _ in the context as the last valeu
        - Implemented Blocks and Methods
        - Fixed return/state issue by implementing Object evalArg and Object evalArgAndReturnSelf in Python (not sure why this doesn't work in mio itself)
        - Implemented Object evalArgAndReturnNone
        
        
        mio 0.0.1 (*2013-10-19*)
        ........................
        
        - Initial Release
        
Keywords: toy programming language io mio message
Platform: POSIX
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Assemblers
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Compilers
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Interpreters
