Move the Subclassing POD under Examples
[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: always
60
61 # FIXME - This stuff is not yet available for free OSS accounts, sadpanda
62 # First paragrah on http://about.travis-ci.org/docs/user/caching/
63 #cache:
64 #  apt: true
65 #  directories:
66 #    - /var/cache/apt/archives
67
68 language: perl
69
70 perl:
71   - "5.18"
72
73 env:
74   - CLEANTEST=false
75   - CLEANTEST=true
76
77 matrix:
78   fast_finish: true
79   include:
80     # this particular perl is quite widespread
81     - perl: 5.8.8_thr_mb
82       env:
83         - CLEANTEST=true
84         - BREWOPTS="-Duseithreads -Dusemorebits"
85         - BREWVER=5.8.8
86
87     # so is this one (test a sane CPAN.pm)
88     - perl: 5.12.4_thr_mb
89       env:
90         - CLEANTEST=true
91         - BREWOPTS="-Duseithreads -Dusemorebits"
92         - BREWVER=5.12.4
93
94     # this is the perl suse ships
95     - perl: 5.10.0_thr_dbg
96       env:
97         - CLEANTEST=true
98         - BREWOPTS="-DDEBUGGING -Duseithreads"
99         - BREWVER=5.10.0
100
101     # CLEANTEST of minimum supported
102     - perl: 5.8.3_nt_mb
103       env:
104         - CLEANTEST=true
105         - BREWOPTS="-Dusemorebits"
106         - BREWVER=5.8.3
107
108     # Full Test of minimum supported with threads
109     - perl: 5.8.5_thr
110       env:
111         - CLEANTEST=false
112         - BREWOPTS="-Duseithreads"
113         - BREWVER=5.8.5
114         - DBIC_TRACE_PROFILE=console
115
116     # Full Test of minimum supported without threads
117     - perl: 5.8.3_nt
118       env:
119         - CLEANTEST=false
120         - BREWOPTS=""
121         - BREWVER=5.8.3
122         - DBIC_TRACE_PROFILE=console_monochrome
123
124     ###
125     # some permutations of tracing and envvar poisoning
126
127     - perl: 5.16.2_thr_mb
128       env:
129         - CLEANTEST=false
130         - POISON_ENV=true
131         - DBIC_TRACE=1
132         - DBIC_MULTICREATE_DEBUG=0
133         - BREWOPTS="-Duseithreads -Dusemorebits"
134         - BREWVER=5.16.2
135
136     - perl: 5.18
137       env:
138         - CLEANTEST=false
139         - POISON_ENV=true
140         - DBIC_TRACE_PROFILE=console
141
142     - perl: 5.8
143       env:
144         - CLEANTEST=true
145         - POISON_ENV=true
146         - DBIC_TRACE=1
147         - DBIC_TRACE_PROFILE=console
148
149     - perl: 5.18
150       env:
151         - CLEANTEST=false
152         - POISON_ENV=true
153         - DBIC_TRACE=1
154         - DBIC_TRACE_PROFILE=console_monochrome
155         - DBIC_MULTICREATE_DEBUG=0
156
157     ###
158     # Start of the allow_failures block
159
160     # old threaded with blead CPAN
161     - perl: devcpan_5.8.7_thr
162       env:
163         - CLEANTEST=true
164         - BREWOPTS="-Duseithreads"
165         - BREWVER=5.8.7
166         - DEVREL_DEPS=true
167
168     # 5.10.0 threaded with blead CPAN
169     - perl: devcpan_5.10.0_thr_mb
170       env:
171         - CLEANTEST=true
172         - BREWOPTS="-Duseithreads -Dusemorebits"
173         - BREWVER=5.10.0
174         - DEVREL_DEPS=true
175
176     # 5.12.2 with blead CPAN
177     - perl: devcpan_5.12.2_thr
178       env:
179         - CLEANTEST=true
180         - BREWOPTS="-Duseithreads"
181         - BREWVER=5.12.2
182         - DEVREL_DEPS=true
183
184     # recentish threaded stable with blead CPAN
185     - perl: devcpan_5.18.2_thr_mb
186       env:
187         - CLEANTEST=false
188         - BREWOPTS="-Duseithreads -Dusemorebits"
189         - BREWVER=5.18.2
190         - DEVREL_DEPS=true
191
192     # bleadperl with stock CPAN, full depchain test
193     - perl: bleadperl
194       env:
195         - CLEANTEST=true
196         - BREWVER=blead
197
198     # bleadperl with blead CPAN
199     - perl: devcpan_bleadperl_thr_mb
200       env:
201         - CLEANTEST=false
202         - BREWOPTS="-Duseithreads -Dusemorebits"
203         - BREWVER=blead
204         - DEVREL_DEPS=true
205
206
207   # which ones of the above can fail
208   allow_failures:
209
210     # these run with various dev snapshots - allowed to fail
211     - perl: devcpan_5.8.7_thr
212     - perl: devcpan_5.10.0_thr_mb
213     - perl: devcpan_5.12.2_thr
214     - perl: devcpan_5.18.2_thr_mb
215     - perl: bleadperl
216     - perl: devcpan_bleadperl_thr_mb
217
218
219 # sourcing the files is *EXTREMELY* important - otherwise
220 # no envvars will survive
221
222 # the entire run times out after 50 minutes, or after 5 minutes without
223 # console output
224
225 before_install:
226   # Sets global envvars, downloads/configures debs based on CLEANTEST
227   # Sets extra DBICTEST_* envvars
228   #
229   - source maint/travis-ci_scripts/10_before_install.bash
230
231 install:
232   # Build and switch to a custom perl if requested
233   # Configure the perl env, preinstall some generic toolchain parts
234   #
235   - source maint/travis-ci_scripts/20_install.bash
236
237 before_script:
238   # Preinstall/install deps based on envvars/CLEANTEST
239   #
240   - source maint/travis-ci_scripts/30_before_script.bash
241
242 script:
243   # Run actual tests
244   #
245   - source maint/travis-ci_scripts/40_script.bash
246
247 after_success:
248   # Check if we can assemble a dist properly if not in CLEANTEST
249   #
250   - source maint/travis-ci_scripts/50_after_success.bash
251
252 after_failure:
253   # No tasks yet
254   #
255   #- source maint/travis-ci_scripts/50_after_failure.bash
256
257 after_script:
258   # No tasks yet
259   #
260   #- source maint/travis-ci_scripts/60_after_script.bash
261
262   # if we do not unset this before we terminate the travis teardown will
263   # mark the entire job as failed
264   - set +e