chef-sugar 3.6.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: '09a4806c8e6896ab3ab09faf047ce442aa01dc56'
-  data.tar.gz: 149b614267fa4f7ce0872c8aa229cfd57996872a
+SHA256:
+  metadata.gz: dd1b41f119b41a34d47609f912c519e23685e7b5eca55f478a5ddfea4451ae6f
+  data.tar.gz: 752a3dbe7c9a053a3601898e3573e55fa014a2d51939de993d0cd82d8ada7826
 SHA512:
-  metadata.gz: a1598f00e0c1153e2aac52cc7ff3c6f0e1bb966f4fc8a801292ac7f65049563cf935d18fb95aa57d1775096be02cd92c470e65c6fc04655b4614bd97eced6312
-  data.tar.gz: 8f2a0b21bfced7369184e87fd90ff059f5061eb45bcade2d97b6ba9c86c8b8526e9e728cfecbc9a3618bb457703ea1f40c35e6f1270bb980120ac6d1917545b9
+  metadata.gz: 2790325f88839809491ab60f7f269cf61e58789281bd6598b29d753b338ced290daf437e196c25250adb3fa23e92c425e393a8308c939cabee1dc06f18078cae
+  data.tar.gz: a9369e0cab82f26db49b63fd80f521323520aa1acbccf30a26d3328970f9623c7ccb1e871fc3d7479d105531748b7562ca09439e2dd3809e575d7cb151be38fa

data/.kitchen.yml

@@ -6,8 +6,8 @@ provisioner:
   deprecations_as_errors: true
 
 platforms:
-  - name: centos-6.8
-  - name: centos-7.3
+  - name: centos-6
+  - name: centos-7
   - name: ubuntu-14.04
   - name: ubuntu-16.04
 

data/.travis.yml

@@ -1,10 +1,10 @@
 sudo: false
 
 rvm:
-  - 2.1.9
-  - 2.2.6
-  - 2.3.1
-  - 2.4.0
+  - 2.2.9
+  - 2.3.6
+  - 2.4.3
+  - 2.5.0
 
 branches:
   only:

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 This file is used to list changes made in each version of the chef-sugar cookbook and gem.
 
+## v4.0.0 (2018-01-26)
+
+- Require Ruby 2.2 or later and Chef 12.10 or later
+- Cookbook now installs the chef-sugar gem via a metadata installation so chef-sugar::default on your runlist is no longer needed
+- Added additional metadata to the cookbook: supports, issue_url, source_url, chef_version.
+- Requirements improved in the readme
+
 ## v3.6.0 (2017-10-26)
 
 - Add Ubuntu zesty and debian stretch detection

data/README.md

@@ -1,16 +1,27 @@
-Chef Sugar
-==========
-[![Gem Version](http://img.shields.io/gem/v/chef-sugar.svg?style=flat-square)][gem]
-[![Build Status](http://img.shields.io/travis/sethvargo/chef-sugar.svg?style=flat-square)][travis]
+# Chef Sugar
 
-[gem]: https://rubygems.org/gems/chef-sugar
-[travis]: http://travis-ci.org/sethvargo/chef-sugar
+[![Gem Version](http://img.shields.io/gem/v/chef-sugar.svg?style=flat-square)][gem] [![Build Status](http://img.shields.io/travis/sethvargo/chef-sugar.svg?style=flat-square)][travis]
 
 Chef Sugar is a Gem & Chef Recipe that includes series of helpful syntactic sugars on top of the Chef core and other resources to make a cleaner, more lean recipe DSL, enforce DRY principles, and make writing Chef recipes an awesome and fun experience!
 
-Installation
-------------
-If you want to develop/hack on chef-sugar, please see the Contributing.md.
+## Requirements
+
+### Platforms
+
+- any platform
+
+
+### Chef
+
+- Chef 12.10+
+
+### Cookbooks
+
+- none
+
+## Installation
+
+If you want to develop/hack on chef-sugar, please see the CONTRIBUTING.md.
 
 If you are using Berkshelf, add `chef-sugar` to your `Berksfile`:
 
@@ -24,20 +35,14 @@ Otherwise, you can use `knife` or download the tarball directly from the communi
 knife cookbook site install chef-sugar
 ```
 
+## Usage
 
-Usage
------
-In order to use Chef Sugar in your Chef Recipes, you'll first need to include it:
-
-```ruby
-include_recipe 'chef-sugar::default'
-```
-
-Alternatively you can put it in a base role or recipe and it will be included subsequently.
+Simply depend on this cookbook in the metadata of your cookbook and the gem will be installed and required..
 
 Requiring the Chef Sugar Gem will automatically extend the Recipe DSL, `Chef::Resource`, and `Chef::Provider` with helpful convenience methods.
 
 ### Module Method
+
 If you are working outside of the Recipe DSL, you can use the module methods instead of the Recipe DSL. In general, the module methods have the same name as their Recipe-DSL counterparts, but require the node object as a parameter. For example:
 
 In a Recipe:
@@ -67,12 +72,12 @@ def only_on_windows(&block)
 end
 ```
 
+## API
 
-API
----
 **Note:** For the most extensive API documentation, please see the YARD documentation.
 
 ### Architecture
+
 **Note:** Some of the architecture commands begin with an underscore (`_`) because Ruby does not permit methods to start with a numeric.
 
 - `_64_bit?`
@@ -84,6 +89,7 @@ API
 - `powerpc?`
 
 #### Examples
+
 ```ruby
 execute 'build[my binary]' do
   command '...'
@@ -92,6 +98,7 @@ end
 ```
 
 ### Cloud
+
 - `azure?`
 - `cloud?`
 - `digitalocean?`
@@ -105,6 +112,7 @@ end
 - `softlayer?`
 
 #### Examples
+
 ```ruby
 template '/tmp/config' do
   variables(
@@ -115,6 +123,7 @@ end
 ```
 
 ### Core Extensions
+
 **Note:** Core extensions are **not** included by default. You must require the `chef/sugar/core_extensions` module manually to gain access to these APIs:
 
 ```ruby
@@ -127,6 +136,7 @@ require 'chef/sugar/core_extensions'
 - `Object#blank?`
 
 #### Examples
+
 ```ruby
 # Checking version constraints
 '1.0.0'.satisfies?('~> 1.0') #=> true
@@ -140,11 +150,13 @@ require 'chef/sugar/core_extensions'
 ```
 
 ### Data Bag
+
 - `encrypted_data_bag_item` - a handy DSL method for loading encrypted data bag items the same way you load a regular data bag item; this requires `Chef::Config[:encrypted_data_bag_secret]` is set!
 - `encrypted_data_bag_item_for_environment` - find the encrypted data bag entry for the current node's Chef environment.
 - `data_bag_item_for_environment` - find the data bag entry for the current node's Chef environment.
 
 #### Examples
+
 ```ruby
 encrypted_data_bag_item('accounts', 'hipchat')
 ```
@@ -158,11 +170,13 @@ data_bag_item_for_environment('accounts', 'github')
 ```
 
 ### Docker
+
 Chef Sugar looks for hints to see if the node being converged is a Docker container. When [Ohai supports checking other nodes](https://github.com/opscode/ohai/pull/428), Chef Sugar will automatically pick up the information.
 
 - `docker?`
 
 #### Examples
+
 ```ruby
 template '/runme' do
   only_if { docker?(node) }
@@ -170,6 +184,7 @@ end
 ```
 
 ### Attributes
+
 Chef Sugar adds more Chef-like DSL to attribute definitions. Instead of using the Ruby hash syntax, you can define attributes using nested namespaces. This DSL may be more friendly to non-Ruby developers. It can safely be mixed-and-matched with the standard syntax.
 
 ```ruby
@@ -198,11 +213,13 @@ end
 ```
 
 ### Constraints
+
 - `constraints` - create a new constraint (or requirement) that can be used to test version validations.
 - `chef_version` - (DSL only) a wrapper for `version(Chef::VERSION)`
 - `version` - create a new version that can be used to test constraint validation.
 
 #### Examples
+
 ```ruby
 # Check if a version is satisfied by a constraint
 version('1.2.3').satisfies?('~> 1.2.0')
@@ -227,14 +244,18 @@ end
 ```
 
 ### Kernel
+
 - `require_chef_gem` - "safely" require a gem. Loading a gem with Chef is sometimes difficult and confusing. The errors that Chef produces are also sometimes not very intuitive. In the event you require a gem to exist on the system, you can use `require_chef_gem`, which will attempt to require the gem and then produce helpful output if the gem is not installed:
 
-        Chef could not load the gem `#{name}'! You may need to install the gem
-        manually with `gem install #{name}', or include a recipe before you can
-        use this resource. Please consult the documentation for this cookbook
-        for proper usage.
+  ```
+    Chef could not load the gem `#{name}'! You may need to install the gem
+    manually with `gem install #{name}', or include a recipe before you can
+    use this resource. Please consult the documentation for this cookbook
+    for proper usage.
+  ```
 
 #### Examples
+
 ```ruby
 # LWRP
 require_chef_gem 'pry'
@@ -251,11 +272,13 @@ end
 ```
 
 ### Init
+
 - `systemd?` - detect if init system is systemd
 - `upstart?` - detect if init system is upstart
 - `runit?` - detect if init system is runit
 
 #### Examples
+
 ```ruby
 systemd_service 'my-service' do
   description 'My Service'
@@ -276,9 +299,11 @@ end
 ```
 
 ### IP
+
 - `best_ip_for` - determine the best IP address for the given "other" node, preferring local IP addresses over public ones.
 
 #### Examples
+
 ```ruby
 redis = search('node', 'role:redis').first
 
@@ -298,6 +323,7 @@ Additional methods for the `node` object
 - `in?` - determine if the node is in the given Chef environment.
 
 #### Examples
+
 ```ruby
 credentials = if node.in?('production')
                 Chef::EncryptedDataBag.new('...')
@@ -311,6 +337,7 @@ node.deep_fetch('apache2', 'config', 'root') => node['apache2']['config']['root'
 ```
 
 ### Platform
+
 - `amazon_linux?`
 - `centos?`
 - `linux_mint?`
@@ -326,7 +353,7 @@ node.deep_fetch('apache2', 'config', 'root') => node['apache2']['config']['root'
 - `nexus?`
 - `ios_xr?`
 
-There are also a series of dynamically defined matchers that map named operating system release versions and comparison operators in the form "#{platform}\_#{operator}\_#{name}?". For example:
+There are also a series of dynamically defined matchers that map named operating system release versions and comparison operators in the form "#{platform}_#{operator}_#{name}?". For example:
 
 - `debian_after_squeeze?`
 - `linuxmint_after_or_at_olivia?`
@@ -344,6 +371,7 @@ puts Chef::Sugar::Platform.instance_methods
 ```
 
 #### Examples
+
 ```ruby
 if ubuntu?
   execute 'apt-get update'
@@ -351,6 +379,7 @@ end
 ```
 
 ### Platform Family
+
 - `arch_linux?`
 - `debian?`
 - `fedora?`
@@ -366,6 +395,7 @@ end
 - `wrlinux?`
 
 #### Examples
+
 ```ruby
 node['attribute'] = if windows?
                       'C:\Foo\BarDrive'
@@ -375,17 +405,20 @@ node['attribute'] = if windows?
 ```
 
 ### Ruby
+
 **Note:** The applies to the Ruby found at `node['languages']['ruby']`.
 
 - `ruby_20?`
 - `ruby_19?`
 
 #### Examples
+
 ```ruby
 log 'This has been known to fail on Ruby 2.0' if ruby_20?
 ```
 
 ### Run Context
+
 - `includes_recipe?` - determines if the current run context includes the recipe
 
 ```ruby
@@ -397,6 +430,7 @@ end
 ```
 
 ### Shell
+
 - `which`
 - `dev_null`
 - `installed?`
@@ -404,6 +438,7 @@ end
 - `version_for`
 
 #### Examples
+
 ```ruby
 log "Using `mongo` at `#{which('mongo')}`"
 
@@ -420,9 +455,11 @@ log "Skipping git install, version is at #{version_for('mongo', '-v')}"
 ```
 
 ### Vagrant
+
 - `vagrant?`
 
 #### Examples
+
 ```ruby
 http_request 'http://...' do
   not_if { vagrant? }
@@ -430,6 +467,7 @@ end
 ```
 
 ### Virtualization
+
 - `kvm?`
 - `lxc?`
 - `virtualbox?`
@@ -437,6 +475,7 @@ end
 - `openvz?`
 
 #### Examples
+
 ```ruby
 service 'ntpd' do
   action [:enable, :start]
@@ -445,11 +484,13 @@ end
 ```
 
 ### Filters
+
 - `at_compile_time` - accepts a block of resources to run at compile time
 - `before` - insert resource in the collection before the given resource
 - `after` - insert resource in the collection after the given resource
 
 #### Examples
+
 ```ruby
 at_compile_time do
   package 'apache2'
@@ -473,9 +514,8 @@ after 'service[apache2]' do
 end
 ```
 
+## License & Authors
 
-License & Authors
------------------
 - Author: Seth Vargo (sethvargo@gmail.com)
 
 ```text
@@ -493,3 +533,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 ```
+
+[gem]: https://rubygems.org/gems/chef-sugar
+[travis]: http://travis-ci.org/sethvargo/chef-sugar

data/chef-sugar.gemspec

@@ -17,7 +17,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/sethvargo/chef-sugar'
   spec.license       = 'Apache 2.0'
 
-  spec.required_ruby_version = '>= 2.1'
+  spec.required_ruby_version = '>= 2.2.2'
 
   spec.files         = `git ls-files`.split($/)
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
@@ -25,10 +25,9 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_development_dependency 'bundler', '~> 1.3'
-  spec.add_development_dependency 'rack', '~> 1.6'
   spec.add_development_dependency 'rake'
 
-  spec.add_development_dependency 'chefspec',        '~> 4.2'
-  spec.add_development_dependency 'test-kitchen',    '~> 1.3'
-  spec.add_development_dependency 'kitchen-vagrant', '~> 0.15'
+  spec.add_development_dependency 'chefspec'
+  spec.add_development_dependency 'test-kitchen'
+  spec.add_development_dependency 'kitchen-vagrant'
 end

data/lib/chef/sugar/version.rb

@@ -16,6 +16,6 @@
 
 class Chef
   module Sugar
-    VERSION = '3.6.0'
+    VERSION = '4.0.0'
   end
 end

data/libraries/chef-sugar.rb

@@ -1 +1 @@
-require "chef-sugar" if Gem::Requirement.new(">= 12.10.48").satisfied_by?(Gem::Version.new(Chef::VERSION))
+require "chef/sugar"

data/metadata.rb

@@ -1,7 +1,7 @@
 name             'chef-sugar'
 maintainer       'Seth Vargo'
 maintainer_email 'sethvargo@gmail.com'
-license          'Apache 2.0'
+license          'Apache-2.0'
 description      'Installs chef-sugar. Please see the chef-sugar ' \
                  'Ruby gem for more information.'
 long_description <<-EOH
@@ -17,4 +17,8 @@ EOH
 require          File.expand_path('../lib/chef/sugar/version', __FILE__)
 version          Chef::Sugar::VERSION
 
-gem "chef-sugar" if Gem::Requirement.new(">= 12.10.48").satisfied_by?(Gem::Version.new(Chef::VERSION))
+supports     'any'
+issues_url   'https://github.com/sethvargo/chef-sugar/issues'
+source_url   'https://github.com/sethvargo/chef-sugar'
+chef_version '>= 12.10.48' if respond_to?(:chef_version)
+gem          'chef-sugar'

data/recipes/default.rb

@@ -17,18 +17,4 @@
 # limitations under the License.
 #
 
-gem_version = run_context.cookbook_collection[cookbook_name].metadata.version
-
-if Chef::Resource::ChefGem.instance_methods(false).include?(:compile_time)
-  chef_gem 'chef-sugar' do
-    version gem_version
-    compile_time true
-  end
-else
-  chef_gem 'chef-sugar' do
-    version gem_version
-    action :nothing
-  end.run_action(:install)
-end
-
-require 'chef/sugar'
+Chef::Log.warn('chef-sugar::default no longer needs to be included in your runlist. Instead simply depend on the chef-sugar cookbook and the gem will be intalled and loaded automatically.')

data/spec/unit/recipes/default_spec.rb

@@ -1,10 +1,9 @@
 require 'spec_helper'
 
 describe 'chef-sugar::default' do
-  let(:chef_run) { ChefSpec::SoloRunner.converge(described_recipe) }
+  let(:chef_run) { ChefSpec::SoloRunner.new(platform: 'ubuntu', version: '16.04').converge(described_recipe) }
 
-  it 'installs the chef gem' do
-    expect(chef_run).to install_chef_gem('chef-sugar')
-      .with(version: Chef::Sugar::VERSION)
+  it 'converges successfully' do
+    expect { :chef_run }.to_not raise_error
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chef-sugar
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Seth Vargo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-26 00:00:00.000000000 Z
+date: 2018-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -24,20 +24,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
-- !ruby/object:Gem::Dependency
-  name: rack
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -56,44 +42,44 @@ dependencies:
   name: chefspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4.2'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4.2'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: test-kitchen
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: kitchen-vagrant
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '0'
 description: A series of helpful sugar of the Chef core and other resources to make
   a cleaner, more lean recipe DSL, enforce DRY principles, and make writing Chef recipes
   an awesome experience!
@@ -176,7 +162,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.1'
+      version: 2.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -184,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.7.4
 signing_key: 
 specification_version: 4
 summary: A collection of helper methods and modules that make working with Chef recipes