Skip to content

Latest commit

 

History

History
79 lines (52 loc) · 2.59 KB

CONTRIBUTING.md

File metadata and controls

79 lines (52 loc) · 2.59 KB

ScalikeJDBC Contributers' Guide

Issues

  • Questions should be posted to ScalikeJDBC Users Group
  • Please describe about your issue in detail (verison, situation, examples)
  • We may close your issue when we have no plan to take action right now. We appreciate your understanding.

Pull Requests

  • Pull requests basically should be sent toward "master" branch
  • Source and binary compatibility always must be kept
  • scalariform must be applied to all Scala source code
  • Prefer creating scala source code for each class/object/trait (of course, except for sealed trait)
  • ScalikeJDBC build checks binary compatibility by using MiMa. After 2.x.0 release, binary compatibility must be kept while 2.x series release.

Branches

master (the default branch)
  • the latest stable version
  • Changes that bring binary/source incompatibility are allowed until 2.3.0 release
  • This branch must be able to build against Scala 2.10 and 2.11
2.2.x
  • the version 2.2 series maintainance branch
  • Only security fixes and critical bug fixes in master branch will be backported
  • This branch must be able to build against Scala 2.10 and 2.11
2.1.x
  • the version 2.1 series maintainance branch
  • Only security fixes and critical bug fixes in master branch will be backported
  • This branch must be able to build against Scala 2.10 and 2.11
2.0.x
  • the version 2.0 series maintainance branch
  • Only security fixes and critical bug fixes in master branch will be backported
  • This branch must be able to build against Scala 2.10 and 2.11
1.8.x
  • This branch must be able to build against Scala 2.10
  • This branch must be compatible with ScalaTest 1.9
  • Backport from master branch which doesn't work on Scala 2.9 can be merged
  • Source code compatibility should be kept with 1.7.x
1.7.x
  • This branch must be able to build against Scala 2.9.1, 2.9.2, 2.9.3 and 2.10
  • This branch must be compatible with ScalaTest 1.9
  • Backport from master branch which doesn't work on Scala 2.9 can NOT be merged

Testing your pull request

All the pull requests should pass the Travis CI jobs before merging them.

https://travis-ci.org/scalikejdbc/scalikejdbc

Testing with default settings is required when push changes:

sbt library/test
sbt interpolation/test

If your change needs testing with MySQL/PostgreSQL

./scripts/run_tests.sh mysql
./scripts/run_tests.sh postgresql

See the required JDBC settings here.

scalikejdbc-core/src/test/resources/*.properties