Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sous-chefs/perl
Development repository for the perl cookbook
https://github.com/sous-chefs/perl
chef chef-cookbook chef-resource hacktoberfest managed-by-terraform perl
Last synced: 3 months ago
JSON representation
Development repository for the perl cookbook
- Host: GitHub
- URL: https://github.com/sous-chefs/perl
- Owner: sous-chefs
- License: apache-2.0
- Created: 2012-03-14T18:18:42.000Z (almost 13 years ago)
- Default Branch: main
- Last Pushed: 2024-02-01T11:57:43.000Z (about 1 year ago)
- Last Synced: 2024-04-14T06:09:21.409Z (10 months ago)
- Topics: chef, chef-cookbook, chef-resource, hacktoberfest, managed-by-terraform, perl
- Language: Ruby
- Homepage: https://supermarket.chef.io/cookbooks/perl
- Size: 343 KB
- Stars: 52
- Watchers: 57
- Forks: 60
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# perl Cookbook
[](https://supermarket.chef.io/cookbooks/perl)
[](https://github.com/sous-chefs/perl/actions?query=workflow%3Aci)
[](#backers)
[](#sponsors)
[](https://opensource.org/licenses/Apache-2.0)
Manages Perl installation and provides `cpan_module`, to install modules from... CPAN.
## Maintainers
This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit [sous-chefs.org](https://sous-chefs.org/) or come chat with us on the Chef Community Slack in [#sous-chefs](https://chefcommunity.slack.com/messages/C2V7B88SF).
## Requirements
### Platforms
- Debian/Ubuntu/Mint
- RHEL/CentOS/Scientific/Amazon/Oracle
- Fedora
- openSUSE
- Windows
### Chef
- Chef 13.4+
### Cookbooks
- none
## Recipes
- `default` - On Linux installs perl packages and pulls cpanm from Github. On Windows installs the Strawberry Perl Chocolatey package. Requires Chocolatey to be installed prior to running this cookbook, which can be done with the [chocolatey cookbook](https://supermarket.chef.io/cookbooks/chocolatey) from the Supermarket.
## Attributes
The cookbook ships with a sane set of platform specific attributes for installing perl as well as cpanm. There _should_ be no need to modify these attributes to use this cookbook.
- `node['perl']['packages']` - platform specific packages installed by default recipe
- `node['perl']['cpanm']['path']` - platform specific path for `cpanm` binary to live
- `node['perl']['cpanm']['url']` - URL to download cpanm script from (*nix only)
- `node['perl']['cpanm']['checksum']` - checksum for the above remote file (*nix only)
- `node['perl']['version']` - version of perl to install. (windows only)
- `node['perl']['cpanm']['path']` - The path to the cpanm binary. On *nix systems this is where the file will be installed. On Windows it's part of Strawberry Perl so no additional installation is required.
- `node['perl']['cpanm']['suppress_diff']` - Whether or not to suppress the diff of the cpanm file.
## Resources
### cpan_module
#### Actions
- `:install` - install the module (default action)
- `:uninstall` - uninstall the module
#### Properties
- `module_name` - The name of the module if it's different than the name of the resource property
- `force` - To force the install within cpanm (default: false)
- `test` - To do a test install (default: false)
- `version` - Any version string cpanm would find acceptable
- `cwd` - A path to change into before running cpanm
#### Examples
To install a module from CPAN:
```ruby
cpan_module 'App::Munchies'
```
Optionally, installation can forced with the 'force' parameter.
```ruby
cpan_module 'App::Munchies'
force true
end
```
You can also use [cpanm's version mechanism](http://search.cpan.org/~miyagawa/App-cpanminus-1.7027/bin/cpanm#COMMANDS) to grab a specific version, or glob a version.
Exactly version 1.01 of `App::Munchies` will be installed:
```ruby
cpan_module 'App::Munchies'
version '== 1.01'
end
```
At least version 1.01 of `App::Munchies` will be installed:
```ruby
cpan_module 'App::Munchies'
version '1.01'
end
```
At least version 1.01 will be installed, but not version 2:
```ruby
cpan_module 'App::Munchies'
version '>= 1.01, < 2.0'
end
```
Additionally, you can use the `cpan_module` LWRP to delete a given package (uses cpanm's `--uninstall` param)
```ruby
cpan_module 'App::Munchies'
action :uninstall
end
```
## Contributors
This project exists thanks to all the people who [contribute.](https://opencollective.com/sous-chefs/contributors.svg?width=890&button=false)
### Backers
Thank you to all our backers!
### Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.
