Move the Subclassing POD under Examples

[dbsrgits/DBIx-Class-Historic.git] / .travis.yml

# Some overall notes on how this works
#
# * We smoke using the system provided latest, and custom built "oddball perls"
# The reason for not having a blanket matrix is to conserve travis resources
# as a full DBIC depchain isn't cheap
#
# * Minimum perl officially supported by DBIC is 5.8.3. This *includes* the
# basic depchain. On failure either attempt to fix it or bring it to the
# attention of ribasushi. *DO NOT* disable 5.8 testing - it is here for a
# reason
#
# * The matrix is built from two main modes - CLEANTEST = [true|false].
# - In the first case we test with minimal deps available, and skip everything
#   listed in DBIC::OptDesps. The modules are installed with classic CPAN
#   invocations and are *fully tested*. In other words we simulate what would
#   happen if a user tried to install on a just-compiled virgin perl
# - Without CLEANTEST we bring the armada of RDBMS and install the maximum
#   possible set of deps *without testing them*. This ensures we stay within
#   a reasonable build-time and still run as many of our tests as possible
#
# * The perl builds and the DBIC tests run under NUMTHREADS number of threads.
# The testing of dependencies under CLEANTEST runs single-threaded, at least
# until we fix our entire dep-chain to safely pass under -j
#
# * The way .travis.yml is fed to the command controller is idiotic - it
# makes using multiline `bash -c` statements impossible. Therefore to
# aid readability (our travis logic is rather complex), the bulk of
# functionality is moved to scripts. More about the problem (and the
# WONTFIX "explanation") here: https://github.com/travis-ci/travis-ci/issues/497
#

#
# Smoke all branches except for blocked* and wip/*
#
# Additionally master does not smoke with bleadperl
# ( implemented in maint/travis-ci_scripts/10_before_install.bash )
#
branches:
  except:
    - /^wip\//
    - /^blocked/

notifications:
  irc:
    channels:
      - "irc.perl.org#dbic-smoke"
    template:
      - "%{branch}#%{build_number} by %{author}: %{message} (%{build_url})"
    on_success: change
    on_failure: always
    use_notice: true

  email:
    recipients:
      - ribasushi@cpan.org
      # Temporary - if it proves to be too noisy, we'll shut it off
      #- dbix-class-devel@lists.scsys.co.uk
    on_success: change
    on_failure: always

# FIXME - This stuff is not yet available for free OSS accounts, sadpanda
# First paragrah on http://about.travis-ci.org/docs/user/caching/
#cache:
#  apt: true
#  directories:
#    - /var/cache/apt/archives

language: perl

perl:
  - "5.18"

env:
  - CLEANTEST=false
  - CLEANTEST=true

matrix:
  fast_finish: true
  include:
    # this particular perl is quite widespread
    - perl: 5.8.8_thr_mb
      env:
        - CLEANTEST=true
        - BREWOPTS="-Duseithreads -Dusemorebits"
        - BREWVER=5.8.8

    # so is this one (test a sane CPAN.pm)
    - perl: 5.12.4_thr_mb
      env:
        - CLEANTEST=true
        - BREWOPTS="-Duseithreads -Dusemorebits"
        - BREWVER=5.12.4

    # this is the perl suse ships
    - perl: 5.10.0_thr_dbg
      env:
        - CLEANTEST=true
        - BREWOPTS="-DDEBUGGING -Duseithreads"
        - BREWVER=5.10.0

    # CLEANTEST of minimum supported
    - perl: 5.8.3_nt_mb
      env:
        - CLEANTEST=true
        - BREWOPTS="-Dusemorebits"
        - BREWVER=5.8.3

    # Full Test of minimum supported with threads
    - perl: 5.8.5_thr
      env:
        - CLEANTEST=false
        - BREWOPTS="-Duseithreads"
        - BREWVER=5.8.5
        - DBIC_TRACE_PROFILE=console

    # Full Test of minimum supported without threads
    - perl: 5.8.3_nt
      env:
        - CLEANTEST=false
        - BREWOPTS=""
        - BREWVER=5.8.3
        - DBIC_TRACE_PROFILE=console_monochrome

    ###
    # some permutations of tracing and envvar poisoning

    - perl: 5.16.2_thr_mb
      env:
        - CLEANTEST=false
        - POISON_ENV=true
        - DBIC_TRACE=1
        - DBIC_MULTICREATE_DEBUG=0
        - BREWOPTS="-Duseithreads -Dusemorebits"
        - BREWVER=5.16.2

    - perl: 5.18
      env:
        - CLEANTEST=false
        - POISON_ENV=true
        - DBIC_TRACE_PROFILE=console

    - perl: 5.8
      env:
        - CLEANTEST=true
        - POISON_ENV=true
        - DBIC_TRACE=1
        - DBIC_TRACE_PROFILE=console

    - perl: 5.18
      env:
        - CLEANTEST=false
        - POISON_ENV=true
        - DBIC_TRACE=1
        - DBIC_TRACE_PROFILE=console_monochrome
        - DBIC_MULTICREATE_DEBUG=0

    ###
    # Start of the allow_failures block

    # old threaded with blead CPAN
    - perl: devcpan_5.8.7_thr
      env:
        - CLEANTEST=true
        - BREWOPTS="-Duseithreads"
        - BREWVER=5.8.7
        - DEVREL_DEPS=true

    # 5.10.0 threaded with blead CPAN
    - perl: devcpan_5.10.0_thr_mb
      env:
        - CLEANTEST=true
        - BREWOPTS="-Duseithreads -Dusemorebits"
        - BREWVER=5.10.0
        - DEVREL_DEPS=true

    # 5.12.2 with blead CPAN
    - perl: devcpan_5.12.2_thr
      env:
        - CLEANTEST=true
        - BREWOPTS="-Duseithreads"
        - BREWVER=5.12.2
        - DEVREL_DEPS=true

    # recentish threaded stable with blead CPAN
    - perl: devcpan_5.18.2_thr_mb
      env:
        - CLEANTEST=false
        - BREWOPTS="-Duseithreads -Dusemorebits"
        - BREWVER=5.18.2
        - DEVREL_DEPS=true

    # bleadperl with stock CPAN, full depchain test
    - perl: bleadperl
      env:
        - CLEANTEST=true
        - BREWVER=blead

    # bleadperl with blead CPAN
    - perl: devcpan_bleadperl_thr_mb
      env:
        - CLEANTEST=false
        - BREWOPTS="-Duseithreads -Dusemorebits"
        - BREWVER=blead
        - DEVREL_DEPS=true


  # which ones of the above can fail
  allow_failures:

    # these run with various dev snapshots - allowed to fail
    - perl: devcpan_5.8.7_thr
    - perl: devcpan_5.10.0_thr_mb
    - perl: devcpan_5.12.2_thr
    - perl: devcpan_5.18.2_thr_mb
    - perl: bleadperl
    - perl: devcpan_bleadperl_thr_mb


# sourcing the files is *EXTREMELY* important - otherwise
# no envvars will survive

# the entire run times out after 50 minutes, or after 5 minutes without
# console output

before_install:
  # Sets global envvars, downloads/configures debs based on CLEANTEST
  # Sets extra DBICTEST_* envvars
  #
  - source maint/travis-ci_scripts/10_before_install.bash

install:
  # Build and switch to a custom perl if requested
  # Configure the perl env, preinstall some generic toolchain parts
  #
  - source maint/travis-ci_scripts/20_install.bash

before_script:
  # Preinstall/install deps based on envvars/CLEANTEST
  #
  - source maint/travis-ci_scripts/30_before_script.bash

script:
  # Run actual tests
  #
  - source maint/travis-ci_scripts/40_script.bash

after_success:
  # Check if we can assemble a dist properly if not in CLEANTEST
  #
  - source maint/travis-ci_scripts/50_after_success.bash

after_failure:
  # No tasks yet
  #
  #- source maint/travis-ci_scripts/50_after_failure.bash

after_script:
  # No tasks yet
  #
  #- source maint/travis-ci_scripts/60_after_script.bash

  # if we do not unset this before we terminate the travis teardown will
  # mark the entire job as failed
  - set +e