docs: add examples to docs

docs/examples.rst

@@ -0,0 +1,23 @@
+.. # Licensed under the Apache License, Version 2.0 (the "License");
+   # you may not use this file except in compliance with the License.
+   # You may obtain a copy of the License at
+   #
+   #     http://www.apache.org/licenses/LICENSE-2.0
+   #
+   # Unless required by applicable law or agreed to in writing, software
+   # distributed under the License is distributed on an "AS IS" BASIS,
+   # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   # See the License for the specific language governing permissions and
+   # limitations under the License.
+   #
+   # SPDX-License-Identifier: Apache-2.0
+
+Examples
+========
+
+Models used in Unit Tests
+-------------------------
+
+.. literalinclude:: ../tests/model.py
+   :language: python
+   :linenos:

docs/index.rst

@@ -35,6 +35,7 @@ See also:
    getting-started
    customising-structure
    formatters
+   examples
    support
    changelog
 

tests/model.py

@@ -1,5 +1,4 @@
 # encoding: utf-8
-import re
 
 # This file is part of py-serializable
 #
@@ -17,6 +16,8 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 # Copyright (c) Paul Horton. All Rights Reserved.
+
+import re
 from datetime import date
 from enum import Enum, unique
 from typing import Iterable, List, Optional, Set