link-rep 0.0.2__tar.gz → 0.0.4__tar.gz

link_rep-0.0.4/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: link-rep
+Version: 0.0.4
+Summary: representation for a composite topological link.
+License: MIT
+License-File: LICENSE
+Author: GGN_2015
+Author-email: premierbob@qq.com
+Requires-Python: >=3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: typing_extensions
+Description-Content-Type: text/markdown
+
+# link-rep
+
+Parse and serialize the textual link-representation format used by the TopLink pipeline.
+
+## Installation
+
+```bash
+pip install linkrep
+```
+
+## Quick start
+
+Create `link_rep.LinkRep()` and call `deserialize(text)` or `serialize()`.
+
+PD codes are lists of four-entry crossings. Each arc label must occur exactly twice. Functions validate their inputs and do not mutate caller-owned PD-code lists unless explicitly documented.
+
+## Development
+
+Use Python 3.10 or newer for Python packages. Build distributions with `poetry build`. Run the package's tests or examples before publishing. C++ projects require a modern standards-compliant compiler.
+
+## License
+
+MIT. See `LICENSE`.
+

link_rep-0.0.4/README.md

@@ -0,0 +1,23 @@
+# link-rep
+
+Parse and serialize the textual link-representation format used by the TopLink pipeline.
+
+## Installation
+
+```bash
+pip install linkrep
+```
+
+## Quick start
+
+Create `link_rep.LinkRep()` and call `deserialize(text)` or `serialize()`.
+
+PD codes are lists of four-entry crossings. Each arc label must occur exactly twice. Functions validate their inputs and do not mutate caller-owned PD-code lists unless explicitly documented.
+
+## Development
+
+Use Python 3.10 or newer for Python packages. Build distributions with `poetry build`. Run the package's tests or examples before publishing. C++ projects require a modern standards-compliant compiler.
+
+## License
+
+MIT. See `LICENSE`.

{link_rep-0.0.2 → link_rep-0.0.4}/link_rep/__init__.py

@@ -1,4 +1,5 @@
 from .Comment import Comment
+from .LinkId import LinkId
 from .LinkMethod import LinkMethod
 from .LinkRep import LinkRep
 from .LinkSet import LinkSet
@@ -7,6 +8,7 @@ from .VarDef import VarDef
 
 __all__ = [
     "Comment",
+    "LinkId",
     "LinkMethod",
     "LinkRep", # 其中最重要的是 LinkRep
     "LinkSet",

{link_rep-0.0.2 → link_rep-0.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "link-rep"
-version = "0.0.2"
+version = "0.0.4"
 description = "representation for a composite topological link."
 authors = [
     {name = "GGN_2015",email = "premierbob@qq.com"}
@@ -15,4 +15,4 @@ dependencies = [
 
 [build-system]
 requires = ["poetry-core>=2.0.0,<3.0.0"]
-build-backend = "poetry.core.masonry.api"
+build-backend = "poetry.core.masonry.api"

link_rep-0.0.2/PKG-INFO

@@ -1,156 +0,0 @@
-Metadata-Version: 2.4
-Name: link-rep
-Version: 0.0.2
-Summary: representation for a composite topological link.
-License: MIT
-License-File: LICENSE
-Author: GGN_2015
-Author-email: premierbob@qq.com
-Requires-Python: >=3.10
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: typing_extensions
-Description-Content-Type: text/markdown
-
-# LinkRep
-A Cross-Platform Universal Representation for Composite Links
-
-## Installation
-
-```bash
-pip install link-rep
-```
-
-## Usage
-
-```python
-from link_rep import LinkRep
-
-real_serial = ( # human readable presentation
-"""
-// this is comment line 1
-// this is comment line 2
-L2a1: [[4, 1, 3, 2], [2, 3, 1, 4]]
-L4a1: [[6, 1, 7, 2], [8, 3, 5, 4], [2, 5, 3, 6], [4, 7, 1, 8]]
-K3a1: [[1, 5, 2, 4], [3, 1, 4, 6], [5, 3, 6, 2]]
-[L2a1, L4a1, K3a1]
-L[1, 1]#L[2, 1]
-L[2, 2]#L[3, 1]
-""").lstrip()
-
-link_r = LinkRep()
-link_r.deserialize(real_serial)
-
-print(link_r.json_serialize()) # machine readable presentation
-print(link_r.serialize())      # human readable presentation
-
-json_str = link_r.json_serialize()
-new_link_r = LinkRep()
-new_link_r.json_deserialize(json_str) # get data from json serial
-```
-
-## LinkRep Format
-
-The content of LinkRep consists of four parts:
-
-1. Comment Lines: Lines starting with `//`, as well as lines containing only whitespace characters, are comment lines. Lines containing only whitespace should be ignored during parsing, while comment lines should be retained as informational content.
-
-2. Variable Definitions (VarDef): Used to define variables that represent PdCodes (Planar Diagram Codes), for example:
-
-```
-L2a1: [[4, 1, 3, 2], [2, 3, 1, 4]]
-```
-
-The above statement defines a variable named `L2a1` that stores a PdCode `[[4, 1, 3, 2], [2, 3, 1, 4]]`. The variable name (VarName) should be a string composed of letters, numbers, and underscores, and must not start with a number. Multiple variables with different names can be defined.
-
-While the rules allow arbitrary variable naming, in practice it is recommended to use standard knot or link names to name PdCodes. Warnings should be issued for variable definitions using non-standard PdCodes.
-
-3. Link Set Description (LinkSet): A sequence of variable names describing all links used, where the order affects subsequent usage. This description can only appear once in LinkRep.
-
-```
-[L2a1, L4a1, K3a1]
-```
-
-This line describes the knot information before performing connected sums. In the connection method descriptor, `L[i, j]` is used to denote the j-th connected component of the i-th link variable. Both `i` and `j` are numbered starting from 1 and increment upwards.
-
-4. Connection Method Descriptor (LinkMethod): Describes which connected components of which links should be connected together, for example:
-
-```
-L[1, 1]#L[2, 2]
-```
-
-This can be used to indicate that the first connected component of the first link should be connected (via connected sum) with the second connected component of the second link.
-
-```
-L[1, 2]#L[2, 2]#L[3, 1]
-```
-
-This can be used to indicate that the second connected component of the first link should be connected (via connected sum) with the second connected component of the second link, and this connected component should then be connected (via connected sum) with the first connected component of the third link. The order of the components is defined by the order of minimal arc number in the component.
-
-## Formal Definition
-
-Lexical Units:
-```
-CommentLine => "//[^\n]*\n"
-VarName => "[A-Za-z_][A-Za-z0-9_]*"
-PdCode  => "\[\[\d+,\s*\d+,\s*\d+,\s*\d+\](,\[\d+,\s*\d+,\s*\d+,\s*\d+\])*\]"
-PosName => "L\[\d+,\s*\d+\]"
-```
-
-VarLine: Defines a single variable
-```
-VarLine -> VarName ":\s*" PdCode "\n"
-```
-
-VarDef: Defines all variables
-```
-VarDef -> VarLine
-VarDef -> VarLine VarDef
-```
-
-VarNameList: List of variable names
-```
-VarNameList -> VarName
-VarNameList -> VarName "," VarNameList
-```
-
-LinkSet: Defines all links to be used
-```
-LinkSet -> "[" VarNameList "]" "\n"
-```
-
-LinkLineList: Connects connected components without line breaks
-```
-LinkLineList -> PosName "#" PosName
-LinkLineList -> PosName "#" PosName "#" LinkLineList
-```
-
-LinkLine: Describes the connection of connected components
-```
-LinkLine -> LinkLineList "\n"
-```
-
-LinkMethod: Describes the connection of connected components
-```
-LinkMethod ->
-LinkMethod -> LinkLine
-LinkMethod -> LinkLine LinkMethod
-```
-
-Comment:
-```
-Comment ->
-Comment -> CommentLine
-Comment -> CommentLine Comment
-```
-
-LinkRep:
-```
-LinkRep -> Comment VarDef LinkSet LinkMethod
-```
-

link_rep-0.0.2/README.md

@@ -1,136 +0,0 @@
-# LinkRep
-A Cross-Platform Universal Representation for Composite Links
-
-## Installation
-
-```bash
-pip install link-rep
-```
-
-## Usage
-
-```python
-from link_rep import LinkRep
-
-real_serial = ( # human readable presentation
-"""
-// this is comment line 1
-// this is comment line 2
-L2a1: [[4, 1, 3, 2], [2, 3, 1, 4]]
-L4a1: [[6, 1, 7, 2], [8, 3, 5, 4], [2, 5, 3, 6], [4, 7, 1, 8]]
-K3a1: [[1, 5, 2, 4], [3, 1, 4, 6], [5, 3, 6, 2]]
-[L2a1, L4a1, K3a1]
-L[1, 1]#L[2, 1]
-L[2, 2]#L[3, 1]
-""").lstrip()
-
-link_r = LinkRep()
-link_r.deserialize(real_serial)
-
-print(link_r.json_serialize()) # machine readable presentation
-print(link_r.serialize())      # human readable presentation
-
-json_str = link_r.json_serialize()
-new_link_r = LinkRep()
-new_link_r.json_deserialize(json_str) # get data from json serial
-```
-
-## LinkRep Format
-
-The content of LinkRep consists of four parts:
-
-1. Comment Lines: Lines starting with `//`, as well as lines containing only whitespace characters, are comment lines. Lines containing only whitespace should be ignored during parsing, while comment lines should be retained as informational content.
-
-2. Variable Definitions (VarDef): Used to define variables that represent PdCodes (Planar Diagram Codes), for example:
-
-```
-L2a1: [[4, 1, 3, 2], [2, 3, 1, 4]]
-```
-
-The above statement defines a variable named `L2a1` that stores a PdCode `[[4, 1, 3, 2], [2, 3, 1, 4]]`. The variable name (VarName) should be a string composed of letters, numbers, and underscores, and must not start with a number. Multiple variables with different names can be defined.
-
-While the rules allow arbitrary variable naming, in practice it is recommended to use standard knot or link names to name PdCodes. Warnings should be issued for variable definitions using non-standard PdCodes.
-
-3. Link Set Description (LinkSet): A sequence of variable names describing all links used, where the order affects subsequent usage. This description can only appear once in LinkRep.
-
-```
-[L2a1, L4a1, K3a1]
-```
-
-This line describes the knot information before performing connected sums. In the connection method descriptor, `L[i, j]` is used to denote the j-th connected component of the i-th link variable. Both `i` and `j` are numbered starting from 1 and increment upwards.
-
-4. Connection Method Descriptor (LinkMethod): Describes which connected components of which links should be connected together, for example:
-
-```
-L[1, 1]#L[2, 2]
-```
-
-This can be used to indicate that the first connected component of the first link should be connected (via connected sum) with the second connected component of the second link.
-
-```
-L[1, 2]#L[2, 2]#L[3, 1]
-```
-
-This can be used to indicate that the second connected component of the first link should be connected (via connected sum) with the second connected component of the second link, and this connected component should then be connected (via connected sum) with the first connected component of the third link. The order of the components is defined by the order of minimal arc number in the component.
-
-## Formal Definition
-
-Lexical Units:
-```
-CommentLine => "//[^\n]*\n"
-VarName => "[A-Za-z_][A-Za-z0-9_]*"
-PdCode  => "\[\[\d+,\s*\d+,\s*\d+,\s*\d+\](,\[\d+,\s*\d+,\s*\d+,\s*\d+\])*\]"
-PosName => "L\[\d+,\s*\d+\]"
-```
-
-VarLine: Defines a single variable
-```
-VarLine -> VarName ":\s*" PdCode "\n"
-```
-
-VarDef: Defines all variables
-```
-VarDef -> VarLine
-VarDef -> VarLine VarDef
-```
-
-VarNameList: List of variable names
-```
-VarNameList -> VarName
-VarNameList -> VarName "," VarNameList
-```
-
-LinkSet: Defines all links to be used
-```
-LinkSet -> "[" VarNameList "]" "\n"
-```
-
-LinkLineList: Connects connected components without line breaks
-```
-LinkLineList -> PosName "#" PosName
-LinkLineList -> PosName "#" PosName "#" LinkLineList
-```
-
-LinkLine: Describes the connection of connected components
-```
-LinkLine -> LinkLineList "\n"
-```
-
-LinkMethod: Describes the connection of connected components
-```
-LinkMethod ->
-LinkMethod -> LinkLine
-LinkMethod -> LinkLine LinkMethod
-```
-
-Comment:
-```
-Comment ->
-Comment -> CommentLine
-Comment -> CommentLine Comment
-```
-
-LinkRep:
-```
-LinkRep -> Comment VarDef LinkSet LinkMethod
-```