[dev] Announcement: Renaming of the AST classes. Concerns all extension and converter writers!

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

[dev] Announcement: Renaming of the AST classes. Concerns all extension and converter writers!

Robert.Panzer
Hi,

so we finally have a result for the class names of the AST data structures!
This is basically (left old, right new names):

AbstractNode                        ContentNode             
  +- AbstractBlock                   +- StructuralNode
  |   +- Block                       |   +- Block
  |   +- Section         =>          |   +- Section         
  |   +- Document  (Class)           |   +- Document (Interface)
  |   +- ListNode                    |   +- List
  |   +- ListItem                    |   +- ListItem
  |                                  |   +- Table
  +- Inline                          +- PhraseNode

I will merge the respective PR [1] over the weekend.
So in case you have written an extension based on snapshots of the asciidoctorj-1.6.0 branch, this will break your code!!!
You will have to align it to this renaming!!!
This is also the case if you use the 1.6.0-SNAPSHOT versions from oss.jfrog.org.

If you have written extensions for AsciidoctorJ 1.5.2 you are fine, but please be aware of the change once you want to upgrade to 1.6.0.

We're also planning to cut a first alpha release in the next few weeks, so you will also be able to enjoy the evolution of AsciidoctorJ via jcenter.

Best regards
Robert

[1] https://github.com/asciidoctor/asciidoctorj/pull/371
Reply | Threaded
Open this post in threaded view
|

Re: [dev] Announcement: Renaming of the AST classes. Concerns all extension and converter writers!

Robert.Panzer
Just merged it.

So if you have integrated a 1.6.0-SNAPSHOT version of asciidoctorj your code may be failing now.

Please rename the classes you use like this:

AbstractNode                        ContentNode             
  +- AbstractBlock                   +- StructuralNode
  |   +- Block                       |   +- Block
  |   +- Section         =>          |   +- Section         
  |   +- Document  (Class)           |   +- Document (Interface)
  |   +- ListNode                    |   +- List
  |   +- ListItem                    |   +- ListItem
  |                                  |   +- Table
  +- Inline                          +- PhraseNode