Grace

What is Grace?

Grace enables you to write, build, test, deploy and upload dizmos without worrying about concatenating your classes together or having to deal with other problems. A SCSS parser is included so that you do not need to convert it on your own. Grace takes care of such tasks in your project, so that you do not have to worry them, but can concentrating on writing pure JavaScript and HTML.

Please note that Grace can be used for Javascript projects in general but comes with a plug-in that supports working with dizmos specifically. We do not cover general usage of Grace but focus on how to use it for dizmo development. For more information about Grace in general have a look on Grace on GitHub and Grace-dizmo on GitHub

Installing Grace

This will install the Grace tool and its specific dizmo development features.

Windows

Install the latest Python 2.7.x release through the installer found here: https://www.python.org/downloads/

The Windows path environment will need the Python and Python scripts directories added to it.

You will want to add this to the beginning of the path value (in the system variables):

    C:\\Python27\\;C:\\Python27\\Scripts\\;

To do that, type into the command prompt

$ path= %path%;C:\\Python27\\Scripts

and press Enter

If you want to add the path to Python permanently, you should add it to system variables. (Computer > Advanced System Settings > Environment Variables)

See also:

Download and run the following to install Setuptools which contains EasyInstall: https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py right-click the link and with the context menu item save as ... save the file to your Desktop.

Open cmd and go to the Desktop. You can do that by typing cd Desktop

Then use the python ez_setup.py command to install easy_install.

Continue the install as follows in the command prompt:

$ easy_install pip
$ pip install grace
$ pip install grace-dizmo

Mac

First, we need to install the command line tools from Xcode. These Command Line Tools let us automatically build python modules on our system. Xcode is available via the Mac App Store.

Open Terminal and run the following commands:

$ sudo easy_install pip
$ sudo pip install grace
$ sudo pip install grace-dizmo

Should the installation fail on the second command listed, then you have hit upon a bug related to Xcode 5.1.x. To resolve this you will need to run the second command as follows:

    sudo easy_install pipsudo CFLAGS=-Qunused-arguments CPPFLAGS=-Qunused-arguments pip install grace

Linux

$ sudo apt-get install python-pip
$ pip install grace --user
$ pip install grace-dizmo --user

Note: If the install fails on the second or third command listed, you likely need to install python2.7-dev like so:

$ sudo aptitude install python2.7-dev

To finish off, run the following to update your PATH:

$ echo "export PATH=~/.local/bin:$PATH" >> ~/.bashrc

Updating Grace

You can update Grace to its latest version.

Mac

$ sudo pip install -U grace grace-dizmo

Windows

$ pip install -U grace grace-dizmo

Linux

$ pip install --upgrade --user grace grace-dizmo

External resources