incubator-sling-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bdelacre...@apache.org
Subject svn commit: r680953 - in /incubator/sling/trunk/launchpad: testing/README.txt webapp/README.txt
Date Wed, 30 Jul 2008 09:42:33 GMT
Author: bdelacretaz
Date: Wed Jul 30 02:42:30 2008
New Revision: 680953

URL: http://svn.apache.org/viewvc?rev=680953&view=rev
Log:
SLING-567 - adapt README.txt

Added:
    incubator/sling/trunk/launchpad/testing/README.txt   (with props)
Modified:
    incubator/sling/trunk/launchpad/webapp/README.txt

Added: incubator/sling/trunk/launchpad/testing/README.txt
URL: http://svn.apache.org/viewvc/incubator/sling/trunk/launchpad/testing/README.txt?rev=680953&view=auto
==============================================================================
--- incubator/sling/trunk/launchpad/testing/README.txt (added)
+++ incubator/sling/trunk/launchpad/testing/README.txt Wed Jul 30 02:42:30 2008
@@ -0,0 +1,95 @@
+Apache Sling Launchpad Testing module
+
+This module builds a Sling webapp using bundles from the trunk, and
+runs integration tests (that were previously in the launchpad/webapp
+module) on them.  
+
+
+Disclaimer
+==========
+Apache Sling is an effort undergoing incubation at The Apache Software Foundation (ASF),
+sponsored by the Apache Jackrabbit PMC. Incubation is required of all newly accepted
+projects until a further review indicates that the infrastructure, communications,
+and decision making process have stabilized in a manner consistent with other
+successful ASF projects. While incubation status is not necessarily a reflection of
+the completeness or stability of the code, it does indicate that the project has yet
+to be fully endorsed by the ASF.
+
+Getting Started
+===============
+
+This component uses a Maven 2 (http://maven.apache.org/) build
+environment. It requires a Java 5 JDK (or higher) and Maven (http://maven.apache.org/)
+2.0.7 or later. We recommend to use the latest Maven version.
+
+If you have Maven 2 installed, you can compile and
+package the jar using the following command:
+
+    mvn package
+
+See the Maven 2 documentation for other build features.
+
+The latest source code for this component is available in the
+Subversion (http://subversion.tigris.org/) source repository of
+the Apache Software Foundation. If you have Subversion installed,
+you can checkout the latest source using the following command:
+
+    svn checkout http://svn.apache.org/repos/asf/incubator/sling/trunk/launchpad/webapp
+
+See the Subversion documentation for other source control features.
+
+
+How to run this
+---------------
+
+1) Build all Sling bundles
+
+  cd <top of the Sling source code tree>
+  mvn clean install
+  
+2) Build and run this
+
+  cd launchpad/testing
+  mvn clean package jetty:run
+  
+Once the webapp starts, http://localhost:8888/system/console should display the Felix
+OSGi console.
+
+4) Test node creation and display
+To create a node with curl:
+
+	 curl -D - -Ftitle=something http://admin:admin@localhost:8888/testing/this
+	 
+Then, http://admin:admin@localhost:8888/testing/this should display a default HTML
+representation, including the value of the "title" property.
+
+Add a txt or json extension to see other output formats.
+
+Integration tests
+-----------------
+This module provides a number of integration tests, that run automatically when
+doing a full build, and test Sling via its client HTTP interfaces.
+
+These tests can also be run against another instance of Sling, for example to
+test it in another web container than the embedded Jetty that is used during the
+Maven build.
+
+See pom.xml for the parameters that control these integration tests. Here's an
+example of running them against a Sling instance running on host xyzzy, port 1234,
+with the Sling webapp mounted under /foo:
+
+   mvn -o -s /dev/null test \
+    -Dhttp.port=1234 \
+    -Dtest.host=xyzzy \
+    -Dhttp.base.path=foo \
+    -Dwebdav.workspace.path=foo/dav/default \
+    -Dtest=**/integrationtest/**/*Test.java
+
+The  -s /dev/null parameter disables all your local Maven settings, to make sure
+they don't interfere. Feel free to remove that if you know what you're doing.
+
+To run a single test, other values can be used for the "-Dtest" parameter.
+
+This is very useful during development: you can leave a Sling webapp instance
+running, update bundles in it using the mvn autoInstallBundle profile, and run
+specific integration tests quickly from another terminal.

Propchange: incubator/sling/trunk/launchpad/testing/README.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: incubator/sling/trunk/launchpad/webapp/README.txt
URL: http://svn.apache.org/viewvc/incubator/sling/trunk/launchpad/webapp/README.txt?rev=680953&r1=680952&r2=680953&view=diff
==============================================================================
--- incubator/sling/trunk/launchpad/webapp/README.txt (original)
+++ incubator/sling/trunk/launchpad/webapp/README.txt Wed Jul 30 02:42:30 2008
@@ -40,7 +40,6 @@
 See the Subversion documentation for other source control features.
 
 
-
 How to run this
 ---------------
 
@@ -49,21 +48,15 @@
   cd <top of the Sling source code tree>
   mvn clean install
   
-2) Build the launchpad servlets
-
-  cd launchpad/launchpad-servlets
-  mvn clean install
-  cd -
-  
-3) Build and run this
+2) Build and run this
 
-  cd launchpad/launchpad-webapp
+  cd launchpad/webapp
   mvn clean package jetty:run
   
-Once the webapp starts, http://localhost:8888/sling should display the Sling 
-web console.
+Once the webapp starts, http://localhost:8888/system/console should display the Felix
+OSGi console.
 
-4) Test node creation and display
+3) Test node creation and display
 To create a node with curl:
 
 	 curl -D - -Ftitle=something http://admin:admin@localhost:8888/testing/this
@@ -73,31 +66,6 @@
 
 Add a txt or json extension to see other output formats.
 
-Integration tests
------------------
-This module provides a number of integration tests, that run automatically when
-doing a full build, and test Sling via its client HTTP interfaces.
-
-These tests can also be run against another instance of Sling, for example to
-test it in another web container than the embedded Jetty that is used during the
-Maven build.
-
-See pom.xml for the parameters that control these integration tests. Here's an
-example of running them against a Sling instance running on host xyzzy, port 1234,
-with the Sling webapp mounted under /foo:
-
-   mvn -o -s /dev/null test \
-    -Dhttp.port=1234 \
-    -Dtest.host=xyzzy \
-    -Dhttp.base.path=foo \
-    -Dwebdav.workspace.path=foo/dav/default \
-    -Dtest=**/integrationtest/**/*Test.java
-
-The  -s /dev/null parameter disables all your local Maven settings, to make sure
-they don't interfere. Feel free to remove that if you know what you're doing.
-
-To run a single test, other values can be used for the "-Dtest" parameter.
-
-This is very useful during development: you can leave a Sling webapp instance
-running, update bundles in it using the mvn autoInstallBundle profile, and run
-specific integration tests quickly from another terminal.
+For more info see the Sling website at http://incubator.apache.org/sling, and the
+"Sling in 15 minutes" tutorial 
+at http://incubator.apache.org/sling/site/discover-sling-in-15-minutes.html
\ No newline at end of file



Mime
View raw message