twat 1.6.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,112 @@
1
+ name: Build & Test
2
+
3
+ on:
4
+ push:
5
+ branches: [main]
6
+ tags-ignore: ["v*"]
7
+ pull_request:
8
+ branches: [main]
9
+ workflow_dispatch:
10
+
11
+ permissions:
12
+ contents: write
13
+ id-token: write
14
+
15
+ concurrency:
16
+ group: ${{ github.workflow }}-${{ github.ref }}
17
+ cancel-in-progress: true
18
+
19
+ jobs:
20
+ quality:
21
+ name: Code Quality
22
+ runs-on: ubuntu-latest
23
+ steps:
24
+ - name: Checkout code
25
+ uses: actions/checkout@v4
26
+ with:
27
+ fetch-depth: 0
28
+
29
+ - name: Run Ruff lint
30
+ uses: astral-sh/ruff-action@v3
31
+ with:
32
+ version: "latest"
33
+ args: "check --output-format=github"
34
+
35
+ - name: Run Ruff Format
36
+ uses: astral-sh/ruff-action@v3
37
+ with:
38
+ version: "latest"
39
+ args: "format --check --respect-gitignore"
40
+
41
+ test:
42
+ name: Run Tests
43
+ needs: quality
44
+ strategy:
45
+ matrix:
46
+ python-version: ["3.10"]
47
+ os: [ubuntu-latest]
48
+ fail-fast: true
49
+ runs-on: ${{ matrix.os }}
50
+ steps:
51
+ - name: Checkout code
52
+ uses: actions/checkout@v4
53
+
54
+ - name: Set up Python
55
+ uses: actions/setup-python@v5
56
+ with:
57
+ python-version: ${{ matrix.python-version }}
58
+
59
+ - name: Install UV
60
+ uses: astral-sh/setup-uv@v5
61
+ with:
62
+ version: "latest"
63
+ python-version: ${{ matrix.python-version }}
64
+ enable-cache: true
65
+ cache-suffix: ${{ matrix.os }}-${{ matrix.python-version }}
66
+
67
+ - name: Install test dependencies
68
+ run: |
69
+ uv pip install --system --upgrade pip
70
+ uv pip install --system ".[test]"
71
+
72
+ - name: Run tests with Pytest
73
+ run: uv run pytest -n auto --maxfail=1 --disable-warnings --cov-report=xml --cov-config=pyproject.toml --cov=src/twat --cov=tests tests/
74
+
75
+ - name: Upload coverage report
76
+ uses: actions/upload-artifact@v4
77
+ with:
78
+ name: coverage-${{ matrix.python-version }}-${{ matrix.os }}
79
+ path: coverage.xml
80
+
81
+ build:
82
+ name: Build Distribution
83
+ needs: test
84
+ runs-on: ubuntu-latest
85
+ steps:
86
+ - name: Checkout code
87
+ uses: actions/checkout@v4
88
+
89
+ - name: Set up Python
90
+ uses: actions/setup-python@v5
91
+ with:
92
+ python-version: "3.12"
93
+
94
+ - name: Install UV
95
+ uses: astral-sh/setup-uv@v5
96
+ with:
97
+ version: "latest"
98
+ python-version: "3.12"
99
+ enable-cache: true
100
+
101
+ - name: Install build tools
102
+ run: uv pip install build hatchling hatch-vcs
103
+
104
+ - name: Build distributions
105
+ run: uv run python -m build --outdir dist
106
+
107
+ - name: Upload distribution artifacts
108
+ uses: actions/upload-artifact@v4
109
+ with:
110
+ name: dist-files
111
+ path: dist/
112
+ retention-days: 5
@@ -0,0 +1,59 @@
1
+ name: Release
2
+
3
+ on:
4
+ push:
5
+ tags: ["v*"]
6
+
7
+ permissions:
8
+ contents: write
9
+ id-token: write
10
+
11
+ jobs:
12
+ release:
13
+ name: Release to PyPI
14
+ runs-on: ubuntu-latest
15
+ environment:
16
+ name: pypi
17
+ url: https://pypi.org/p/twat
18
+ steps:
19
+ - name: Checkout code
20
+ uses: actions/checkout@v4
21
+ with:
22
+ fetch-depth: 0
23
+
24
+ - name: Set up Python
25
+ uses: actions/setup-python@v5
26
+ with:
27
+ python-version: "3.12"
28
+
29
+ - name: Install UV
30
+ uses: astral-sh/setup-uv@v5
31
+ with:
32
+ version: "latest"
33
+ python-version: "3.12"
34
+ enable-cache: true
35
+
36
+ - name: Install build tools
37
+ run: uv pip install build hatchling hatch-vcs
38
+
39
+ - name: Build distributions
40
+ run: uv run python -m build --outdir dist
41
+
42
+ - name: Verify distribution files
43
+ run: |
44
+ ls -la dist/
45
+ test -n "$(find dist -name '*.whl')" || (echo "Wheel file missing" && exit 1)
46
+ test -n "$(find dist -name '*.tar.gz')" || (echo "Source distribution missing" && exit 1)
47
+
48
+ - name: Publish to PyPI
49
+ uses: pypa/gh-action-pypi-publish@release/v1
50
+ with:
51
+ password: ${{ secrets.PYPI_TOKEN }}
52
+
53
+ - name: Create GitHub Release
54
+ uses: softprops/action-gh-release@v1
55
+ with:
56
+ files: dist/*
57
+ generate_release_notes: true
58
+ env:
59
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
twat-1.6.0/.gitignore ADDED
@@ -0,0 +1,314 @@
1
+ *_autogen/
2
+ .DS_Store
3
+ __version__.py
4
+ __pycache__/
5
+ _Chutzpah*
6
+ _deps
7
+ _NCrunch_*
8
+ _pkginfo.txt
9
+ _Pvt_Extensions
10
+ _ReSharper*/
11
+ _TeamCity*
12
+ _UpgradeReport_Files/
13
+ !?*.[Cc]ache/
14
+ !.axoCover/settings.json
15
+ !.vscode/extensions.json
16
+ !.vscode/launch.json
17
+ !.vscode/settings.json
18
+ !.vscode/tasks.json
19
+ !**/[Pp]ackages/build/
20
+ !Directory.Build.rsp
21
+ .*crunch*.local.xml
22
+ .axoCover/*
23
+ .builds
24
+ .cr/personal
25
+ .fake/
26
+ .history/
27
+ .ionide/
28
+ .localhistory/
29
+ .mfractor/
30
+ .ntvs_analysis.dat
31
+ .paket/paket.exe
32
+ .sass-cache/
33
+ .vs/
34
+ .vscode
35
+ .vscode/*
36
+ .vshistory/
37
+ [Aa][Rr][Mm]/
38
+ [Aa][Rr][Mm]64/
39
+ [Bb]in/
40
+ [Bb]uild[Ll]og.*
41
+ [Dd]ebug/
42
+ [Dd]ebugPS/
43
+ [Dd]ebugPublic/
44
+ [Ee]xpress/
45
+ [Ll]og/
46
+ [Ll]ogs/
47
+ [Oo]bj/
48
+ [Rr]elease/
49
+ [Rr]eleasePS/
50
+ [Rr]eleases/
51
+ [Tt]est[Rr]esult*/
52
+ [Ww][Ii][Nn]32/
53
+ *_h.h
54
+ *_i.c
55
+ *_p.c
56
+ *_wpftmp.csproj
57
+ *- [Bb]ackup ([0-9]).rdl
58
+ *- [Bb]ackup ([0-9][0-9]).rdl
59
+ *- [Bb]ackup.rdl
60
+ *.[Cc]ache
61
+ *.[Pp]ublish.xml
62
+ *.[Rr]e[Ss]harper
63
+ *.a
64
+ *.app
65
+ *.appx
66
+ *.appxbundle
67
+ *.appxupload
68
+ *.aps
69
+ *.azurePubxml
70
+ *.bim_*.settings
71
+ *.bim.layout
72
+ *.binlog
73
+ *.btm.cs
74
+ *.btp.cs
75
+ *.build.csdef
76
+ *.cab
77
+ *.cachefile
78
+ *.code-workspace
79
+ *.coverage
80
+ *.coveragexml
81
+ *.d
82
+ *.dbmdl
83
+ *.dbproj.schemaview
84
+ *.dll
85
+ *.dotCover
86
+ *.DotSettings.user
87
+ *.dsp
88
+ *.dsw
89
+ *.dylib
90
+ *.e2e
91
+ *.exe
92
+ *.gch
93
+ *.GhostDoc.xml
94
+ *.gpState
95
+ *.ilk
96
+ *.iobj
97
+ *.ipdb
98
+ *.jfm
99
+ *.jmconfig
100
+ *.la
101
+ *.lai
102
+ *.ldf
103
+ *.lib
104
+ *.lo
105
+ *.log
106
+ *.mdf
107
+ *.meta
108
+ *.mm.*
109
+ *.mod
110
+ *.msi
111
+ *.msix
112
+ *.msm
113
+ *.msp
114
+ *.ncb
115
+ *.ndf
116
+ *.nuget.props
117
+ *.nuget.targets
118
+ *.nupkg
119
+ *.nvuser
120
+ *.o
121
+ *.obj
122
+ *.odx.cs
123
+ *.opendb
124
+ *.opensdf
125
+ *.opt
126
+ *.out
127
+ *.pch
128
+ *.pdb
129
+ *.pfx
130
+ *.pgc
131
+ *.pgd
132
+ *.pidb
133
+ *.plg
134
+ *.psess
135
+ *.publishproj
136
+ *.publishsettings
137
+ *.pubxml
138
+ *.pyc
139
+ *.rdl.data
140
+ *.rptproj.bak
141
+ *.rptproj.rsuser
142
+ *.rsp
143
+ *.rsuser
144
+ *.sap
145
+ *.sbr
146
+ *.scc
147
+ *.sdf
148
+ *.sln.docstates
149
+ *.sln.iml
150
+ *.slo
151
+ *.smod
152
+ *.snupkg
153
+ *.so
154
+ *.suo
155
+ *.svclog
156
+ *.tlb
157
+ *.tlh
158
+ *.tli
159
+ *.tlog
160
+ *.tmp
161
+ *.tmp_proj
162
+ *.tss
163
+ *.user
164
+ *.userosscache
165
+ *.userprefs
166
+ *.vbp
167
+ *.vbw
168
+ *.VC.db
169
+ *.VC.VC.opendb
170
+ *.VisualState.xml
171
+ *.vsp
172
+ *.vspscc
173
+ *.vspx
174
+ *.vssscc
175
+ *.xsd.cs
176
+ **/[Pp]ackages/*
177
+ **/*.DesktopClient/GeneratedArtifacts
178
+ **/*.DesktopClient/ModelManifest.xml
179
+ **/*.HTMLClient/GeneratedArtifacts
180
+ **/*.Server/GeneratedArtifacts
181
+ **/*.Server/ModelManifest.xml
182
+ *~
183
+ ~$*
184
+ $tf/
185
+ AppPackages/
186
+ artifacts/
187
+ ASALocalRun/
188
+ AutoTest.Net/
189
+ Backup*/
190
+ BenchmarkDotNet.Artifacts/
191
+ bld/
192
+ BundleArtifacts/
193
+ ClientBin/
194
+ cmake_install.cmake
195
+ CMakeCache.txt
196
+ CMakeFiles
197
+ CMakeLists.txt.user
198
+ CMakeScripts
199
+ CMakeUserPresets.json
200
+ compile_commands.json
201
+ coverage*.info
202
+ coverage*.json
203
+ coverage*.xml
204
+ csx/
205
+ CTestTestfile.cmake
206
+ dlldata.c
207
+ DocProject/buildhelp/
208
+ DocProject/Help/*.hhc
209
+ DocProject/Help/*.hhk
210
+ DocProject/Help/*.hhp
211
+ DocProject/Help/*.HxC
212
+ DocProject/Help/*.HxT
213
+ DocProject/Help/html
214
+ DocProject/Help/Html2
215
+ ecf/
216
+ FakesAssemblies/
217
+ FodyWeavers.xsd
218
+ Generated_Code/
219
+ Generated\ Files/
220
+ healthchecksdb
221
+ install_manifest.txt
222
+ ipch/
223
+ Makefile
224
+ MigrationBackup/
225
+ mono_crash.*
226
+ nCrunchTemp_*
227
+ node_modules/
228
+ nunit-*.xml
229
+ OpenCover/
230
+ orleans.codegen.cs
231
+ Package.StoreAssociation.xml
232
+ paket-files/
233
+ project.fragment.lock.json
234
+ project.lock.json
235
+ publish/
236
+ PublishScripts/
237
+ rcf/
238
+ ScaffoldingReadMe.txt
239
+ ServiceFabricBackup/
240
+ StyleCopReport.xml
241
+ Testing
242
+ TestResult.xml
243
+ UpgradeLog*.htm
244
+ UpgradeLog*.XML
245
+ x64/
246
+ x86/
247
+ # Python
248
+ __pycache__/
249
+ *.py[cod]
250
+ *$py.class
251
+ *.so
252
+ .Python
253
+ build/
254
+ develop-eggs/
255
+ downloads/
256
+ eggs/
257
+ .eggs/
258
+ lib/
259
+ lib64/
260
+ parts/
261
+ sdist/
262
+ var/
263
+ wheels/
264
+ *.egg-info/
265
+ .installed.cfg
266
+ *.egg
267
+ MANIFEST
268
+
269
+ # Distribution / packaging
270
+ !dist/.gitkeep
271
+
272
+ # Unit test / coverage reports
273
+ htmlcov/
274
+ .tox/
275
+ .nox/
276
+ .coverage
277
+ .coverage.*
278
+ .cache
279
+ nosetests.xml
280
+ coverage.xml
281
+ *.cover
282
+ *.py,cover
283
+ .hypothesis/
284
+ .pytest_cache/
285
+ cover/
286
+ .ruff_cache/
287
+
288
+ # Environments
289
+ .env
290
+ .venv
291
+ env/
292
+ venv/
293
+ ENV/
294
+ env.bak/
295
+ venv.bak/
296
+
297
+ # IDE
298
+ .idea/
299
+ .vscode/
300
+ *.swp
301
+ *.swo
302
+ *~
303
+
304
+ # OS
305
+ .DS_Store
306
+ .DS_Store?
307
+ ._*
308
+ .Spotlight-V100
309
+ .Trashes
310
+ ehthumbs.db
311
+ Thumbs.db
312
+
313
+ # Project specific
314
+ __version__.py
@@ -0,0 +1,20 @@
1
+ repos:
2
+ - repo: https://github.com/astral-sh/ruff-pre-commit
3
+ rev: v0.3.4
4
+ hooks:
5
+ - id: ruff
6
+ args: [--fix]
7
+ - id: ruff-format
8
+ args: [--respect-gitignore]
9
+ - repo: https://github.com/pre-commit/pre-commit-hooks
10
+ rev: v4.5.0
11
+ hooks:
12
+ - id: trailing-whitespace
13
+ - id: end-of-file-fixer
14
+ - id: check-yaml
15
+ - id: check-toml
16
+ - id: check-added-large-files
17
+ - id: debug-statements
18
+ - id: check-case-conflict
19
+ - id: mixed-line-ending
20
+ args: [--fix=lf]
twat-1.6.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Adam Twardoch
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.
twat-1.6.0/PKG-INFO ADDED
@@ -0,0 +1,102 @@
1
+ Metadata-Version: 2.4
2
+ Name: twat
3
+ Version: 1.6.0
4
+ Project-URL: Documentation, https://github.com/twardoch/twat#readme
5
+ Project-URL: Issues, https://github.com/twardoch/twat/issues
6
+ Project-URL: Source, https://github.com/twardoch/twat
7
+ Author-email: Adam Twardoch <adam+github@twardoch.com>
8
+ License-Expression: MIT
9
+ License-File: LICENSE
10
+ Classifier: Development Status :: 4 - Beta
11
+ Classifier: Programming Language :: Python
12
+ Classifier: Programming Language :: Python :: 3.10
13
+ Classifier: Programming Language :: Python :: 3.11
14
+ Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: Programming Language :: Python :: Implementation :: CPython
16
+ Classifier: Programming Language :: Python :: Implementation :: PyPy
17
+ Requires-Python: >=3.10
18
+ Requires-Dist: importlib-metadata>=6.0.0
19
+ Requires-Dist: importlib-resources>=5.0.0
20
+ Requires-Dist: pydantic>=2.0.0
21
+ Requires-Dist: twat
22
+ Requires-Dist: typing-extensions>=4.0.0; python_version < '3.10'
23
+ Provides-Extra: all
24
+ Requires-Dist: mypy>=1.0.0; extra == 'all'
25
+ Requires-Dist: pre-commit>=3.6.0; extra == 'all'
26
+ Requires-Dist: pytest-benchmark[histogram]>=4.0.0; extra == 'all'
27
+ Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
28
+ Requires-Dist: pytest-xdist>=3.5.0; extra == 'all'
29
+ Requires-Dist: pytest>=7.0.0; extra == 'all'
30
+ Requires-Dist: ruff>=0.1.0; extra == 'all'
31
+ Provides-Extra: dev
32
+ Requires-Dist: mypy>=1.0.0; extra == 'dev'
33
+ Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
34
+ Requires-Dist: ruff>=0.1.0; extra == 'dev'
35
+ Provides-Extra: test
36
+ Requires-Dist: pytest-benchmark[histogram]>=4.0.0; extra == 'test'
37
+ Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
38
+ Requires-Dist: pytest-xdist>=3.5.0; extra == 'test'
39
+ Requires-Dist: pytest>=7.0.0; extra == 'test'
40
+ Description-Content-Type: text/markdown
41
+
42
+ # twat
43
+
44
+ (work in progress)
45
+
46
+ ## Features
47
+
48
+ - Plugin system for Python packages
49
+ - Dynamic plugin loading and discovery
50
+ - Modern Python packaging with PEP 621 compliance
51
+ - Type hints and runtime type checking
52
+ - Comprehensive test suite and documentation
53
+ - CI/CD ready configuration
54
+
55
+ ## Installation
56
+
57
+ ```bash
58
+ pip install twat
59
+ ```
60
+
61
+ ## Usage
62
+
63
+ ```python
64
+ import twat
65
+
66
+ # Load a plugin
67
+ plugin = twat.plugin_name
68
+
69
+ # List available plugins
70
+ from importlib.metadata import entry_points
71
+ plugins = entry_points(group="twat.plugins")
72
+ ```
73
+
74
+ ## Development
75
+
76
+ This project uses [Hatch](https://hatch.pypa.io/) for development workflow management.
77
+
78
+ ### Setup Development Environment
79
+
80
+ ```bash
81
+ # Install hatch if you haven't already
82
+ pip install hatch
83
+
84
+ # Create and activate development environment
85
+ hatch shell
86
+
87
+ # Run tests
88
+ hatch run test
89
+
90
+ # Run tests with coverage
91
+ hatch run test-cov
92
+
93
+ # Run linting
94
+ hatch run lint
95
+
96
+ # Format code
97
+ hatch run format
98
+ ```
99
+
100
+ ## License
101
+
102
+ MIT License
twat-1.6.0/README.md ADDED
@@ -0,0 +1,61 @@
1
+ # twat
2
+
3
+ (work in progress)
4
+
5
+ ## Features
6
+
7
+ - Plugin system for Python packages
8
+ - Dynamic plugin loading and discovery
9
+ - Modern Python packaging with PEP 621 compliance
10
+ - Type hints and runtime type checking
11
+ - Comprehensive test suite and documentation
12
+ - CI/CD ready configuration
13
+
14
+ ## Installation
15
+
16
+ ```bash
17
+ pip install twat
18
+ ```
19
+
20
+ ## Usage
21
+
22
+ ```python
23
+ import twat
24
+
25
+ # Load a plugin
26
+ plugin = twat.plugin_name
27
+
28
+ # List available plugins
29
+ from importlib.metadata import entry_points
30
+ plugins = entry_points(group="twat.plugins")
31
+ ```
32
+
33
+ ## Development
34
+
35
+ This project uses [Hatch](https://hatch.pypa.io/) for development workflow management.
36
+
37
+ ### Setup Development Environment
38
+
39
+ ```bash
40
+ # Install hatch if you haven't already
41
+ pip install hatch
42
+
43
+ # Create and activate development environment
44
+ hatch shell
45
+
46
+ # Run tests
47
+ hatch run test
48
+
49
+ # Run tests with coverage
50
+ hatch run test-cov
51
+
52
+ # Run linting
53
+ hatch run lint
54
+
55
+ # Format code
56
+ hatch run format
57
+ ```
58
+
59
+ ## License
60
+
61
+ MIT License
@@ -0,0 +1 @@
1
+