GroupsMath 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,121 @@
1
+ Metadata-Version: 2.4
2
+ Name: GroupsMath
3
+ Version: 0.1.0
4
+ Summary: The educational Python library for Group Theory
5
+ Author-email: Mario Sultan Romero <mariosultan.uem@gmail.com>
6
+ License: PolyForm Strict License 1.0.0.
7
+ Project-URL: Homepage, https://github.com/MarioSultan/GroupsMath
8
+ Project-URL: Documentation, https://github.com/MarioSultan/GroupsMath/tree/main/docs
9
+ Project-URL: Issues, https://github.com/MarioSultan/GroupsMath/issues
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Operating System :: OS Independent
12
+ Requires-Python: >=3.8
13
+ Description-Content-Type: text/markdown
14
+ License-File: LICENSE
15
+ Dynamic: license-file
16
+
17
+ # GroupsMath – v0.4.0
18
+
19
+ ![GroupsMath Logo](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/logo.png)
20
+
21
+
22
+ **GroupsMath** is a Python module for constructing, studying, and manipulating finite groups.
23
+
24
+ The project aims to provide a simple and intuitive interface for working with finite groups and their algebraic properties.
25
+
26
+ > **Note:** GroupsMath is currently under active development. Its API is still evolving and may change before version `1.0.0`.
27
+
28
+ ---
29
+
30
+ ## Installation
31
+
32
+ GroupsMath is currently distributed through GitHub and has not yet been published on PyPI.
33
+
34
+ To install the latest released version from PyPI, run:
35
+
36
+ ```bash
37
+ pip install groupsmath
38
+ ```
39
+
40
+ Alternatively, you can install the latest development version directly from GitHub:
41
+
42
+ ```bash
43
+ pip install git+https://github.com/MarioSultan/GroupsMath.git
44
+ ```
45
+
46
+ Alternatively, you can visit https://github.com/MarioSultan/GroupsMath and download all the files.
47
+
48
+ ---
49
+
50
+ ## Examples
51
+
52
+ ### Cayley table of $S_3$
53
+ ![S3 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_S3.png)
54
+
55
+ ### Cayley table of $A_5\times C_4$
56
+ ![A4xC3 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_A4xC3.png)
57
+
58
+ ### Cayley table of $U_{1200}$
59
+ ![U1200 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_U1200.png)
60
+
61
+
62
+ ---
63
+
64
+ ## Features
65
+
66
+ GroupsMath is designed to provide tools for working with finite groups, including:
67
+
68
+ **GROUPS:**
69
+ * Construction of finite groups.
70
+ * Determination of the order of a group and its elements.
71
+ * Operation with group elements (multiplication, inverse, powers, ...)
72
+ * Computation of Cayley tables with `matplotlib.pyplot`.
73
+ * Detection of algebraic properties such as cyclicity and commutativity.
74
+ * Computation and exploration of other structural properties of finite groups.
75
+ * Predefined group families in the library `groupsmath.precooked`, such as $C_n$, $S_n$, $A_n$, $D_n$, $V_4$, $Q_8$, ...
76
+
77
+ **SUBGROUPS:**
78
+ * Study of subgroups (order, cosets, normal subgroups, quotients, ...).
79
+ * Normal subgroups.
80
+ * Quotient groups $Q=G/H$.
81
+
82
+ **AUTOMORPHISMS:**
83
+ * Class `Automorphism` and automorphism functions.
84
+ * Automorphism groups $\text{Aut}(G)$.
85
+
86
+ **PRODUCTS:**
87
+ * Direct product of two groups $G\times H$.
88
+ * Semidirect product of two groups $G\rtimes H$.
89
+
90
+ The available functionality will expand as the project develops.
91
+
92
+ ---
93
+
94
+ ## Coming soon
95
+
96
+ The GroupsMath team is currently working on theese ideas:
97
+ * Presentation of groups and generators.
98
+ * Groups generated by matrices ($GL$, $O$,...).
99
+ * Optimization of actual features.
100
+
101
+ ---
102
+
103
+ ## Documentation
104
+
105
+ Detailed documentation is available in the [`docs`](https://github.com/MarioSultan/GroupsMath/tree/main/docs) directory of GitHub. The documentation is developed alongside the library.
106
+
107
+ ---
108
+
109
+ ## Project status
110
+
111
+ GroupsMath is currently under active development.
112
+
113
+ The project has successfully transitioned to an object-oriented interface centered around the `Group` class. The legacy function-based interface is being removed for future versions.
114
+
115
+ The API should therefore be considered **unstable** until the `1.0.0` release, and breaking changes may occur between development versions.
116
+
117
+ ---
118
+
119
+ ## Contributing
120
+
121
+ Contributions, suggestions, and bug reports are welcome. If you find a bug or have an idea for improving GroupsMath, please open an issue in the GitHub repository.
@@ -0,0 +1,11 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ GroupsMath.egg-info/PKG-INFO
5
+ GroupsMath.egg-info/SOURCES.txt
6
+ GroupsMath.egg-info/dependency_links.txt
7
+ GroupsMath.egg-info/top_level.txt
8
+ groupsmath/__init__.py
9
+ groupsmath/core.py
10
+ groupsmath/precooked.py
11
+ groupsmath/shortcuts.py
@@ -0,0 +1,4 @@
1
+ dist
2
+ docs
3
+ groupsmath
4
+ imgs
@@ -0,0 +1,14 @@
1
+ Copyright (c) 2026 Mario Sultan Romero
2
+
3
+ This software is licensed under the PolyForm Strict License 1.0.0.
4
+
5
+ The complete license terms are available at:
6
+ https://polyformproject.org/licenses/strict/1.0.0
7
+
8
+ PolyForm Strict 1.0.0 permits non-commercial use, including personal study,
9
+ research, experimentation, testing, hobby projects, and use by educational
10
+ institutions and public research organizations. It does not grant permission
11
+ to distribute the software or to make changes or new works based on it.
12
+
13
+ For the complete and legally authoritative terms, see the official license text
14
+ at the URL above.
@@ -0,0 +1,121 @@
1
+ Metadata-Version: 2.4
2
+ Name: GroupsMath
3
+ Version: 0.1.0
4
+ Summary: The educational Python library for Group Theory
5
+ Author-email: Mario Sultan Romero <mariosultan.uem@gmail.com>
6
+ License: PolyForm Strict License 1.0.0.
7
+ Project-URL: Homepage, https://github.com/MarioSultan/GroupsMath
8
+ Project-URL: Documentation, https://github.com/MarioSultan/GroupsMath/tree/main/docs
9
+ Project-URL: Issues, https://github.com/MarioSultan/GroupsMath/issues
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Operating System :: OS Independent
12
+ Requires-Python: >=3.8
13
+ Description-Content-Type: text/markdown
14
+ License-File: LICENSE
15
+ Dynamic: license-file
16
+
17
+ # GroupsMath – v0.4.0
18
+
19
+ ![GroupsMath Logo](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/logo.png)
20
+
21
+
22
+ **GroupsMath** is a Python module for constructing, studying, and manipulating finite groups.
23
+
24
+ The project aims to provide a simple and intuitive interface for working with finite groups and their algebraic properties.
25
+
26
+ > **Note:** GroupsMath is currently under active development. Its API is still evolving and may change before version `1.0.0`.
27
+
28
+ ---
29
+
30
+ ## Installation
31
+
32
+ GroupsMath is currently distributed through GitHub and has not yet been published on PyPI.
33
+
34
+ To install the latest released version from PyPI, run:
35
+
36
+ ```bash
37
+ pip install groupsmath
38
+ ```
39
+
40
+ Alternatively, you can install the latest development version directly from GitHub:
41
+
42
+ ```bash
43
+ pip install git+https://github.com/MarioSultan/GroupsMath.git
44
+ ```
45
+
46
+ Alternatively, you can visit https://github.com/MarioSultan/GroupsMath and download all the files.
47
+
48
+ ---
49
+
50
+ ## Examples
51
+
52
+ ### Cayley table of $S_3$
53
+ ![S3 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_S3.png)
54
+
55
+ ### Cayley table of $A_5\times C_4$
56
+ ![A4xC3 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_A4xC3.png)
57
+
58
+ ### Cayley table of $U_{1200}$
59
+ ![U1200 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_U1200.png)
60
+
61
+
62
+ ---
63
+
64
+ ## Features
65
+
66
+ GroupsMath is designed to provide tools for working with finite groups, including:
67
+
68
+ **GROUPS:**
69
+ * Construction of finite groups.
70
+ * Determination of the order of a group and its elements.
71
+ * Operation with group elements (multiplication, inverse, powers, ...)
72
+ * Computation of Cayley tables with `matplotlib.pyplot`.
73
+ * Detection of algebraic properties such as cyclicity and commutativity.
74
+ * Computation and exploration of other structural properties of finite groups.
75
+ * Predefined group families in the library `groupsmath.precooked`, such as $C_n$, $S_n$, $A_n$, $D_n$, $V_4$, $Q_8$, ...
76
+
77
+ **SUBGROUPS:**
78
+ * Study of subgroups (order, cosets, normal subgroups, quotients, ...).
79
+ * Normal subgroups.
80
+ * Quotient groups $Q=G/H$.
81
+
82
+ **AUTOMORPHISMS:**
83
+ * Class `Automorphism` and automorphism functions.
84
+ * Automorphism groups $\text{Aut}(G)$.
85
+
86
+ **PRODUCTS:**
87
+ * Direct product of two groups $G\times H$.
88
+ * Semidirect product of two groups $G\rtimes H$.
89
+
90
+ The available functionality will expand as the project develops.
91
+
92
+ ---
93
+
94
+ ## Coming soon
95
+
96
+ The GroupsMath team is currently working on theese ideas:
97
+ * Presentation of groups and generators.
98
+ * Groups generated by matrices ($GL$, $O$,...).
99
+ * Optimization of actual features.
100
+
101
+ ---
102
+
103
+ ## Documentation
104
+
105
+ Detailed documentation is available in the [`docs`](https://github.com/MarioSultan/GroupsMath/tree/main/docs) directory of GitHub. The documentation is developed alongside the library.
106
+
107
+ ---
108
+
109
+ ## Project status
110
+
111
+ GroupsMath is currently under active development.
112
+
113
+ The project has successfully transitioned to an object-oriented interface centered around the `Group` class. The legacy function-based interface is being removed for future versions.
114
+
115
+ The API should therefore be considered **unstable** until the `1.0.0` release, and breaking changes may occur between development versions.
116
+
117
+ ---
118
+
119
+ ## Contributing
120
+
121
+ Contributions, suggestions, and bug reports are welcome. If you find a bug or have an idea for improving GroupsMath, please open an issue in the GitHub repository.
@@ -0,0 +1,105 @@
1
+ # GroupsMath – v0.4.0
2
+
3
+ ![GroupsMath Logo](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/logo.png)
4
+
5
+
6
+ **GroupsMath** is a Python module for constructing, studying, and manipulating finite groups.
7
+
8
+ The project aims to provide a simple and intuitive interface for working with finite groups and their algebraic properties.
9
+
10
+ > **Note:** GroupsMath is currently under active development. Its API is still evolving and may change before version `1.0.0`.
11
+
12
+ ---
13
+
14
+ ## Installation
15
+
16
+ GroupsMath is currently distributed through GitHub and has not yet been published on PyPI.
17
+
18
+ To install the latest released version from PyPI, run:
19
+
20
+ ```bash
21
+ pip install groupsmath
22
+ ```
23
+
24
+ Alternatively, you can install the latest development version directly from GitHub:
25
+
26
+ ```bash
27
+ pip install git+https://github.com/MarioSultan/GroupsMath.git
28
+ ```
29
+
30
+ Alternatively, you can visit https://github.com/MarioSultan/GroupsMath and download all the files.
31
+
32
+ ---
33
+
34
+ ## Examples
35
+
36
+ ### Cayley table of $S_3$
37
+ ![S3 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_S3.png)
38
+
39
+ ### Cayley table of $A_5\times C_4$
40
+ ![A4xC3 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_A4xC3.png)
41
+
42
+ ### Cayley table of $U_{1200}$
43
+ ![U1200 table](https://raw.githubusercontent.com/MarioSultan/GroupsMath/main/imgs/cayley_U1200.png)
44
+
45
+
46
+ ---
47
+
48
+ ## Features
49
+
50
+ GroupsMath is designed to provide tools for working with finite groups, including:
51
+
52
+ **GROUPS:**
53
+ * Construction of finite groups.
54
+ * Determination of the order of a group and its elements.
55
+ * Operation with group elements (multiplication, inverse, powers, ...)
56
+ * Computation of Cayley tables with `matplotlib.pyplot`.
57
+ * Detection of algebraic properties such as cyclicity and commutativity.
58
+ * Computation and exploration of other structural properties of finite groups.
59
+ * Predefined group families in the library `groupsmath.precooked`, such as $C_n$, $S_n$, $A_n$, $D_n$, $V_4$, $Q_8$, ...
60
+
61
+ **SUBGROUPS:**
62
+ * Study of subgroups (order, cosets, normal subgroups, quotients, ...).
63
+ * Normal subgroups.
64
+ * Quotient groups $Q=G/H$.
65
+
66
+ **AUTOMORPHISMS:**
67
+ * Class `Automorphism` and automorphism functions.
68
+ * Automorphism groups $\text{Aut}(G)$.
69
+
70
+ **PRODUCTS:**
71
+ * Direct product of two groups $G\times H$.
72
+ * Semidirect product of two groups $G\rtimes H$.
73
+
74
+ The available functionality will expand as the project develops.
75
+
76
+ ---
77
+
78
+ ## Coming soon
79
+
80
+ The GroupsMath team is currently working on theese ideas:
81
+ * Presentation of groups and generators.
82
+ * Groups generated by matrices ($GL$, $O$,...).
83
+ * Optimization of actual features.
84
+
85
+ ---
86
+
87
+ ## Documentation
88
+
89
+ Detailed documentation is available in the [`docs`](https://github.com/MarioSultan/GroupsMath/tree/main/docs) directory of GitHub. The documentation is developed alongside the library.
90
+
91
+ ---
92
+
93
+ ## Project status
94
+
95
+ GroupsMath is currently under active development.
96
+
97
+ The project has successfully transitioned to an object-oriented interface centered around the `Group` class. The legacy function-based interface is being removed for future versions.
98
+
99
+ The API should therefore be considered **unstable** until the `1.0.0` release, and breaking changes may occur between development versions.
100
+
101
+ ---
102
+
103
+ ## Contributing
104
+
105
+ Contributions, suggestions, and bug reports are welcome. If you find a bug or have an idea for improving GroupsMath, please open an issue in the GitHub repository.
@@ -0,0 +1 @@
1
+ from .core import *