Visit the course webpage for additional details about the project, AutoTest, and the specific requirements of each project deliverable.
To start using this project you need to get your computer configured so you can build and execute the code. This process should be largely similar to the cpsc310starter
repo used during the first lab. To do this, follow these steps; the specifics of each step (especially the first two) will vary based on which operating system your computer has:
-
Install git (you should be able to execute
git -v
on the command line). -
Install Node, which will also install NPM (you should be able to execute
node -v
andnpm -v
the command line). -
Clone the project:
git clone [email protected]:CS310-2016Fall/cpsc310project_teamXXX.git
(whereXXX
is your team number). You can also clone the repo by visiting your project in Github and getting the clone target by clicking on the green button on your project repository. -
It is important that your project directory be called
cpsc310project
if you want to work with the public test suite we are providing. The easiest way to do this is to move it to the right name:mv cpsc310project_teamXXX cpsc310project
(replacingXXX
with your team number). NOTE: This is important or the public test suite will not work. The private test suite we run will do this automatically.
Once your project is configured you need to further prepare the project's tooling and dependencies. In the cpsc310project
folder:
-
npm run clean
-
npm run configure
-
npm run build
If you use Windows; instead try:
-
npm run cleanwin
-
npm run configurewin
-
npm run build
The sample project ships with some automated unit tests. These commands will execute the suites:
- Test:
npm run test
(ornpm test
) - Test coverage:
npm run cover
(ornpm run coverwin
if you use Windows). HTML reports can be found:./coverage/lcov-report/index.html
You can also run the tests as a Mocha target inside your favourite IDE (WebStorm and VSCode both work well and are free for academic use); some students are also using Atom and Cloud9 (although this will require a bit of fiddling since it runs in the cloud).
Instructions for running the public suite will be included in your team's public suite repo.
To invoke the private suite, add a @CPSC310Bot
mention to any commit in your main branch in Github. Remember: these are rate limited so choose your commits wisely. Additional details can be found in the AutoTest documentation.
npm run start
You can then open the sample UI in your web browser by visiting http://localhost:4321. Alternatively, you can invoke the server using curl or some other tool that can hit your REST endpoints once the server is started.
If you are developing in Typescript you will have to re-compile the Typescript code. This can be done with npm run build
to build the system and get it ready to execute. New unit tests can be written and added to /test
; as long as the tests end in Spec.ts
they will be executed automatically when you run npm run test
.
While these instructions are for WebStorm, other IDEs (e.g., VSCode, Atom, etc.) and editors (e.g., Sublime) should be similar, or will at least be compatible with the command line options described above.
To run or test the system in WebStorm you will need to configure run targets. To run the system go to the Run->Edit Configurations
and tap on the +
and then Node.js
. Point the 'JavaScript file' argument to src/App.js
. To run the system tests, go to the Run->Edit Configurations
and tap on the +
and then Mocha
. Point the 'Test Directory' file argument to test/
.