Notepad++ SU8 Ruby API Autocomplete

Dan Rathbun · 3 Feb 2011, 17:04

here it is, ...

Looks like there are 85 of them on the Mac (thanks John.)

...I'm running these through Ruby Console, so aren't they shielded from external globals?

HELL NO. The Ruby Console runs WITHIN Object, anything you define there becomes global. That's why it's dangerous to define methods in the console.. they get inherited by ALL objects.

Dan Rathbun · 3 Feb 2011, 17:05

BUT if running one of the WebConsoles ... you might be within the coder's namespace instead of Object.

Dan Rathbun · 3 Feb 2011, 17:30

@driven said:

Is the a 1.8.6 module that simply didn't exist at all in 1.8.5 that I could test for?

Well I'm purty sure module DanZoid did not exist in Ruby 1.8.5... or any version. (snicker)

Offhand I dont know of one such module (mostly the changes have been adding or removing methods and constants, and fixing bugs.)

I don't really have a good 1.8.5 reference... just all those numerous YAML documents in share\ri\1.8\system and I don't have time to learn how to use rdoc to generate a HTML help page right now.

If you want to know what happens when a non-existant module (or class,) is referenced in Ruby, the answer is that a NameError exception is raised.

Try it at the console...
puts DrivenUpTheWall.methods
~

driven · 3 Feb 2011, 18:47

@dan rathbun said:

Here's the 1.8.6 constant list AND class methods for the Marshal module:

As an experiment, in parameters, I used:
"~" to denote "this class or subclass"
"^" to denote "implictly convertable to" (which would include the class and any subclasses.)

for ex: ^Integer would mean: " Integer class, subclass, or object that implements a to_i() method."

Hi Dan,
What I was trying to say is I don't know the method you used to get the additional information about this Constant.
I tried a couple of things to add it to the other code snippet, but I have had no luck (which is what's required for me).

I realise if a method doesn't exist it throws an error, so what I'm looking for is a method that didn't exist in 1.8.5 (which SkechUp says its using on Macs), if this newer Ruby/Class/Constant, etc.., is present then SU must be referencing or have access to other installed versions.

There's a native coca utility http://chmox.sourceforge.net/ for reading CHM on OSX, forgot I had, so now I'll have a look.

The other thing I'm always looking for is what makes WebDialog different on the Mac, so probing SU through the ruby console appeals to me.

Not to mention that autocomplete on a Mac editor would be a good thing...

john

thomthom · 3 Feb 2011, 19:08

@driven said:

Not to mention that autocomplete on a Mac editor would be a good thing...

I use TextMate, would be nice to get an autocomplete for that. If that's even possible...

Dan Rathbun · 3 Feb 2011, 19:41

@driven said:

@dan rathbun said:

Here's the 1.8.6 constant list AND class methods for the Marshal module:

What I was trying to say is I don't know the method you used to get the additional information about this Constant.

If you mean the text that is in the XML descr attributes.. that I just copy and pasted manually out of the Ruby Core Reference Help CHM. Then edited it a bit to make it more readable, more concise, etc. (Sometimes those Japanese guys who work on the Ruby Core don't write the best English.)

Of course... doing that manually for all of the methods in Ruby and the Sketchup API is a lifetime project.

I'm looking at seeing if I can script it.. at least grabbing the text that can be edited and cut-down later. (Notepad++ has a memory limit to the text for each function.)

@@ThomThom - That BitBucket website just about locks up MSIE 7. But I stopped posting new constant lists, as I realized that it is better the write a plugin that generates the XML files, so I've been working on that. Also need to write a database utility, or maybe a webform so the functions and overloads can be added, edited, etc. more easily by multiple people.

driven · 3 Feb 2011, 20:08

@thomthom said:

I use TextMate, would be nice to get an autocomplete for that. If that's even possible...

I'll try this with TextWrangler, and let you know how it pans out http://c-command.com/bbautocomplete/

john

thomthom · 3 Feb 2011, 20:13

@dan rathbun said:

@@ThomThom - That BitBucket website just about locks up MSIE 7

hm... No problems in IE8 here. (Don't have IE7 any more on any of my machines.)

unclex · 9 Feb 2011, 03:28

Wonderful!!!!!!

Jim · 2 Jun 2012, 20:56

This seems sort on hard to maintain as a .xml file. Would it be easier to manage as in a different format that could be translated into the .xml?

Maybe a spreadsheet?
(A read-only version of the actual Spreadsheet)

Edit - see next post.

Jim · 3 Jun 2012, 15:52

Here's a Ruby script that creates the Ruby.xml auto-complete file directly from the online spreadsheet.

Use:
prompt$ ruby gss2nppxml.rb (Google Spreadsheet 2 Notepad Plus Plus XML)

requires 'nokogiri' ( gem install nokogiri)

The file Ruby.xml will be created in the same folder. Move/Copy this file to the Notepad++ plugins/API folder and restart Notepad++.

n++ auto-complete documentation.

The spreadsheet is publically editable by anyone with the link (see attachment,) so anyone can easily contribute by adding return values and function paramter hints to the sheets.

link.txt

gss2nppxml.rb

thomthom · 3 Jun 2012, 20:43

Oooh, what have you done here Jim? Looks interesting. I haven't checked out the spreadcheet you generated, but does it include argument name hints?
Do you have a pre-compiled XML file?

Dan Rathbun · 3 Jun 2012, 20:55

So the spreadsheet is is used as a dB. I had done this in the past when outputting HTML API docs for eigenMath, which I eventually compiled into a CHM using the free MS HTML Help Workshop.

I had proposed something along this line for the Ruby API docs, but input forms would be a great benefit. Fortunately.. Excel and it's OpenSource clones can have worksheets that are dB input forms (or the suite's dB engine Access or OpenBase, can be used to create an updating applet with forms.)

Jim · 3 Jun 2012, 21:18

@thomthom said:

does it include argument name hints?

Yes. If you look at the spreadsheet, overloads are handled using a period (.) You can have any number of overloads and parameters.

@thomthom said:

Do you have a pre-compiled XML file?

Ruby.xml.txt

NP++ Seems to get confused, though. See how NP++ uses the hints from add for add_3d_text. I can't see anything wrong in the XML according to the docs.

Anton_S · 4 Jun 2012, 05:25

Is there a way for np++ automatically to add/remove your own module, class, and method names into/from the auto-complition list?

What I mean:
Lets say I write some class in NP++, naming it 'Anton'.
On the next line I start with letter A and the auto-completion-list should show-up displaying all index with A including my name.
Then I erase my class and on next line start with word A again. Now, the index list should no longer have 'Anton' in the index.

Sorry, that's kind of awkward put together, though I hope ya could understand what I mean.

thomthom · 4 Jun 2012, 07:41

Not that I'm aware of - but it would be really nice. It's something that an IDE does though - and Notepadd++ is more of a text editor than an IDE. But they do have a plugin system - maybe there is something there.... ?

Dan Rathbun · 4 Jun 2012, 09:49

@anton_s said:

Is there a way for np++ automatically to add/remove your own module, class, and method names into/from the auto-complition list?

What I was really wishing for... was to be able to load multiple API overlay files.

One for Core Ruby. Then if You wanted to work on a Rails project, you could load a Rails API overlay list.

For a Sketchup example, the Core Ruby API would always load. Then of course we'd need the basic Sketchup API. If we also needed the TT_Lib API, and the WxSU APIs, we could load them also.

NP++ has session files that keep track of all open files in a project, their window sizes, the language they use, where the cursor is, what is hilighted, etc. So keeping an API file list for each file would not be "out of this world."

For a Js example, you could set a Core Js, and overlay say, the JQuery API on top of it.

And it would also be nice to have a "bread-crumb" API bar that would list the loaded APIs for the active file.
There is alot of room on the left side of the statusbar (just after it displays the file language, and before the file length.)

thomthom · 4 Jun 2012, 10:14

[off:yn4rf05y]And a list of methods in file...[/off:yn4rf05y]

Jim · 4 Jun 2012, 23:32

Time to find a new editor.

thomthom · 5 Jun 2012, 08:47

@jim said:

Time to find a new editor.

Got any good alternatives?

On OSX there is TextMate, but Windows...?