Metadata-Version: 1.1
Name: korapp
Version: 0.1.3
Summary: Python package to generate app from mind map
Home-page: https://github.com/korakotlee
Author: Korakot Leemakdej
Author-email: kleemakdej@gmail.com
License: MIT
Description: KorApp
        ======
        
        .. figure:: https://github.com/korakotlee/img/raw/master/sample_mm.png
           :alt: 
        
        Python package to generate app.
        
        Installation
        ~~~~~~~~~~~~
        
        ::
        
            pip install korapp
        
        For App Creator
        ~~~~~~~~~~~~~~~
        
        Introduction
        ^^^^^^^^^^^^
        
        -  A brain is an instruction to generate applications, you can generate
           any kind of application in any language depending on the brain.
           Download the brain that you want and put in the location ``~/.brain``
        -  To create new application, use ``korapp new <appname>``
        -  Then cd into the new application folder
        -  open file ``app.mm`` to examine and make modification
        -  and run ``korapp gen``
        -  If you change the ``app.mm`` mind map, run ``korapp gen`` again to
           regenerate the related files. Note that KorApp will overwrite its
           generated files so whatever customization you make will be
           overwritten. So if you want to modify the file, you can use the
           generated file as template and copy to other file or inherit from
           them.
        -  However, the files created by ``korapp new`` will only generate once
           and not overwritten.
        
        Doc Server
        ^^^^^^^^^^
        
        The brain can behave differently from brain to brain. App Creator can
        learn how each brain work from the document server. To access the
        document for the brain. ``cd <brain_dir>   korapp doc`` The document
        then can be access from http://127.0.0.1:8000/
        
        For Brain Creator
        ~~~~~~~~~~~~~~~~~
        
        The brain is also work from mind map as well. To create a brain
        
        -  you need to write a mind map ``new.mm`` which will get run when app
           creator issue ``korapp new``
        -  put any script used by ``new.mm`` inside ``script/`` directory
        -  in the ``gen/`` directory, write mind maps corresponding to the
           branch that the app creator will be used in the first level branch,
           i.e., ``models.mm`` will get run when they use ``model`` branch,
           ``pages.mm`` for ``pages`` branch, and so on.
        -  put all the script files under same ``script/`` directory.
        
        Example of ``models.mm``
        
        |models|. - The other directory structure are not required by KorApp, it
        depends on the script to use them.
        
        Korapp New
        ^^^^^^^^^^
        
        .. figure:: korapp/img/new_mm.png
           :alt: Korapp new
        
           Korapp new
        
        -  Korapp will first look into ``new.mm`` and execute each branch. The
           first level node is command which can be either ``bash`` or
           ``python`` (``py`` is the same as ``python``)
        -  The second level branch is the script filename that is under script/
           directory of the brain.
        -  For bash, the script will run ``brain/script/<name>.sh``, the
           extension ``.sh`` will be added automatically.
        -  For python, the script will run ``brain/script/<name>.py``, the
           extension ``.py`` will be added automatically.
        
        Korapp Gen Parameters
        ^^^^^^^^^^^^^^^^^^^^^
        
        -  for bash, will run with each node converted to snakecase arguments
           only first branch level
        -  for other, will write node xml into ``.korapp/node_param.yaml`` and
           call as argument to script. The script can access node xml by using
           ``utils.get_node_param()`` like so
        
           ::
        
               from korapp import utils
        
               node_param = utils.get_node_param()
        
        Korapp Doc
        ^^^^^^^^^^
        
        Each mind map (``.mm`` files) can have accompanied document file in the
        format of markdown. The doc server will concatenate together
        ``README.md``, ``new.md`` and all .md files in the ``gen/`` directory
        
        REFERENCE
        ---------
        
        Requirement
        ~~~~~~~~~~~
        
        -  Python 3
        
        Brain Location
        ~~~~~~~~~~~~~~
        
        -  default to ~/.brain
        -  can be specified by ``-b`` or ``--brain``
           ``korapp new my_app -b ~/brain0``
        
        .. |models| image:: korapp/img/models.png
        
        
Keywords: mind map,app generator
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
