Add boxcutter_ros::build_essential and boxcutter_ros::dev_tools

Author: taylorific

cookbooks/boxcutter_ros/Policyfile.rb

@@ -12,6 +12,10 @@
 
 # run_list: chef-client will run these recipes in the order specified.
 run_list 'boxcutter_ohai', 'boxcutter_init', 'boxcutter_ros_test::default'
+named_run_list 'boxcutter_ros_test_build_essential',
+               'boxcutter_ohai', 'boxcutter_init', 'boxcutter_ros_test::build_essential'
+named_run_list 'boxcutter_ros_test_dev_tools',
+               'boxcutter_ohai', 'boxcutter_init', 'boxcutter_ros_test::dev_tools'
 
 # Specify a custom source for a single cookbook:
 cookbook 'boxcutter_ros', path: '.'

cookbooks/boxcutter_ros/kitchen.yml

@@ -69,3 +69,17 @@ suites:
       inspec_tests:
         - test/integration/default
     attributes:
+
+  - name: build_essential
+    named_run_list: boxcutter_ros_test_build_essential
+    verifier:
+      inspec_tests:
+        - test/integration/build_essential
+    attributes:
+
+  - name: dev_tools
+    named_run_list: boxcutter_ros_test_dev_tools
+    verifier:
+      inspec_tests:
+        - test/integration/dev_tools
+    attributes:

cookbooks/boxcutter_ros/recipes/build_essential.rb

@@ -0,0 +1,36 @@
+#
+# Cookbook:: boxcutter_ros
+# Recipe:: build_essential
+#
+# Copyright:: 2025, Boxcutter
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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.
+
+# Includes only the packages that are required for building standalone ROS 2
+# packages. ROS developers should use ros::dev_tools instead for the full set
+# of recommended tools.
+
+unless node.ubuntu?
+  raise 'boxcutter_ros is only supported onUbuntu.'
+end
+
+%w(
+  build-essential
+  cmake
+  git
+  python3-pip
+).each do |pkg|
+  package pkg do
+    action :upgrade
+  end
+end

cookbooks/boxcutter_ros/recipes/dev_tools.rb

@@ -0,0 +1,34 @@
+#
+# Cookbook:: boxcutter_ros
+# Recipe:: dev_tools
+#
+# Copyright:: 2025, Boxcutter
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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.
+
+unless node.ubuntu?
+  raise 'boxcutter_ros is only supported onUbuntu.'
+end
+
+include_recipe 'boxcutter_ros::common'
+include_recipe 'boxcutter_ros::build_essential'
+
+%w(
+  python3-colcon-common-extensions
+  python3-vcstool
+  python3-rosdep
+).each do |pkg|
+  package pkg do
+    action :upgrade
+  end
+end

cookbooks/boxcutter_ros/spec/unit/recipes/build_essential_spec.rb

@@ -0,0 +1,41 @@
+#
+# Cookbook:: boxcutter_ros
+# Spec:: build_essential
+#
+# Copyright:: 2025, Boxcutter
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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.
+
+require 'spec_helper'
+
+describe 'boxcutter_ros::build_essential' do
+  context 'When all attributes are default, on Ubuntu 20.04' do
+    # for a complete list of available platforms and versions see:
+    # https://github.com/chefspec/fauxhai/blob/main/PLATFORMS.md
+    platform 'ubuntu', '20.04'
+
+    it 'converges successfully' do
+      expect { chef_run }.to_not raise_error
+    end
+  end
+
+  context 'When all attributes are default, on CentOS 8' do
+    # for a complete list of available platforms and versions see:
+    # https://github.com/chefspec/fauxhai/blob/main/PLATFORMS.md
+    platform 'centos', '8'
+
+    it 'converges successfully' do
+      expect { chef_run }.to_not raise_error
+    end
+  end
+end

cookbooks/boxcutter_ros/spec/unit/recipes/dev_tools_spec.rb

@@ -0,0 +1,41 @@
+#
+# Cookbook:: boxcutter_ros
+# Spec:: dev_tools
+#
+# Copyright:: 2025, Boxcutter
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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.
+
+require 'spec_helper'
+
+describe 'boxcutter_ros::dev_tools' do
+  context 'When all attributes are default, on Ubuntu 20.04' do
+    # for a complete list of available platforms and versions see:
+    # https://github.com/chefspec/fauxhai/blob/main/PLATFORMS.md
+    platform 'ubuntu', '20.04'
+
+    it 'converges successfully' do
+      expect { chef_run }.to_not raise_error
+    end
+  end
+
+  context 'When all attributes are default, on CentOS 8' do
+    # for a complete list of available platforms and versions see:
+    # https://github.com/chefspec/fauxhai/blob/main/PLATFORMS.md
+    platform 'centos', '8'
+
+    it 'converges successfully' do
+      expect { chef_run }.to_not raise_error
+    end
+  end
+end

cookbooks/boxcutter_ros/test/cookbooks/boxcutter_ros_test/recipes/build_essential.rb

@@ -0,0 +1,5 @@
+#
+# Cookbook:: polymath_ros_test
+# Recipe:: build_essential
+#
+include_recipe 'boxcutter_ros::build_essential'

cookbooks/boxcutter_ros/test/cookbooks/boxcutter_ros_test/recipes/dev_tools.rb

@@ -0,0 +1 @@
+include_recipe 'boxcutter_ros::dev_tools'

cookbooks/boxcutter_ros/test/integration/build_essential/build_essential_test.rb

@@ -0,0 +1,15 @@
+# Chef InSpec test for recipe polymath_ros::build_essential
+
+# The Chef InSpec reference, with examples and extensive documentation, can be
+# found at https://docs.chef.io/inspec/resources/
+
+%w(cmake git python3).each do |tool|
+  describe command("which #{tool}") do
+    its('exit_status') { should eq 0 }
+    its('stdout') { should match %r{^/} }  # should return a path like /usr/bin/git
+  end
+
+  describe command("#{tool} --version") do
+    its('exit_status') { should eq 0 }
+  end
+end

cookbooks/boxcutter_ros/test/integration/default/build_essential_test.rb

@@ -0,0 +1,16 @@
+# Chef InSpec test for recipe boxcutter_ros::build_essential
+
+# The Chef InSpec reference, with examples and extensive documentation, can be
+# found at https://docs.chef.io/inspec/resources/
+
+unless os.windows?
+  # This is an example test, replace with your own test.
+  describe user('root'), :skip do
+    it { should exist }
+  end
+end
+
+# This is an example test, replace it with your own test.
+describe port(80), :skip do
+  it { should_not be_listening }
+end