On 10/16/2011 07:59 PM, Scott Wilson wrote:
On 16 Oct 2011, at 15:13, Ate Douma wrote:
Hi Scott,
I looked at the download you provided and I have several comments and
questions, which is why I opened this separate DISCUSS thread to not pollute
the vote thread itself.
First of all, I assume the target for this artifact is the Maven central
repository, right?
For that purpose, I think we'll then need a 'proper' maven artifact build,
which means includes a maven project pom (dependency resolution, general
project and artifact meta-data), and preferably also a -sources.jar and
-javadoc.jar artifact for IDE support etc.
Maven based builds of course can produce such additional artifacts as a trivial
by-product, given a proper maven pom that is, but as Wookie currently is using
ivy (which I don't know nothing about) I don't know how such things are done
the ivy way.
I also noticed the binary jar has the sources embedded, which is kind of
unusual nowadays (I think). Not really wrong, but unexpected.
The LICENSE and NOTICE files are contained within the root of the jar while
these IMO should be provided under the META-INF/ folder.
I really think, as a minimum, a proper maven pom is required to even be able to
upload to the Maven repository, and such pom should provide proper dependency
resolutions. Can ivy 'generate' such a maven pom automatically?
If not, I really think the java connector module should be (also) build by
maven itself then, which also will make it much easier to 'stage' the artifact
first through repository.apache.org (Nexus) and after release automatically
'publish' it to Maven central. If you need to do this manually I have no idea
how that (nowadays) works.
OK, all this is now generated correctly using the new Ant/Ivy scripts in 0.9.1,
but it wasn't in place for 0.9.0, so we'd have to sort out all the artifacts,
pom etc manually.
An alternative is we just get a move on with the 0.9.1 release, including the
full server, and both the connector, and parser subprojects. As we only have a
few issues left to resolve it may actually be quicker....
If the 0.9.1 version is almost already, yes it might indeed be quicker...
I haven't been able to review this yet, but is the (ivy) build also/already able
to deploy a 0.9.1-SNAPSHOT connector to the Apache snapshot repository?
If so, I'd suggest doing that as it would immediately make it discoverable by
Rave (and for any Maven repository using project). It also makes it possible to
proper test the integration before the release!
Of course, adding a Wookie connector 0.9.1-SNAPSHOT dependency will make it a
'blocker' on getting Wookie 0.9.1-incubating released and available from the
official Maven Central repository before we can release Rave next
(0.5-incubating) which should be end of this month...
Ate
Ate Douma
As an side-note: I noticed the current wookie (main) download page only
provides the links to the binary distributions. I was kind of surprised by
that, until I found out that the sources download is provided on a separate
page. Not sure how this is viewed by others, but the common (ASF) practice is
to promote the source distributions as the primary artifacts and typically the
sources and optionally also the binary downloads are provided from the main
download page.
On 10/15/2011 02:17 PM, Scott Wilson wrote:
In order to integrate Wookie and Rave we need a published non-snapshot version
of the Java Connector framework.
While we do have the 0.9.1 release coming soon, it would be good to publish the
0.9.0 version of the connector to the repository given the full 0.9.0 release
is already available, just so we can get Wookie-Rave integration into the next
Rave release.
The scope of the release is the following artifact:
http://people.apache.org/~scottbw/wookie-connector/
[ ] +1 approve
[ ] +0 no opinion
[ ] -1 disapprove
S