You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: user/languages/perl.md
+53-68Lines changed: 53 additions & 68 deletions
Original file line number
Diff line number
Diff line change
@@ -4,122 +4,107 @@ layout: en
4
4
5
5
---
6
6
7
-
### What This Guide Covers
7
+
<divid="toc"></div>
8
8
9
-
This guide covers build environment and configuration topics specific to Perl projects. Please make sure to read our [Tutorial](/user/tutorial/) and [general build configuration](/user/customizing-the-build/) guides first.
9
+
<asidemarkdown="block"class="ataglance">
10
10
11
-
Perl builds are not available on the macOS environment.
Perl workers on Travis CI use [Perlbrew](http://perlbrew.pl/) to provide several Perl versions your projects can be tested against. To specify them, use the `perl:` key in your `.travis.yml` file, for example:
18
+
Minimal example:
16
19
17
20
```yaml
18
21
language: perl
19
22
perl:
20
23
- "5.26"
21
-
- "5.24"
22
-
- "5.22"
23
-
- "5.20"
24
24
```
25
25
{: data-file=".travis.yml"}
26
26
27
-
A more extensive example:
27
+
</aside>
28
28
29
-
```yaml
30
-
language: perl
31
-
perl:
32
-
- "5.26"
33
-
- "5.24"
34
-
- "5.22"
35
-
- "5.20"
36
-
- "5.18"
37
-
- "5.16"
38
-
```
39
-
{: data-file=".travis.yml"}
29
+
## What This Guide Covers
40
30
41
-
As time goes, new releases come out and we upgrade both Perlbrew and Perls, aliases like `5.14` will float and point to different exact versions, patch levels and so on.
31
+
{{ site.data.snippets.trusty_note_no_osx }}
42
32
43
-
For precise versions pre-installed on the VM, please consult "Build system information" in the build log.
33
+
Perl builds are not available on the OS X environment.
44
34
45
-
*Perl versions earlier than 5.8 are not and will not be provided. Please do not list them in `.travis.yml`.*
35
+
The rest of this guide covers configuring Perl projects in Travis CI. If you're
36
+
new to Travis CI please read our [Getting Started](/user/getting-started/) and
Additionally, some Perls have been compiled with threading support. They have
50
-
been compiled with the additional compile flags `-Duseshrplib` and `-Duseithreads`. This are the
51
-
versions that are available:
41
+
Travis CI uses [Perlbrew](http://perlbrew.pl/) to provide several Perl versions
42
+
you can test your projects against:
52
43
53
44
```yaml
54
-
5.26-shrplib
55
-
5.24-shrplib
56
-
5.22-shrplib
57
-
5.20-shrplib
58
-
5.18-shrplib
45
+
language: perl
46
+
perl:
47
+
- "5.26"
48
+
- "5.24"
49
+
- "5.22"
59
50
```
60
51
{: data-file=".travis.yml"}
61
52
53
+
These versions specified by `major.minor` numbers are aliases to exact patch
54
+
levels, which are subject to change. For precise versions pre-installed on the
55
+
VM, please consult "Build system information" in the build log.
62
56
63
-
## Default Perl Version
64
-
65
-
If you leave the `perl` key out of your `.travis.yml`, Travis CI will use Perl 5.14.
57
+
> Perl versions earlier than 5.8 are not supported.
66
58
67
-
## Default Test Script
59
+
### Perl runtimes with threading support
68
60
69
-
### Module::Build
61
+
{{ site.data.language-details.perl.threading }}
70
62
71
-
If your repository has Build.PL in the root, it will be used to generate the build script:
63
+
## Default Build Script
72
64
73
-
```bash
74
-
perl Build.PL && ./Build test
75
-
```
65
+
The default build script varies according to your project:
76
66
77
-
### EUMM
67
+
* if your repository has `Build.PL` in the root:
78
68
79
-
If your repository has Makefile.PL in the root, it will be used like so
80
-
81
-
```bash
82
-
perl Makefile.PL && make test
83
-
```
69
+
```bash
70
+
perl Build.PL && ./Build test
71
+
```
72
+
* if your repository has Makefile.PL in the root:
84
73
85
-
If neither Module::Build nor EUMM build files are found, Travis CI will fall back to running
74
+
```bash
75
+
perl Makefile.PL && make test
76
+
```
86
77
87
-
```bash
88
-
make test
89
-
```
78
+
* if neither is found:
90
79
91
-
It is possible to override test command as described in the [general build configuration](/user/customizing-the-build/) guide.
80
+
```bash
81
+
make test
82
+
```
92
83
93
84
## Dependency Management
94
85
95
-
### Travis CI uses cpanm
96
-
97
-
By default Travis CI use `cpanm` to manage your project's dependencies. It is possible to override dependency installation command as described in the [general build configuration](/user/customizing-the-build/) guide.
98
-
99
-
The exact default command is
86
+
By default Travis CI use `cpanm` to manage your project's dependencies.
100
87
101
88
```bash
102
89
cpanm --quiet --installdeps --notest .
103
90
```
104
91
105
-
### When Overriding Build Commands, Do Not Use sudo
92
+
### When Overriding Build Commands, Do Not Use `sudo`
106
93
107
-
When overriding `install:` key to tweak dependency installation command (for example, to run cpanm with verbosity flags), do not use sudo.
108
-
Travis CI Environment has Perls installed via Perlbrew in non-privileged user $HOME directory. Using sudo will result in dependencies
109
-
being installed in unexpected (for Travis CI Perl builder) locations and they won't load.
94
+
When overriding `install:` key to tweak dependency installation command (for
95
+
example, to run cpanm with verbosity flags), do not use `sudo`. Travis CI
96
+
Environment has Perls installed via Perlbrew in non-privileged user's `$HOME`
97
+
directory. Using `sudo` will result in dependencies being installed in unexpected
98
+
(for Travis CI Perl builder) locations and they won't load.
110
99
111
100
## Build Matrix
112
101
113
102
For Perl projects, `env` and `perl` can be given as arrays
114
103
to construct a build matrix.
115
104
116
-
## Environment Variable
105
+
## Environment Variables
117
106
118
-
The version of Perl a job is using is available as:
119
-
120
-
```
121
-
TRAVIS_PERL_VERSION
122
-
```
107
+
The version of Perl a job is using is available as `TRAVIS_PERL_VERSION`.
Copy file name to clipboardExpand all lines: user/reference/precise.md
+7-20Lines changed: 7 additions & 20 deletions
Original file line number
Diff line number
Diff line change
@@ -77,7 +77,7 @@ to accommodate projects that may need one of those runtimes during the build.
77
77
78
78
Language-specific workers have multiple runtimes for their respective language (for example, Ruby workers have about 10 Ruby versions/implementations).
79
79
80
-
### Databases
80
+
### Data Stores
81
81
82
82
- MySQL
83
83
- PostgreSQL
@@ -244,31 +244,18 @@ Scons
244
244
245
245
## Perl VM images
246
246
247
-
### Perl versions
248
-
249
247
Perl versions are installed via [Perlbrew](http://perlbrew.pl/).
250
-
Those runtimes that end with the `-extras` suffix have been compiled with
251
-
`-Duseshrplib`and `-Duseithreads` flags.
252
-
These also have aliases with the `-shrplib` suffix.
0 commit comments