Add Schema.Push convenience method with unit test

Author: Jesse Coretta

schema.go

@@ -287,6 +287,37 @@ func (r Schema) Counters() Counters {
 	}
 }
 
+/*
+Push assigns the input instance of [Definition] to the appropriate
+underlying collection. The input instance MUST be compliant.
+
+This is a fluent method.
+*/
+func (r Schema) Push(def Definition) Schema {
+	if !r.IsZero() && def.Compliant() {
+		switch def.Type() {
+		case `ldapSyntax`:
+			r.LDAPSyntaxes().Push(def)
+		case `matchingRule`:
+			r.MatchingRules().Push(def)
+		case `attributeType`:
+			r.AttributeTypes().Push(def)
+		case `matchingRuleUse`:
+			r.MatchingRuleUses().Push(def)
+		case `objectClass`:
+			r.ObjectClasses().Push(def)
+		case `dITContentRule`:
+			r.DITContentRules().Push(def)
+		case `nameForm`:
+			r.NameForms().Push(def)
+		case `dITStructureRule`:
+			r.DITStructureRules().Push(def)
+		}
+	}
+
+	return r
+}
+
 /*
 ParseRaw returns an error following an attempt to parse raw into
 usable schema definitions. This method operates similarly to the

schema_test.go

@@ -48,6 +48,24 @@ func ExampleSchema_Options() {
 	// Output: true
 }
 
+/*
+This example demonstrates a convenient means of adding any [Definition]
+qualifier, such as an [ObjectClass] instance, to the schema. This is
+useful when manual type verification is cumbersome.
+*/
+func ExampleSchema_Push() {
+	def := mySchema.NewObjectClass()
+	def.SetNumericOID(`1.3.6.1.4.1.56521.999.1232`)
+	def.SetKind(AuxiliaryKind)
+	def.SetName(`exampleClass`)
+
+	mySchema.Push(def)
+	get := mySchema.ObjectClasses().Get(`exampleClass`)
+
+	fmt.Printf("%s\n", get.OID())
+	// Output: exampleClass
+}
+
 func ExampleSchema_Replace_objectClass() {
 
 	gon := mySchema.ObjectClasses().Get(`groupOfNames`)