Package Health Score

58 / 100

security
Security review needed
popularity
Small
maintenance
Inactive
community
Active

Popularity

Small

GitHub Stars: 92
Forks: 71
Contributors: 50

Direct Usage Popularity

Based on project statistics from the GitHub repository for the PyPI package pypuppetdb, we found that it has been starred 92 times.

Security

Security review needed

Security and license risk for latest version

Release Date: Oct 8, 2023
Direct Vulnerabilities: 0
C
0
H
0
M
0
L
Indirect Vulnerabilities: 0
C
0
H
0
M
0
L
License Risk: 0
H
1
M
0
L

All security vulnerabilities belong to production dependencies of direct and indirect packages.

License

Apache-2.0

Security Policy

We found a way for you to contribute to the project! Looks like pypuppetdb is missing a security policy.

You can connect your project's repository to Snyk to stay up to date on security alerts and receive automatic fix pull requests.

Keep your project free of vulnerabilities with Snyk

Maintenance

Inactive

Commit Frequency

Open Issues: 4
Open PR: 5
Last Release: 1 year ago
Last Commit: 11 days ago

Further analysis of the maintenance status of pypuppetdb based on released PyPI versions cadence, the repository activity, and other data points determined that its maintenance is Inactive.

An important project maintenance signal to consider for pypuppetdb is that it hasn't seen any new versions released to PyPI in the past 12 months, and could be considered as a discontinued project, or that which receives low attention from its maintainers.

As a healthy sign for on-going project maintenance, we found that the GitHub repository had at least 1 pull request or issue interacted with by the community.

Community

Active

Readme: Yes
Contributing.md: Yes
Code of Conduct: Yes
Contributors: 50
Funding: Yes

With more than 10 contributors for the pypuppetdb repository, this is possibly a sign for a growing and inviting community.

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Python Versions Compatibility: >=3.7.0

Age: 11 years
Latest Release: 1 year ago
Dependencies: 1 Direct / 5 Total
Versions: 28
Maintainers: 0
Wheels: OS Independent

Not sure how to use pypuppetdb?

To help you get started, we've collected the most common ways that pypuppetdb is being used within popular public projects.

voxpupuli / pypuppetdb / tests / test_querybuilder.py View on Github

def test_limit_offset(self):
        fr = FromOperator("facts")
        op = EqualsOperator("certname", "test01")
        fr.add_query(op)

        fr.add_offset(10)
        assert str(fr) == \
            '["from", "facts", ["=", "certname", "test01"], ["offset", 10]]'

        fr.add_limit(5)
        assert str(fr) == \
            '["from", "facts", ["=", "certname",' \
            ' "test01"], ["limit", 5], ["offset", 10]]'

        fr.add_limit(15)
        assert str(fr) == \
            '["from", "facts", ["=", "certname",' \
            ' "test01"], ["limit", 15], ["offset", 10]]'

View more ways to use pypuppetdb

pypuppetdb

Tests Status

This library is a thin wrapper around the REST API providing some convenience functions and objects to request and hold data from PuppetDB.

Requirements

PuppetDB 5.2 or newer
Python 3.7-3.11

(For support of the older PuppetDB or Python versions please check previous library version.)

Installation

You can install this package from PyPI with:

pip install pypuppetdb

Documentation

The user guide, API reference and a developer guide is available on Read the Docs.

Getting Help

For bug reports you can file an issue. If you need help with something feel free to pop by #voxpupuli or the #puppetboard on Freenode or Vox Pupuli on Slack.

Contributing

Please see the contribution guide here.

License

This project is licensed under the Apache v2.0 License.

Changelog

All notable changes to this project will be documented in this file.

3.2.0 (2023-10-08)

Full Changelog

Merged pull requests:

CI: Run on PRs and merges #252 (bastelfreak)
purge not required empty newlines #242 (bastelfreak)
add dummy CI job we can depend on #241 (bastelfreak)
add dependabot config #240 (bastelfreak)
Update sphinx requirement from <6.0,>=4.3 to >=4.3,<8.0 #239 (dependabot[bot])
Update urllib3 requirement from <2.0,>=1.26 to >=1.26,<3.0 #238 (dependabot[bot])
Modernize the code #235 (gdubicki)

3.1.0 (2022-10-27)

Confirm support for Python 3.11 (final).

3.0.0

This is a maintenance release.

The major version is bumped because of:

dropped support for PuppetDBs < 5.2.0 (Puppet 4 has reached its end-of-life in October 2018),
dropped support for Python 3.6 (end-of-life in December 2021),
the required Requests version bumped to the current latest.

2.5.2

Remove harmful terminology, following the Puppetlabs components name changes (#216)
Use built-in unittest.mock instead of mock (#228)
Build and test dependencies updates.

Thanks to the following contributors of this release: @pgajdos.

2.5.1

Fix TypeError exception thrown by BaseAPI._query() when using debug logging.

Thanks to Ben Roberts for his contribution!

2.5.0

Python 3.10 added as a supported version (#213)

2.4.0

Added PQL support with pql() method (PR #201, fixes #167)
Added ability to specify additional queries when using Node.facts() (#127)
Improve the documentation (even more 😉) (PR #206, fixes #143 and #129)
Fixed creating Edge objects (#202)
Python 3.9 added as a supported version (#203)

2.3.0

Added support for with statement (#185)
Added explicit disconnect() method (#185)
Improved the documentation on Read the Docs and in the project's README (#190)

2.2.0

Loosen requirements and drop six

2.1.0

Bugfix: Fixed metric() function to query the new v2 endpoint based on Jolokia ()
Added a new parameter metric_api_version to the BaseAPI() constructor that allows changing the version of the metric API being queried. Valid values are 'v1' for PuppetDB <= 6.9.0, 'v2' for PuppetDB >= 6.9.1 or None which defaults to 'v2'.
Added a mew parameter version to the metric() function that allows overriding the version of the metric API being queried for that individual call. If nothing is specified it will default to the self.metric_api_version of the class, else it expects a value of 'v1' or 'v2' same as the metric_api_version class parameter.
Added new payload parameter to _query() to allow users to send arbitrary payloads with their queries (useful for debugging).

2.0.0

Dropping old python 2.7/3.5 and ensuring 3 latest versions are supported
Adding mypy + cleanup + further removal of python2 code
Bugfix: Httpretty is not used outside tests and breaks install on newer python versions for some systems

1.2.0

Add option to get nodes without using event-counts
define the project status as stable
bundle requirements-test.txt in python package

1.1.0

deduplicate dependencylist
QueryBuilder.py: Use native data structures for internal representation
Add support for the Command API, /pdb/cmd/v1. Added _cmd alongside _query to minimise changes to original code

1.0.0

Bump dependencies
QueryBuilder: Added support for FromOperator, arrays and FromOperator
New endpoint: status
POST query in request body
Simplify JSON encoding for POST
Upload and publish is built in to setuptools

0.3.3

Add support for authentication with tokens
Fix bug with parsing results from inventory endpoint

0.3.2

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.

0.3.1

Fixed a datetime related bug in pypuppetdb.api.nodes() that caused all returned nodes to be an unreported status

0.3.0

New QueryBuilder module allows users to build PuppetDB queries in an Object-Oriented fashion.
Adding support for new fields provided in PuppetDB 4.1.0.

0.2.3

Removed deprecation of pypuppetdb.types.Report.events(). Expanded resource events data timestamps are not parseable.
Escaping additional path parameters passed to _url() with urllib.quote

0.2.2

Fixed URL Encoding found when querying the specific value of a macaddress fact.
Adding support for PuppetDB 4.0.0 information. Namely Adding a catalog_uuid attribute to the Catalog type object. Adding code_id, catalog_uuid and cached_catalog_status attributes to the Report type object.
Removing unneeded sudo option from .travis.yml, this gave unnecessary warning in the test environment.
Updating the files under docs/ so can be updated
Deprecating pypuppetdb.types.Report.events() in favour of the new events list variable.
Renaming test-requirements.txt to requirements.txt

0.2.1

Adding a version comparison utility function using examples provided in
Adding a new variable latest_report_hash to the Node object. Default None but is given a real value from the field of the same name in the Nodes endpoint available in PuppetDB 3.2 or higher.
Allowing support for 'GET' AND 'POST' requests in the api _query() function. This will allow clients to send requests to the PuppetDB that are too long for a GEt request query string
Adding a node field, code_id, to the Catalog object using the field of the same name from the Catalogs endpoint (currently unused as of PuppetDB 3.2.2)
Adding test cases for new features EXCEPT the GET and POST update.

0.2.0

Version bump to 0.2.0
Adding support for v4 of the Query API
Removing v2 and v3 api functions as per changelog
pypuppetdb will no longer support multiple API versions, removing the api_version attribute from pypuppetdb.connect()
All clients must remove the api_version attribute from the connect function, or the starting number, since it is no longer supported
Removing all NotImplemented errors in the function of BaseAPI and filled them with the real code

New Features

New endpoints:

environments: environments()
factsets: factsets()
fact-paths: fact_paths()
fact-contents: fact_contents()
edges: edges()

Changes to Types:

pypupperdb.types.Report now requires api to be passed as the second argument, this allows to directly query for any events that occurred in this report object. This functionality was proposed and denied because of backward compatability reasons, since the previous versions are now removed this is no longer a problem.
All pypupperdb.types.* accept the v4 API information as optional parameters. These parameters are primarily environment related but may include additional information if provided from that endpoint.
Functions appearing inside pypuppetdb.types that run queries against the PuppetDB now accept and passing additional keyword arguments to the query.
All pypuppetdb.BaseAPI functions pass any received keyword arguments to the pypuppetdb.api.__init__._query() function. This allows for easy integration with paging functions and parameters.

0.1.1

Fix the license in our setup.py. The license shouldn't be longer than 200 characters. We were including the full license tripping up tools like bdist_rpm.

0.1.0

Significant changes have been made in this release. The complete v3 API is now supported except for query pagination.

Most changes are backwards compatible except for a change in the SSL configuration. The previous behaviour was buggy and slightly misleading in the names the options took:

ssl has been renamed to ssl_verify and now defaults to True.
Automatically use HTTPS if ssl_key and ssl_cert are provided.

For additional instructions about getting SSL to work see the Quickstart in the documentation.

Deprecation

Support for API v2 will be dropped in the 0.2.x release series.

New features

The following features are only supported for API v3.

The node() and nodes() function have gained the following options:

with_status=False
unreported=2

When with_status is set to True an additional query will be made using the events-count endpoint scoped to the latest report. This will result in an additional events and status keys on the node object. status will be either of changed, unchanged or failed depending on if events contains successes or failures or none.

By default unreported is set to 2. This is only in effect when with_status is set to True. It means that if a node hasn't checked in for two hours it will get a status of unreported instead.

New endpoints:

events-count: events_count()
aggregate-event-counts: aggregate_event_counts()
server-time: server_time()
version: current_version()
catalog: catalog()

New types:

pypuppetdb.types.Catalog
pypuppetdb.types.Edge

Changes to types:

pypuppetdb.types.Node now has:
- status defaulting to None
- events defaulting to None
- unreported_time defaulting to None

0.0.4

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.

0.0.3

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.

0.0.2

Fix a bug in setup.py preventing successful installation.

0.0.1

Initial release. Implements most of the v2 API.

* This Changelog was automatically generated by github_changelog_generator

pypuppetdb dependencies

requests

FAQs

What is pypuppetdb?

Library for working with the PuppetDB REST API. Visit Snyk Advisor to see a full health score report for pypuppetdb, including popularity, security, maintenance & community analysis.

Is pypuppetdb popular?

The python package pypuppetdb receives a total of 5,115 weekly downloads. As such, pypuppetdb popularity was classified as small. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is pypuppetdb well maintained?

We found indications that pypuppetdb is an Inactive project. See the full package health analysis to learn more about the package maintenance status.

Is pypuppetdb safe to use?

While scanning the latest version of pypuppetdb, we found that a security review is needed. A total of 0 vulnerabilities or license issues were detected. See the full security scan results.

Last updated on 22 December-2024, at 08:17 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP

Package Health Score

Direct Usage Popularity

Security and license risk for latest version

Commit Frequency

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Not sure how to use pypuppetdb?

pypuppetdb

Requirements

Installation

Documentation

Getting Help

Contributing

License

Changelog

3.2.0 (2023-10-08)

3.1.0 (2022-10-27)

3.0.0

2.5.2

2.5.1

2.5.0

2.4.0

2.3.0

2.2.0

2.1.0

2.0.0

1.2.0

1.1.0

1.0.0

0.3.3

0.3.2

0.3.1

0.3.0

0.2.3

0.2.2

0.2.1

0.2.0

0.1.1

0.1.0

0.0.4

0.0.3

0.0.2

0.0.1

pypuppetdb dependencies

FAQs

What is pypuppetdb?

Is pypuppetdb popular?

Is pypuppetdb well maintained?

Is pypuppetdb safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Source Code

Open Source

Container

Config

Fix identified vulnerabilities

Monitor for new issues