SchemaModule · jeffpatton1971 · Nov 24, 2021 · Nov 18, 2021 · Nov 18, 2021 · Nov 18, 2021
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -8,6 +8,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## Unreleased
 
 - Move code out of functions into classes
+- Better Error handling support
+
+## [3.0.0] - 2021-11-24
+
+### Added
+- Added support for processing definitions
+- Added schemaDefinition Class
+- Added type support for Definitions
+- Added ConvertTo-SchemaDefinition function
+- Added ToObject support for Arrays
+- Added Global:RawSchema variable to view incoming schema before processing
+
+### Updated
+
+- Find-SchemaElement handles arrays and definitions
+- ConvertTo-SchemaElement can now work with definitions properly
+- Get-SchemaDefinition has better support for actual definitions
 
 ## [2.0.0] - 2020-12-22
 

diff --git a/README.md b/README.md
diff --git a/cabs/schema_b75e69d4-47bc-4ac6-b7d7-df9a36e08bbe_en-US_HelpContent.cab b/cabs/schema_b75e69d4-47bc-4ac6-b7d7-df9a36e08bbe_en-US_HelpContent.cab
diff --git a/cabs/schema_b75e69d4-47bc-4ac6-b7d7-df9a36e08bbe_en-US_HelpContent.zip b/cabs/schema_b75e69d4-47bc-4ac6-b7d7-df9a36e08bbe_en-US_HelpContent.zip
diff --git a/docs/ConvertFrom-SchemaArray.md b/docs/ConvertFrom-SchemaArray.md
@@ -102,17 +102,14 @@ Accept wildcard characters: False
 ```
 
 ### CommonParameters
-
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
 ## INPUTS
 
 ### None
-
 ## OUTPUTS
 
 ### System.Object[]
-
 ## NOTES
 
 ## RELATED LINKS

diff --git a/docs/ConvertFrom-SchemaObject.md b/docs/ConvertFrom-SchemaObject.md
@@ -115,17 +115,14 @@ Accept wildcard characters: False
 ```
 
 ### CommonParameters
-
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
 ## INPUTS
 
 ### None
-
 ## OUTPUTS
 
 ### System.Object
-
 ## NOTES
 
 ## RELATED LINKS

diff --git a/docs/ConvertTo-SchemaDefinition.md b/docs/ConvertTo-SchemaDefinition.md
@@ -0,0 +1,125 @@
+---
+external help file: schema-help.xml
+Module Name: schema
+online version: https://github.com/SchemaModule/PowerShell/blob/master/docs/ConvertTo-SchemaDefinition.md#convertto-schemadefinition
+schema: 2.0.0
+---
+
+# ConvertTo-SchemaDefinition
+
+## SYNOPSIS
+
+This function takes an object that has the format of a Schema Definition and
+converts it into the schemaDefinition class. It can also return as either the
+schemaDefinition class or a json string.
+
+## SYNTAX
+
+```
+ConvertTo-SchemaDefinition [[-Definition] <Object>] [-AsJson]  [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+This function takes an object that has the format of a Schema Definition and
+converts it into the schemaDefinition class. It can also return as either the
+schemaDefinition class or a json string.
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+PS C:\> $Schema = Get-SchemaDocument -Path 'D:\TEMP\test\schema-sample.json'
+
+ConvertTo-SchemaDefinition -Definition $Schema.definitions.room
+
+
+type        : object
+properties  : @{Id=; Title;Description=}
+required    :
+```
+
+This example shows how to use the function to convert an object into a schema
+class.
+
+
+## PARAMETERS
+
+### -AsJson
+
+Allows the funciton to return a string in JSON format.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Definition
+
+This is a JSON Schema definition as defined by the json-schema.org (see related
+links below). This object is then converted into a PowerShell object that can be
+used like any other PowerShell object.
+
+{
+ "type": [
+  "object"
+ ],
+ "properties": {
+  "Id": {
+   "type": "string"
+  },
+  "Regions": {
+   "type": "array",
+   "items": {
+    "$ref": "#/definitions/Region"
+   }
+  }
+ },
+ "required": [
+  "Id",
+  "Regions"
+ ]
+}
+
+```yaml
+Type: System.Object
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 0
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+## OUTPUTS
+
+### schemaDefinition
+This class is really modified object that contains the $schema attribute as well as validation on what values can be present for that attribute. Schema Definition (https://json-schema.org/understanding-json-schema/structuring.html#defs) Schema Keyword (https://json-schema.org/understanding-json-schema/reference/schema.html) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
+
+## NOTES
+
+## RELATED LINKS
+
+[Get-SchemaDocument](https://github.com/SchemaModule/PowerShell/blob/master/docs/Get-SchemaDocument.md#get-schemadocument)
+
+[New-SchemaProperty](https://github.com/SchemaModule/PowerShell/blob/master/docs/New-SchemaProperty.md#new-schemaproperty)
+
+[About Classes](https://github.com/SchemaModule/PowerShell/blob/master/docs/about_Schema_Classes.md)
+
+[JSON Schema Reference](https://json-schema.org/understanding-json-schema/reference/index.html)
diff --git a/docs/ConvertTo-SchemaElement.md b/docs/ConvertTo-SchemaElement.md
@@ -15,7 +15,7 @@ SchemaModule classes.
 ## SYNTAX
 
 ```
-ConvertTo-SchemaElement [-Object] <Object> [<CommonParameters>]
+ConvertTo-SchemaElement [-Object] <Object> [-IsRootSchema] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -71,6 +71,23 @@ Format-List CmdLet.
 
 ## PARAMETERS
 
+### -IsRootSchema
+
+This switch allows the function to know when it's working with the root of a
+schema document versus a regular object.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Object
 
 This is a JSON Schema object as defined by the json-schema.org (see related links
@@ -106,79 +123,33 @@ Accept wildcard characters: False
 ```
 
 ### CommonParameters
-
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
 ## INPUTS
 
 ### None
-
 ## OUTPUTS
 
 ### schemaDocument
-
-This class is really modified object that contains the $schema attribute as well
-as validation on what values can be present for that attribute.
-
-[Schema Object](https://json-schema.org/understanding-json-schema/reference/object.html)
-
-[Schema Keyword](https://json-schema.org/understanding-json-schema/reference/schema.html)
-
-[Schema Types](https://json-schema.org/understanding-json-schema/reference/type.html)
+This class is really modified object that contains the $schema attribute as well as validation on what values can be present for that attribute. Schema Object (https://json-schema.org/understanding-json-schema/reference/object.html) Schema Keyword (https://json-schema.org/understanding-json-schema/reference/schema.html) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
 
 ### schemaString
-
-The string type is used for strings of text. It may contain Unicode characters.
-
-[Schema String](https://json-schema.org/understanding-json-schema/reference/string.html)
-
-[Schema Types](https://json-schema.org/understanding-json-schema/reference/type.html)
+The string type is used for strings of text. It may contain Unicode characters. Schema String (https://json-schema.org/understanding-json-schema/reference/string.html) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
 
 ### schemaInteger
-
-The integer type is used for integral numbers. In PowerShell this is an int32
-
-[Schema Integer](http://json-schema.org/understanding-json-schema/reference/numeric.html#integer)
-
-[Schema Types](https://json-schema.org/understanding-json-schema/reference/type.html)
+The integer type is used for integral numbers. In PowerShell this is an int32 Schema Integer (http://json-schema.org/understanding-json-schema/reference/numeric.html#integer) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
 
 ### schemaNumber
-
-The number type is used for any numeric type, either integers or floating point
-numbers. In PowerShell this is a double.
-
-[Schema Number](http://json-schema.org/understanding-json-schema/reference/numeric.html#number)
-
-[Schema Types](https://json-schema.org/understanding-json-schema/reference/type.html)
+The number type is used for any numeric type, either integers or floating point numbers. In PowerShell this is a double. Schema Number (http://json-schema.org/understanding-json-schema/reference/numeric.html#number) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
 
 ### schemaBoolean
-
-The boolean type matches only two special values: true and false. Note that
-values that evaluate to true or false, such as 1 and 0, are not accepted by the
-schema.
-
-[Schema Boolean](http://json-schema.org/understanding-json-schema/reference/boolean.html)
-
-[Schema Types](https://json-schema.org/understanding-json-schema/reference/type.html)
+The boolean type matches only two special values: true and false. Note that values that evaluate to true or false, such as 1 and 0, are not accepted by the schema. Schema Boolean (http://json-schema.org/understanding-json-schema/reference/boolean.html) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
 
 ### schemaObject
-
-Objects are the mapping type in JSON. They map "keys" to "values". In JSON, the
-"keys" must always be strings. Each of these pairs is conventionally referred
-to as a "property".
-
-[Schema Object](https://json-schema.org/understanding-json-schema/reference/object.html)
-
-[Schema Types](https://json-schema.org/understanding-json-schema/reference/type.html)
+Objects are the mapping type in JSON. They map "keys" to "values". In JSON, the "keys" must always be strings. Each of these pairs is conventionally referred to as a "property". Schema Object (https://json-schema.org/understanding-json-schema/reference/object.html) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
 
 ### schemaArray
-
-Arrays are used for ordered elements. In JSON, each element in an array may be
-of a different type.
-
-[Schema Array](https://json-schema.org/understanding-json-schema/reference/array.html)
-
-[Schema Types](https://json-schema.org/understanding-json-schema/reference/type.html)
+Arrays are used for ordered elements. In JSON, each element in an array may be of a different type. Schema Array (https://json-schema.org/understanding-json-schema/reference/array.html) Schema Types (https://json-schema.org/understanding-json-schema/reference/type.html)
 
 ## NOTES