Tag Archives: Mirah

Mirah Netbeans Module


Mirah Netbeans Module

A module to add Mirah support to Netbeans.

Screenshot

Project Status

Alpha

This module includes both support for augmenting the build/compile process of certain NetBeans project types, and support for editing .mirah files in the code editor. So far (October 20, 2014) I have focused only on the Codename One and Java SE Application, Java Web Application and Maven project types (added in version 1.0.23).

If you would like to see support for a specific project type, please post it in the issue tracker.

Features

Mirah (the language)

  • Ruby-like syntax
  • Statically compiled to JVM bytecode.
  • Compiled code has no dependencies (you can deploy code just as if it was compiled java).
  • 2-way interrop between Mirah code and java code.
  • As fast as Java

Editor

  • .mirah editor (to edit Mirah files).
  • Syntax highlighting
  • Method and property completion.
  • Import hints
  • Error highlighting
  • Abstract method completion
  • Class member navigation panel

Project Support

  • Java Application & Java Class Library (i.e. JavaSE)
  • Java Web Application (i.e. JavaEE)
  • Codename One Projects
  • Codename One Libraries
  • Maven Projects

Building

  • Seamless integration with Java projects. You can add .mirah source files to your Java project in the same source tree, and they will be built like normal Java files.
  • Support for 2-way dependency between Java and Mirah code.
  • Comes packaged with Mirah compiler

License

Apache 2.0

Download

ca-weblite-netbeans-mirah.nbm

Installation Instructions

  1. Download the .nbm file.
  2. In Netbeans, select “Tools” > “Plugins”
  3. Click on the “Downloaded” tab, and click the “Add Plugins…” button.
  4. In the file dialog, select the ca-weblite-netbeans-mirah.nbm module that you downloaded, and click “Open”.
  5. Follow the prompts as it is installed.

Usage

Screencast

The following screencast demonstrates the use of the NetBeans Mirah plugin to develop a Codename One application using Mirah.

Codename One Mirah Poker Demo Screencast

JavaFX/Maven Tutorial

This tutorial shows you how to use Mirah with a JavaFX Maven project.

Creating a Mirah Class

  1. Access the “New File” wizard inside an existing Java project. (e.g. Select File > “New File…”). New Menu dialog
  2. One of the file types should be “Mirah Class”. Select this option. New Mirah Class
  3. Click “Next”. This will take you to a form to enter the name, package, etc.. of your class. Name class panel
  4. Click “Finish”. This should add your class to the specified directory, and open it in the editor. Project explorer New class

Method Completion

Method completion is a little bit rough, but it works in most cases.

  1. Press Ctrl-Space after typing “.”, and it will present a drop-down list of available methods on this object.

Autocomplete

Import Hints

If you use a class or symbol that hasn’t been imported into the file’s scope, you will receive a hint in the margin that allows you to select appropriate classes that it has found in the classpath and add the import statement automatically.

Import hint

Limitations

This was the first Netbeans module of this complexity that I have written, and there is still much to do. It does handle method completion, but it is still a little clunky and only provides autocomplete for those methods that it could introspect using Java reflection. This doesn’t include Rubyisms like the List.each() method, and it currently doesn’t include properties or static fields.

There also isn’t any support for refactoring operations, either from a producer or consumer standpoint.

Bugs

Report bugs in the issue tracker

Building from Source

  1. Clone the repo
  2. Open project in Netbeans
  3. Build project

Contributions

Mirah is awesome, but the community is small right now. Make it better by forking and improving any of the following projects:

  1. This project
  2. The Mirah Ant Task (used by the Netbeans module to perform builds)
  3. The Mirah Project (Includes the Mirah compiler and CLI tools)
  4. The Mirah Parser Project (Used by the Mirah compiler for parsing source)

References

Credits

  1. Module developed and maintained by Steve Hannah
  2. Mirah created by Charles Nutter
  3. Thanks to Nick Howard and Ryan Brown for their stewardship of the Mirah project in recent years, and for their guidance in building this module.

Maven JavaFX Example


As of version 1.0.23, the Mirah Netbeans Module supports Maven projects. This opens up a lot of doors, as it allows us to essentially use Mirah inside any Maven project. Most Java frameworks have Maven support these days, so this means that you can now use Mirah with most frameworks. In this tutorial I will walk through how to use a Mirah inside a JavaFX Maven project, including how to use a Mirah class as an FXML controller. Read more>>

Creating JavaFX Apps with Mirah in Netbeans


This screencast shows you how to use the Mirah Netbeans Module to write JavaFX apps in NetBeans. This uses the Netbeans Maven JavaFX project as a base.