anson.py3 0.1.0__tar.gz

anson_py3-0.1.0/.gitignore

@@ -0,0 +1,2 @@
+__pycache__
+dist

anson_py3-0.1.0/.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

anson_py3-0.1.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,12 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="PyPep8Inspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
+      <option name="ignoredErrors">
+        <list>
+          <option value="E501" />
+        </list>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

anson_py3-0.1.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

anson_py3-0.1.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.12" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.9" project-jdk-type="Python SDK" />
+</project>

anson_py3-0.1.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/py3.iml" filepath="$PROJECT_DIR$/.idea/py3.iml" />
+    </modules>
+  </component>
+</project>

anson_py3-0.1.0/.idea/py3.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="Python 3.12" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

anson_py3-0.1.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

anson_py3-0.1.0/.idea/workspace.xml

@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="8abd2f88-f467-4ea4-848e-e32bbaf197e2" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="FileTemplateManagerImpl">
+    <option name="RECENT_TEMPLATES">
+      <list>
+        <option value="Python Script" />
+      </list>
+    </option>
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$/.." />
+  </component>
+  <component name="MarkdownSettingsMigration">
+    <option name="stateVersion" value="1" />
+  </component>
+  <component name="ProjectId" id="2XHS1eigFVfsCqhKGGKDGDVYhNP" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;RunOnceActivity.OpenProjectViewOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;last_opened_file_path&quot;: &quot;C:/Users/Alice/github/Ever-connecting/synode-gui/portfolio-gui&quot;
+  }
+}</component>
+  <component name="RecentsManager">
+    <key name="CopyFile.RECENT_KEYS">
+      <recent name="C:\Users\Alice\github\antson\py3\test\testier" />
+    </key>
+    <key name="MoveFile.RECENT_KEYS">
+      <recent name="C:\Users\Alice\github\antson\py3\test" />
+      <recent name="C:\Users\Alice\github\antson\py3\test\io" />
+      <recent name="C:\Users\Alice\github\antson\py3" />
+      <recent name="C:\Users\Alice\github\antson\py3\ansonpy" />
+    </key>
+  </component>
+  <component name="RunManager">
+    <configuration name="testAnson" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="py3" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/test" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/test/testAnson.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Python.testAnson" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="8abd2f88-f467-4ea4-848e-e32bbaf197e2" name="Changes" comment="" />
+      <created>1698284298825</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1698284298825</updated>
+    </task>
+    <servers />
+  </component>
+  <component name="XDebuggerManager">
+    <breakpoint-manager>
+      <default-breakpoints>
+        <breakpoint type="python-exception">
+          <properties notifyOnTerminate="true" exception="BaseException">
+            <option name="notifyOnTerminate" value="true" />
+          </properties>
+        </breakpoint>
+      </default-breakpoints>
+    </breakpoint-manager>
+    <watches-manager>
+      <configuration name="PythonConfigurationType">
+        <watch expression="get_origin(f.type)" language="Python" />
+        <watch expression="it.type == str" language="Python" />
+        <watch expression="it.type == type(list())" language="Python" />
+        <watch expression="issubclass(it.type, Number)" language="Python" />
+        <watch expression="get_origin(f.type) == list" language="Python" />
+        <watch expression="issubclass(myfields[k].type, Number)" language="Python" />
+        <watch expression="isinstance(v, str)" language="Python" />
+      </configuration>
+    </watches-manager>
+  </component>
+</project>

anson_py3-0.1.0/.project

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>anston.py3</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.python.pydev.PyDevBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.python.pydev.pythonNature</nature>
+	</natures>
+</projectDescription>

anson_py3-0.1.0/.pydevproject

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<?eclipse-pydev version="1.0"?><pydev_project>
+<pydev_pathproperty name="org.python.pydev.PROJECT_SOURCE_PATH">
+<path>/${PROJECT_DIR_NAME}</path>
+</pydev_pathproperty>
+<pydev_property name="org.python.pydev.PYTHON_PROJECT_VERSION">python 3.5</pydev_property>
+<pydev_property name="org.python.pydev.PYTHON_PROJECT_INTERPRETER">Default</pydev_property>
+</pydev_project>

anson_py3-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 odys-z
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

anson_py3-0.1.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: anson.py3
+Version: 0.1.0
+Summary: Anson for Python3
+Project-URL: Homepage, https://github.com/odys-z/antson
+Project-URL: Issues, https://github.com/odys-z/antson/issues
+Author-email: Ody Z <odys.zhou@gmail.com>
+License: Copyright (c) 2025 Ody Z. All rights reserved.
+        
+        This work is licensed under the terms of the MIT license.
+        For a copy, see <https://opensource.org/licenses/MIT>.
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Anson.py3
+
+A testing package ...
+
+```code
+from ansons.anson import Anson
+```
+
+# Install from testpypi
+
+```
+pip install --index-url https://test.pypi.org/simple --extra-index-url https://pypi.org/simple anson.py3
+```
+
+# Guide
+
+- Mapping Java vs Python package structure
+
+Python packages tree is in format of *path/to/module/class*, while java has no node of *module*:
+
+```
+├── io
+│   └── oz
+│       ├── jserv
+│       │   └── docs
+│       │       └── syn
+│       │           └── singleton.py "class AppSettings"
+│       └── syn.py "class AnRegistry, SynodeConfig, SynOrg, YellowPages"
+```
+
+Java packages tree:
+
+```
+.
+└── io
+    └── oz
+        └── jserv
+            └── docs
+                └── syn
+                    ├── singleton
+                    │   └── AppSettings.java
+```
+
+```
+.
+└── io
+    └── oz
+        └── syn
+            ├── AnRegistry.java
+            ├── SynodeConfig.java
+            ├── SynOrg.java
+            └── YellowPages.java
+```
+
+Anson.py3 is using package name path with a top level path. Say, if the json envelope
+define as
+
+```
+{ type: io.oz.syn.AnRegistry,
+  ...
+}
+```
+
+and the user's project tree is:
+
+```
+src
+├── io
+│   └── oz
+│       ├── jserv
+│       │   └── docs
+│       │       └── syn
+│       │           └── singleton.py "class AppSettings"
+│       └── syn.py "class AnRegistry, SynodeConfig, SynOrg, YellowPages"
+main.py
+```
+
+In main.py, call
+
+```code
+Anson.java_src('src')
+```
+
+before
+
+```code
+AnRegistry.from_file(path)
+```
+
+# Issues
+
+- Printing Anson subclasses with non-default field without value initialization will result in errors
+
+If SynOrg.parent is defined as
+
+```
+class SynOrg(Anson)
+    parent: str
+
+    def __init__(self):
+        super().__init__()
+
+```
+
+```
+org = Anson.from_file(...)
+print (org)
+
+Error
+Traceback (most recent call last):
+  File "/home/antson/py3/test/testYellowPages.py", line 18, in testAnregistry
+    print(diction)
+  File "/usr/lib/python3.12/dataclasses.py", line 262, in wrapper
+    result = user_function(self)
+             ^^^^^^^^^^^^^^^^^^^
+  File "<string>", line 3, in __repr__
+  File "/usr/lib/python3.12/dataclasses.py", line 262, in wrapper
+    result = user_function(self)
+             ^^^^^^^^^^^^^^^^^^^
+  File "<string>", line 3, in __repr__
+  File "/usr/lib/python3.12/dataclasses.py", line 262, in wrapper
+    result = user_function(self)
+             ^^^^^^^^^^^^^^^^^^^
+  File "<string>", line 3, in __repr__
+AttributeError: 'SynOrg' object has no attribute 'parent'
+```
+
+# References
+
+- https://packaging.python.org/en/latest/tutorials/packaging-projects/
+
+```python3 -m twine upload --repository testpypi dist/*```
+
+# Troubleshootings
+
+.pypirc
+
+```
+[testpypi]
+repository: https://test.pypi.org/legacy/
+username = __token__
+password = pypi-zzz
+```
+
+```
+python3 -m twine --version
+twine version 6.1.0 (keyring: 25.6.0, packaging: 24.2, requests: 2.31.0, requests-toolbelt: 1.0.0,
+urllib3: 2.0.7, id: 1.5.0)
+python3 -m build
+python3 -m twine upload --repository testpypi dist/*
+```
+
+```
+ERROR   InvalidDistribution: Invalid distribution metadata: unrecognized or malformed field
+        'license-file'; unrecognized or malformed field 'license-expression'  
+```
+
+Install twine 6.1.0 and packaging 24.
+
+```
+pip install packaging -U
+```
+
+See [issue #1216](https://github.com/pypa/twine/issues/1216#issuecomment-2609745412).

anson_py3-0.1.0/README.md

@@ -0,0 +1,164 @@
+# Anson.py3
+
+A testing package ...
+
+```code
+from ansons.anson import Anson
+```
+
+# Install from testpypi
+
+```
+pip install --index-url https://test.pypi.org/simple --extra-index-url https://pypi.org/simple anson.py3
+```
+
+# Guide
+
+- Mapping Java vs Python package structure
+
+Python packages tree is in format of *path/to/module/class*, while java has no node of *module*:
+
+```
+├── io
+│   └── oz
+│       ├── jserv
+│       │   └── docs
+│       │       └── syn
+│       │           └── singleton.py "class AppSettings"
+│       └── syn.py "class AnRegistry, SynodeConfig, SynOrg, YellowPages"
+```
+
+Java packages tree:
+
+```
+.
+└── io
+    └── oz
+        └── jserv
+            └── docs
+                └── syn
+                    ├── singleton
+                    │   └── AppSettings.java
+```
+
+```
+.
+└── io
+    └── oz
+        └── syn
+            ├── AnRegistry.java
+            ├── SynodeConfig.java
+            ├── SynOrg.java
+            └── YellowPages.java
+```
+
+Anson.py3 is using package name path with a top level path. Say, if the json envelope
+define as
+
+```
+{ type: io.oz.syn.AnRegistry,
+  ...
+}
+```
+
+and the user's project tree is:
+
+```
+src
+├── io
+│   └── oz
+│       ├── jserv
+│       │   └── docs
+│       │       └── syn
+│       │           └── singleton.py "class AppSettings"
+│       └── syn.py "class AnRegistry, SynodeConfig, SynOrg, YellowPages"
+main.py
+```
+
+In main.py, call
+
+```code
+Anson.java_src('src')
+```
+
+before
+
+```code
+AnRegistry.from_file(path)
+```
+
+# Issues
+
+- Printing Anson subclasses with non-default field without value initialization will result in errors
+
+If SynOrg.parent is defined as
+
+```
+class SynOrg(Anson)
+    parent: str
+
+    def __init__(self):
+        super().__init__()
+
+```
+
+```
+org = Anson.from_file(...)
+print (org)
+
+Error
+Traceback (most recent call last):
+  File "/home/antson/py3/test/testYellowPages.py", line 18, in testAnregistry
+    print(diction)
+  File "/usr/lib/python3.12/dataclasses.py", line 262, in wrapper
+    result = user_function(self)
+             ^^^^^^^^^^^^^^^^^^^
+  File "<string>", line 3, in __repr__
+  File "/usr/lib/python3.12/dataclasses.py", line 262, in wrapper
+    result = user_function(self)
+             ^^^^^^^^^^^^^^^^^^^
+  File "<string>", line 3, in __repr__
+  File "/usr/lib/python3.12/dataclasses.py", line 262, in wrapper
+    result = user_function(self)
+             ^^^^^^^^^^^^^^^^^^^
+  File "<string>", line 3, in __repr__
+AttributeError: 'SynOrg' object has no attribute 'parent'
+```
+
+# References
+
+- https://packaging.python.org/en/latest/tutorials/packaging-projects/
+
+```python3 -m twine upload --repository testpypi dist/*```
+
+# Troubleshootings
+
+.pypirc
+
+```
+[testpypi]
+repository: https://test.pypi.org/legacy/
+username = __token__
+password = pypi-zzz
+```
+
+```
+python3 -m twine --version
+twine version 6.1.0 (keyring: 25.6.0, packaging: 24.2, requests: 2.31.0, requests-toolbelt: 1.0.0,
+urllib3: 2.0.7, id: 1.5.0)
+python3 -m build
+python3 -m twine upload --repository testpypi dist/*
+```
+
+```
+ERROR   InvalidDistribution: Invalid distribution metadata: unrecognized or malformed field
+        'license-file'; unrecognized or malformed field 'license-expression'  
+```
+
+Install twine 6.1.0 and packaging 24.
+
+```
+pip install packaging -U
+```
+
+See [issue #1216](https://github.com/pypa/twine/issues/1216#issuecomment-2609745412).

anson_py3-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build" 
+
+[project]
+name = "anson.py3"
+version = "0.1.0"
+authors = [
+  { name="Ody Z", email="odys.zhou@gmail.com" },
+]
+description = "Anson for Python3"
+readme = "README.md"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = {text = """Copyright (c) 2025 Ody Z. All rights reserved.
+
+This work is licensed under the terms of the MIT license.
+For a copy, see <https://opensource.org/licenses/MIT>.""" }
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/anson"]
+
+[project.urls]
+Homepage = "https://github.com/odys-z/antson"
+Issues = "https://github.com/odys-z/antson/issues"
+

anson_py3-0.1.0/src/anson/io/odysz/anson/x/__init__.py

@@ -0,0 +1,10 @@
+
+class AnsonException:
+    type = "io.odysz.ansons.x.AnsonException"
+    excode = 0
+    err = ""
+
+    def __init__(self, excode: int, template: str, *param: object):
+        super().__init__()
+        self.excode = excode
+        self.err = template if param is None else template.format(param)