diff options
author | Josh Cooper <josh+github@puppetlabs.com> | 2012-03-06 17:14:35 -0800 |
---|---|---|
committer | Josh Cooper <josh+github@puppetlabs.com> | 2012-03-06 17:14:35 -0800 |
commit | 63834354c2c2ed56a01c8ff3d898c62d53551de1 (patch) | |
tree | 2b835293d04bde1be382a0a92f8b6fda763804dd /README_DEVELOPER.markdown | |
parent | 32bad79d88e4464cb91101e4671874c11f3e5bf2 (diff) | |
parent | 369f7304310f8cff7d3c0cb81932aa8be1488ac2 (diff) | |
download | puppet-stdlib-63834354c2c2ed56a01c8ff3d898c62d53551de1.tar.gz puppet-stdlib-63834354c2c2ed56a01c8ff3d898c62d53551de1.tar.bz2 |
Merge pull request #44 from jeffmccune/ticket/2.3.x/12357_add_puppet_settings_facts
(#12357) Make facter_dot_d look in Puppet[:confdir]/facts.d
Diffstat (limited to 'README_DEVELOPER.markdown')
-rw-r--r-- | README_DEVELOPER.markdown | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/README_DEVELOPER.markdown b/README_DEVELOPER.markdown new file mode 100644 index 0000000..e8aa27a --- /dev/null +++ b/README_DEVELOPER.markdown @@ -0,0 +1,35 @@ +Puppet Specific Facts +===================== + +Facter is meant to stand alone and apart from Puppet. However, Facter often +runs inside Puppet and all custom facts included in the stdlib module will +almost always be evaluated in the context of Puppet and Facter working +together. + +Still, we don't want to write custom facts that blow up in the users face if +Puppet is not loaded in memory. This is often the case if the user run +`facter` without also supplying the `--puppet` flag. + +Ah! But Jeff, the custom fact won't be in the `$LOAD_PATH` unless the user +supplies `--facter`! You might say... + +Not (always) true I say! If the user happens to have a CWD of +`<modulepath>/stdlib/lib` then the facts will automatically be evaluated and +blow up. + +In any event, it's pretty easy to write a fact that has no value if Puppet is +not loaded. Simply do it like this: + + Facter.add(:node_vardir) do + setcode do + # This will be nil if Puppet is not available. + Facter::Util::PuppetSettings.with_puppet do + Puppet[:vardir] + end + end + end + +The `Facter::Util::PuppetSettings.with_puppet` method accepts a block and +yields to it only if the Puppet library is loaded. If the Puppet library is +not loaded, then the method silently returns `nil` which Facter interprets as +an undefined fact value. The net effect is that the fact won't be set. |