..	*******************************************************************************
	* MetaFactory.io R2
	* Technical Documentation
	* 
	* File name   : ModRef_Package.rst
	* Created by  : Marnix Bochove (original text)
	* Updated by  : Niels de Nies
	*
	* MetaFactory BV Amsterdam 
	*******************************************************************************

.. include:: /inline-images.txt
.. include:: /metadata_include.txt

Package
=======

<package> is the highest element inside the model xml tree and may contain multiple <object> elements.
The number of <package> elements in <model> is not limited.
It can thus be used to group your objects, which allows MetaFactory to execute group specific code instructions.


.. code-block:: xml
	:caption: <package> structure
	:name: MR-package
	:linenos:
	:emphasize-lines: 4-7

	<model>
		...
		
		<package name="yourModelPackageA">
			0 or more <metadata></metadata>
			0 or more <object name="yourModelObject01"> 
		</package>
		<package name="yourModelPackageB">
			0 or more <metadata></metadata>
			0 or more <object name="yourModelObject01"> 
		</package>
		
		...
	</model>

.. rubric:: Attributes

..	list-table:: **attributes of <package/>**
	:widths: 15 70 15
	:header-rows: 1
	:class: tight-table

	*	-	Name
		-	Details
		-	Required
	*	-	name
		-	Name of the package. Must be unique.
		-	mandatory


.. rubric:: Sub elements

..	list-table:: <package/> sub elements
	:widths: 15 70 15
	:header-rows: 1
	:class: tight-table

	*	-	Name
		-	Details
		-	Number
	*	-	:ref:`metadata <Reference/ModelReference/ModRef_Metadata:Metadata>`
		-	This element can contain properties that are specific to the package.
		-	0 .. n
	*	-	:ref:`object <Reference/ModelReference/ModRef_Object:Object>`
		-	Objects define the data entities in the MetaFactory model. They live inside the package in which they are defined.
		-	0 .. n