Add new refactor command for emr-c

[tuhdo]

New command: emr-c:semantic-insert-function-prototype-or-implementation.

What it does: Insert function implementation/prototype into other file (file with the same name but different extension) from anywhere in your project. It was originated from this StackExchange question.

• If there's only one other file, the command inserts immediately into that file. Here is a demo (begins when START DEMO at the bottom):

In the beginning, test.h is empty. I ran the command in test.c, and it switches to test.h and insert immediately, since the file was empty. After the first function interface is inserted, when running the command on the second interface in test.c switched to test.h and prompt for a place to insert. I selected the first function inserted previously, and as a result, the second signature is inserted after it.

• If more than one, you are prompted to select a file. Demo:

• If there's none, you are prompted for the entire files in your project. After you select a file, a prompt offers a list of Semantic tags in the buffer.
• Insert prototype from .cpp to .h:

As you see, you can insert based on a position of a tag. Note that when point was in .cpp file, it is inside the function body; you do not have to move point to function name to do this. When the file .h was switched, the command offered a list of Semantic tags for selecting one, and insert after it. If a tag is a child of another tag, it will be appended with prefix (<parent tag name>).

• Similarly, insert implementation body from .h to .cpp. Notice that the pair {} is opened and indented nicely, create a body to write code immeidately:

TODO:

• Create an emr-menu for the command and future refactor commands.
• Make it behave smarter: if the tag at point is a function parameter, do not offer for inserting function prototype/implementation.
• Query all Semantic tags in current header file, filter and insert empty function definitions in corresponding source file.

[tuhdo]

TODO:

• Create an emr-menu for the command and future refactor commands, similar to this menu for Emacs Lisp.
• [IN PROGRESS] If user wants to insert a function prototype, but as a parameter of some function, that function prototype should be transformed into a function pointer.
• Make it behave smarter: if the tag at point is a function parameter, do not offer for inserting function prototype/implementation.
• Query all Semantic tags in current header file, filter and insert empty function definitions in corresponding source file.
• Extract function from selected lines of code.
• Extract constant.
• Extract interface: collect all function signatures and put it into a class. Since we can already do this for any function, it is easy.
• Base class generation.
• Getter/setter generation.
• Add proper Helm commands to provide a better interface: running helm-execute-persisten-action on a Semantic tag, by pressing TAB (or C-z, the default) should jump to that tag for previewing, and provide an action menu for listing positions to insert (i.e. currently it inserts after a selected tag, by default; we could insert before that tag, or on the same line). With Helm, it's possible to generate two or more classes into two or more different files with a single command.

[tuhdo]

I think I will create a new package of out this.

[chrisbarrett]

The package-private prefix should be emr-c: for consistency with the rest of the codebase, so this would be emr-c:semantic-tag-list. Same for the rest.

A double-dash prefix would be better for all of emr, but that's a topic for another changeset. :)

[chrisbarrett]

Very cool. Please update the identifiers as noted, then let me know when you've pushed all your commits on this feature and I'll merge. :)

[chrisbarrett]

Oh, I see you closed it. Hadn't refreshed. :P Let me know if you want to proceed.

[tuhdo]

That's fine by me. I think leaving it in here would be better for everyone. Please open it again.

[tuhdo]

This is a good reference list for future features: http://refactoring.com/catalog/

[tuhdo]

I created a package out of this: https://github.com/tuhdo/semantic-refactor

I think it's better this way since EMR has many dependencies and not all people want. The package can also be better maintained, since I take an active role over the package.

I'm sorry about this. Maybe I can integrate my package into yours at some point, as a dependency, is that ok?

[chrisbarrett]

No worries. Your package looks awesome. :D