tdd-nca

---

Project maintained by tmstff Hosted on GitHub Pages — Theme by mattgraham

TDD @ NCA

This project is intended to be used for showing how to develop a Couch DB driver in a test-driven fashion.

gradle commands

This project uses gradle as build tool.

To run the tests use

./gradlew test

To build a JAR of the lib (to be found in build/libs) use

./gradlew assemble

Docker

For the tests, the Couch DB will by default be run in a docker container started by the test containers lib. If you want to to use another Couch DB Instance, you can supply useExternalCouchDB=true as environment variable or system option, e.g. for command line

env "useExternalCouchDB=true" ./gradlew test

or in the IDE for test execution:

-DuseExternalCouchDB=true

If an external Couch DB is used it is assumed that the Couch DB is reachable at http://localhost:5984, you can change this through environment variable or system option couchDbUrl eg.

-DcouchDbUrl=http://localhost:4711

Run Couch DB locally

You can start a couch DB instance as docker image:

docker run -p 5984:5984 couchdb

Access local Couch db:

curl localhost:5984

Technologies

• Couch DB
  • Couch DB Api
• Groovy Language
• Gradle Build Tool
• Spock Testing Framework
• httpbuilder - groovy http client
• docker container technology
  • Couch Db docker container
• testcontainers - docker container handling for automated tests
• Jackson JSON Library
  • Jackson datatype JSONObject