> > 1. There typing will likely change soon given the work in "Gremlin > Traversal Machine and Language." >
I don't see why that's a problem really - the table is dynamically driven. If we refactor, it's really not that big a deal to change. > 2. We don't have a DSL path yet. > we haven't discussed all the goals of 3.1.0 but the approach to DSLs should be part of that release - so in that sense it doesn't seem premature to me to have this feature in that branch. > Finally, I don't know what use this would have as a "runtime call." If > someone is developing a traversal language using the "instruction set" of > Gremlin, they will most likely be in JavaDoc-land, not in > describeSteps()-land. ?? > Having it as a utility allows us to generate it into the docs in real-time (not as some static data we have to manage manually). I also believe that a table is helpful from both a development and QA perspective. javadoc doesn't make it as easy to see in once place what all the relationships are among the steps. Finally, there will be steps outside of those maintained by TinkerPop and since this utility operates by doing a scan of the classpath for Step implementations, it will capture those on the classpath of the console as well and work them into the table. On Tue, Aug 18, 2015 at 3:06 PM, Marko Rodriguez <[email protected]> wrote: > Hi Stephen, > > I wouldn't add this just yet. I would not promote "normal users" working > with Steps directly as: > > 1. There typing will likely change soon given the work in "Gremlin > Traversal Machine and Language." > 2. We don't have a DSL path yet. > 3. The interface API will most likely change as well. > > Finally, I don't know what use this would have as a "runtime call." If > someone is developing a traversal language using the "instruction set" of > Gremlin, they will most likely be in JavaDoc-land, not in > describeSteps()-land. ?? > > Perhaps, for now, you can pull this into a feature branch. > > Thanks, > Marko. > > http://markorodriguez.com > > On Aug 18, 2015, at 10:32 AM, Stephen Mallette <[email protected]> > wrote: > > I just wanted to quickly mention a minor new feature that will be > available in 3.1.0. It is an addition to the utilities plugin and is > basically a function called describeSteps(). When it is called from the > Gremlin Console it will scan the classpath for all non-abstract Step > implementations and print them in a table to display which important base > classes and marker interfaces they extend/implement. This kind of > information will be useful to those developing core API/TraversalStrategy > implementations. You can see its usage in this gist: > > https://gist.github.com/spmallette/e12aebc8a747623059c4 > > -- > You received this message because you are subscribed to the Google Groups > "Gremlin-users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/gremlin-users/CAA-H43-pxcn9SFhjLiRu7y7yWcjF7hZkkJeb%3DAfVJJBjZ5CHEw%40mail.gmail.com > <https://groups.google.com/d/msgid/gremlin-users/CAA-H43-pxcn9SFhjLiRu7y7yWcjF7hZkkJeb%3DAfVJJBjZ5CHEw%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > For more options, visit https://groups.google.com/d/optout. > > > -- > You received this message because you are subscribed to the Google Groups > "Gremlin-users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/gremlin-users/BA0F5FFE-239B-43DB-B3FE-A4C811D7572C%40gmail.com > <https://groups.google.com/d/msgid/gremlin-users/BA0F5FFE-239B-43DB-B3FE-A4C811D7572C%40gmail.com?utm_medium=email&utm_source=footer> > . > For more options, visit https://groups.google.com/d/optout. >
