This FW/1 directory is a complete web application and expects to live in its own
webroot if you plan to run the applications within it. To use FW/1 in a separate
webroot you can either copy the
framework directory to that webroot or add a mapping
/framework to the
framework folder inside this FW/1 directory. Note that since
Application.cfc needs to extend
framework.one, you have to add the mapping
in your admin - you can't just use a per-application mapping.
Please read the Framework One Code of Conduct - we want FW/1 to be a welcoming and supportive environment for everyone to feel comfortable contributing!
Project home: https://github.com/framework-one/fw1
Running the Tests
build.xml file is primarily designed to be used by Travis to run the tests automatically, but it is possible to run the tests locally, with some setup:
- This FW/1 directory needs to be a web root for some test domain on your local machine. I have
fw1.localsetup to resolve to this folder.
- You'll need MXUnit installed and accessible via
/mxunitfor the test domain you use for this project. You can install MXUnit into this FW/1 directory if you want -
mxunit/*is on the
You can run the build locally using a variant of this command (all on one line):
ant -Dplatform=railo41 -Dtest.path.root=/Developer/workspace/fw1 \ -Dcontext.root= -Dserver.name=fw1.local -Dserver.port=8080 \ run-tests-mxunit
run-tests-example.sh file for a template (for Mac/Linux).
platformneeds to be set just to satisfy the build script it doesn't affect anything (so use
railo41even if you're on ACF or a different version of Railo)
test.path.rootshould be the filesystem path to this directory, i.e., the web root for the FW/1 project.
context.rootshould probably be empty (unless you are using a named web application context)
server.nameshould be the test domain you have configured
server.portshould be the port on which you access that test domain
run-tests-mxunitis the actual Ant task that does the testing
Copyright and License
Copyright (c) 2009-2016 Sean Corfield (and others -- see individual files for additional copyright holders). All rights reserved. The use and distribution terms for this software are covered by the Apache Software License 2.0 (http://www.apache.org/licenses/LICENSE-2.0) which can also be found in the file LICENSE at the root of this distribution and in individual licensed files. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.