search

tusharjoshi / netbeans-php-drupal

Netbeans Drupal Development Tool
Apache License 2.0
107 stars 14 forks source link

Announcement: nbddapigen is now available #39

Closed silkentrance closed 7 years ago

silkentrance commented 7 years ago

As a first release I present you nbddapigen, a simple api generator for NBDrupalDevel.

See https://github.com/coldrye-php/nbddapigen and https://github.com/coldrye-php/nbddapigen/releases.

For Linux there exist both deb and rpm packages. See the package source for more information on what is being installed and where.

On Windows you will have to install from the provided tar.gz release. If you have any suggestions/provable solutions on how to provide a package that can be installed on Windows, feel free to file an issue https://github.com/coldrye-php/nbddapigen/issues.

Please note that this is a WIP, yet it works as expected and will generate the API documentation just fine.

Perhaps this might also be a provable solution for #38.

silkentrance commented 7 years ago

@HollyIT how about this one. would that solve your problems of having to maintain the api docs/code templates manually?

I think that with this tool, people can start providing their own "pluggable" api docs/code templates and provide these for installation, e.g. in form of a jar/zip that would then be recognized by the NBDrupalDevel plugin and all available api docs/code templates would then be merged... or the users would simply extract the contents of these archives into their local api docs/code templates folder...

Having this, you would no longer be required to provide said api docs/code templates yourself.

silkentrance commented 7 years ago

@uberhacker if you need windows integration, file an issue against the aforementioned project and provide a PR https://github.com/coldrye-php/nbddapigen.

silkentrance commented 7 years ago

@tusharvjoshi I very much like to make this part of the NDDT and thus part of the Java part and not as a third party tool that you need to invoke on the command line.

However, current state of the PHP IDE integration is that most frameworks/APIs are considered internal and one may not access the AST builder directly in order to be able to implement such a tool.

Care for joining me in lobbying the team responsible for the PHP IDE integration part so that they rework their internal architecture and make useful APIs such as the AST and AST builder a public component?

See https://netbeans.org/bugzilla/show_bug.cgi?id=268539.

tusharjoshi commented 7 years ago

@silkentrance I will need some more time to go through your project and understand what it is and why it is needed, looks like an important part of php/drupal tools.

To start with I have voted for your issue in NetBeans bugzilla and added myself as CC to that issue so we can track that issue together.

I am with you for any enhancement requests needed from NetBeans side.

silkentrance commented 7 years ago

Since I have moved to jetbrains/phpstorm, I have no longer a need for that. Would you care to take over?

tusharjoshi commented 7 years ago

Sure @silkentrance as I have taken netbeans-php-drupal project, I would also help taking over your project. My progress may be slow for initial days but I will try to merge these projects eventually to make them one code base, as you have envisioned.

silkentrance commented 7 years ago

@tusharvjoshi I have just opened a transfer request for that project.