Stream: tooling
Topic: PlantUML in Maven
Jose Costa Teixeira (Apr 11 2019 at 08:03):
Pulling in @Marc Robberecht on the topic:
The developer of PlantUML has their stuff under an Apache or MIT license (i.e. something other than GPL) here (http://plantuml.com/download) but we also need them to expose it as Maven so we can reference it in the build. The PlantUML team don't know how to do that. Is that something someone can coach PlantUML or just do it for them? (Discussion here: http://forum.plantuml.net/7628/hosting-apache-or-mit-licensed-code-in-maven?show=7628#q7628)
Patrick Werner (May 31 2019 at 17:26):
Here is the official documentation on howto release jars on maven central: https://maven.apache.org/repository/guide-central-repository-upload.html
Patrick Werner (May 31 2019 at 17:28):
quite straight forward. If you/they need additional help i‘ll be happy to help.
Jose Costa Teixeira (Jun 03 2019 at 08:31):
Hi @Patrick Werner yep, I need more help. I tried to make a POM but I do not know if I did that correctly. If you have some availability, could you try to do it? Or provide some steps for dummies? I am really out of my depth with the Java ecosystem.
Jose Costa Teixeira (Jun 03 2019 at 08:33):
for ASL, the source is : http://sourceforge.net/projects/plantuml/files/plantuml-asl-1.2019.6.tar.gz/download , the JAR is http://sourceforge.net/projects/plantuml/files/plantuml-jar-asl-1.2019.6.zip/download
Jose Costa Teixeira (Jun 03 2019 at 08:34):
for MIT, source http://sourceforge.net/projects/plantuml/files/plantuml-mit-1.2019.6.tar.gz/download and jar http://sourceforge.net/projects/plantuml/files/plantuml-jar-mit-1.2019.6.zip/download
Jose Costa Teixeira (Jun 03 2019 at 08:34):
either one of those should be ok
Jose Costa Teixeira (Jun 03 2019 at 08:38):
in the POM, i actually only changed the license, but i got confused because the code location points to here svn://svn.code.sf.net/p/plantuml/code/tags/plantuml-1.2019.6 and there is no reference to the license
Jose Costa Teixeira (Jun 03 2019 at 08:38):
the author said that parts of the code are different between GPL and ASL/MIT license, and i could not find any code tagged ASL / MIT
Patrick Werner (Jun 03 2019 at 08:56):
i'll have a look later and do a PR
Jose Costa Teixeira (Jun 03 2019 at 09:13):
thanks
Patrick Werner (Jun 06 2019 at 07:57):
so i had a look. It is about the plantuml jar, the binary to start the app? To publish that i would suggest using a CI build (Travis) and publish releases to the release section of github. If it is about using plantuml as a dependency in another project, maven would be the way to go.
Jose Costa Teixeira (Jun 06 2019 at 08:12):
we want it as a dependency in the FHIR build / IG build, to render the diagrams for the spec or IG.
Patrick Werner (Jun 06 2019 at 08:50):
ok, then i'll go for the maven repo
Jose Costa Teixeira (Jun 06 2019 at 08:52):
danke!
Jose Costa Teixeira (Jun 14 2019 at 18:21):
Hi @Patrick Werner did you get a chance to look at this?
Jose Costa Teixeira (Jul 01 2019 at 19:43):
is this what we needed?
https://mvnrepository.com/artifact/com.credibledoc/plantuml-parent
Patrick Werner (Jul 04 2019 at 14:38):
sorry totally lost track of this topic. Yeah it seems that PlantUML is already on maven central. I think you are looking for this instead of parent:
https://mvnrepository.com/artifact/com.credibledoc/plantuml-core
Patrick Werner (Jul 04 2019 at 14:38):
@Jose Costa Teixeira
Jose Costa Teixeira (Jul 04 2019 at 15:03):
Thanks
Jose Costa Teixeira (Jul 16 2019 at 18:52):
@Lloyd McKenzie now that (it seems) plantuml is available, anything we should do to get it into the build?
Jose Costa Teixeira (Jul 16 2019 at 18:53):
I can document the process for the ExampleScenario. it requires a few steps
Lloyd McKenzie (Jul 16 2019 at 19:00):
Probably best to coordinate w/ @Grahame Grieve once he gets back
Jose Costa Teixeira (Jul 16 2019 at 19:12):
ok
btw, I noted that ExampleScenario.process.step.operation.response is 0..1
Jose Costa Teixeira (Jul 16 2019 at 19:13):
I think it should be 0..*
Jose Costa Teixeira (Jul 16 2019 at 19:13):
in FHIR over REST, perhaps we only have one object returned. but I can imagine that a response can consist of more objects without them being necessarily bundled (if not in REST)
Lloyd McKenzie (Jul 16 2019 at 19:25):
How?
Jose Costa Teixeira (Jul 16 2019 at 19:26):
i am thinking if we use this for non-FHIR stuff
Jose Costa Teixeira (Jul 16 2019 at 19:26):
or not on REST.
Lloyd McKenzie (Jul 16 2019 at 19:26):
ExampleScenario is intended for use with FHIR. If someone wants to use it for non-FHIR, they can make an extension. For FHIR non-REST, there would still only be one response
Jose Costa Teixeira (Jul 16 2019 at 19:27):
we had discussed that we should be able to support other stuff. For example, using this for FHIR and v2 messages, or FHIR and GS1 messages, or...
Jose Costa Teixeira (Jul 16 2019 at 19:45):
i create a GF for discussing in a call sometime
Lloyd McKenzie (Jul 16 2019 at 19:49):
v2 only have single responses. As do v3.
Jose Costa Teixeira (Jul 16 2019 at 19:51):
Jose Costa Teixeira (Jul 16 2019 at 19:52):
22855 is to extend binding of instance.resourceType to extensible
Jose Costa Teixeira (Jul 16 2019 at 19:54):
that's two small steps for man...
Jose Costa Teixeira (Jul 16 2019 at 19:54):
i will produce a decent example by next call.
Jose Costa Teixeira (Jul 16 2019 at 20:05):
my indecent example is this: Using an ExampleScenario to document how to render the ExampleScenario
pasted image
Jose Costa Teixeira (Jul 29 2019 at 19:57):
@Grahame Grieve can this be used in our build?
https://mvnrepository.com/artifact/com.credibledoc/plantuml-core/1.0.10
The usage is something like
java -jar plantuml.jar source.txt [options]
and it creates a file e.g. source.svg
Grahame Grieve (Jul 29 2019 at 20:45):
technically, yes.
Jose Costa Teixeira (Aug 05 2019 at 11:10):
@Lloyd McKenzie how do we go at this? Topic for Atlanta? Or is there any call for these matters?
Lloyd McKenzie (Aug 05 2019 at 14:32):
Is this just for rendering ExampleScenario or are we looking at it for other things too?
Jose Costa Teixeira (Aug 05 2019 at 14:46):
I would use it for exampleScenario, also PlanDefinition (at least for "workflow conformance").
Jose Costa Teixeira (Aug 05 2019 at 14:47):
Not sure if it would be interesting to use for other UML visualtizations (can only think of class diagrams for our Patterns)
Grahame Grieve (Aug 05 2019 at 21:25):
I'd very much like to stick to the existing code for class diagrams
Jose Costa Teixeira (Aug 06 2019 at 17:34):
if the current SVG generation works, agree.
No other uses beyond sequence diagrams.
Jose Costa Teixeira (Aug 06 2019 at 17:34):
TestScript also has a sequence of activities but I can't see the big advantage of a rendering for that.
Jose Costa Teixeira (Oct 14 2019 at 21:22):
Ok finally we have plantUML with a MIT license
https://github.com/plantuml/plantuml-mit
Jose Costa Teixeira (Oct 14 2019 at 21:23):
is anyone experienced with making things available in maven?
I was pointed to this article explaining it, but I just can't follow this https://dzone.com/articles/publish-your-artifacts-to-maven-central
Grahame Grieve (Oct 15 2019 at 10:38):
@James Agnew I believe that our choices are that someone puts it in maven, or we clone the code? other choices?
Jose Costa Teixeira (Nov 05 2019 at 18:14):
Pinging @James Agnew for when he's back.
James Agnew (Nov 07 2019 at 10:35):
@Jose Costa Teixeira Back now!
Have you been communicating with the author of this library? Do we have any sense of his/her wishes?
Obviously just cloning the code into the publisher's repo would be easiest, and given that there is now an MIT licensed version of it there is nothing stopping us from doing so. If the author intends to continue to develop the library though, that is sort of a disrespectful move so I'd rather help them get this into Maven if they feel up to it.
Jose Costa Teixeira (Nov 07 2019 at 17:53):
@James Agnew he actually appreciates help in setting it up to maven.
Last updated: Apr 12 2022 at 19:14 UTC
