View source for FreeplaneJrubyInstaller - developers


This wiki page is intended for new programmers that want to '''try Ruby, and make Freeplane ruby scripts'''.

If you just want to '''''run a ruby script''''', then instead read [[FreeplaneJrubyInstaller_Addon.md|FreeplaneJrubyInstaller Addon]] 
If you want to know '''''how the addon was made''''', then instead read [[FreeplaneJrubyInstaller_-_making_of|FreeplaneJrubyInstaller - making of]]


I estimate that only a small number of people will actually feel curious to learn ruby and make freeplane scripts with ruby, which makes us - the ''freeplane-ruby-scripts programmers'' - a '''really small and nice club''' :)

So, if you anytime feel ''part-of-the-club'' (or just want to say hello), dont be shy and drop a comment in this forum thread: XXXXXXXTODOXXXXX

Hope we all have a great time :)



So here we go: learn ruby, program freeplane, have fun :)



== Lets play first and read the instructions latter ==


* In Freeplane, click '''Tools/Jruby.../Ruby Live Debugger.../Debug in paralell Thread (GUI responsive)''', and wait (2min) until a new black window appears

* Now follow one of these video examples:

TODO




== Freeplane ruby script = Ruby + Freeplane Scripting Api ==


A ruby script for freeplane, is a '''ruby''' program that will use '''Freeplane java-objects from the [http://freeplane.sourceforge.net/doc/api/ Freeplane Scripting API]'''


To learn how to make ruby scripts for freeplane, the ideal learning-path is to:
# [[FreeplaneJrubyInstaller_-_developers#Learn_the_basics_of_Ruby|Learn the basics of Ruby]]
# Know how to call the Freeplane-java-objects in your ruby script. This is in fact 2 things:
## [[FreeplaneJrubyInstaller_-_developers#Learn_what_freeplane-java-objects_are_available_for_you_-_the_Freeplane_Scripting_API|Learn what freeplane-java-objects are available for you - the Freeplane Scripting API]]
## [[FreeplaneJrubyInstaller_-_developers#Learn_how_to_call_freeplane-java-objects_in_.28J.29ruby|Learn how to call freeplane-java-objects in (J)ruby]]


In the next sections, we'll go through this learning-path, which I trimmed down to the essentials (with links for further exploration, if/when you need)




=== Learn the basics of Ruby ===

Ruby is a simple language, easy to learn for new programmers, with lots of books, guides, videos and explanations in internet (almost too much)

In internet there are lots of learning material about "Ruby" and about "Ruby on Rails", but stay away from "Ruby on Rails" because that is another umongous universe (using ruby to make webpages). For freeplane scripting, we just need to learn ''Ruby'' (without Rails!), and even then, just the ''basics'' of Ruby.


To start with Ruby, I recommend you read and follow these learning links:

* [http://tryruby.org/levels/1/challenges/0 Try ruby in 15 minutes, in the browser]
** >> I think this should be your first contact with ruby: a guided interactive tour to do simple things in ruby
** Its all online, no install needed, and seems like 15-30min
** From here take a general idea of ruby - you'll see these things explained in more detail in other guides/books

* [https://pine.fm/LearnToProgram/ Learn to Program - A Place to Start for the Future Programmer]
** >> I think this should be your second contact with ruby - understand a bit more of what is ruby. <br /> While reading the book, have in the side a browser open with the [https://repl.it/languages/ruby Online Interactive Ruby (online irb)] (see bellow) to copy/paste code from the book, and try for yourself 
** Small online book made to teach ruby for new programmers.
** Covers the basics, and seems well written

* [https://repl.it/languages/ruby Online Interactive Ruby (online irb)]
** >> Keep this close to you everytime you are learning ruby, it allows you to try ruby code without installing anything. This is the equivalent of an ''online'' '''irb'''.
** Instead of installing ruby in your pc and then use its "irb" to test ruby code, you can use this ''online'' irb without installing anything :) 
** Good to try out small code snippets, like examples from a book, or for you to explore ruby


Also, the following links are optional '''support-material''' - they will not teach you ruby but if you have them somewhere close they will be helpfull many times. 

They contain more than info than you will ever need, but are good consulting references, to clearout doubts, see examples, etc. I still use them myself:

* [http://www.digilife.be/quickreferences/qrc/ruby%20language%20quickref.pdf Ruby QuickRef Card (print it)]
** >> Print these 2 pages in 1 sheet and keep it around in the desk - it will help you many times to remember ruby syntax. Take notes on it as you need :)

* [http://www.zenspider.com/ruby/quickref.html Zenspider Ruby QuickRef (bookmark it)]
** >> This is '''the best quickref of ruby'''. I always search here first. Its too big to be printed (what a pitty) but whenever you want, you can open it online, and "find" what you want
** Its a great reference to be consulted when needed! I never got even close to know all of it, so don't sweat. Just a reference, use it as you need it :)

* Search in google "TutorialsPoint Ruby Basics" - TutorialsPoint Ruby Basics (consult when needed)
** >> Use it like support-material: when you have a doubt about something specific, search for it in here
** It packs good info in short resumes. Sometimes a bit canonical, but the examples can be of use for you and clarifying
** Use it to consult, like a ''reference'' with examples and resumes.
** This wiki filters the webpage link as spam (which is not), so use google to reach it


For freeplane scripts, its enough to learn only the basics of ruby - its up to you to decide how deep you want to learn it. In any case, have an overall idea of Ruby, and comeback to the above links whenever you need.

<small> NOTE: If someday you want to become a ruby pro, you will want to read the "pickaxe" book: [https://pragprog.com/book/ruby4/programming-ruby-1-9-2-0 The Pragmatic Programmers' Guide, Programming Ruby] If you are a new programmer, dont start here. </small>



=== Know how to call the Freeplane-java-objects in your (J)ruby script ===

==== Learn what freeplane-java-objects are available for you - the Freeplane Scripting API ====

Now, we will skim over the [http://freeplane.sourceforge.net/doc/api/ Freeplane Scripting API], which are a group of Java classes and its methods.


All the Freeplane Scripting API are '''Java''' classes and '''methods'''.

This will not make much sense to you now, after having learned the basics of ruby, because you don't know how to use ''Java'' classes/methods in ''ruby''. These java classes will not be ''used'' just now, I will just ''present'' them so that you have an idea that they exist, and where you can find them latter, when you need them.


The freeplane-java-objects are documented in the [http://freeplane.sourceforge.net/doc/api/ Freeplane Scripting API], which is a Java API, where you can see the '''classes''' , the '''methods''' of each '''class''' and a short description of what each '''method''' does. The Freeplane Scripting Api should be open by your side while you'r making freeplane scripts - you will consult it all the time. Click the "FRAMES" link at the top, to show in the webpage a left-side-navigation-list with all the Classes available.


To learn freeplane scripting, the most interesting class of the [http://freeplane.sourceforge.net/doc/api/ Freeplane Scripting API], is [http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.Node.html Proxy.Node]
* Represented in groovy and ruby scripts by the variable <code>node</code>   
* Look to these java methods: '''getText()''' and '''setText("whatever")'''


In Ruby scripts (imitating what happens with Groovy scripts), there are some handy '''special variables predefined''' for us to use in scripts, that point to usefull java-classes:
* <code>node, c</code> - as explained here http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/ScriptUtils.html
* <code>ui, logger, htmlUtils, textUtils, menuUtils, config</code> - as explained here http://freeplane.sourceforge.net/doc/api/index.html?org/freeplane/plugin/script/FreeplaneScriptBaseClass.html


    


==== Learn how to call freeplane-java-objects in (J)ruby ====


In last section I ''presented'' the Freeplane Scripting API, which are a group of '''Java''' classes/methods. In this section, I will focus on how to ''use'' '''Java''' classes/methods inside a '''(j)ruby''' script.


Read this section once, and take a pause. Then re-read it again. It's normal to don't understand-it-all in the first time (and second), at least that's what happened to me. <br /> So know in advance that this will not be all understood in one pass - so read it relaxedly and let it sink-in afterwards. <br /> Its a bunch of concepts, and you dont need to master all of them to start with scripts. The natural evolution is to get an idea, use examples, and if/when you need then comeback and dive deeper into understanding. 

<small>
If/when you want to understand more about this topic, then:
* have a look into the Jruby wiki page dedicated to [https://github.com/jruby/jruby/wiki/CallingJavaFromJRuby#calling-java-from-jruby Calling Java from JRuby]
* get this book [https://www.google.es/search?q=using+jruby+inurl%3Apdf Using JRuby - The pragmatic programmers] 
** read only "Chapter2 Driving Java from Ruby" and "Appendix B: Ruby/Java Interoperability"
** you just need to read those 2 sections of the book, its a 2-3h read, not much
** dont stress out - just read it once to get an idea, and get back to it if/when you latter need it.
** NOTE: if you are a java programmer getting into jruby, this book may be '''''it'''''
</small>





The '''ruby''' language cannot use java-objects by default, but the '''J'''ruby-complete.jar adds some special-jruby-magic that makes possible for the ruby programs executed by the '''j'''ruby-complete.jar to '''''use''''' java-objects. 

So '''Jruby''' = ruby + <some-special-magic-that-enables-us-to-call-java-objects-from-inside-jruby-scripts>. 

That jruby <special-magic> is refered as "Driving Java from Ruby", and I will resume here some basics of it, enough for freeplane-ruby-script. For  more info, see links at the end of section



In a normal '''R'''uby program (not '''J'''ruby, just '''R'''uby as you saw in [[FreeplaneJrubyInstaller_-_developers#Learn_the_basics_of_Ruby|Learn the basics of Ruby ]]), there is:
* '''ruby code''' that ''drives/uses''
**  '''Ruby-objects''' (Ruby-classes/methods)


In a '''<span style="background:GreenYellow">J</span>'''ruby program (not '''R'''uby, but '''J'''ruby now), there is:
* '''ruby code''' that ''drives/uses''
** '''Ruby-objects''' (Ruby-classes/methods)
** <span style="background:GreenYellow">'''Java-objects''' (Java classes/methods) </span>



Jruby can access any Java-class, however we will focus mainly on the Java objects from the [http://freeplane.sourceforge.net/doc/api/ Freeplane Scripting API]



===== Access Scripting API Java-classes: node, c, ui, logger, htmlUtils, textUtils, menuUtils, config =====

Jruby can access any Java-class, however we will focus mainly on the Java-classes from the Freeplane Scripting API, and not all of the API java-classes, but just in those that are most usefull.


And we are in luck, that the Freeplane Scripting Api has some '''special variables predefined''' for us, to access the most-usefull [http://freeplane.sourceforge.net/doc/api/ Freeplane Scripting API] classes: '''node, c, ui, logger, htmlUtils, textUtils, menuUtils, config''' (see [[FreeplaneJrubyInstaller_-_developers#Learn_what_freeplane-java-objects_are_available_for_you_-_the_Freeplane_Scripting_API|Learn what freeplane-java-objects are available for you - the Freeplane Scripting API]]). <br />So you can simply use '''node''' to access the [http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.Node.html Proxy.Node] Java-class, and the other special-variables to access other most-usefull java-classes from the Scripting API.

So, Jruby can access any of the Freeplane Scripting API Java-classes, but from aaalll the classes of the API, only a small number of them is actually usefull, and for those there are '''special variables predefined'''. that give quick access to those java classes.

I recommend that to start playing with Scripting API, you only use the '''[http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.Node.html node]''' (and maybe others '''special variables predefined'''). <br />
The '''[http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.Node.html node]''' will allow you to read/write into a node text, details, attributes, ... so should give more than enough runway for a smooth start into scripting :) 




<small>
NOTE: Ignore the following if you are starting with scripting

If/when you need to access any other Java-classes, you can do it like this:
More info in https://github.com/jruby/jruby/wiki/CallingJavaFromJRuby

    # Access Java-classes of Scripting API that are  -->> Proxy.Xyzzz <<-- with:
    Java::org.freeplane.plugin.script.proxy.XyzzzProxy    # Java: Proxy.Xyzzz  (notice that XyzzzProxy <---- Proxy.Xyzzz )
    Java::org.freeplane.plugin.script.proxy.MapProxy      # Java: Proxy.Map
    Java::org.freeplane.plugin.script.proxy.NodeProxy     # Java: Proxy.Node
        #
        # NOTE: In technicall rigor, I believe that the Java-Interface 'Proxy.Node' has a Java-Class 'NodeProxy',
        # and that Java-Class is used in Jruby as 'NodeProxy'
        # I believe that is why all the Java-Interfaces (all the Proxy.Xyzzz) are accessed with 'XyzzzProxy'
        #
    
    # Access Java-classes of Scripting API that are not -->> Proxy.Xxxxx <<-- with:
    Java::org.freeplane.core.util.FreeplaneVersion        # Java: FreeplaneVersion
    Java::org.freeplane.core.util.HtmlUtils               # Java: HtmlUtils
    Java::org.freeplane.core.util.LogUtils                # Java: LogUtils
</small>





===== Call Java-methods: getXXX(), setXXX(yyy), isXXX(), ... =====

Ok, so in last section we saw we can use the special-variables to access the most usefull java-scripting-classes

Now we'll see how to '''call''' a ''java''-'''method''''' from those ''java-classes''.

In Jruby, you can call Java-methods in multiple ways - they all do the same thing, just written differently: 

    # Calling java-methods in "java-style"
    the_node_text = node.getText()
    node.setText("hello!")
    bool_value = node.isRoot()
    node.createChild("Im a newborne child node")
    
    # In ruby the parenthesis are optional
    # So we could write it as:
    the_node_text = node.getText
    node.setText "hello!"  
    bool_value = node.isRoot
    node.createChild "Im a newborne child node" 
    
    # Jruby also allows to call aJavaMethod() like this: a_java_method()
    # So we could write it as:
    the_node_text = node.get_text
    node.set_text "hello!"
    bool_value = node.is_Root
    node.create_child("Im a newborne child node")
    
    # Jruby also allows to call the java-methods getXXX(), setXXX(yyy), isXXX() like this:  
    #
    #            a_value = obj.getXXX()         can be written as as        a_value = obj.XXX 
    #
    #            obj.setXXX(yyy)                can be written as as        obj.XXX = yyy
    #
    #            a_bool = obj.isXXX()           can be written as as         a_bool = obj.XXX?
    #
    # (for more info see https://github.com/jruby/jruby/wiki/CallingJavaFromJRuby#alternative-names-and-beans-convention)
    # So we could write it as:
    the_node_text = node.text
    node.text = "hello!"   
    bool_value = node.root?
    node.createChild("Im a newborne child node")
    
    
It's up to you to decide which to use.<br /> Fro an easy start, use the   <code>node.getText()</code>   (the "java-style") that is closer to the Scripting API syntax. <br /> With time, you may get more confortable with <code>node.text</code> and <code>node.root?</code>





===== Call Java-methods: conversions between ruby-type <--> java-type (automatic and manual) =====

So now that we know how to call a java-method from Jruby. Let see how we can give arguments and receive return-values from the java-methods in our Jruby programs.



Each Java-class has '''methods'''. 

Each Java method takes 0-or-more '''arguments''', and returns a '''return-value'''



As we saw before, in a '''<span style="background:GreenYellow">J</span>'''ruby program (not '''R'''uby, but '''J'''ruby now), there is:
* '''ruby code''' that ''drives/uses''
** '''Ruby-objects''' (Ruby-classes/methods)
** <span style="background:GreenYellow">'''Java-objects''' (Java classes/methods) </span>




Long-story-short, the thing is this: 
* In the pure '''Java-world''' there are only '''java-objects''': in a java program, you have only java-objects, and java-methods expect to work with java-objects.

* In the pure '''Ruby-world''' there are only '''ruby-objects''': in a ruby program, you only have ruby-objects, and ruby-methods expect to work with ruby-objects.

* Now comes the magical part: in the '''<span style="background:GreenYellow">J</span>ruby-world''', there are both java-objects and ruby-objects. And part of that magic, is that when you need to call a '''java-method''' with arguments that are '''ruby-objects''', then Jruby will automatically try to convert the arguments-ruby-objects into appropriate arguments-java-objects that can be used internally by the java-method. Also, part of that magic is that after a java-method is called, it internally delivers a return-value that is a '''java-object''', ''but'' Jruby automatically tries to convert it into an appropriate '''ruby-object''' that is returned into the jruby-program (if it cannot convert, it returns the unconverted java-object)

These conversions are predefined for the most usefull ruby/java types (see bellow) and work so well normally that you dont even think about them. But in some few cases, when there is no automatic-conversion possible, then if you need to you can manually convert between java-objects/ruby-objects. Just remember that a java-method can only work with arguments that are java-object internally: so if in the jruby-program you give it an argument that is a ruby-object, then jruby will internally try to convert that ruby-object into a java-object, but if jruby cannot do the conversion automatically (because it does not have an automatic conversion defined for that specific pair of ruby-object>>java-object types) then you need to make the conversion manually in you jruby-program (because the java-method needs ''java-objects'' as arguments, it does not understand ruby-objects) and give an already-converted-java-object (instead of the unconverteable-ruby-object) as the argument to the java-method. On the other hand, for return-values its much simpler: if Jruby cannot convert the internal-java-object-return-value to a suitable ruby-object, then it will simply deliver the java-object to the jruby-program (which is just fine because jruby-programs understand java-objects along with ruby-objects).  




When Jruby calls a Java-method, it automatically:
* takes the '''arguments''' objects and analyses them: the ones that are [https://github.com/jruby/jruby/wiki/CallingJavaFromJRuby#ruby-to-java ruby-objects are converted automatically into java-objects]. So the Java-method will receive arguments that are all java-objects.
* Executes the java-method (with all arguments as java-objects) and creates a return value which is a java-object
* takes the '''return''' value that is a java-object, and [https://github.com/jruby/jruby/wiki/CallingJavaFromJRuby#java-to-ruby converts that java-object into a ruby-object if possible]. That converted-object-return-value (that may be a converted ruby-object or the original java-object) is the one that is put back into the jruby-program


The conversion exist in 2 directions: ruby->java and java->ruby. For the most used ruby-types and java-types the "conversions" are predefined and are '''automatic'''. For other ruby/java types the conversion should be made '''manually''' by the programmer (you)


The '''automatic''' conversions (made seamlessly by Jruby) between most used ruby-types and java-types, are:

[[Image:FreeplaneJrubyInstaller__160908_170934.png]]



Here are some '''manual''' conversions that '''you''' as programmer might have to use, for some ruby-types >> java-types, and ruby-types << java-types:
* '''java.util.List --> ruby-Array'''
    # java.util.List --> ruby-Array: use .to_a
    a_java_array_list = java.util.ArrayList.new([1,2,3])  # or Vector, LinkedList, Collection, ...
    a_ruby_array = a_java_array_list.to_a
    #=> [1, 2, 3]

* '''java.util.Map --> ruby-Hash'''
    # java.util.Map --> ruby-Hash: use .to_hash
    a_java_hash_map = java.util.HashMap.new(:a => 123) # or Hashtable
    a_ruby_hash = a_java_hash_map.to_hash
    #=> {:a = 123}

* '''ruby-Time --> java.util.Date'''
    # ruby-Time --> java.util.Date: use .to_java
    a_ruby_time = Time.now
    a_java_date = a_ruby_time.to_java
    #=> #<Java::JavaUtil::Date:0x747541f8>




Some examples of conversions:

    # NodeProxy.setNoteText() expects as argument a java.lang.String object
    # but we can give as argument a ruby-String, and Jruby will automatically convert the ruby-String into a java.lang.String
    # see http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.Node.html#setNoteText-java.lang.String-
    node.setNoteText("Hi Im a ruby-string")

    # NodeProxy.getNoteText() returns a java.lang.String object, which Jruby automatically converts
    # into a ruby-String
    # see http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.NodeRO.html#getNoteText--
    a_ruby_string = node.getNoteText()

    # NodeProxy.getChildren() returns a java.util.List<Proxy.Node>
    # Jruby cannot automatically convert a java.util.List, but you can convert it manually into a ruby-Array
    # see http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.NodeRO.html#getChildren--
    a_java_list = node.getChildren()
    a_ruby_array = a_java_list.to_a
    

    

This section was a long one. Just keep the idea that there are conversions going on with ruby/java and if/when you need to go into it, then this is here to help you. 





=== Joining the pieces together :) ===

So you first learned 


    
    
    



Jruby coding tips:

    # In Jruby to access a Java-class-field, use :: like this SomeJavaClass::SomeJavaField
    # Access FreeplaneVersion::XML_VERSION (see http://freeplane.sourceforge.net/doc/api/org/freeplane/core/util/FreeplaneVersion.html)
    the_java_class = Java::org.freeplane.core.util.FreeplaneVersion
    the_value_of_field = the_java_class::XML_VERSION

    # To call a java-class-constructor, just:
    a_java_instance = JavaClass.new()
    a_java_instance = JavaClass.new(x,y,z)
    

    # toggle folding of node branch
    node.folded = ! node.folded?     # same as:    node.setFolded( ! node.isFolded() )
    

    # Show message in new window
    ui.informationMessage("Hello World!")
    
    # Show message in status bar (bottom of freeplane) 
    c.statusInfo = "Hello World again!"

    # Description:
    #     Lambda that receives a target_node
    #     and returns an array of all ancestor nodes (including the root-node) 
    # Arguments: 
    #     target_node   - a Proxy.Node 
    # Returns:
    #     Array of nodes, where array[0] is root-node, and array[-1] is the target_node
    #    [root-node, ..., parent-of-parent-of-target_node, parent-of-target_node, target_node]
    # Usage:
    #    the_ancestry_of_node  = get_ancestry_array.call(node)
    #    the_ancestry_of_node.map {|n| n.text }
    #
    #    the_ancestry_of_nodeX = get_ancestry_array.call(nodeX)
    #    the_ancestry_of_nodeX.map {|n| n.text }
    #
    get_ancestry_array = lambda do |target_node| 
      ancestry = [target_node]
      ancestry.unshift(ancestry[0].parentNode) while ( not ancestry[0].root? )
      ancestry
    end
    
    the_ancestry_of_node  = get_ancestry_array.call(node)
    the_ancestry_of_node.map {|n| n.text }
    
    # Example:
    [[Image:FreeplaneJrubyInstaller__161001_230705.png]]


    # Convert a java.util.List --> ruby Array
    my_java_list = node.findAll
    my_ruby_array = my_java_list.to_a


    # Show the Java-class of an object
    node.java_class
    #=> class org.freeplane.plugin.script.proxy.NodeProxy

 




#call java field










==

TODO

Ideas:
 1: nodnode
 2: node
 3: node.text
 4: invokeAndWait { node.createChild("Hi im child")
 5: }
 6: invokeAndWait { node.createChild("Hi im another child") }
 7: invokeAndWait { node.text
 8: }
 9: node.text
10: invokeAndWait { node.text += "--> Added into the end of text <--" }
11: 3.times.do { |i| invokeAndWait { node.createChild("Hi im grandson #{i}") } }
12: 3.times.each { |i| invokeAndWait { node.createChild("Hi im grandson #{i}") } }
13: node.fold
14: node.folded?
15: node.folded = !node.folded?
16: node.folded = !node.folded?
17: invokeAndWait { node.folded = !node.folded? }
18: hist
19: hist --replay 3..12


NOTES:
After editing an existing script, you dont need to restart freeplane. That is, you can just edit the ruby script, save it, and then in freeplane rerun the script, without restarting freeplane!

invokeAndWait {}
* does not return a value from the block (always returns nil)
    [12] pry(main)> invokeAndWait { 1 }
    => nil
    [13] pry(main)> invokeAndWait { 5 }
    => nil
    [14] pry(main)> invokeAndWait { true }
    => nil
    [15] pry(main)> invokeAndWait { "invokeAndWait always returns nil, no matter what happens inside the block" }
    => nil
    [16] pry(main)> invokeAndWait { raise "Exceptions that happen inside the invokeAndWait block are discarded, but get registered into the freeplane log file" }
    => nil


* ruby exceptions that happen inside the block are not shown in the debug window, but they are registered in freeplane log file
    [5] pry(main)> invokeAndWait { node.thisMethodDoesNotExist }
    => nil
    
    [16] pry(main)> invokeAndWait { raise "Exceptions that happen inside the invokeAndWait block are discarded, but get registered into the freeplane log file" }
    => nil

    
    # exception is registered in freeplane logs: <freeplane_user_dir>/logs/log.0
    STDERR: Exception in thread "AWT-EventQueue-0" 
    STDERR: org.jruby.exceptions.RaiseException: (NoMethodError) undefined method `thisMethodDoesNotExist' for #<Java::OrgFreeplanePluginScriptProxy::NodeProxy:0xdbe721>
    STDERR: 	at RUBY.block in evaluate_ruby((pry):6)

    STDERR: Exception in thread "AWT-EventQueue-0" 
    STDERR: org.jruby.exceptions.RaiseException: (RuntimeError) Exceptions that happen inside the invokeAndWait block are discarded, but get registered into the freeplane log file
    STDERR: 	at RUBY.block in evaluate_ruby((pry):18)
    



There will be some examples, that you can try yourself in the RubyLiveDebugger  ('''Tools / Jruby / Ruby Live Debugger / Debug in EDT thread (GUI freezed)'''
Also, have the [http://freeplane.sourceforge.net/doc/api/org/freeplane/plugin/script/proxy/Proxy.Node.html Proxy.Node] webpage open nearby.




    


== FreeplaneJrubyInstaller Addon - The making of ==


If someday you want to go into the rabbit hole of how this addon was made, understanding the details about the addon plugin and how this all came together into freeplane, then read the [[FreeplaneJrubyInstaller_-_making_of|FreeplaneJrubyInstaller - making of]]. 

Its a cmopletely optional and big reading - if your starting with scripting, leave it for a latter day :)