Merge fix/implicit-class-reference into master

Author: unsektor

changelog.md

@@ -5,8 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2023-01-20
+### Fixed
+
+- `md.python.reference` class implicit reference resolution issue:
+  returns class definition parent type, instead of itself.  
+
+### Changed
+
+- documentation enhancement:
+  - clarified component packages on architecture class diagram  
+
 ## [1.0.0] - 2023-01-19
 
 - Initial implementation
 
+[1.1.0]: https://github.com/md-py/md.python/releases/tag/1.1.0
 [1.0.0]: https://github.com/md-py/md.python/releases/tag/1.0.0

lib/md/python/_python.py

@@ -134,6 +134,9 @@ def reference(definition: typing.Union[str, collections.Callable], explicit: boo
     if module_reference == 'builtins':
         return definition.__name__  # e.g. reference(str) -> 'str'
 
+    if isinstance(definition, type):
+        return f'{module_reference}.{definition.__name__}'
+
     return definition.__class__.__name__  # as is
 
 

setup.py

@@ -5,7 +5,7 @@
 
 setuptools.setup(
     name='md.python',
-    version='1.0.0',
+    version='1.1.0',
     description='component that provides python definition API',
     long_description=long_description,
     long_description_content_type='text/markdown',

tests/acceptance/python.py

@@ -33,6 +33,13 @@ def test_reference_explicit(self) -> None:  # white/positive
         # assert
         assert reference_ == 'md.python._python.reference'
 
+    def test_reference_implicit_class(self) -> None:  # white/positive
+        # act
+        reference_ = md.python.reference(definition=TestReference, explicit=False)
+
+        # assert
+        assert reference_ == 'python.TestReference'
+
     def test_reference_implicit(self) -> None:  # white/positive
         # act
         reference_ = md.python.reference(definition=md.python.reference, explicit=False)