RubyGems - puppet-strings - Versions diffs - 2.4.0 → 2.5.0 - Mend

puppet-strings 2.4.0 → 2.5.0

Files changed (69) hide show

data/spec/fixtures/acceptance/modules/test/manifests/init.pp DELETED

@@ -1,31 +0,0 @@
-# Class: test
-#
-#   This class exists to serve as fixture data for testing the puppet strings face
-#
-# @example
-#   class { "test": }
-#
-# @param package_name The name of the package
-# @param service_name The name of the service
-# @param myenum
-# @enum myenum a Option A
-# @enum myenum b Option B
-class test (
-  $package_name = $test::params::package_name,
-  $service_name = $test::params::service_name,
-  Enum['a', 'b'] $myenum = 'a',
-) inherits test::params {
-  # validate parameters here
-  class { 'test::install': } ->
-  class { 'test::config': } ~>
-  class { 'test::service': } ->
-  Class['test']
-  File {
-    owner => 'user',
-    path => 'some/file/path',
-  }
-}

data/spec/fixtures/acceptance/modules/test/manifests/triple_nested_classes.pp DELETED

@@ -1,27 +0,0 @@
-# Testing tested classes
-# docs stuff
-# @param nameservers [String] Don't ask me what this does!
-# @param default_lease_time [Integer[1024, 8192]] text goes here
-# @param max_lease_time does stuff
-class outer (
-		$dnsdomain,
-		$nameservers,
-		$default_lease_time = 3600,
-		$max_lease_time     = 86400
-		) {
-	# @param options [String[5,7]] gives user choices
-	# @param multicast [Boolean] foobar
-	# @param servers yep, that's right
-	class middle (
-      $options   = "iburst",
-      $servers,
-      $multicast = false
-    ) {
-    class inner (
-        $choices   = "uburst",
-        $secenekler   = "weallburst",
-        $boxen,
-        $manyspell = true
-      ) {}
-    }
-}

data/spec/fixtures/acceptance/modules/test/metadata.json DELETED

@@ -1,10 +0,0 @@
-{
-  "name": "username-test",
-  "version": "0.0.1",
-  "author": "username",
-  "summary": "brief summary",
-  "license": "MIT",
-  "source": "git://github.com/not_a/real_repo.git",
-  "dependencies": [
-  ]
-}

data/spec/fixtures/acceptance/modules/test/types/elephant.pp DELETED

	@@ -1,2 +0,0 @@
1	- # A simple elephant type.
2	- type Test::Elephant = String[2]

data/spec/fixtures/unit/markdown/output.md DELETED

@@ -1,561 +0,0 @@
-# Reference
-<!-- DO NOT EDIT: This document was generated by Puppet Strings -->
-## Table of Contents
-**Classes**
-_Public Classes_
-* [`klass`](#klass): A simple class.
-_Private Classes_
-* `noparams`: Overview for class noparams
-**Defined types**
-* [`klass::dt`](#klassdt): A simple defined type.
-**Resource types**
-* [`apt_key`](#apt_key): Example resource type using the new API.
-* [`database`](#database): An example database server type.
-**Functions**
-* [`func`](#func): A simple Puppet function.
-* [`func3x`](#func3x): Documentation for an example 3.x function.
-* [`func4x`](#func4x): An example 4.x function.
-* [`func4x_1`](#func4x_1): An example 4.x function with only one signature.
-**Tasks**
-* [`(stdin)`](#(stdin)): Allows you to backup your database to local file.
-## Classes
-### klass
-An overview for a simple class.
-* **TODO** Do a thing
-* **Note** some note
-* **Since** 1.0.0
-* **See also**
-www.puppet.com
-#### Examples
-##### This is an example
-```puppet
-class { 'klass':
-  param1 => 1,
-  param3 => 'foo',
-}
-```
-##### This is another example
-```puppet
-class { 'klass':
-  param1 => 1,
-  param3 => 'foo',
-}
-```
-#### Parameters
-The following parameters are available in the `klass` class.
-##### `param1`
-Data type: `Integer`
-First param.
-Default value: 1
-##### `param2`
-Data type: `Any`
-Second param.
-Options:
-* **:opt1** `String`: something about opt1
-* **:opt2** `Hash`: a hash of stuff
-Default value: `undef`
-##### `param3`
-Data type: `String`
-Third param.
-Default value: 'hi'
-##### `param4`
-Data type: `Enum['one', 'two']`
-Fourth param.
-Options:
-* **:one**: One option
-* **:two**: Second option
-Default value: 'two'
-## Defined types
-### klass::dt
-An overview for a simple defined type.
-* **Since** 1.1.0
-* **See also**
-www.puppet.com
-#### Examples
-##### Here's an example of this type:
-```puppet
-klass::dt { 'foo':
-  param1 => 33,
-  param4 => false,
-}
-```
-#### Parameters
-The following parameters are available in the `klass::dt` defined type.
-##### `param1`
-Data type: `Integer`
-First param.
-Default value: 44
-##### `param2`
-Data type: `Any`
-Second param.
-Options:
-* **:opt1** `String`: something about opt1
-* **:opt2** `Hash`: a hash of stuff
-##### `param3`
-Data type: `String`
-Third param.
-Default value: 'hi'
-##### `param4`
-Data type: `Boolean`
-Fourth param.
-Default value: `true`
-##### `param5`
-Data type: `Enum['a', 'b']`
-Fifth param.
-Options:
-* **:a**: Option A
-* **:b**: Option B
-Default value: 'a'
-## Resource types
-### apt_key
-This type provides Puppet with the capabilities to manage GPG keys needed
-by apt to perform package validation. Apt has it's own GPG keyring that can
-be manipulated through the `apt-key` command.
-**Autorequires**:
-If Puppet is given the location of a key file which looks like an absolute
-path this type will autorequire that file.
-#### Examples
-##### here's an example
-```puppet
-apt_key { '6F6B15509CF8E59E6E469F327F438280EF8D349F':
-  source => 'http://apt.puppetlabs.com/pubkey.gpg'
-}
-```
-#### Properties
-The following properties are available in the `apt_key` type.
-##### `ensure`
-Data type: `Enum[present, absent]`
-Whether this apt key should be present or absent on the target system.
-##### `created`
-Data type: `String`
-Date the key was created, in ISO format.
-#### Parameters
-The following parameters are available in the `apt_key` type.
-##### `id`
-namevar
-Data type: `Variant[Pattern[/A(0x)?[0-9a-fA-F]{8}Z/], Pattern[/A(0x)?[0-9a-fA-F]{16}Z/], Pattern[/A(0x)?[0-9a-fA-F]{40}Z/]]`
-_*this data type contains a regex that may not be accurately reflected in generated documentation_
-The ID of the key you want to manage.
-### database
-An example database server type.
-#### Examples
-##### here's an example
-```puppet
-database { 'foo':
-  address => 'qux.baz.bar',
-}
-```
-#### Properties
-The following properties are available in the `database` type.
-##### `ensure`
-Valid values: present, absent, up, down
-Aliases: "up"=>"present", "down"=>"absent"
-What state the database should be in.
-Options:
-* **:up**: Upstate
-* **:down**: Downstate
-Default value: up
-##### `file`
-The database file to use.
-##### `log_level`
-Valid values: debug, warn, error
-The log level to use.
-Default value: warn
-#### Parameters
-The following parameters are available in the `database` type.
-##### `address`
-namevar
-The database server name.
-##### `encryption_key`
-The encryption key to use.
-Required features: encryption.
-##### `encrypt`
-Valid values: `true`, `false`, yes, no
-Whether or not to encrypt the database.
-Default value: `false`
-## Functions
-### func
-Type: Puppet Language
-A simple Puppet function.
-#### Examples
-##### Test
-```puppet
-$result = func(1, 2)
-```
-#### `func(Integer $param1, Any $param2, String $param3 = hi, Enum['yes', 'no'] $param4 = 'yes')`
-A simple Puppet function.
-Returns: `Undef` Returns nothing.
-Raises:
-* `SomeError` this is some error
-##### Examples
-###### Test
-```puppet
-$result = func(1, 2)
-```
-##### `param1`
-Data type: `Integer`
-First param.
-##### `param2`
-Data type: `Any`
-Second param.
-##### `param3`
-Data type: `String`
-Third param.
-Options:
-* **:param3opt** `Array`: Something about this option
-##### `param4`
-Data type: `Enum['yes', 'no']`
-Fourth param.
-Options:
-* **:yes**: Yes option.
-* **:no**: No option.
-### func3x
-Type: Ruby 3.x API
-Documentation for an example 3.x function.
-#### Examples
-##### Calling the function.
-```puppet
-func3x('hi', 10)
-```
-#### `func3x(String $param1, Integer $param2)`
-Documentation for an example 3.x function.
-Returns: `Undef`
-##### Examples
-###### Calling the function.
-```puppet
-func3x('hi', 10)
-```
-##### `param1`
-Data type: `String`
-The first parameter.
-##### `param2`
-Data type: `Integer`
-The second parameter.
-### func4x
-Type: Ruby 4.x API
-An example 4.x function.
-#### Examples
-##### Calling the function
-```puppet
-$result = func4x(1, 'foo')
-```
-##### Calling the function with all args
-```puppet
-$result = func4x(1, 'foo', ['bar'])
-```
-#### `func4x(Integer $param1, Any $param2, Optional[Array[String]] $param3, Optional[Enum[one, two]] $param4)`
-An overview for the first overload.
-Returns: `Undef` Returns nothing.
-##### Examples
-###### Calling the function foo
-```puppet
-$result = func4x(1, 'foooo')
-```
-##### `param1`
-Data type: `Integer`
-The first parameter.
-##### `param2`
-Data type: `Any`
-The second parameter.
-Options:
-* **:option** `String`: an option
-* **:option2** `String`: another option
-##### `param3`
-Data type: `Optional[Array[String]]`
-The third parameter.
-##### `param4`
-Data type: `Optional[Enum[one, two]]`
-The fourth parameter.
-Options:
-* **:one**: Option one.
-* **:two**: Option two.
-#### `func4x(Boolean $param, Callable &$block)`
-An overview for the second overload.
-Returns: `String` Returns a string.
-##### Examples
-###### Calling the function bar
-```puppet
-$result = func4x(1, 'bar', ['foo'])
-```
-##### `param`
-Data type: `Boolean`
-The first parameter.
-##### `&block`
-Data type: `Callable`
-The block parameter.
-### func4x_1
-Type: Ruby 4.x API
-An example 4.x function with only one signature.
-#### `func4x_1(Integer $param1)`
-An example 4.x function with only one signature.
-Returns: `Undef` Returns nothing.
-##### `param1`
-Data type: `Integer`
-The first parameter.
-## Tasks
-### (stdin)
-Allows you to backup your database to local file.
-**Supports noop?** false
-#### Parameters
-##### `database`
-Data type: `Optional[String[1]]`
-Database to connect to
-##### `user`
-Data type: `Optional[String[1]]`
-The user
-##### `password`
-Data type: `Optional[String[1]]`
-The password
-##### `sql`
-Data type: `String[1]`
-Path to file you want backup to