point out where in the docs a user is most likely to spend reading time
[dbsrgits/DBIx-Class.git] / .travis.yml
1 # Some overall notes on how this works
2 #
3 # * We smoke using the system provided latest, and custom built "oddball perls"
4 # The reason for not having a blanket matrix is to conserve travis resources
5 # as a full DBIC depchain isn't cheap
6 #
7 # * Minimum perl officially supported by DBIC is 5.8.3. This *includes* the
8 # basic depchain. On failure either attempt to fix it or bring it to the
9 # attention of ribasushi. *DO NOT* disable 5.8 testing - it is here for a
10 # reason
11 #
12 # * The matrix is built from two main modes - CLEANTEST = [true|false].
13 # - In the first case we test with minimal deps available, and skip everything
14 #   listed in DBIC::OptDesps. The modules are installed with classic CPAN
15 #   invocations and are *fully tested*. In other words we simulate what would
16 #   happen if a user tried to install on a just-compiled virgin perl
17 # - Without CLEANTEST we bring the armada of RDBMS and install the maximum
18 #   possible set of deps *without testing them*. This ensures we stay within
19 #   a reasonable build-time and still run as many of our tests as possible
20 #
21 # * The perl builds and the DBIC tests run under NUMTHREADS number of threads.
22 # The testing of dependencies under CLEANTEST runs single-threaded, at least
23 # until we fix our entire dep-chain to safely pass under -j
24 #
25 # * The way .travis.yml is fed to the command controller is idiotic - it
26 # makes using multiline `bash -c` statements impossible. Therefore to
27 # aid readability (our travis logic is rather complex), the bulk of
28 # functionality is moved to scripts. More about the problem (and the
29 # WONTFIX "explanation") here: https://github.com/travis-ci/travis-ci/issues/497
30 #
31
32 #
33 # Smoke all branches except for blocked* and wip/*
34 #
35 # Additionally master does not smoke with bleadperl
36 # ( implemented in maint/travis-ci_scripts/10_before_install.bash )
37 #
38 branches:
39   except:
40     - /^wip\//
41     - /^blocked/
42
43 notifications:
44   irc:
45     channels:
46       - "irc.perl.org#dbic-smoke"
47     template:
48       - "%{branch}#%{build_number} by %{author}: %{message} (%{build_url})"
49     on_success: change
50     on_failure: always
51     use_notice: true
52
53   email:
54     recipients:
55       - ribasushi@cpan.org
56       # Temporary - if it proves to be too noisy, we'll shut it off
57       #- dbix-class-devel@lists.scsys.co.uk
58     on_success: change
59     on_failure: change
60
61 language: perl
62
63 perl:
64   - "5.16"
65
66 env:
67   - CLEANTEST=false
68   - CLEANTEST=true
69
70 matrix:
71   include:
72     # bleadperl
73     - perl: bleadperl_thr_mb
74       env:
75         - CLEANTEST=false
76         - BREWOPTS="-Duseithreads -Dusemorebits"
77         - BREWVER=blead
78
79     # minimum supported with threads
80     - perl: 5.8.5_thr
81       env:
82         - CLEANTEST=false
83         - BREWOPTS="-Duseithreads"
84         - BREWVER=5.8.5
85         - DBIC_TRACE_PROFILE=console
86
87     # minimum supported without threads
88     - perl: 5.8.3_nt
89       env:
90         - CLEANTEST=false
91         - BREWOPTS=""
92         - BREWVER=5.8.3
93         - DBIC_TRACE_PROFILE=console_monochrome
94
95     # check CLEANTEST of minimum supported
96     - perl: 5.8.3_nt_mb
97       env:
98         - CLEANTEST=true
99         - BREWOPTS="-Dusemorebits"
100         - BREWVER=5.8.3
101
102     # this is the perl suse ships
103     - perl: 5.10.0_thr_dbg
104       env:
105         - CLEANTEST=true
106         - BREWOPTS="-DDEBUGGING -Duseithreads"
107         - BREWVER=5.10.0
108
109     # this particular perl is quite widespread
110     - perl: 5.8.8_thr_mb
111       env:
112         - CLEANTEST=true
113         - BREWOPTS="-Duseithreads -Dusemorebits"
114         - BREWVER=5.8.8
115
116     # some permutations of tracing and envvar poisoning
117     - perl: 5.16
118       env:
119         - CLEANTEST=false
120         - POISON_ENV=true
121
122     - perl: 5.16
123       env:
124         - CLEANTEST=true
125         - POISON_ENV=true
126         - DBIC_TRACE=1
127         - DBIC_TRACE_PROFILE=console
128
129     - perl: 5.16
130       env:
131         - CLEANTEST=false
132         - POISON_ENV=true
133         - DBIC_TRACE=1
134         - DBIC_TRACE_PROFILE=console_monochrome
135
136 # sourcing the files is *EXTREMELY* important - otherwise
137 # no envvars will survive
138
139 # the entire run times out after 50 minutes, or after 5 minutes without
140 # console output
141
142 before_install:
143   # Sets global envvars, downloads/configures debs based on CLEANTEST
144   # Sets extra DBICTEST_* envvars
145   #
146   - source maint/travis-ci_scripts/10_before_install.bash
147
148 install:
149   # Build and switch to a custom perl if requested
150   # Configure the perl env, preinstall some generic toolchain parts
151   #
152   - source maint/travis-ci_scripts/20_install.bash
153
154 before_script:
155   # Preinstall/install deps based on envvars/CLEANTEST
156   #
157   - source maint/travis-ci_scripts/30_before_script.bash
158
159 script:
160   # Run actual tests
161   #
162   - source maint/travis-ci_scripts/40_script.bash
163
164 after_success:
165   # Check if we can assemble a dist properly if not in CLEANTEST
166   #
167   - source maint/travis-ci_scripts/50_after_success.bash
168
169 after_failure:
170   # No tasks yet
171   #
172   #- source maint/travis-ci_scripts/50_after_failure.bash
173
174 after_script:
175   # No tasks yet
176   #
177   #- source maint/travis-ci_scripts/60_after_script.bash
178
179   # if we do not unset this before we terminate the travis teardown will
180   # mark the entire job as failed
181   - set +e