Pacman-inspired game, for teaching testing purposes.
Branch: master
Clone or download
avandeursen Bump to version 8.1.1.
Small release for some simple typos and small patches.
Latest commit 6f703ad Jan 4, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
src Fix critical typo May 9, 2018
.checkstyle Added checkstyle and made the main project comply Apr 7, 2014
.editorconfig Add new line to the end of .editorconfig Apr 24, 2017
.gitignore
.gitlab-ci.yml Spot bugs depends on the compile output. Apr 21, 2018
.pmd Added pmd rule for catch in tests. Apr 18, 2016
.travis.yml Add java9 as travis build environment. Apr 4, 2018
AUTHORS.md Add MD Authors file Apr 21, 2017
Apache-2.0-LICENSE.txt Included Apache license as it was for jpacman 5.x Apr 6, 2014
README.md Update version in readme. Apr 30, 2018
checkstyle.xml Use SuppressWarnings annotation for checkstyle. Apr 8, 2018
pmd-rules.xml Update pmd rule sets to new "best practices" category. Apr 8, 2018
pom.xml Bump to version 8.1.1. Jan 4, 2019
src-assembly.xml Fix issues reported by intellij inspect code Apr 23, 2016

README.md

build status

JPacman-Framework

About

Pacman-like game used for teaching software testing. It exposes students to the use of git, maven, JUnit, and mockito.

Parts of the code are well tested, whereas others are left untested intentionally. As a student in software testing, you can extend the test suite, or use the framework to build extensions in a test-driven way. As a teacher, you can use the framework to create your own testing exercises.

As a starting point for working on your own solution, a template solution is available.

We have developed and are using this code at a software testing course at Delft University of Technology, The Netherlands. Teachers interested in seeing the exercises I use there are invited to contact me.

Other universities who have used this material include Antwerp, Mons, Eindhoven, and UBC (Vancouver). At TU Delft, we use it in combination with gitlab as continuous integration and feedback server.

If you have any suggestions on how to improve this framework, please do not hesitate to contact us, open issue, or provide a pull request. Since testing is deliberately left as an exercise, pull requests that "solve" exercises or offer full coverage are less likely to be merged.

Main contributors:

  • Arie van Deursen (versions 1.0-5.x, 2003-2013, updates to versions 6.x and further, 2014-...)
  • Jeroen Roosen (major rewrite, version 6.0, 2014)

Getting Started

  1. Git clone the project
  2. If you use Eclipse:
    1. Import
    2. Right Click -> Configure -> Convert to Maven Project
  3. To see JPacman in action: run nl.tudelft.jpacman.Launcher. From the command line, run java -classpath target/jpacman-framework-<VERSION>.jar nl.tudelft.jpacman.Launcher
  4. To run the test suite in maven: mvn test
  5. To run the test suite in Eclipse: right click -> run as -> JUnit Test.