Unit tests

.gitignore

@@ -1 +1,10 @@
 .idea/
+
+# Ignore development environment artefacts.
+*~
+.vagrant
+ansible/*.retry
+
+# Ignore Composer artefacts.
+composer.lock
+vendor/

Vagrantfile

@@ -0,0 +1,17 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+Vagrant.configure("2") do |config|
+  # Configure a single virtual machine.
+  config.vm.box = "debian/contrib-stretch64"
+  config.vm.hostname = "b2db"
+
+  # Use Ansible for provisining the virtual machine. Use local provisioning in
+  # order not to polute the user's host system.
+  config.vm.provision "ansible_local" do |ansible|
+    ansible.playbook = "ansible/provision.yml"
+    ansible.install_mode = "pip"
+    ansible.version = "2.7.5"
+    ansible.compatibility_mode = "2.0"
+  end
+end

ansible/provision.yml

@@ -0,0 +1,72 @@
+---
+
+- hosts: all
+  become: yes
+  tasks:
+
+    # Package installation.
+    - name: Install packages for Ansible use
+      apt:
+        name:
+          - python-mysqldb
+
+    - name: Install database servers
+      apt:
+        name:
+          - mariadb-server
+        state: present
+
+    - name: Install PHP and B2DB requirements
+      apt:
+        name:
+          # Core for library itself.
+          - php
+          - php-cli
+          - php-apcu
+          - php7.0-mbstring
+          # For Composer.
+          - unzip
+          # For running tests.
+          - php7.0-xml
+          - php-xdebug
+
+    # Create necessary databases and database users.
+    - name: Create database
+      mysql_db:
+        name: b2db
+        encoding: utf8
+        collation: utf8_general_ci
+        state: present
+
+    - name: Create database user
+      mysql_user:
+        name: b2db
+        host: localhost
+        password: b2db
+        priv: 'b2db.*:ALL'
+        state: present
+
+    # Composer dependency installation.
+    - name: Download composer
+      get_url:
+        url: https://getcomposer.org/download/1.8.0/composer.phar
+        checksum: sha256:0901a84d56f6d6ae8f8b96b0c131d4f51ccaf169d491813d2bcedf2a6e4cefa6
+        dest: /usr/local/bin/composer
+        owner: vagrant
+        group: vagrant
+        mode: 0755
+
+    - name: Install up-to-date development requirements via composer
+      become_user: vagrant
+      composer:
+        command: update
+        no_dev: no
+        working_dir: /vagrant
+
+    - name: Create convenience symlink for running the phpunit
+      file:
+        src: "/vagrant/vendor/bin/phpunit"
+        dest: "/usr/local/bin/phpunit"
+        owner: root
+        group: root
+        state: link

composer.json

@@ -19,6 +19,9 @@
         "ext-mbstring" : "*",
         "ext-pdo" : "*"
     },
+    "require-dev" : {
+        "phpunit/phpunit": "^6"
+    },
     "autoload" : {
         "psr-4" : {
             "b2db\\" : "src/"

phpunit.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit bootstrap="vendor/autoload.php"
+         colors="true"
+         verbose="true"
+         stopOnFailure="false">
+
+    <testsuites>
+        <testsuite name="Test suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+
+    <logging>
+      <log type="coverage-text" target="php://stdout" />
+    </logging>
+
+    <filter>
+      <whitelist processUncoveredFilesFromWhitelist="true">
+        <directory suffix=".php">src/</directory>
+      </whitelist>
+    </filter>
+
+</phpunit>