DefPixel 0.1.0__3-py3-none-any.whl

DefPixel/Validator/Validator.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+
+from .Pattern import Pattern
+
+__all__ = (
+	'Validator',
+)
+
+
+class Validator(object):
+	"""
+	Validator Class
+	"""
+	def __init__(self, *args):
+		for pattern in args:
+			if not isinstance(pattern, Pattern):
+				raise RuntimeError('{} must be based {}'.format(pattern, Pattern))
+		self.patterns = args
+		return
+
+	def __call__(self, parameter):
+		for pattern in self.patterns:
+			parameter = pattern(parameter)
+		return parameter
+
+	def __repr__(self):
+		return 'Validator({})'.format(
+			', '.join([repr(p) for p in self.patterns])
+		)
+	

DefPixel/Validator/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+
+from .Validator import Validator
+from .Pattern import Pattern
+from .Validate import Validate
+
+__all__ = (
+	'Validator',
+	'Pattern',
+	'Validate',
+)

defpixel-0.1.0.dist-info/METADATA

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: DefPixel
+Version: 0.1.0
+Summary: A Python toolkit for data connections, modling, and access
+Home-page: https://github.com/yong5eon/DefPixel
+Author: Heo Yongseon
+Project-URL: Source, https://github.com/yong5eon/DefPixel
+Project-URL: Issues, https://github.com/yong5eon/DefPixel/issues
+Project-URL: Releases, https://github.com/yong5eon/DefPixel/releases
+Classifier: Programming Language :: Python :: 3.9
+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-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# DefPixel
+
+Define your data connections, models, and access in Python.
+
+**Define your pixels.**<br>
+**Shape your voxels.**
+
+DefPixel is a Python library for defining data source connections, models, and access. Use a provided data access implementation or build your own, and work with data directly or through standard dataclasses.
+
+## Connect · model · use
+
+- Define connections: storage-specific configuration and data access capabilities.
+- Define models: storage specifications and validation rules attached to standard dataclasses.
+- Use your data: direct access without models, or storage and retrieval through models.
+
+Configuration and Connection provide connection foundations. Database, KeyValue, Document, and Index Protocols describe capabilities. Modeling approaches and support vary by implementation. Validators also provide independent value validation and conversion.
+
+## Requirements and installation
+
+Python 3.9+ is required.
+
+```shell
+pip install DefPixel
+```
+
+## Usage at a glance
+
+### Database
+
+#### SQLite
+
+Execute SQL directly for dictionary results or map standard dataclasses to tables and retrieve objects. This complete example requires SQLite 3.35+ as used by Python.
+
+```python
+from dataclasses import dataclass
+from DefPixel.DataAccessObject.Implements.Sqlite import (
+  Configuration, Connection, column, table,
+)
+from DefPixel.DataAccessObject.Implements.Sqlite.Constraints import PrimaryKey
+from DefPixel.DataAccessObject.Implements.Sqlite.Executors import Create, Insert, Select
+from DefPixel.DataAccessObject.Implements.Sqlite.Types import Integer, Text
+
+
+@table(name='users', constraints=(PrimaryKey('id'),))
+@dataclass
+class User:
+  id: int = column(Integer())
+  name: str = column(Text())
+
+
+connection = Connection(Configuration(':memory:'))
+connection.connect()
+try:
+  with connection.session() as session:
+    session.run(Create(User))
+    session.run(Insert(User).values(id=1, name='Alice'))
+
+    rows = session.execute(
+      'SELECT id, name FROM users WHERE id = ?', 1,
+    ).rows()
+    print(rows)
+
+    users = session.run(Select(User), fetch=User)
+    print(users)
+finally:
+  connection.close()
+```
+
+Output:
+
+```text
+[{'id': 1, 'name': 'Alice'}]
+[User(id=1, name='Alice')]
+```
+
+Sessions commit on normal completion and roll back on exceptions. Direct SQL does not require models. Models remain ordinary Python objects; attribute assignment does not automatically persist changes. No custom Model base class or Service/Repository/DTO structure is required.
+
+## Supported implementations
+
+- SQLite: direct SQL, dataclass mappings, CRUD, tables, views, constraints, indexes, joins, aggregates, and transactions. SQLite modeling requires SQLite 3.35+.
+
+## Build your own
+
+Implement the capability Protocols for the store you need, without inheriting a provided implementation or adapting every store to SQL.
+
+The source repository includes step-by-step implementation development guides and a SQLite user manual.

defpixel-0.1.0.dist-info/RECORD

@@ -0,0 +1,92 @@
+DefPixel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+DefPixel/DataAccessObject/Configuration.py,sha256=vX8QcjmRceE469N-KMjd08NDZme8fD0h-k6oFFcvSDQ,321
+DefPixel/DataAccessObject/Connection.py,sha256=Noi8dIBgZ3drfCe37Cq6RAahBNIri50tZbeonCXe0tI,639
+DefPixel/DataAccessObject/__init__.py,sha256=O_GTr0rSz0KddlR8a-Xq0pV81IOsj8-0wBnMSvFwY6w,149
+DefPixel/DataAccessObject/Implements/__init__.py,sha256=iwhKnzeBJLKxpRVjvzwiRE63_zNpIBfaKLITauVph-0,24
+DefPixel/DataAccessObject/Implements/Sqlite/Configuration.py,sha256=9PdXvH1fm3VDELKm6HgvbC7WR0Zu_BZlCFHdwvO_hxs,328
+DefPixel/DataAccessObject/Implements/Sqlite/Connection.py,sha256=8oUTl54MYS6cSGFZlWNpQncLqcmP1b6xfS0e4JwVN9Q,1725
+DefPixel/DataAccessObject/Implements/Sqlite/Constraint.py,sha256=EEWD2w3vNzx47nGDv6uWrkOSDSBgGR7JvT5IHKO1YVo,128
+DefPixel/DataAccessObject/Implements/Sqlite/Context.py,sha256=liR5jvuGC39i4_GIkhPWUVYELFlkEnf1sfiyif-YjCU,716
+DefPixel/DataAccessObject/Implements/Sqlite/Cursor.py,sha256=PFQkGUWmQigqZsBOSyJqCqy5FZhUPkfw0SL5x4DD9rs,1733
+DefPixel/DataAccessObject/Implements/Sqlite/Expr.py,sha256=1ScoQDjFE4PvR0X7unV8-3RKuH83G1WznFCzw4-y5dc,1016
+DefPixel/DataAccessObject/Implements/Sqlite/Function.py,sha256=Ij8BrjQLLfKrwznKynZvCcDJwYhJ_O5GTz2BtaVuFa0,287
+DefPixel/DataAccessObject/Implements/Sqlite/Index.py,sha256=uYBmlDUzsHpQWPxKAdqheVAqbZfnX2bx8pSAPVpRjcQ,392
+DefPixel/DataAccessObject/Implements/Sqlite/Mapping.py,sha256=tTuAO_ox5_lJimpDHQIJI0XWlRaoHh64lDk4jeRHpCM,7324
+DefPixel/DataAccessObject/Implements/Sqlite/Session.py,sha256=4IBWQGjD7igzpTtvuDXbRYLSS9gfPdtT5oYKYfQrFss,711
+DefPixel/DataAccessObject/Implements/Sqlite/Type.py,sha256=RWLBBFWF72ctSVaXtFndirF1YY1_MO2fTCkSO4xi_tE,1538
+DefPixel/DataAccessObject/Implements/Sqlite/__init__.py,sha256=x4SrGf5lfwnQOv97jTprKW1XaWdlNGL0BxTTMuhdC20,628
+DefPixel/DataAccessObject/Implements/Sqlite/Constraints/ForeignKey.py,sha256=RhcawmCjRdl9IIAXGtj1sRTppOXSVhRKi0qVhM7O5Ls,382
+DefPixel/DataAccessObject/Implements/Sqlite/Constraints/PrimaryKey.py,sha256=R8OWgZxl2xeNcMkK8Mb0nX6Sh28inXWs40G-d-qmHuc,283
+DefPixel/DataAccessObject/Implements/Sqlite/Constraints/Unique.py,sha256=dmkY7mavoWX_G7aNDRjYp10NjlRp0usN1NzIGhgBzLQ,436
+DefPixel/DataAccessObject/Implements/Sqlite/Constraints/__init__.py,sha256=ihf2F0HHMQuVBZj488xjWDLL5E8q3ILMn0tWJ4gPPZs,178
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/Create.py,sha256=KUYMPzY15m4kMe9xctO97Jk9IHsUTuNhFbVGFlQERwU,3724
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/Delete.py,sha256=j3owVMaMVqOkrgxTl-zNwOfg9qmI4TEzNIBE4lnY7U4,637
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/Drop.py,sha256=yXbxnBKcfvyBmvYeqc2emKHqx_WPsJskJSQCOoAt3lI,569
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/Get.py,sha256=QrU7cVQooHiQoLkz4IldQn1lwkH_T4aBcK9ao0ZNavE,344
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/Insert.py,sha256=HWuCvniA3kwpT8lPlla2sKkyn8oiIHX1i5FsDq09WcQ,1144
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/Select.py,sha256=Mhg9Kclo5c8ZYxRmf_1a4uVTYSQ1AT_MuJTKuvXuvh4,2292
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/Update.py,sha256=_rSkVcqOo3SiIQ_Fre_EIJraLfsjHe6EiEo5slCjl_4,735
+DefPixel/DataAccessObject/Implements/Sqlite/Executors/__init__.py,sha256=WL7-56bAp3cuySJK4nMjec4ntZoaxE5MlsBcgyQ08jU,291
+DefPixel/DataAccessObject/Implements/Sqlite/Exprs/Alias.py,sha256=KjA8AbaaKND3BTD-xQ5xfd4pplVg2ApcgFjDYOygQ4o,289
+DefPixel/DataAccessObject/Implements/Sqlite/Exprs/Is.py,sha256=gaoxzxopzhYm2MAYKfZoAD5-WykRS2o1CplV7zb9id0,424
+DefPixel/DataAccessObject/Implements/Sqlite/Exprs/__init__.py,sha256=xsXa2Kwu333v4ta0Vn5PNvSn_r0u_PahAJlJYaJtUPI,141
+DefPixel/DataAccessObject/Implements/Sqlite/Filters/Compare.py,sha256=brpigQpH4aEt_dKg8nDYUIGmCZBXXrVIq2AfGcwNJNo,3136
+DefPixel/DataAccessObject/Implements/Sqlite/Filters/Operator.py,sha256=tT0OjZMUS8d2rZaVspbJfFpi1r3Exr1q3W1mOFVZmJw,394
+DefPixel/DataAccessObject/Implements/Sqlite/Filters/String.py,sha256=Y4ezV_FWaRUZRVmuyyd6ZCopz8wQdUnEuaTKgLk6dqw,340
+DefPixel/DataAccessObject/Implements/Sqlite/Filters/__init__.py,sha256=JZ5F2LsPIaoylXmmZKxtzxEyzADrpqX6exN-wTdG6aI,336
+DefPixel/DataAccessObject/Implements/Sqlite/Functions/Common.py,sha256=NlhrqBECN5y_WgwHuiHDmgOMG6Fg14l2pDTUwkM7mWY,561
+DefPixel/DataAccessObject/Implements/Sqlite/Functions/Condition.py,sha256=1UjopuQvWy0DgRRGpcxUr6gE_CGPkmRA1g1lO_Y80y0,415
+DefPixel/DataAccessObject/Implements/Sqlite/Functions/__init__.py,sha256=QZ_NTW23OlcOhoa3Z7Ubwpo-v9ePF9ghur57jnkWtFo,160
+DefPixel/DataAccessObject/Implements/Sqlite/Joins/FullOuter.py,sha256=i_rihxmoHsY3ANmBhPes1zYVo2_wHeMTbK4TFqZ0S6E,347
+DefPixel/DataAccessObject/Implements/Sqlite/Joins/Inner.py,sha256=uEGasqpmU7IbtPHSwTq2cK9R6lgxoelUjgxPxjCzcI0,325
+DefPixel/DataAccessObject/Implements/Sqlite/Joins/Join.py,sha256=Fy4Q1qXjRhjYn8nVPIKWCXcvATKjbAaHSQgML2g6L0M,492
+DefPixel/DataAccessObject/Implements/Sqlite/Joins/LeftOuter.py,sha256=Spg1oWNBysGpL_KZPzvttBwb5HP1fDg1O3uzVy_Zzwo,342
+DefPixel/DataAccessObject/Implements/Sqlite/Joins/RightOuter.py,sha256=_dWi0F65WDUjpnATDTQiRTObu7fAATFaKPV6p7pv7DE,352
+DefPixel/DataAccessObject/Implements/Sqlite/Joins/__init__.py,sha256=apE9Gssjlvlwcj84Ncd7Cjfjc3_AESfBTIehq6zE390,219
+DefPixel/DataAccessObject/Implements/Sqlite/Orders/Ascend.py,sha256=c_kBy8DP3TsoCDsAewtQ95gUpJlptZvMWR291OrdYC0,416
+DefPixel/DataAccessObject/Implements/Sqlite/Orders/Descend.py,sha256=4TjRet_8BcNRrVjk5wJwUgpVvGESPWMsM8Utjm_l9YE,420
+DefPixel/DataAccessObject/Implements/Sqlite/Orders/__init__.py,sha256=5B_qdFCZ2T5zLgzscKT0f3K5gRnMYWZ0-9QKvXbvovM,119
+DefPixel/DataAccessObject/Implements/Sqlite/Types/Binary.py,sha256=RWEa2lpYFkRJRIo8Dt_e3X979jY4Bvxgg5I9gMCl08M,371
+DefPixel/DataAccessObject/Implements/Sqlite/Types/DateTime.py,sha256=Gq4Z9RI05s_rMmgxDLACoBQpW93iHHqBYlxJJJ2eMes,794
+DefPixel/DataAccessObject/Implements/Sqlite/Types/Numeric.py,sha256=yK8xDXQv8Mali-_KelpKu3CFcuFYq-CKMOb6TbomyZQ,656
+DefPixel/DataAccessObject/Implements/Sqlite/Types/String.py,sha256=eHKAth6NzJydfV3OIjddE8KN10RKspXMmE-K-r3k_1I,363
+DefPixel/DataAccessObject/Implements/Sqlite/Types/__init__.py,sha256=nBFrp4ou4Ya8jgC27hLD1v8wNoMLYyf7LEuoyOKodD8,497
+DefPixel/DataAccessObject/Properties/Dataclass.py,sha256=0C3TJUM8yu-xWlG2YSX3Nn_91TeLlZ71iJPwvC38lVw,510
+DefPixel/DataAccessObject/Properties/__init__.py,sha256=o0eygFnqsiVn6mRUKgbvzPX9MRBfXjB0GlbEOvE4HgE,254
+DefPixel/DataAccessObject/Properties/Database/Context.py,sha256=FSfm_kTXHAsqTMLhkeDvlUDGGAPwg6pbs0shgItygbc,747
+DefPixel/DataAccessObject/Properties/Database/Cursor.py,sha256=pcrdtShABO5-frJaFU6V4Sy8Dr53uO9HmnQp0tbGRJE,581
+DefPixel/DataAccessObject/Properties/Database/Database.py,sha256=gml4LCEpWFWPurtp-lTtW8oX1rECNc8py9FnYsHbUKA,1337
+DefPixel/DataAccessObject/Properties/Database/Executor.py,sha256=Uj3wTamWdurcCIIsyNyRtYzr3L2rKm_fbbckTyZNN5E,528
+DefPixel/DataAccessObject/Properties/Database/Executors.py,sha256=uCrA8jzvXDLNDkYqZ9CZopQxICE_bSVt8qE7g3R2zrE,462
+DefPixel/DataAccessObject/Properties/Database/Fetch.py,sha256=63GprAKEYIaRVEJEs4L9XBTsr1fRO9Yjw0l6w-ex28A,663
+DefPixel/DataAccessObject/Properties/Database/Filter.py,sha256=v_lj7w80j88Ec68aNH9_Z7MFQrgtCXrrDzRwgF9F5VY,396
+DefPixel/DataAccessObject/Properties/Database/Run.py,sha256=WLeSy5u2nLoXptXmUZ-CJqqmxCmaENgHAMS2hjWv78k,716
+DefPixel/DataAccessObject/Properties/Database/Session.py,sha256=cvkORRfd6QsOHSsVCAM4j5nmZFD8TBKURSB55-IvZeM,908
+DefPixel/DataAccessObject/Properties/Database/__init__.py,sha256=usBvrpiudUyfJwWFfXXVrGsZ9XaTO4OZUFmB2DFX144,399
+DefPixel/DataAccessObject/Properties/Document/Document.py,sha256=DotRohWuvQCunIgOoYvdNfHmAW6mN-bd5wm5p1Hluys,946
+DefPixel/DataAccessObject/Properties/Document/__init__.py,sha256=-p_0CYWIy3nk1u_EvgvOY4MBiWoIUNfP84NtuEdm3n4,84
+DefPixel/DataAccessObject/Properties/Index/Index.py,sha256=h16ULzdadi5NfZ1VDct14rlojjmWwFdj1Q2HkrTH-UI,1386
+DefPixel/DataAccessObject/Properties/Index/__init__.py,sha256=QeHKZq8mmOk_Lmtx88a8ZbCMMNrZ_TSStviXWEjGDjs,75
+DefPixel/DataAccessObject/Properties/KeyValue/KeyValue.py,sha256=TqvAP7nNDQpoB6mnl0okF_Tr_3rFlBioBYwhGBzuKBQ,1209
+DefPixel/DataAccessObject/Properties/KeyValue/__init__.py,sha256=AZBc44CWC4MVN5sz3sr2H7Fe4h-xDmuK0uBWp97TPYg,84
+DefPixel/Validator/Pattern.py,sha256=gRRlEzS908b9OCXRpFnEG4gujNKCSTlhPUGwWGi-Dqg,674
+DefPixel/Validator/Validate.py,sha256=2Edk1sWh5_4QdYTc1xakDLPXMAWNrrjso1TLi7ZQ4Gg,700
+DefPixel/Validator/Validator.py,sha256=lvJGzDKecKIBAQrfFuSHBRUh6PCxiHRsabul6cYxcdA,556
+DefPixel/Validator/__init__.py,sha256=juhR_lm3XpqU-BUnTjbaYbFNXa_zs9Xi9-x_9EyvJgE,172
+DefPixel/Validator/Patterns/Array.py,sha256=XPc88iPhU2k30TIyMsB6pdDqUO_wjv-5YP96mTHbApc,514
+DefPixel/Validator/Patterns/Common.py,sha256=JJIOAcPO6epnIINaVu5SuwmnQoK3rLQn6vYyZ3JBuX8,1817
+DefPixel/Validator/Patterns/Compare.py,sha256=5xYVvaiQydvIi8WYgIADltSk0tz_ki76k-c89vZsFcw,3726
+DefPixel/Validator/Patterns/Condition.py,sha256=V8iEG9onH6bxlUnqFY8jDdmm6BIx2SBeEJAluVHeEUM,1135
+DefPixel/Validator/Patterns/DataObject.py,sha256=BTdbKGSYs1ebXNXmKP2m3T0iJeTBxIwgwl45gacpuUA,2258
+DefPixel/Validator/Patterns/DateTime.py,sha256=2ejPyRxFbvWf_0FmUrtXTBTvMnp8nakfW_TyCsRY_h4,2515
+DefPixel/Validator/Patterns/Number.py,sha256=k59Ue1Sw-D1iWz8OywjQljPVXdZlTawSl9jBpPjJKKY,919
+DefPixel/Validator/Patterns/Object.py,sha256=94aa5eC35dZyrgBlbAEH5eB7v9YB8k_haru_EBeU1vw,3563
+DefPixel/Validator/Patterns/Size.py,sha256=n-PdMTYNCw0-KN2wqWqK7nN6smVvrGLO4YfwBLlGA9Y,2016
+DefPixel/Validator/Patterns/String.py,sha256=sR4s0GM1J8r1kiOyu4HkDUgIrz-9PvLthHM1IFTgSqw,1805
+DefPixel/Validator/Patterns/Type.py,sha256=-z75Q3vYw6Br7T-gACIZNLV2PLLkFdHn67VcLxTDqEs,8758
+DefPixel/Validator/Patterns/__init__.py,sha256=2Kkk6BrvcLl0C22I0WhGphp2dF55Ig2b3LY0DMDNWm8,1603
+defpixel-0.1.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+defpixel-0.1.0.dist-info/METADATA,sha256=yetZ_-2UUy9EAO6vVlDkSDwZzju79N9r2-EgTbdDrWA,3927
+defpixel-0.1.0.dist-info/WHEEL,sha256=zI4ESrOpoMW87m0_O7SVV5Hqz2bPU1a6N2LgXIydHH0,100
+defpixel-0.1.0.dist-info/top_level.txt,sha256=q8GXppLfIcF9XRgxaOnzWmk1HvM4fsQQW3eVlmvsatw,9
+defpixel-0.1.0.dist-info/RECORD,,

defpixel-0.1.0.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+Build: 3
+