XML Schema Definition (XSD) for an Equipment Register.
For background information about XSD, please see the following overview provided by the World Wide Web Consortium
and the XML Schema Tutorial provided by w3schools.
The documentation for the Equipment-Register schema is available here.
Python is required to run the tests and to build the documentation. Java is also required to build the documentation. Git is required to interact with the repository.
If you know how to install Java, Git, Python and Python packages (pytest
, lxml
and GTC
are required) you can skip this section entirely (or only install what you do not have).
The remainder of the Contributing Guide assumes that you have executed every command and did not deviate.
Running the following commands will:
You could also manually install each program (links above) rather than running
the following winget
commands.
Open a terminal (i.e., PowerShell or Command Prompt – you may need to open an elevated terminal if you are using an ITS-managed computer) and run each command sequentially to install Git, Java and Python
winget install Git.Git
winget install Oracle.JDK.22
winget install Python.Python.3.12
You must now restart (close then re-open) your terminal so that the executable for these installed programs becomes available to use.
Next, install the Python requirement packages (pytest
, lxml
and GTC
)
py -m pip install pytest lxml GTC
Finally, clone the repository and change directory, cd
, into the root directory of the repository
git clone https://github.com/MSLNZ/equipment-register-schema.git
cd equipment-register-schema
To run the tests, execute the following command from the root directory of the repository
pytest
To build the documentation, execute the following command from the root directory of the repository
py build_docs.py
See docs/README for information about the build process.