Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nwops/puppet-debugger
A interactive live debugger and REPL for the puppet language
https://github.com/nwops/puppet-debugger
List: puppet-debugger
awesome debugger puppet ruby
Last synced: 7 days ago
JSON representation
A interactive live debugger and REPL for the puppet language
- Host: GitHub
- URL: https://github.com/nwops/puppet-debugger
- Owner: nwops
- License: mit
- Created: 2016-02-18T05:42:29.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-01-19T02:11:37.000Z (10 months ago)
- Last Synced: 2024-10-19T11:09:56.993Z (20 days ago)
- Topics: awesome, debugger, puppet, ruby
- Language: Ruby
- Homepage: https://gitlab.com/puppet-debugger/puppet-debugger
- Size: 11.9 MB
- Stars: 121
- Watchers: 13
- Forks: 11
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-puppet - puppet-debugger - A interactive live debugger and REPL for the puppet language (Puppet Tools)
README
This code has moved to gitlab. Please see https://gitlab.com/puppet-debugger/puppet-debugger
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [puppet-debugger](#puppet-debugger)
- [Compatibility](#compatibility)
- [Production usage](#production-usage)
- [Installation](#installation)
- [Load path](#load-path)
- [Interactive demo](#interactive-demo)
- [Web demo](#web-demo)
- [Usage](#usage)
- [Using Variables](#using-variables)
- [Listing variables](#listing-variables)
- [Listing functions](#listing-functions)
- [Using functions](#using-functions)
- [Duplicate resource error](#duplicate-resource-error)
- [Setting the puppet log level](#setting-the-puppet-log-level)
- [Remote nodes](#remote-nodes)
- [Setup](#setup)
[](https://badge.fury.io/rb/puppet-debugger)
# puppet-debugger
A interactive command line tool for evaluating and debugging the puppet language.
## Documentation
Please visit https://docs.puppet-debugger.com for more info.
## Compatibility
Requires Puppet 5.5+, ruby 2.4+
## Production usage
The puppet debugger is a developer tool that should only be used when writing puppet code. Although it might seem useful
to install on your production puppet master. Please do not install because of the puppet-debugger gem dependencies that might conflict with your existing environment.
## Installation
`gem install puppet-debugger`
## Web demo
There is a web version of the [puppet-debugger](https://demo.puppet-debugger.com) online but is somewhat
limited at this time. In the future we will be adding lots of awesome features to the web debugger.
## Usage
The puppet debugger is a puppet application so once you install the gem, just fire it up using `puppet debugger`.
If you have used `puppet apply` to evaulate puppet code, this replaces all of that with a simple debugger REPL console.
The debugger will only parse and evaluate your code. It will not build a catalog
and try to enforce the catalog. This has a few side affects. This means you can type any puppet code in the debugger
and see what it would actual do when compiling a resource.
1. Type and provider code will not get run.
2. Nothing is created or destroyed on your system.
`puppet debugger`
Example Usage
```
Ruby Version: 2.6.5
Puppet Version: 6.17.0
Puppet Debugger Version: 1.0.0
Created by: NWOps
Type "commands" for a list of debugger commands
or "help" to show the help screen.
1:>> $os
=> {
"architecture" => "x86_64",
"family" => "RedHat",
"hardware" => "x86_64",
"name" => "Fedora",
"release" => {
"full" => "23",
"major" => "23"
},
"selinux" => {
"config_mode" => "permissive",
"config_policy" => "targeted",
"current_mode" => "permissive",
"enabled" => true,
"enforced" => false,
"policy_version" => "29"
}
}
2:>>
```
## Copyright
Copyright (c) 2018 NWOPS, LLC. See LICENSE.txt for
further details.