facter 3.12.2.cfacter.20181217 → 4.0.7.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 364520fb97a986c1682b878a85b491f6ab50c5da1ba5a74bf782636b7c29e890
-  data.tar.gz: 07c221de09300211796b4cdec443ca96486da6df7368687ad4b74869ab221188
+  metadata.gz: 2a95b579c2d3ee03ac3fbf5cb0425502f3e18e33c5e434209c0ed0c71f2accd9
+  data.tar.gz: 790cb477add917be240ffff97c31b276a481e1e5e65748422efbf7a33a4ef10a
 SHA512:
-  metadata.gz: 49033dc14634dce2a4c1a2c1c37f919fe6ac9d7f3d0cf4cf48e5038b7708e3fc11d4a9e1488249443198fc635f4080976b33d637ba25dc97efabde957258f004
-  data.tar.gz: 260954f857485b92e261a04978d6447c844bc4f3af2d1d023afd13104aa6844240d7521d7557fbf54a21c423f0795db29a3f6f400e604df1836602da5ca42885
+  metadata.gz: d12e9913d3a16d3997b0c4a21f5876e4c96e27fc2dfb0f3b33d777fc04c37930a41a2b81edbfe35d2b9921441b5da78ca8825aa1b210321e589fb18013de16a2
+  data.tar.gz: a57c800847dd860b39e24f11742655aa1deeea5a62e816386e0d9487b0dec0a61f23849fab4e57dc7a6c8d1f2c7f7e9169932077a422787462ae2511ceec1f6e

data/.gitignore

@@ -0,0 +1,56 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+## Logs
+*.log
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+.rspec_status
+Gemfile.lock

data/.jrubyrc

@@ -0,0 +1,2 @@
+cli.debug=true
+debug.fullTrace=true

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,122 @@
+Documentation:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/ModuleLength:
+  Exclude:
+    - 'lib/facter-ng.rb'
+
+Metrics/MethodLength:
+  Max: 20
+  Exclude:
+    - 'lib/custom_facts/util/values.rb'
+    - 'lib/custom_facts/util/confine.rb'
+    - 'lib/custom_facts/core/execution/windows.rb'
+    - 'lib/custom_facts/core/execution/base.rb'
+
+Metrics/ModuleLength:
+  Max: 100
+  Exclude:
+    - 'lib/facter.rb'
+
+Metrics/BlockLength:
+  Exclude:
+    - !ruby/regexp /(?:(?!.+_spec.rb).)*$/
+Style/ClassVars:
+  Exclude:
+    - !ruby/regexp /(?:(?!.+_resolver.rb).)*$/
+Naming/ClassAndModuleCamelCase:
+  Exclude:
+    - 'spec/mocks/**/*'
+
+Metrics/AbcSize:
+  Exclude:
+    - 'spec/custom_facts/util/parser_spec.rb'
+    - 'spec/custom_facts/core/logging_spec.rb'
+    - 'lib/custom_facts/util/values.rb'
+    - 'lib/custom_facts/util/loader.rb'
+    - 'lib/custom_facts/util/confine.rb'
+    - 'lib/custom_facts/util/confine.rb'
+    - 'lib/custom_facts/core/execution/windows.rb'
+    - 'lib/custom_facts/core/execution/base.rb'
+
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - 'spec/custom_facts/util/normalization_spec.rb'
+    - 'spec/custom_facts/shared_contexts/platform.rb'
+    - 'spec/custom_facts/core/execution/windows_spec.rb'
+    - 'spec/custom_facts/core/execution/posix_spec.rb'
+    - 'lib/custom_facts/util/resolution.rb'
+    - 'lib/custom_facts/core/execution/windows.rb'
+    - 'lib/custom_facts/core/execution/posix.rb'
+
+Style/CaseEquality:
+  Exclude:
+    - 'spec/custom_facts/util/confine_spec.rb'
+    - 'lib/custom_facts/util/confine.rb'
+
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/custom_facts/util/values.rb'
+    - 'lib/custom_facts/util/confine.rb'
+    - 'lib/custom_facts/core/execution/windows.rb'
+    - 'lib/custom_facts/core/execution/posix.rb'
+
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/custom_facts/util/values.rb'
+    - 'lib/custom_facts/util/confine.rb'
+    - 'lib/custom_facts/core/execution/windows.rb'
+    - 'lib/custom_facts/core/execution/posix.rb'
+
+Lint/RescueException:
+  Exclude:
+    - 'lib/custom_facts/util/parser.rb'
+
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/custom_facts/util/fact.rb'
+    - 'lib/resolvers/windows/networking_resolver.rb'
+    - 'lib/custom_facts/util/collection.rb'
+
+Style/DoubleNegation:
+  Exclude:
+    - 'lib/custom_facts/util/confine.rb'
+    - 'lib/custom_facts/util/confine.rb'
+    - 'lib/custom_facts/core/execution/windows.rb'
+    - 'lib/custom_facts/core/execution/posix.rb'
+
+Naming/AccessorMethodName:
+  Exclude:
+    - 'lib/custom_facts/core/suitable.rb'
+
+Style/StderrPuts:
+  Exclude:
+    - 'lib/custom_facts/core/logging.rb'
+
+Style/ModuleFunction:
+  Exclude:
+    - 'lib/custom_facts/core/logging.rb'
+
+Naming/MethodName:
+  Exclude:
+    - 'spec/mocks/**/*'
+
+Naming/PredicateName:
+  Exclude:
+    - 'lib/custom_facts/core/suitable.rb'
+
+Style/MethodMissingSuper:
+  Exclude:
+    - 'lib/facter.rb'
+
+Style/MissingRespondToMissing:
+  Exclude:
+    - 'lib/facter.rb'
+
+Naming/FileName:
+  Exclude:
+    - 'lib/facter.rb'
+    - 'agent/lib/facter-ng.rb'

data/.rubycritic.yml

@@ -0,0 +1,4 @@
+paths: # Files to analyse.
+  - 'lib'
+  - 'bin'
+  - 'config'

data/.travis.yml

@@ -0,0 +1,39 @@
+sudo: false
+language: ruby
+cache:
+  bundler: true
+branches:
+  only:
+    - master
+before_install:
+  - gem update --system --force
+  - gem install bundler
+  - bundle install
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+matrix:
+  include:
+    - rvm: 2.6
+      script:
+        - bundle exec rubocop
+        - bundle exec rubycritic --no-browser -f console
+        - bundle exec rake spec
+
+    - rvm: 2.5
+      script:
+        - bundle exec rake spec
+
+    - rvm: 2.4
+      script:
+        - bundle exec rake spec
+
+    - rvm: 2.3
+      script:
+        - bundle exec rake spec
+
+    - rvm: jruby-head
+      script:
+        - bundle exec rake spec
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT

data/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default to Ghost team
+* @puppetlabs/ghost @puppetlabs/night-s-watch

data/Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+source ENV['GEM_SOURCE'] || 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+gemspec name: 'facter'

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Puppet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,47 @@
+# facter-ng
+
+[![Build Status](https://travis-ci.org/puppetlabs/facter-ng.svg?branch=master)](https://travis-ci.org/puppetlabs/facter-ng?branch=master)
+[![Coverage Status](https://coveralls.io/repos/github/puppetlabs/facter-ng/badge.svg?branch=master)](https://coveralls.io/github/puppetlabs/facter-ng?branch=master)
+[![Maintainability](https://api.codeclimate.com/v1/badges/bf43445f767f2d64170a/maintainability)](https://codeclimate.com/github/puppetlabs/facter-ng/maintainability)
+[<img src="https://img.shields.io/badge/slack-puppet--dev-brightgreen?logo=slack">](https://puppetcommunity.slack.com/messages/C0W1X7ZAL)
+
+Facter is a command-line tool that gathers basic facts about nodes (systems) such as hardware details, network settings, OS type and version, and more. These facts are made available as variables in your Puppet manifests and can be used to inform conditional expressions in Puppet.
+
+## Supported platforms
+* Linux
+* macOS
+* Windows
+* Solaris
+* AIX
+
+## Requirements
+* Ruby 2.3+
+
+## Basic concepts
+The project has three main parts, the framework, facts and resolvers. 
+In the framework we implement functionality that is agnostic of specific facts like parsing user input, formatting output, etc.
+
+Facts are the nuggets of information that will be provided by facter e.g. `os.name`, `networking.interfaces`, etc.
+
+Resolvers have the role of gathering data from the system. 
+For example a resolver can execute a command on the system, can read a file or any operation that retries some data from a single source on the system. 
+
+![Facter user interaction](docs/diagrams/facter_user_interaction.png?raw=true)
+
+## Getting started
+After cloning the project, run `bundle install` to install all dependencies.
+
+You can run facter by executing `./bin/facter`. 
+The command will output all the facts that facter detected for the current os.
+
+In order to generate a fact, we can use the rake task `rake 'create_fact[<os>,<fact_name>]'` e.g. `rake 'create_fact[ubuntu,facterversion]'`
+When generating a fact, the unit test for that fact is also generated. Facts should call on or more resolvers in order to obtain the data they need.
+
+The implementation can be validated locally by running the `./check.sh` script. 
+
+## Goals - fast, easy, compatible
+* Gain performance similar to the C++ version of Facter. We plan to achieve this goal by gathering multiple facts with only one call and by using the faster Win32 API rather than WMI for the Windows implementation. 
+* Facilitate community contribution. At the moment, C++ presents a possible impediment for community contributions. 
+* Enable native integration with other Ruby-based projects such as Bolt and puppet.
+* Enable native integration for custom facts.
+* Provide 100% compatibility with C++ Facter (drop-in replacement).

data/Rakefile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+Dir.glob(File.join('tasks/**/*.rake')).each { |file| load file }
+
+task default: :spec

data/VERSION

@@ -0,0 +1 @@
+4.0.7.pre

data/agent/facter-ng.gemspec

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require_relative '../config/config'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'facter-ng'
+  spec.version       = FACTER_VERSION
+  spec.authors       = ['Puppet']
+  spec.email         = ['team-nw@puppet.com']
+
+  spec.summary       = 'New version of Facter'
+  spec.description   = 'New version of Facter'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = if system('git --help > /dev/null')
+                 `git ls-files -z`.split("\x0")
+               else
+                 Dir.glob('**/*')
+               end
+
+  spec.required_ruby_version = '~> 2.3'
+  spec.files.reject! do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+
+  spec.files.reject! do |f|
+    f == 'bin/facter'
+  end
+
+  spec.bindir = 'bin'
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ['agent/lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'coveralls', '~> 0.8.23'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 0.74.0'
+  spec.add_development_dependency 'rubycritic', '~> 4.1.0'
+
+  spec.add_runtime_dependency 'ffi', '~> 1.9'
+  spec.add_runtime_dependency 'hocon', '~> 1.3'
+  spec.add_runtime_dependency 'sys-filesystem', '~> 1.3' unless Gem.win_platform?
+  spec.add_runtime_dependency 'thor', ['>= 1.0.1', '< 2.0']
+end

data/agent/lib/facter-ng.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+ROOT_DIR = Pathname.new(File.expand_path('../../', __dir__)) unless defined?(ROOT_DIR)
+
+require "#{ROOT_DIR}/lib/facter"

data/bin/facter

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'pathname'
+ROOT_DIR = Pathname.new(File.expand_path('..', __dir__)) unless defined?(ROOT_DIR)
+require "#{ROOT_DIR}/lib/framework/cli/cli_launcher.rb"

data/block_groups.conf

@@ -0,0 +1,14 @@
+{
+  "EC2": [
+    "ec2_metadata",
+    "ec2_userdata"
+  ],
+  "file system" : [
+    "mountpoints",
+    "filesystems",
+    "partitions"
+  ],
+  "hypervisors": [
+    "hypervisors"
+  ]
+}

data/check.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+set -e
+
+# run unit tests
+rspec
+
+# run linting
+rubocop --parallel
+
+# It will be disabled untill we rewrite it's rules
+# rubycritic --no-browser -f console

data/config/config.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'pathname'
+ROOT_DIR = Pathname.new(File.expand_path('..', __dir__)) unless defined?(ROOT_DIR)
+
+FACTER_VERSION = File.read("#{ROOT_DIR}/VERSION").strip