glosa 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.
glosa-0.1.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 credetus
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
glosa-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,82 @@
1
+ Metadata-Version: 2.4
2
+ Name: glosa
3
+ Version: 0.1.0
4
+ Summary: Glosa.
5
+ Author: credetus
6
+ Author-email: credetus <dev@credetus.com>
7
+ License-Expression: MIT
8
+ License-File: LICENSE
9
+ Classifier: Development Status :: 3 - Alpha
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: Operating System :: OS Independent
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3 :: Only
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: 3.14
19
+ Classifier: Typing :: Typed
20
+ Requires-Python: >=3.10
21
+ Project-URL: Homepage, https://github.com/credetus/glosa
22
+ Project-URL: Repository, https://github.com/credetus/glosa
23
+ Project-URL: Issues, https://github.com/credetus/glosa/issues
24
+ Project-URL: Changelog, https://github.com/credetus/glosa/releases
25
+ Description-Content-Type: text/markdown
26
+
27
+ # glosa
28
+
29
+ Glosa.
30
+
31
+ ## Installation
32
+
33
+ ```bash
34
+ uv add glosa
35
+ # or
36
+ pip install glosa
37
+ ```
38
+
39
+ ## Usage
40
+
41
+ ```python
42
+ from glosa import BaseStorageManager, Glosa
43
+
44
+
45
+ class MyStorageManager(BaseStorageManager):
46
+ pass
47
+
48
+
49
+ class MyGlosa(Glosa):
50
+ pass
51
+
52
+
53
+ app = MyGlosa(storage_manager=MyStorageManager())
54
+ ```
55
+
56
+ ## Development
57
+
58
+ ```bash
59
+ uv sync # create .venv and install dev dependencies
60
+ uv run pytest --cov # run tests with coverage
61
+ uv run ruff check . # lint
62
+ uv run ruff format . # format
63
+ uv run ty check # type check
64
+ uv build # build sdist + wheel into dist/
65
+ ```
66
+
67
+ ## Releasing
68
+
69
+ Releases are published to PyPI by GitHub Actions using
70
+ [trusted publishing](https://docs.pypi.org/trusted-publishers/) (no API tokens).
71
+
72
+ 1. Bump the version: `uv version --bump patch` (or `minor` / `major`).
73
+ 2. Commit and push to `main`.
74
+ 3. Tag and push: `git tag v$(uv version --short) && git push --tags`.
75
+
76
+ The `Release` workflow runs CI, verifies the tag matches `pyproject.toml`,
77
+ builds and smoke-tests the distributions, publishes to PyPI, and creates a
78
+ GitHub Release with auto-generated notes.
79
+
80
+ ## License
81
+
82
+ MIT
glosa-0.1.0/README.md ADDED
@@ -0,0 +1,56 @@
1
+ # glosa
2
+
3
+ Glosa.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ uv add glosa
9
+ # or
10
+ pip install glosa
11
+ ```
12
+
13
+ ## Usage
14
+
15
+ ```python
16
+ from glosa import BaseStorageManager, Glosa
17
+
18
+
19
+ class MyStorageManager(BaseStorageManager):
20
+ pass
21
+
22
+
23
+ class MyGlosa(Glosa):
24
+ pass
25
+
26
+
27
+ app = MyGlosa(storage_manager=MyStorageManager())
28
+ ```
29
+
30
+ ## Development
31
+
32
+ ```bash
33
+ uv sync # create .venv and install dev dependencies
34
+ uv run pytest --cov # run tests with coverage
35
+ uv run ruff check . # lint
36
+ uv run ruff format . # format
37
+ uv run ty check # type check
38
+ uv build # build sdist + wheel into dist/
39
+ ```
40
+
41
+ ## Releasing
42
+
43
+ Releases are published to PyPI by GitHub Actions using
44
+ [trusted publishing](https://docs.pypi.org/trusted-publishers/) (no API tokens).
45
+
46
+ 1. Bump the version: `uv version --bump patch` (or `minor` / `major`).
47
+ 2. Commit and push to `main`.
48
+ 3. Tag and push: `git tag v$(uv version --short) && git push --tags`.
49
+
50
+ The `Release` workflow runs CI, verifies the tag matches `pyproject.toml`,
51
+ builds and smoke-tests the distributions, publishes to PyPI, and creates a
52
+ GitHub Release with auto-generated notes.
53
+
54
+ ## License
55
+
56
+ MIT
@@ -0,0 +1,99 @@
1
+ [project]
2
+ name = "glosa"
3
+ version = "0.1.0"
4
+ description = "Glosa."
5
+ readme = "README.md"
6
+ license = "MIT"
7
+ license-files = ["LICENSE"]
8
+ requires-python = ">=3.10"
9
+ dependencies = []
10
+ classifiers = [
11
+ "Development Status :: 3 - Alpha",
12
+ "Intended Audience :: Developers",
13
+ "Operating System :: OS Independent",
14
+ "Programming Language :: Python :: 3",
15
+ "Programming Language :: Python :: 3 :: Only",
16
+ "Programming Language :: Python :: 3.10",
17
+ "Programming Language :: Python :: 3.11",
18
+ "Programming Language :: Python :: 3.12",
19
+ "Programming Language :: Python :: 3.13",
20
+ "Programming Language :: Python :: 3.14",
21
+ "Typing :: Typed",
22
+ ]
23
+
24
+ [[project.authors]]
25
+ name = "credetus"
26
+ email = "dev@credetus.com"
27
+
28
+ [project.urls]
29
+ Homepage = "https://github.com/credetus/glosa"
30
+ Repository = "https://github.com/credetus/glosa"
31
+ Issues = "https://github.com/credetus/glosa/issues"
32
+ Changelog = "https://github.com/credetus/glosa/releases"
33
+
34
+ [build-system]
35
+ requires = ["uv_build>=0.12.19,<0.13.0"]
36
+ build-backend = "uv_build"
37
+
38
+ [dependency-groups]
39
+ dev = [
40
+ "pytest>=9.1.1",
41
+ "pytest-cov>=7.1.0",
42
+ "ruff>=0.16.9",
43
+ "ty>=0.0.84",
44
+ "uv>=0.12.19",
45
+ ]
46
+
47
+ [tool.ruff]
48
+ line-length = 88
49
+ target-version = "py310"
50
+ src = [
51
+ "src",
52
+ "tests",
53
+ ]
54
+
55
+ [tool.ruff.lint]
56
+ select = [
57
+ "E",
58
+ "W",
59
+ "F",
60
+ "I",
61
+ "B",
62
+ "UP",
63
+ "SIM",
64
+ "C4",
65
+ "RUF",
66
+ "PT",
67
+ ]
68
+
69
+ [tool.ruff.format]
70
+ docstring-code-format = true
71
+
72
+ [tool.ty.environment]
73
+ python-version = "3.10"
74
+
75
+ [tool.ty.src]
76
+ include = [
77
+ "src",
78
+ "tests",
79
+ ]
80
+
81
+ [tool.pytest.ini_options]
82
+ minversion = "8.0"
83
+ testpaths = ["tests"]
84
+ addopts = [
85
+ "-ra",
86
+ "--strict-markers",
87
+ "--strict-config",
88
+ "--import-mode=importlib",
89
+ ]
90
+ xfail_strict = true
91
+
92
+ [tool.coverage.run]
93
+ source = ["glosa"]
94
+ branch = true
95
+
96
+ [tool.coverage.report]
97
+ show_missing = true
98
+ skip_covered = false
99
+ exclude_also = ["if TYPE_CHECKING:"]
@@ -0,0 +1,96 @@
1
+ [project]
2
+ name = "glosa"
3
+ version = "0.1.0"
4
+ description = "Glosa."
5
+ readme = "README.md"
6
+ license = "MIT"
7
+ license-files = ["LICENSE"]
8
+ authors = [
9
+ { name = "credetus", email = "dev@credetus.com" }
10
+ ]
11
+ requires-python = ">=3.10"
12
+ dependencies = []
13
+ classifiers = [
14
+ "Development Status :: 3 - Alpha",
15
+ "Intended Audience :: Developers",
16
+ "Operating System :: OS Independent",
17
+ "Programming Language :: Python :: 3",
18
+ "Programming Language :: Python :: 3 :: Only",
19
+ "Programming Language :: Python :: 3.10",
20
+ "Programming Language :: Python :: 3.11",
21
+ "Programming Language :: Python :: 3.12",
22
+ "Programming Language :: Python :: 3.13",
23
+ "Programming Language :: Python :: 3.14",
24
+ "Typing :: Typed",
25
+ ]
26
+
27
+ [project.urls]
28
+ Homepage = "https://github.com/credetus/glosa"
29
+ Repository = "https://github.com/credetus/glosa"
30
+ Issues = "https://github.com/credetus/glosa/issues"
31
+ Changelog = "https://github.com/credetus/glosa/releases"
32
+
33
+ [build-system]
34
+ requires = ["uv_build>=0.12.19,<0.13.0"]
35
+ build-backend = "uv_build"
36
+
37
+ [dependency-groups]
38
+ dev = [
39
+ "pytest>=9.1.1",
40
+ "pytest-cov>=7.1.0",
41
+ "ruff>=0.16.9",
42
+ "ty>=0.0.84",
43
+ "uv>=0.12.19",
44
+ ]
45
+
46
+ # ---------------------------------------------------------------------------
47
+ # Ruff
48
+ # ---------------------------------------------------------------------------
49
+ [tool.ruff]
50
+ line-length = 88
51
+ target-version = "py310"
52
+ src = ["src", "tests"]
53
+
54
+ [tool.ruff.lint]
55
+ select = [
56
+ "E", # pycodestyle errors
57
+ "W", # pycodestyle warnings
58
+ "F", # pyflakes
59
+ "I", # isort
60
+ "B", # flake8-bugbear
61
+ "UP", # pyupgrade
62
+ "SIM", # flake8-simplify
63
+ "C4", # flake8-comprehensions
64
+ "RUF", # ruff-specific
65
+ "PT", # flake8-pytest-style
66
+ ]
67
+
68
+ [tool.ruff.format]
69
+ docstring-code-format = true
70
+
71
+ # ---------------------------------------------------------------------------
72
+ # ty
73
+ # ---------------------------------------------------------------------------
74
+ [tool.ty.environment]
75
+ python-version = "3.10"
76
+
77
+ [tool.ty.src]
78
+ include = ["src", "tests"]
79
+
80
+ # ---------------------------------------------------------------------------
81
+ # Pytest / coverage
82
+ # ---------------------------------------------------------------------------
83
+ [tool.pytest.ini_options]
84
+ minversion = "8.0"
85
+ testpaths = ["tests"]
86
+ addopts = ["-ra", "--strict-markers", "--strict-config", "--import-mode=importlib"]
87
+ xfail_strict = true
88
+
89
+ [tool.coverage.run]
90
+ source = ["glosa"]
91
+ branch = true
92
+
93
+ [tool.coverage.report]
94
+ show_missing = true
95
+ skip_covered = false
96
+ exclude_also = ["if TYPE_CHECKING:"]
@@ -0,0 +1,9 @@
1
+ """glosa."""
2
+
3
+ from importlib.metadata import version
4
+
5
+ from glosa.core import Glosa
6
+ from glosa.storage import BaseStorageManager
7
+
8
+ __all__ = ["BaseStorageManager", "Glosa", "__version__"]
9
+ __version__ = version("glosa")
@@ -0,0 +1,12 @@
1
+ """Glosa base class."""
2
+
3
+ from abc import ABC
4
+
5
+ from glosa.storage import BaseStorageManager
6
+
7
+
8
+ class Glosa(ABC): # noqa: B024 - abstract methods to be added
9
+ """Abstract base class for Glosa."""
10
+
11
+ def __init__(self, storage_manager: BaseStorageManager) -> None:
12
+ self.storage_manager = storage_manager
File without changes
@@ -0,0 +1,10 @@
1
+ """Storage manager base class."""
2
+
3
+ from abc import ABC
4
+
5
+
6
+ class BaseStorageManager(ABC): # noqa: B024 - abstract methods to be added
7
+ """Base class for storage managers."""
8
+
9
+ def __init__(self) -> None: # noqa: B027
10
+ pass