pypuppetdb

Authentication and Query Enhancements:

• Add RBAC authentication #123
• Enhanced query building #115
• Fix Inventory parsing #126
• Update for pytest configuration #120

Bug fixes and PuppetDB 4.2 support

• Fixed noop puppet runs reporting unchanged instead of noop.
• Fixed unreported nodes shown as 'noop' in puppetdb > 4.1.0.
• Add Inventory API endpoint for PuppetDB 4.2.0.
• Support for producer field on catalogs, facts and report types.

https://docs.puppet.com/puppetdb/4.2/release_notes.html#section

This is a bug fix release that address an issue where the datetime calculation of a node's report_timestamp resulted in all nodes to report status 'unreported'

Also included in this release is the new PQL endpoint. This endpoint allows users to submit queries to PuppetDB using PQL as per https://docs.puppet.com/puppetdb/4.1/api/query/v4/pql.html

This is a feature release also including PuppetDB 4.1.0 support.

The main new feature introduces a Query Builder module. With this users will be able to generate queries in an Object-Oriented fashion.

Other updates include:

• PuppetDB 4.1.0 field support

This is a bug fix release from the now removed 0.2.2 release.

• Removing the events variable from :class:pypuppetdb.types.Report since it caused unexpected errors and was not fully tested
• Additional query path parameter values are now URL escaped with urllib.quote to fix #67

This is a backwards compatible release adding support for PuppetDB 4.0 resources. Other changes include:

• Renaming test-requirements.txt to requirements.txt
• Deprecating :func:pypuppetdb.types.Report.events() in favour of the new events :obj:list variable. This function will be removed in the next major release.
• Fixing URL encoding problem when querying fact values by switching from adding the fact name value from the URL path to query string values.

This release features several new features, mostly related to the new features in PuppetDB 3.2 and one independent feature release.

• A new version comparison utility compares 2 values and returns -1 if the first value is less than the second. +1 if the first value is greater than the second, and 0 if the 2 values are equal
• A new field from the PuppetDB Nodes endpoint latest_report_hash is now available in the Node object
  ** The field latest_report_status is also used if available, but preserves noop event counts
• The code_id field from the Catalog endpoint is now available in the Catalog object (current unused in PuppetDB)
• The API now supports POST requests to the PuppetDB endpoint by means of a new keyword argument request_method (Defaults to 'GET')

Introducing full support for the Query API v4, available in PuppetDB 3.x and up.

Because PuppetDB removed Query API versions v2 and v3 this release, too, has removed support for the v2 and v3 apis and therefore is incompatible with PuppetDB < 3.0.

Other updates include:

• Adding new endpoints environments, factsets, fact-paths, fact-contents and edges
• All endpoint functions now accept kwargs that get passed to the query function, enabling support for query paging and other transformations
• The api_version parameter in pypuppetdb.BaseAPI has been removed. Going forward we will not support multiple Query API versions in any release

Due to a fairly serious bug 0.0.3 was pulled from PyPi minutes after release.

When a bug was fixed to be able to query for all facts we accidentally introduced a different bug that caused the facts() call on a node to query for all facts because we were resetting the query.

• Fix a bug where node.facts() was causing us to query all facts because the query to scope our request was being reset.

This release has been pulled from PyPi.

With the introduction of PuppetDB 1.5 a new API version, v3, was also introduced. In that same release the old /experimental endpoints were removed, meaning that as of PuppetDB 1.5 with the v2 API you can no longer get access to reports or events.

In light of this the support for the experimental endpoints has been completely removed from pypuppetdb. As of this release you can only get to reports and/or events through v3 of the API.

This release includes preliminary support for the v3 API. Everything that could be done with v2 plus the experimental endpoints is now possible on v3. However, more advanced funtionality has not yet been implemented. That will be the focus of the next release.

• Removed dependency on pytz.
• Fixed the behaviour of facts() and resources(). We can now correctly query for all facts or resources.
• Fixed an issue with catalog timestampless nodes.
• Pass along the timeout option to connect().
• Added preliminary PuppetDB API v3 support.
• Removed support for the experimental endpoints.
• The connect() method defaults to API v3 now.

• Fixes a rather stupid bug in setup.py preventing successful installation.

This is the first release of pypuppetdb. Though the library works it's not really ready for production.

Features

• PuppetDB v2 API:
  • Nodes
  • Facts and Facts-names
  • Resources
  • Reports
  • Events
  • Freeform queries
• PuppetDB v1 API:
  • Not yet, maybe never

Documentation

Documentation is hosted on Read The Docs and is available here.