You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tuscany.apache.org by ant elder <an...@gmail.com> on 2009/04/22 17:02:32 UTC
[VOTE] Release Tuscany Zip Plugin alpha1
Please review and vote on releasing the alpha1 release of the Tuscany
Zip plugin module.
The zip plugin enables using a packaging of zip in a Maven project
pom.xml to create a zip format SCA contribution.
The tag for the release is:
https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
the Maven staging repository is:
http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
Thanks in advance for the votes,
...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Raymond Feng <en...@gmail.com>.
I'm in the same situation too. Can you use the following example to explain
what the zip plugin does?
Say, I have developed an SCA composite application: distributed calculator.
The application is packaged as two jars:
* The calculator
* The operations
Is the zip plugin there to zip two jars into a zip file as an SCA
contribution? What would the configuration for the plugin look like? Knowing
the input and output for the plugin will give me enough information to test
and vote.
Thanks,
Raymond
--------------------------------------------------
From: "Mike Edwards" <mi...@gmail.com>
Sent: Monday, April 27, 2009 6:53 AM
To: <de...@tuscany.apache.org>
Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
> Ant,
>
> I'd prefer to see a bit more user documentation first.
>
> I'm unclear as to what exactly it does and how to run it properly.
> That's why I'm not voting for it. (note that I have not voted against
> it either...)
>
> Yours, Mike.
>
> ant elder wrote:
>> Still looking for one more vote on this, anyone?
>>
>> ...ant
>>
>> On Sat, Apr 25, 2009 at 8:28 AM, ant elder <an...@apache.org> wrote:
>>> There is a snippet of what a pom.xml using this looks like in the
>>> README,
>>> and i've just added a bit more text about what it does to the trunk
>>> README
>>> at
>>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/trunk/maven-zip-plugin/README
>>>
>>> You could see a complete pom.xml by running the archetype as described
>>> in
>>> the previous email on this thread, or, in svn in the archetype module
>>> there's the resource it uses to create the pom.xm at
>>> https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml
>>>
>>> ...ant
>>>
>>>
>>> On Fri, Apr 24, 2009 at 11:57 PM, Raymond Feng <en...@gmail.com>
>>> wrote:
>>>> Can you give us an example pom.xml that uses the plugin and briefly
>>>> describe the usage?
>>>>
>>>> Thanks,
>>>> Raymond
>>>> From: ant elder
>>>> Sent: Friday, April 24, 2009 5:24 AM
>>>> To: dev@tuscany.apache.org
>>>> Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
>>>>
>>>>
>>>> On Fri, Apr 24, 2009 at 1:11 PM, Mike Edwards
>>>> <mi...@gmail.com> wrote:
>>>>> ant elder wrote:
>>>>>> Please review and vote on releasing the alpha1 release of the Tuscany
>>>>>> Zip plugin module.
>>>>>>
>>>>>> The zip plugin enables using a packaging of zip in a Maven project
>>>>>> pom.xml to create a zip format SCA contribution.
>>>>>>
>>>>>> The tag for the release is:
>>>>>>
>>>>>>
>>>>>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>>>>>>
>>>>>> the Maven staging repository is:
>>>>>> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
>>>>>>
>>>>>> Thanks in advance for the votes,
>>>>>>
>>>>>> ...ant
>>>>>>
>>>>> Ant,
>>>>>
>>>>> Is there any user documentation on how to use this? I don't mean
>>>>> developer
>>>>> documentation of how to build it.
>>>>>
>>>>>
>>>>> Yours, Mike.
>>>>>
>>>> Not so much yet, its an alpha1 release ;) There's a little at the top
>>>> of
>>>> the README:
>>>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//README
>>>>
>>>> and there's an archetype that will create an example using it, thats
>>>> not
>>>> been released yet but if you've done a full 2.x build you'll have it
>>>> locally
>>>> so in an empty folder run:
>>>>
>>>> mvn archetype:generate
>>>>
>>>> enter the option for "tuscany-contribution-zip" which is 5 for me, then
>>>> enter "somegroup" and "sometest", hit enter 3 times to take the next
>>>> defaults. That will create a folder named sometest containing a project
>>>> that
>>>> creates a helloworld sca zip contribution, you can run that by changing
>>>> into
>>>> the sometest folder and entering "mvn tuscany:run" and you should see
>>>> tuscany start up and output "hello world"
>>>>
>>>> Let me know is that does/doesn't work no one other than me has ever
>>>> tried
>>>> it as far as i know.
>>>>
>>>> ...ant
>>>>
>>>>
>>>>
>>>>
>>>>
>>>>
>>>>
>>>
>>
>
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@gmail.com>.
On Tue, Apr 28, 2009 at 9:18 AM, Mike Edwards
<mi...@gmail.com> wrote:
> Mike Edwards wrote:
>>
>> Ant,
>>
>> I'd prefer to see a bit more user documentation first.
>>
>> I'm unclear as to what exactly it does and how to run it properly.
>> That's why I'm not voting for it. (note that I have not voted against
>> it either...)
>>
>> Yours, Mike.
>>
> First, I'd like to make it clear that I'm NOT picking on this release - but
> I am keen to see more and better end user documentation for everything we
> have in Tuscany. So expect me to be more picky with any release of
> anything.
>
> As a first step for THIS release, here is a suggested improvement to the
> documentation which I hope will make it clearer to users what it is for and
> how it is used.
>
>
> Yours, Mike.
>
>
> User Documentation
> __________________
>
> This module is a Maven plugin which supports the creation of a zip format
> SCA contribution from
> the contents of a Maven project. An SCA contribution can be deployed to the
> Tuscany SCA runtime
> and run as an application.
>
> One of the main uses for an SCA zip contribution is that the SCA zip
> contribution can contain
> Java jar files within the zip and those jar files are available to the Java
> classloader of the
> contribution. This enables the packaging of application Java classes along
> with any other Jar files
> which they depend on in one contribution file. As a result the single zip
> file can hold everything
> that's needed for the SCA application other than the Tuscany runtime itself
> - in one neat package.
>
> The zip Maven plugin is used by adding a section into <build/> portion of
> the pom.xml of the Maven
> project which relates to the maven zip plugin. It is also necessary for the
> packaging of the output
> of the project to be declared as "zip". Then run Maven in the project.
>
> This zip plugin builds the output of the project as an SCA zip archive and
> it includes any
> jar files from dependencies declared by the project, where those dependency
> jar files are placed
> into the zip archive in a folder with the name "lib".
>
>
> An outline of a pom.xml including the zip plugin statements:
>
> ...
> <!-- output packaging format is "zip" -->
> <packaging>zip</packaging>
> ...
> <build>
> ...
> <!-- section referencing the Tuscany zip plugin -->
> <plugins>
> ...
> <plugin>
> <groupId>org.apache.tuscany.maven.plugins</groupId>
> <artifactId>maven-zip-plugin</artifactId>
> <extensions>true</extensions>
> </plugin>
> ...
> </plugins>
> </build>
>
>
> Here is an example pom.xml containing the Tuscany zip plugin material:
>
> <?xml version="1.0" encoding="UTF-8"?>
> <project xmlns="http://maven.apache.org/POM/4.0.0"
> xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
> http://maven.apache.org/maven-v4_0_0.xsd">
>
> <modelVersion>4.0.0</modelVersion>
>
> <parent>
> <artifactId>tuscany-sca</artifactId>
> <groupId>org.apache.tuscany.sca</groupId>
> <version>2.0-SNAPSHOT</version>
> </parent>
> <groupId>org.inglenook.test1</groupId>
> <artifactId>mikestest</artifactId>
> <packaging>zip</packaging>
> <version>1.0-SNAPSHOT</version>
> <name>quickstart</name>
>
> <dependencies>
> <!-- TUSCANY DEPENDENCIES -->
> <dependency>
> <groupId>org.apache.tuscany.sca</groupId>
> <artifactId>tuscany-sca-api</artifactId>
> <version>${tuscany.version}</version>
> <scope>provided</scope>
> </dependency>
>
> <!-- AN EXAMPLE APPLICATION DEPENDENCY TO BE INCLUDED IN ZIP -->
> <dependency>
> <groupId>commons-io</groupId>
> <artifactId>commons-io</artifactId>
> <version>1.4</version>
> </dependency>
>
> <!-- JUNIT DEPENDENCY FOR TESTING -->
> <dependency>
> <groupId>junit</groupId>
> <artifactId>junit</artifactId>
> <version>3.8.2</version>
> <scope>test</scope>
> </dependency>
>
> </dependencies>
> <build>
> <defaultGoal>install</defaultGoal>
> <finalName>${artifactId}</finalName>
> <resources>
> <resource>
> <directory>src/main/resources</directory>
> </resource>
> <resource>
> <directory>src/main/java</directory>
> <includes>
> <include>**</include>
> </includes>
> <excludes>
> <exclude>**/*.java</exclude>
> </excludes>
> </resource>
> </resources>
> <testResources>
> <testResource>
> <directory>src/test/java</directory>
> <includes>
> <include>**</include>
> </includes>
> <excludes>
> <exclude>**/*.java</exclude>
> </excludes>
> </testResource>
> </testResources>
> <plugins>
> <plugin>
> <inherited>true</inherited>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-compiler-plugin</artifactId>
> <configuration>
> <source>1.5</source>
> <target>1.5</target>
> <optimise>true</optimise>
> <debug>true</debug>
> </configuration>
> </plugin>
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-eclipse-plugin</artifactId>
> <configuration>
> <downloadSources>true</downloadSources>
> </configuration>
> </plugin>
> <plugin>
> <groupId>org.apache.tuscany.maven.plugins</groupId>
> <artifactId>maven-zip-plugin</artifactId>
> <extensions>true</extensions>
> </plugin>
> <plugin>
> <groupId>org.apache.tuscany.maven.plugins</groupId>
> <artifactId>maven-tuscany-plugin</artifactId>
> </plugin>
> </plugins>
> </build>
> <properties>
> <tuscany.version>2.0-SNAPSHOT</tuscany.version>
> </properties>
> </project>
>
>
> TODOs:
> - make the "lib/" folder where the dependent jars go configurable
> - make which dependencies get included configurable
> (currently its those with compile or runtime scope)
>
Thanks for the great doc update Mike, I've added that to SVN and re
done the release to include the update, see the new vote thread -
http://mail-archives.apache.org/mod_mbox/tuscany-dev/200904.mbox/%3C71e1b5740904280141j3c60d2f4gb3f1085d58fb9f0e@mail.gmail.com%3E
...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Raymond Feng <en...@gmail.com>.
I have integrated the changes under r770316, including the update to the zip
archetype.
Thanks,
Raymond
--------------------------------------------------
From: "ant elder" <an...@apache.org>
Sent: Thursday, April 30, 2009 12:17 AM
To: <de...@tuscany.apache.org>
Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
> Brilliant. This does most of what we need so lets go with that
> approach. Looks like you've already done the code so would you like to
> commit that and I can update the zip archetype to use the new module?
>
> ...ant
>
> On Wed, Apr 29, 2009 at 4:44 PM, Raymond Feng <en...@gmail.com> wrote:
>> The predefined jar-with-dependencies descriptor has a few issues:
>>
>> 1) It produces a jar
>> 2) It unpacks dependencies (instead of lib/???.jar)
>>
>> The shared descriptor approach seems to be satisfying the need without
>> packaging the descriptor in the generated project:
>>
>> <plugin>
>> <artifactId>maven-assembly-plugin</artifactId>
>> <version>2.2-beta-3</version>
>> <dependencies>
>> <dependency>
>> <groupId>org.apache.tuscany.sca</groupId>
>> <artifactId>zip-contribution-descriptor</artifactId>
>> <version>2.0-SNAPSHOT</version>
>> </dependency>
>> </dependencies>
>> <executions>
>> <execution>
>> <id>make-assembly</id>
>> <phase>package</phase>
>> <goals>
>> <goal>single</goal>
>> </goals>
>> <configuration>
>> <!-- This is where we use our shared assembly descriptor -->
>> <descriptors>
>> <descriptor>zip-contribution.xml</descriptor>
>> </descriptors>
>> </configuration>
>> </execution>
>> </executions>
>> </plugin>
>>
>> [1]
>> http://maven.apache.org/plugins/maven-assembly-plugin/examples/sharing-descriptors.html
>>
>> Thanks,
>> Raymond
>>
>> --------------------------------------------------
>> From: "ant elder" <an...@apache.org>
>> Sent: Tuesday, April 28, 2009 11:56 PM
>> To: <de...@tuscany.apache.org>
>> Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
>>
>>> On Tue, Apr 28, 2009 at 6:57 PM, Raymond Feng <en...@gmail.com>
>>> wrote:
>>>>
>>>> Hi,
>>>>
>>>> Here is what I did to get the same zip using the maven-assembly-plugin:
>>>>
>>>> 1) Configure the tuscany-zip-plugin in the pom.xml for the archetype
>>>>
>>>> (https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml)
>>>>
>>>> <plugin>
>>>> <artifactId>maven-assembly-plugin</artifactId>
>>>> <configuration>
>>>> <descriptors>
>>>> <descriptor>src/main/assembly/zip.xml</descriptor>
>>>> </descriptors>
>>>> </configuration>
>>>> </plugin>
>>>>
>>>> 2) Add the assembly descriptor (src/main/assembly/zip.xml) to the
>>>> archetype:
>>>> <assembly>
>>>> <id>zip-contribution</id>
>>>> <formats>
>>>> <format>zip</format>
>>>> </formats>
>>>> <includeBaseDirectory>false</includeBaseDirectory>
>>>> <dependencySets>
>>>> <dependencySet>
>>>> <unpack>false</unpack>
>>>> <scope>runtime</scope>
>>>> <outputDirectory>lib</outputDirectory>
>>>> <useProjectArtifact>false</useProjectArtifact>
>>>> </dependencySet>
>>>> </dependencySets>
>>>> <fileSets>
>>>> <fileSet>
>>>> <directory>${project.build.outputDirectory}</directory>
>>>> <outputDirectory>/</outputDirectory>
>>>> </fileSet>
>>>> </fileSets>
>>>> </assembly>
>>>>
>>>
>>> But Raymond, requiring the user project include extra files that
>>> aren't related to their sca contribution was exactly what i was trying
>>> to avoid. This is in effect doing the same as the zip plugin but
>>> instead of having it hidden away in some Tuscany plugin code now every
>>> user project would need to include it.
>>>
>>> The pre-defined descriptors approach you mentioned first seemed good,
>>> if we could get that to work it would solve this. Do you know if there
>>> is any way to include a predefined descriptor that does what we need
>>> in some Tuscany module that a user build script can refer to with a
>>> descriptorRef element?
>>>
>>> ...ant
>>
>>
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@apache.org>.
Brilliant. This does most of what we need so lets go with that
approach. Looks like you've already done the code so would you like to
commit that and I can update the zip archetype to use the new module?
...ant
On Wed, Apr 29, 2009 at 4:44 PM, Raymond Feng <en...@gmail.com> wrote:
> The predefined jar-with-dependencies descriptor has a few issues:
>
> 1) It produces a jar
> 2) It unpacks dependencies (instead of lib/???.jar)
>
> The shared descriptor approach seems to be satisfying the need without
> packaging the descriptor in the generated project:
>
> <plugin>
> <artifactId>maven-assembly-plugin</artifactId>
> <version>2.2-beta-3</version>
> <dependencies>
> <dependency>
> <groupId>org.apache.tuscany.sca</groupId>
> <artifactId>zip-contribution-descriptor</artifactId>
> <version>2.0-SNAPSHOT</version>
> </dependency>
> </dependencies>
> <executions>
> <execution>
> <id>make-assembly</id>
> <phase>package</phase>
> <goals>
> <goal>single</goal>
> </goals>
> <configuration>
> <!-- This is where we use our shared assembly descriptor -->
> <descriptors>
> <descriptor>zip-contribution.xml</descriptor>
> </descriptors>
> </configuration>
> </execution>
> </executions>
> </plugin>
>
> [1]
> http://maven.apache.org/plugins/maven-assembly-plugin/examples/sharing-descriptors.html
>
> Thanks,
> Raymond
>
> --------------------------------------------------
> From: "ant elder" <an...@apache.org>
> Sent: Tuesday, April 28, 2009 11:56 PM
> To: <de...@tuscany.apache.org>
> Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
>
>> On Tue, Apr 28, 2009 at 6:57 PM, Raymond Feng <en...@gmail.com> wrote:
>>>
>>> Hi,
>>>
>>> Here is what I did to get the same zip using the maven-assembly-plugin:
>>>
>>> 1) Configure the tuscany-zip-plugin in the pom.xml for the archetype
>>>
>>> (https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml)
>>>
>>> <plugin>
>>> <artifactId>maven-assembly-plugin</artifactId>
>>> <configuration>
>>> <descriptors>
>>> <descriptor>src/main/assembly/zip.xml</descriptor>
>>> </descriptors>
>>> </configuration>
>>> </plugin>
>>>
>>> 2) Add the assembly descriptor (src/main/assembly/zip.xml) to the
>>> archetype:
>>> <assembly>
>>> <id>zip-contribution</id>
>>> <formats>
>>> <format>zip</format>
>>> </formats>
>>> <includeBaseDirectory>false</includeBaseDirectory>
>>> <dependencySets>
>>> <dependencySet>
>>> <unpack>false</unpack>
>>> <scope>runtime</scope>
>>> <outputDirectory>lib</outputDirectory>
>>> <useProjectArtifact>false</useProjectArtifact>
>>> </dependencySet>
>>> </dependencySets>
>>> <fileSets>
>>> <fileSet>
>>> <directory>${project.build.outputDirectory}</directory>
>>> <outputDirectory>/</outputDirectory>
>>> </fileSet>
>>> </fileSets>
>>> </assembly>
>>>
>>
>> But Raymond, requiring the user project include extra files that
>> aren't related to their sca contribution was exactly what i was trying
>> to avoid. This is in effect doing the same as the zip plugin but
>> instead of having it hidden away in some Tuscany plugin code now every
>> user project would need to include it.
>>
>> The pre-defined descriptors approach you mentioned first seemed good,
>> if we could get that to work it would solve this. Do you know if there
>> is any way to include a predefined descriptor that does what we need
>> in some Tuscany module that a user build script can refer to with a
>> descriptorRef element?
>>
>> ...ant
>
>
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Raymond Feng <en...@gmail.com>.
The predefined jar-with-dependencies descriptor has a few issues:
1) It produces a jar
2) It unpacks dependencies (instead of lib/???.jar)
The shared descriptor approach seems to be satisfying the need without
packaging the descriptor in the generated project:
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.2-beta-3</version>
<dependencies>
<dependency>
<groupId>org.apache.tuscany.sca</groupId>
<artifactId>zip-contribution-descriptor</artifactId>
<version>2.0-SNAPSHOT</version>
</dependency>
</dependencies>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
<configuration>
<!-- This is where we use our shared assembly descriptor -->
<descriptors>
<descriptor>zip-contribution.xml</descriptor>
</descriptors>
</configuration>
</execution>
</executions>
</plugin>
[1]
http://maven.apache.org/plugins/maven-assembly-plugin/examples/sharing-descriptors.html
Thanks,
Raymond
--------------------------------------------------
From: "ant elder" <an...@apache.org>
Sent: Tuesday, April 28, 2009 11:56 PM
To: <de...@tuscany.apache.org>
Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
> On Tue, Apr 28, 2009 at 6:57 PM, Raymond Feng <en...@gmail.com> wrote:
>> Hi,
>>
>> Here is what I did to get the same zip using the maven-assembly-plugin:
>>
>> 1) Configure the tuscany-zip-plugin in the pom.xml for the archetype
>> (https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml)
>>
>> <plugin>
>> <artifactId>maven-assembly-plugin</artifactId>
>> <configuration>
>> <descriptors>
>> <descriptor>src/main/assembly/zip.xml</descriptor>
>> </descriptors>
>> </configuration>
>> </plugin>
>>
>> 2) Add the assembly descriptor (src/main/assembly/zip.xml) to the
>> archetype:
>> <assembly>
>> <id>zip-contribution</id>
>> <formats>
>> <format>zip</format>
>> </formats>
>> <includeBaseDirectory>false</includeBaseDirectory>
>> <dependencySets>
>> <dependencySet>
>> <unpack>false</unpack>
>> <scope>runtime</scope>
>> <outputDirectory>lib</outputDirectory>
>> <useProjectArtifact>false</useProjectArtifact>
>> </dependencySet>
>> </dependencySets>
>> <fileSets>
>> <fileSet>
>> <directory>${project.build.outputDirectory}</directory>
>> <outputDirectory>/</outputDirectory>
>> </fileSet>
>> </fileSets>
>> </assembly>
>>
>
> But Raymond, requiring the user project include extra files that
> aren't related to their sca contribution was exactly what i was trying
> to avoid. This is in effect doing the same as the zip plugin but
> instead of having it hidden away in some Tuscany plugin code now every
> user project would need to include it.
>
> The pre-defined descriptors approach you mentioned first seemed good,
> if we could get that to work it would solve this. Do you know if there
> is any way to include a predefined descriptor that does what we need
> in some Tuscany module that a user build script can refer to with a
> descriptorRef element?
>
> ...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@apache.org>.
On Tue, Apr 28, 2009 at 6:57 PM, Raymond Feng <en...@gmail.com> wrote:
> Hi,
>
> Here is what I did to get the same zip using the maven-assembly-plugin:
>
> 1) Configure the tuscany-zip-plugin in the pom.xml for the archetype
> (https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml)
>
> <plugin>
> <artifactId>maven-assembly-plugin</artifactId>
> <configuration>
> <descriptors>
> <descriptor>src/main/assembly/zip.xml</descriptor>
> </descriptors>
> </configuration>
> </plugin>
>
> 2) Add the assembly descriptor (src/main/assembly/zip.xml) to the archetype:
> <assembly>
> <id>zip-contribution</id>
> <formats>
> <format>zip</format>
> </formats>
> <includeBaseDirectory>false</includeBaseDirectory>
> <dependencySets>
> <dependencySet>
> <unpack>false</unpack>
> <scope>runtime</scope>
> <outputDirectory>lib</outputDirectory>
> <useProjectArtifact>false</useProjectArtifact>
> </dependencySet>
> </dependencySets>
> <fileSets>
> <fileSet>
> <directory>${project.build.outputDirectory}</directory>
> <outputDirectory>/</outputDirectory>
> </fileSet>
> </fileSets>
> </assembly>
>
But Raymond, requiring the user project include extra files that
aren't related to their sca contribution was exactly what i was trying
to avoid. This is in effect doing the same as the zip plugin but
instead of having it hidden away in some Tuscany plugin code now every
user project would need to include it.
The pre-defined descriptors approach you mentioned first seemed good,
if we could get that to work it would solve this. Do you know if there
is any way to include a predefined descriptor that does what we need
in some Tuscany module that a user build script can refer to with a
descriptorRef element?
...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Raymond Feng <en...@gmail.com>.
Hi,
Here is what I did to get the same zip using the maven-assembly-plugin:
1) Configure the tuscany-zip-plugin in the pom.xml for the archetype
(https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml)
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptors>
<descriptor>src/main/assembly/zip.xml</descriptor>
</descriptors>
</configuration>
</plugin>
2) Add the assembly descriptor (src/main/assembly/zip.xml) to the archetype:
<assembly>
<id>zip-contribution</id>
<formats>
<format>zip</format>
</formats>
<includeBaseDirectory>false</includeBaseDirectory>
<dependencySets>
<dependencySet>
<unpack>false</unpack>
<scope>runtime</scope>
<outputDirectory>lib</outputDirectory>
<useProjectArtifact>false</useProjectArtifact>
</dependencySet>
</dependencySets>
<fileSets>
<fileSet>
<directory>${project.build.outputDirectory}</directory>
<outputDirectory>/</outputDirectory>
</fileSet>
</fileSets>
</assembly>
3) Use mvn archetype:generate to generate a project from the archetype
4) Run mvn assembly:assembly to produce the zip (This can be automated into
the default build)
Thanks,
Raymond
--------------------------------------------------
From: "ant elder" <an...@gmail.com>
Sent: Tuesday, April 28, 2009 8:48 AM
To: <de...@tuscany.apache.org>
Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
> On Tue, Apr 28, 2009 at 4:36 PM, Raymond Feng <en...@gmail.com> wrote:
>> Hi,
>>
>> Thanks Mike for the great document. It helps me understand what the zip
>> plugin does.
>>
>> But now I have a new question:
>>
>> Can we just use the the maven assembly plugin to package them into a zip?
>> The pom will look like:
>>
>> <project>
>> [...]
>> <build>
>> [...]
>> <plugins>
>> <plugin>
>> <!-- NOTE: We don't need a groupId specification because the group
>> is
>> org.apache.maven.plugins ...which is assumed by default.
>> -->
>> <artifactId>maven-assembly-plugin</artifactId>
>> <configuration>
>> <descriptorRefs>
>> <descriptorRef>jar-with-dependencies</descriptorRef> <!-- This
>> is
>> a predefined descriptor, see [2] -->
>> </descriptorRefs>
>> </configuration>
>> [...]
>> </project>
>>
>> [1] http://maven.apache.org/plugins/maven-assembly-plugin/usage.html
>> [2]
>> http://maven.apache.org/plugins/maven-assembly-plugin/descriptor-refs.html#jar-with-dependencies
>>
>> IMO, developing our own maven plugin will be the last resort.
>>
>
> I don't think its the last resort, if we can make it simpler for users
> with our own plugin then thats a good thing and worth doing. The
> plugin is just a side effect of the main goal which is to have an easy
> way to create sca zip contributions and to use that in the
> contribution-zip archetype, if you think there's an easier way to do
> that that thats great, could you show us with an actual example? I've
> just updated the contribution-zip archetype to use a calculator type
> service which uses a dependency jar so you could try updating that to
> use you new approach, if that does turn out to be simpler then I'm all
> for it.
>
> ...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@gmail.com>.
On Tue, Apr 28, 2009 at 4:36 PM, Raymond Feng <en...@gmail.com> wrote:
> Hi,
>
> Thanks Mike for the great document. It helps me understand what the zip
> plugin does.
>
> But now I have a new question:
>
> Can we just use the the maven assembly plugin to package them into a zip?
> The pom will look like:
>
> <project>
> [...]
> <build>
> [...]
> <plugins>
> <plugin>
> <!-- NOTE: We don't need a groupId specification because the group is
> org.apache.maven.plugins ...which is assumed by default.
> -->
> <artifactId>maven-assembly-plugin</artifactId>
> <configuration>
> <descriptorRefs>
> <descriptorRef>jar-with-dependencies</descriptorRef> <!-- This is
> a predefined descriptor, see [2] -->
> </descriptorRefs>
> </configuration>
> [...]
> </project>
>
> [1] http://maven.apache.org/plugins/maven-assembly-plugin/usage.html
> [2]
> http://maven.apache.org/plugins/maven-assembly-plugin/descriptor-refs.html#jar-with-dependencies
>
> IMO, developing our own maven plugin will be the last resort.
>
I don't think its the last resort, if we can make it simpler for users
with our own plugin then thats a good thing and worth doing. The
plugin is just a side effect of the main goal which is to have an easy
way to create sca zip contributions and to use that in the
contribution-zip archetype, if you think there's an easier way to do
that that thats great, could you show us with an actual example? I've
just updated the contribution-zip archetype to use a calculator type
service which uses a dependency jar so you could try updating that to
use you new approach, if that does turn out to be simpler then I'm all
for it.
...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Raymond Feng <en...@gmail.com>.
Hi,
Thanks Mike for the great document. It helps me understand what the zip
plugin does.
But now I have a new question:
Can we just use the the maven assembly plugin to package them into a zip?
The pom will look like:
<project>
[...]
<build>
[...]
<plugins>
<plugin>
<!-- NOTE: We don't need a groupId specification because the group
is
org.apache.maven.plugins ...which is assumed by default.
-->
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef> <!-- This
is a predefined descriptor, see [2] -->
</descriptorRefs>
</configuration>
[...]
</project>
[1] http://maven.apache.org/plugins/maven-assembly-plugin/usage.html
[2]
http://maven.apache.org/plugins/maven-assembly-plugin/descriptor-refs.html#jar-with-dependencies
IMO, developing our own maven plugin will be the last resort.
Thanks,
Raymond
--------------------------------------------------
From: "Mike Edwards" <mi...@gmail.com>
Sent: Tuesday, April 28, 2009 1:18 AM
To: <de...@tuscany.apache.org>
Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
> Mike Edwards wrote:
>> Ant,
>>
>> I'd prefer to see a bit more user documentation first.
>>
>> I'm unclear as to what exactly it does and how to run it properly.
>> That's why I'm not voting for it. (note that I have not voted against
>> it either...)
>>
>> Yours, Mike.
>>
> First, I'd like to make it clear that I'm NOT picking on this release -
> but I am keen to see more and better end user documentation for everything
> we have in Tuscany. So expect me to be more picky with any release of
> anything.
>
> As a first step for THIS release, here is a suggested improvement to the
> documentation which I hope will make it clearer to users what it is for
> and how it is used.
>
>
> Yours, Mike.
>
>
> User Documentation
> __________________
>
> This module is a Maven plugin which supports the creation of a zip format
> SCA contribution from
> the contents of a Maven project. An SCA contribution can be deployed to
> the Tuscany SCA runtime
> and run as an application.
>
> One of the main uses for an SCA zip contribution is that the SCA zip
> contribution can contain
> Java jar files within the zip and those jar files are available to the
> Java classloader of the
> contribution. This enables the packaging of application Java classes
> along with any other Jar files
> which they depend on in one contribution file. As a result the single zip
> file can hold everything
> that's needed for the SCA application other than the Tuscany runtime
> itself - in one neat package.
>
> The zip Maven plugin is used by adding a section into <build/> portion of
> the pom.xml of the Maven
> project which relates to the maven zip plugin. It is also necessary for
> the packaging of the output
> of the project to be declared as "zip". Then run Maven in the project.
>
> This zip plugin builds the output of the project as an SCA zip archive and
> it includes any
> jar files from dependencies declared by the project, where those
> dependency jar files are placed
> into the zip archive in a folder with the name "lib".
>
>
> An outline of a pom.xml including the zip plugin statements:
>
> ...
> <!-- output packaging format is "zip" -->
> <packaging>zip</packaging>
> ...
> <build>
> ...
> <!-- section referencing the Tuscany zip plugin -->
> <plugins>
> ...
> <plugin>
> <groupId>org.apache.tuscany.maven.plugins</groupId>
> <artifactId>maven-zip-plugin</artifactId>
> <extensions>true</extensions>
> </plugin>
> ...
> </plugins>
> </build>
>
>
> Here is an example pom.xml containing the Tuscany zip plugin material:
>
> <?xml version="1.0" encoding="UTF-8"?>
> <project xmlns="http://maven.apache.org/POM/4.0.0"
> xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
> http://maven.apache.org/maven-v4_0_0.xsd">
>
> <modelVersion>4.0.0</modelVersion>
>
> <parent>
> <artifactId>tuscany-sca</artifactId>
> <groupId>org.apache.tuscany.sca</groupId>
> <version>2.0-SNAPSHOT</version>
> </parent>
> <groupId>org.inglenook.test1</groupId>
> <artifactId>mikestest</artifactId>
> <packaging>zip</packaging>
> <version>1.0-SNAPSHOT</version>
> <name>quickstart</name>
>
> <dependencies>
> <!-- TUSCANY DEPENDENCIES -->
> <dependency>
> <groupId>org.apache.tuscany.sca</groupId>
> <artifactId>tuscany-sca-api</artifactId>
> <version>${tuscany.version}</version>
> <scope>provided</scope>
> </dependency>
>
> <!-- AN EXAMPLE APPLICATION DEPENDENCY TO BE INCLUDED IN ZIP -->
> <dependency>
> <groupId>commons-io</groupId>
> <artifactId>commons-io</artifactId>
> <version>1.4</version>
> </dependency>
>
> <!-- JUNIT DEPENDENCY FOR TESTING -->
> <dependency>
> <groupId>junit</groupId>
> <artifactId>junit</artifactId>
> <version>3.8.2</version>
> <scope>test</scope>
> </dependency>
>
> </dependencies>
> <build>
> <defaultGoal>install</defaultGoal>
> <finalName>${artifactId}</finalName>
> <resources>
> <resource>
> <directory>src/main/resources</directory>
> </resource>
> <resource>
> <directory>src/main/java</directory>
> <includes>
> <include>**</include>
> </includes>
> <excludes>
> <exclude>**/*.java</exclude>
> </excludes>
> </resource>
> </resources>
> <testResources>
> <testResource>
> <directory>src/test/java</directory>
> <includes>
> <include>**</include>
> </includes>
> <excludes>
> <exclude>**/*.java</exclude>
> </excludes>
> </testResource>
> </testResources>
> <plugins>
> <plugin>
> <inherited>true</inherited>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-compiler-plugin</artifactId>
> <configuration>
> <source>1.5</source>
> <target>1.5</target>
> <optimise>true</optimise>
> <debug>true</debug>
> </configuration>
> </plugin>
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-eclipse-plugin</artifactId>
> <configuration>
> <downloadSources>true</downloadSources>
> </configuration>
> </plugin>
> <plugin>
> <groupId>org.apache.tuscany.maven.plugins</groupId>
> <artifactId>maven-zip-plugin</artifactId>
> <extensions>true</extensions>
> </plugin>
> <plugin>
> <groupId>org.apache.tuscany.maven.plugins</groupId>
> <artifactId>maven-tuscany-plugin</artifactId>
> </plugin>
> </plugins>
> </build>
> <properties>
> <tuscany.version>2.0-SNAPSHOT</tuscany.version>
> </properties>
> </project>
>
>
> TODOs:
> - make the "lib/" folder where the dependent jars go configurable
> - make which dependencies get included configurable
> (currently its those with compile or runtime scope)
>
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Mike Edwards <mi...@gmail.com>.
Mike Edwards wrote:
> Ant,
>
> I'd prefer to see a bit more user documentation first.
>
> I'm unclear as to what exactly it does and how to run it properly.
> That's why I'm not voting for it. (note that I have not voted against
> it either...)
>
> Yours, Mike.
>
First, I'd like to make it clear that I'm NOT picking on this release - but I am keen to see more
and better end user documentation for everything we have in Tuscany. So expect me to be more picky
with any release of anything.
As a first step for THIS release, here is a suggested improvement to the documentation which I hope
will make it clearer to users what it is for and how it is used.
Yours, Mike.
User Documentation
__________________
This module is a Maven plugin which supports the creation of a zip format SCA contribution from
the contents of a Maven project. An SCA contribution can be deployed to the Tuscany SCA runtime
and run as an application.
One of the main uses for an SCA zip contribution is that the SCA zip contribution can contain
Java jar files within the zip and those jar files are available to the Java classloader of the
contribution. This enables the packaging of application Java classes along with any other Jar files
which they depend on in one contribution file. As a result the single zip file can hold everything
that's needed for the SCA application other than the Tuscany runtime itself - in one neat package.
The zip Maven plugin is used by adding a section into <build/> portion of the pom.xml of the Maven
project which relates to the maven zip plugin. It is also necessary for the packaging of the output
of the project to be declared as "zip". Then run Maven in the project.
This zip plugin builds the output of the project as an SCA zip archive and it includes any
jar files from dependencies declared by the project, where those dependency jar files are placed
into the zip archive in a folder with the name "lib".
An outline of a pom.xml including the zip plugin statements:
...
<!-- output packaging format is "zip" -->
<packaging>zip</packaging>
...
<build>
...
<!-- section referencing the Tuscany zip plugin -->
<plugins>
...
<plugin>
<groupId>org.apache.tuscany.maven.plugins</groupId>
<artifactId>maven-zip-plugin</artifactId>
<extensions>true</extensions>
</plugin>
...
</plugins>
</build>
Here is an example pom.xml containing the Tuscany zip plugin material:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<artifactId>tuscany-sca</artifactId>
<groupId>org.apache.tuscany.sca</groupId>
<version>2.0-SNAPSHOT</version>
</parent>
<groupId>org.inglenook.test1</groupId>
<artifactId>mikestest</artifactId>
<packaging>zip</packaging>
<version>1.0-SNAPSHOT</version>
<name>quickstart</name>
<dependencies>
<!-- TUSCANY DEPENDENCIES -->
<dependency>
<groupId>org.apache.tuscany.sca</groupId>
<artifactId>tuscany-sca-api</artifactId>
<version>${tuscany.version}</version>
<scope>provided</scope>
</dependency>
<!-- AN EXAMPLE APPLICATION DEPENDENCY TO BE INCLUDED IN ZIP -->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>1.4</version>
</dependency>
<!-- JUNIT DEPENDENCY FOR TESTING -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.2</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<defaultGoal>install</defaultGoal>
<finalName>${artifactId}</finalName>
<resources>
<resource>
<directory>src/main/resources</directory>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**</include>
</includes>
<excludes>
<exclude>**/*.java</exclude>
</excludes>
</resource>
</resources>
<testResources>
<testResource>
<directory>src/test/java</directory>
<includes>
<include>**</include>
</includes>
<excludes>
<exclude>**/*.java</exclude>
</excludes>
</testResource>
</testResources>
<plugins>
<plugin>
<inherited>true</inherited>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
<optimise>true</optimise>
<debug>true</debug>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-eclipse-plugin</artifactId>
<configuration>
<downloadSources>true</downloadSources>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.tuscany.maven.plugins</groupId>
<artifactId>maven-zip-plugin</artifactId>
<extensions>true</extensions>
</plugin>
<plugin>
<groupId>org.apache.tuscany.maven.plugins</groupId>
<artifactId>maven-tuscany-plugin</artifactId>
</plugin>
</plugins>
</build>
<properties>
<tuscany.version>2.0-SNAPSHOT</tuscany.version>
</properties>
</project>
TODOs:
- make the "lib/" folder where the dependent jars go configurable
- make which dependencies get included configurable
(currently its those with compile or runtime scope)
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Mike Edwards <mi...@gmail.com>.
Ant,
I'd prefer to see a bit more user documentation first.
I'm unclear as to what exactly it does and how to run it properly.
That's why I'm not voting for it. (note that I have not voted against
it either...)
Yours, Mike.
ant elder wrote:
> Still looking for one more vote on this, anyone?
>
> ...ant
>
> On Sat, Apr 25, 2009 at 8:28 AM, ant elder <an...@apache.org> wrote:
>> There is a snippet of what a pom.xml using this looks like in the README,
>> and i've just added a bit more text about what it does to the trunk README
>> at
>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/trunk/maven-zip-plugin/README
>>
>> You could see a complete pom.xml by running the archetype as described in
>> the previous email on this thread, or, in svn in the archetype module
>> there's the resource it uses to create the pom.xm at
>> https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml
>>
>> ...ant
>>
>>
>> On Fri, Apr 24, 2009 at 11:57 PM, Raymond Feng <en...@gmail.com> wrote:
>>> Can you give us an example pom.xml that uses the plugin and briefly
>>> describe the usage?
>>>
>>> Thanks,
>>> Raymond
>>> From: ant elder
>>> Sent: Friday, April 24, 2009 5:24 AM
>>> To: dev@tuscany.apache.org
>>> Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
>>>
>>>
>>> On Fri, Apr 24, 2009 at 1:11 PM, Mike Edwards
>>> <mi...@gmail.com> wrote:
>>>> ant elder wrote:
>>>>> Please review and vote on releasing the alpha1 release of the Tuscany
>>>>> Zip plugin module.
>>>>>
>>>>> The zip plugin enables using a packaging of zip in a Maven project
>>>>> pom.xml to create a zip format SCA contribution.
>>>>>
>>>>> The tag for the release is:
>>>>>
>>>>>
>>>>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>>>>>
>>>>> the Maven staging repository is:
>>>>> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
>>>>>
>>>>> Thanks in advance for the votes,
>>>>>
>>>>> ...ant
>>>>>
>>>> Ant,
>>>>
>>>> Is there any user documentation on how to use this? I don't mean
>>>> developer
>>>> documentation of how to build it.
>>>>
>>>>
>>>> Yours, Mike.
>>>>
>>> Not so much yet, its an alpha1 release ;) There's a little at the top of
>>> the README:
>>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//README
>>>
>>> and there's an archetype that will create an example using it, thats not
>>> been released yet but if you've done a full 2.x build you'll have it locally
>>> so in an empty folder run:
>>>
>>> mvn archetype:generate
>>>
>>> enter the option for "tuscany-contribution-zip" which is 5 for me, then
>>> enter "somegroup" and "sometest", hit enter 3 times to take the next
>>> defaults. That will create a folder named sometest containing a project that
>>> creates a helloworld sca zip contribution, you can run that by changing into
>>> the sometest folder and entering "mvn tuscany:run" and you should see
>>> tuscany start up and output "hello world"
>>>
>>> Let me know is that does/doesn't work no one other than me has ever tried
>>> it as far as i know.
>>>
>>> ...ant
>>>
>>>
>>>
>>>
>>>
>>>
>>>
>>
>
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@apache.org>.
Still looking for one more vote on this, anyone?
...ant
On Sat, Apr 25, 2009 at 8:28 AM, ant elder <an...@apache.org> wrote:
> There is a snippet of what a pom.xml using this looks like in the README,
> and i've just added a bit more text about what it does to the trunk README
> at
> https://svn.apache.org/repos/asf/tuscany/maven-plugins/trunk/maven-zip-plugin/README
>
> You could see a complete pom.xml by running the archetype as described in
> the previous email on this thread, or, in svn in the archetype module
> there's the resource it uses to create the pom.xm at
> https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml
>
> ...ant
>
>
> On Fri, Apr 24, 2009 at 11:57 PM, Raymond Feng <en...@gmail.com> wrote:
>>
>> Can you give us an example pom.xml that uses the plugin and briefly
>> describe the usage?
>>
>> Thanks,
>> Raymond
>> From: ant elder
>> Sent: Friday, April 24, 2009 5:24 AM
>> To: dev@tuscany.apache.org
>> Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
>>
>>
>> On Fri, Apr 24, 2009 at 1:11 PM, Mike Edwards
>> <mi...@gmail.com> wrote:
>> > ant elder wrote:
>> >>
>> >> Please review and vote on releasing the alpha1 release of the Tuscany
>> >> Zip plugin module.
>> >>
>> >> The zip plugin enables using a packaging of zip in a Maven project
>> >> pom.xml to create a zip format SCA contribution.
>> >>
>> >> The tag for the release is:
>> >>
>> >>
>> >> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>> >>
>> >> the Maven staging repository is:
>> >> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
>> >>
>> >> Thanks in advance for the votes,
>> >>
>> >> ...ant
>> >>
>> > Ant,
>> >
>> > Is there any user documentation on how to use this? I don't mean
>> > developer
>> > documentation of how to build it.
>> >
>> >
>> > Yours, Mike.
>> >
>>
>> Not so much yet, its an alpha1 release ;) There's a little at the top of
>> the README:
>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//README
>>
>> and there's an archetype that will create an example using it, thats not
>> been released yet but if you've done a full 2.x build you'll have it locally
>> so in an empty folder run:
>>
>> mvn archetype:generate
>>
>> enter the option for "tuscany-contribution-zip" which is 5 for me, then
>> enter "somegroup" and "sometest", hit enter 3 times to take the next
>> defaults. That will create a folder named sometest containing a project that
>> creates a helloworld sca zip contribution, you can run that by changing into
>> the sometest folder and entering "mvn tuscany:run" and you should see
>> tuscany start up and output "hello world"
>>
>> Let me know is that does/doesn't work no one other than me has ever tried
>> it as far as i know.
>>
>> ...ant
>>
>>
>>
>>
>>
>>
>>
>
>
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@apache.org>.
There is a snippet of what a pom.xml using this looks like in the README,
and i've just added a bit more text about what it does to the trunk README
at
https://svn.apache.org/repos/asf/tuscany/maven-plugins/trunk/maven-zip-plugin/README
You could see a complete pom.xml by running the archetype as described in
the previous email on this thread, or, in svn in the archetype module
there's the resource it uses to create the pom.xm at
https://svn.apache.org/repos/asf/tuscany/java/sca/archetypes/contribution-zip/src/main/resources/archetype-resources/pom.xml
...ant
On Fri, Apr 24, 2009 at 11:57 PM, Raymond Feng <en...@gmail.com> wrote:
> Can you give us an example pom.xml that uses the plugin and briefly
> describe the usage?
>
> Thanks,
> Raymond
>
> *From:* ant elder <an...@gmail.com>
> *Sent:* Friday, April 24, 2009 5:24 AM
> *To:* dev@tuscany.apache.org
> *Subject:* Re: [VOTE] Release Tuscany Zip Plugin alpha1
>
>
>
> On Fri, Apr 24, 2009 at 1:11 PM, Mike Edwards <
> mike.edwards.inglenook@gmail.com> wrote:
> > ant elder wrote:
> >>
> >> Please review and vote on releasing the alpha1 release of the Tuscany
> >> Zip plugin module.
> >>
> >> The zip plugin enables using a packaging of zip in a Maven project
> >> pom.xml to create a zip format SCA contribution.
> >>
> >> The tag for the release is:
> >>
> >>
> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
> >>
> >> the Maven staging repository is:
> >> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/<http://people.apache.org/%7Eantelder/tuscany/maven-zip-plugin-alpha1-RC1/>
> >>
> >> Thanks in advance for the votes,
> >>
> >> ...ant
> >>
> > Ant,
> >
> > Is there any user documentation on how to use this? I don't mean
> developer
> > documentation of how to build it.
> >
> >
> > Yours, Mike.
> >
>
> Not so much yet, its an alpha1 release ;) There's a little at the top of
> the README:
> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//README
>
> and there's an archetype that will create an example using it, thats not
> been released yet but if you've done a full 2.x build you'll have it locally
> so in an empty folder run:
>
> mvn archetype:generate
>
> enter the option for "tuscany-contribution-zip" which is 5 for me, then
> enter "somegroup" and "sometest", hit enter 3 times to take the next
> defaults. That will create a folder named sometest containing a project that
> creates a helloworld sca zip contribution, you can run that by changing into
> the sometest folder and entering "mvn tuscany:run" and you should see
> tuscany start up and output "hello world"
>
> Let me know is that does/doesn't work no one other than me has ever tried
> it as far as i know.
>
> ...ant
>
>
>
>
>
>
>
>
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Raymond Feng <en...@gmail.com>.
Can you give us an example pom.xml that uses the plugin and briefly describe the usage?
Thanks,
Raymond
From: ant elder
Sent: Friday, April 24, 2009 5:24 AM
To: dev@tuscany.apache.org
Subject: Re: [VOTE] Release Tuscany Zip Plugin alpha1
On Fri, Apr 24, 2009 at 1:11 PM, Mike Edwards <mi...@gmail.com> wrote:
> ant elder wrote:
>>
>> Please review and vote on releasing the alpha1 release of the Tuscany
>> Zip plugin module.
>>
>> The zip plugin enables using a packaging of zip in a Maven project
>> pom.xml to create a zip format SCA contribution.
>>
>> The tag for the release is:
>>
>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>>
>> the Maven staging repository is:
>> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
>>
>> Thanks in advance for the votes,
>>
>> ...ant
>>
> Ant,
>
> Is there any user documentation on how to use this? I don't mean developer
> documentation of how to build it.
>
>
> Yours, Mike.
>
Not so much yet, its an alpha1 release ;) There's a little at the top of the README: https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//README
and there's an archetype that will create an example using it, thats not been released yet but if you've done a full 2.x build you'll have it locally so in an empty folder run:
mvn archetype:generate
enter the option for "tuscany-contribution-zip" which is 5 for me, then enter "somegroup" and "sometest", hit enter 3 times to take the next defaults. That will create a folder named sometest containing a project that creates a helloworld sca zip contribution, you can run that by changing into the sometest folder and entering "mvn tuscany:run" and you should see tuscany start up and output "hello world"
Let me know is that does/doesn't work no one other than me has ever tried it as far as i know.
...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@gmail.com>.
On Fri, Apr 24, 2009 at 1:11 PM, Mike Edwards <
mike.edwards.inglenook@gmail.com> wrote:
> ant elder wrote:
>>
>> Please review and vote on releasing the alpha1 release of the Tuscany
>> Zip plugin module.
>>
>> The zip plugin enables using a packaging of zip in a Maven project
>> pom.xml to create a zip format SCA contribution.
>>
>> The tag for the release is:
>>
>>
https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>>
>> the Maven staging repository is:
>> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
>>
>> Thanks in advance for the votes,
>>
>> ...ant
>>
> Ant,
>
> Is there any user documentation on how to use this? I don't mean
developer
> documentation of how to build it.
>
>
> Yours, Mike.
>
Not so much yet, its an alpha1 release ;) There's a little at the top of the
README:
https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//README
and there's an archetype that will create an example using it, thats not
been released yet but if you've done a full 2.x build you'll have it locally
so in an empty folder run:
mvn archetype:generate
enter the option for "tuscany-contribution-zip" which is 5 for me, then
enter "somegroup" and "sometest", hit enter 3 times to take the next
defaults. That will create a folder named sometest containing a project that
creates a helloworld sca zip contribution, you can run that by changing into
the sometest folder and entering "mvn tuscany:run" and you should see
tuscany start up and output "hello world"
Let me know is that does/doesn't work no one other than me has ever tried it
as far as i know.
...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Mike Edwards <mi...@gmail.com>.
ant elder wrote:
> Please review and vote on releasing the alpha1 release of the Tuscany
> Zip plugin module.
>
> The zip plugin enables using a packaging of zip in a Maven project
> pom.xml to create a zip format SCA contribution.
>
> The tag for the release is:
> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>
> the Maven staging repository is:
> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
>
> Thanks in advance for the votes,
>
> ...ant
>
Ant,
Is there any user documentation on how to use this? I don't mean developer documentation of how to
build it.
Yours, Mike.
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Ramkumar R <ra...@gmail.com>.
Hi Ant,
Thanks for the clarification, I believe we follow this process for all kind
of artifacts.
My question was specifically about how to verify the functionality of this
plugin by using them,
I think the README has some information on that now.
+1 from me, I just checked the LICENSE and the artifact signings as required
for this release.
On Fri, Apr 24, 2009 at 3:19 PM, ant elder <an...@apache.org> wrote:
> On Fri, Apr 24, 2009 at 10:29 AM, Ramkumar R <ra...@gmail.com>
> wrote:
> > Hi Ant,
> >
> > May be I am not sure how to verify this plugin, can you please post some
> > info on this. Thanks.
> >
>
> Its mainly down to the ASF standards and requirements for release
> artifacts, so:
>
> - Is every seperatley distributable artifact correctly licensed, do
> they have the correct LICENSE and NOTICE files?
> These do if you look within the jars at
>
> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/org/apache/tuscany/maven/plugins/maven-zip-plugin/alpha1/<http://people.apache.org/%7Eantelder/tuscany/maven-zip-plugin-alpha1-RC1/org/apache/tuscany/maven/plugins/maven-zip-plugin/alpha1/>
> you can see the LICENSE and NOTICE files.
>
> - are the artifacts signed with a valid key?
> These are, you can see the .asc files and if you down load those
> artifacts and run something like gpg --verify
> maven-zip-plugin-alpha1.jar.asc it should be ok
>
> Those are the main blocking things for these simple maven plugin
> releases, if either of those were incorrect a -1 would be warranted.
> Then there's stylistic things, is there a correct svn tag, and in
> there a RELEASE_NOTES and README file to give some info about what the
> release is for, are they full of typos, if you were so inclined you
> could try out using the plugin. None of those things are absolutely
> required though especially not for an alpha1 release like this and
> even if you found issues you could just point them out for fixing in a
> later release.
>
> ...ant
>
--
Thanks & Regards,
Ramkumar Ramalingam
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@apache.org>.
On Fri, Apr 24, 2009 at 10:29 AM, Ramkumar R <ra...@gmail.com> wrote:
> Hi Ant,
>
> May be I am not sure how to verify this plugin, can you please post some
> info on this. Thanks.
>
Its mainly down to the ASF standards and requirements for release artifacts, so:
- Is every seperatley distributable artifact correctly licensed, do
they have the correct LICENSE and NOTICE files?
These do if you look within the jars at
http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/org/apache/tuscany/maven/plugins/maven-zip-plugin/alpha1/
you can see the LICENSE and NOTICE files.
- are the artifacts signed with a valid key?
These are, you can see the .asc files and if you down load those
artifacts and run something like gpg --verify
maven-zip-plugin-alpha1.jar.asc it should be ok
Those are the main blocking things for these simple maven plugin
releases, if either of those were incorrect a -1 would be warranted.
Then there's stylistic things, is there a correct svn tag, and in
there a RELEASE_NOTES and README file to give some info about what the
release is for, are they full of typos, if you were so inclined you
could try out using the plugin. None of those things are absolutely
required though especially not for an alpha1 release like this and
even if you found issues you could just point them out for fixing in a
later release.
...ant
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Ramkumar R <ra...@gmail.com>.
Hi Ant,
May be I am not sure how to verify this plugin, can you please post some
info on this. Thanks.
On Wed, Apr 22, 2009 at 8:32 PM, ant elder <an...@gmail.com> wrote:
> Please review and vote on releasing the alpha1 release of the Tuscany
> Zip plugin module.
>
> The zip plugin enables using a packaging of zip in a Maven project
> pom.xml to create a zip format SCA contribution.
>
> The tag for the release is:
>
> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>
> the Maven staging repository is:
> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/<http://people.apache.org/%7Eantelder/tuscany/maven-zip-plugin-alpha1-RC1/>
>
> Thanks in advance for the votes,
>
> ...ant
>
--
Thanks & Regards,
Ramkumar Ramalingam
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@apache.org>.
On Fri, Apr 24, 2009 at 8:41 AM, Simon Laws <si...@googlemail.com> wrote:
> As an aside. It seems that this is heavily based on some other Apache
> code. WAR plugin? Can we doff our hats in the README to show our
> appreciation to the original authors?
>
Sure ok i'll add that now, it does already say this in the code (eg
comment at the top of [1]) but you're right it would be good to have
it in the README too.
...ant
[1] https://svn.apache.org/repos/asf/tuscany/maven-plugins/trunk/maven-zip-plugin/src/main/java/org/apache/tuscany/maven/zip/ZipMojo.java
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by Simon Laws <si...@googlemail.com>.
On Fri, Apr 24, 2009 at 6:44 AM, ant elder <an...@gmail.com> wrote:
>
>
> On Wed, Apr 22, 2009 at 4:02 PM, ant elder <an...@gmail.com> wrote:
>>
>> Please review and vote on releasing the alpha1 release of the Tuscany
>> Zip plugin module.
>>
>> The zip plugin enables using a packaging of zip in a Maven project
>> pom.xml to create a zip format SCA contribution.
>>
>> The tag for the release is:
>>
>> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>>
>> the Maven staging repository is:
>> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/
>>
>> Thanks in advance for the votes,
>>
>> ...ant
>
> +1 from me of course, would a couple of others be able to have a look? Its
> very small so should only take moments to review.
>
> ...ant
>
>
+1 from me.
As an aside. It seems that this is heavily based on some other Apache
code. WAR plugin? Can we doff our hats in the README to show our
appreciation to the original authors?
Regards
Simon
Re: [VOTE] Release Tuscany Zip Plugin alpha1
Posted by ant elder <an...@gmail.com>.
On Wed, Apr 22, 2009 at 4:02 PM, ant elder <an...@gmail.com> wrote:
> Please review and vote on releasing the alpha1 release of the Tuscany
> Zip plugin module.
>
> The zip plugin enables using a packaging of zip in a Maven project
> pom.xml to create a zip format SCA contribution.
>
> The tag for the release is:
>
> https://svn.apache.org/repos/asf/tuscany/maven-plugins/tags/maven-zip-plugin-alpha1//
>
> the Maven staging repository is:
> http://people.apache.org/~antelder/tuscany/maven-zip-plugin-alpha1-RC1/<http://people.apache.org/%7Eantelder/tuscany/maven-zip-plugin-alpha1-RC1/>
>
> Thanks in advance for the votes,
>
> ...ant
>
+1 from me of course, would a couple of others be able to have a look? Its
very small so should only take moments to review.
...ant