feat: prepare "contrib" area

Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>

Author: jkowalleck

cyclonedx/__test.py

@@ -0,0 +1,5 @@
+from .builder.this import this_tool as o
+from .contrib.this import this_tool as n
+
+a = o()
+b = n()

cyclonedx/builder/this.py

@@ -17,30 +17,28 @@
 
 """Representation of this very python library."""
 
-from ..contrib.this import this_tool as _this_tool, this_component as _this_component
+__all__ = ['this_component', 'this_tool', ]
+
+from ..contrib.this import this_component as _this_component, this_tool as _this_tool
 
 # endregion deprecated re-export
 
 this_component = _this_component
-"""
-Alias of :func:`cyclonedx..contrib.this.this_component`.
-
-This re-export location is deprecated.
-Use ``from ...contrib.this import this_component`` instead.
-The exported symbol itself is NOT deprecated - only this import path.
+"""Deprecated — Alias of :func:`cyclonedx.contrib.this.this_component`.
 
 .. deprecated:: next
+    This re-export location is deprecated.
+    Use ``from cyclonedx.contrib.this import this_component`` instead.
+    The exported symbol itself is NOT deprecated - only this import path.
 """
 
 this_tool = _this_tool
-"""
-Alias of :func:`cyclonedx..contrib.this.this_tool`.
-
-This re-export location is deprecated.
-Use ``from ...contrib.this import this_tool`` instead.
-The exported symbol itself is NOT deprecated - only this import path.
+"""Deprecated — Alias of :func:`cyclonedx.contrib.this.this_tool`.
 
 .. deprecated:: next
+    This re-export location is deprecated.
+    Use ``from cyclonedx.contrib.this import this_tool`` instead.
+    The exported symbol itself is NOT deprecated - only this import path.
 """
 
 # endregion deprecated re-export

cyclonedx/contrib/this.py

@@ -1,4 +1,3 @@
-
 # This file is part of CycloneDX Python Library
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

cyclonedx/factory/license.py

@@ -15,19 +15,19 @@
 # SPDX-License-Identifier: Apache-2.0
 # Copyright (c) OWASP Foundation. All Rights Reserved.
 
+__all__ = ['LicenseFactory']
+
 from ..contrib.license import LicenseFactory as _LicenseFactory
 
 # region deprecated re-export
 
 LicenseFactory = _LicenseFactory
-"""
-Alias of :class:`cyclonedx.contrib.license.LicenseFactory`.
-
-This re-export location is deprecated.
-Use ``from ...contrib.license import LicenseFactory`` instead.
-The exported symbol itself is NOT deprecated - only this import path.
+"""Deprecated — Alias of :class:`cyclonedx.contrib.license.LicenseFactory`.
 
 .. deprecated:: next
+    This re-export location is deprecated.
+    Use ``from cyclonedx.contrib.license import LicenseFactory`` instead.
+    The exported symbol itself is NOT deprecated - only this import path.
 """
 
 # endregion deprecated re-export