python-plugins 0.1.0__tar.gz → 0.1.2__tar.gz

python_plugins-0.1.2/CHANGES.rst

@@ -0,0 +1,20 @@
+v0.1.2
+------
+
+Released 2024-09-17
+
+- support sqlalchemy mixins
+
+v0.1.1
+------
+
+Released 2024-09-16
+
+- support send email
+
+v0.1.0
+------
+
+Released 2024-08-27
+
+- Init release

{python_plugins-0.1.0 → python_plugins-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-plugins
-Version: 0.1.0
+Version: 0.1.2
 Summary: A collection of Python functions and classes.
 Project-URL: Documentation, https://python-plugins.readthedocs.io
 Project-URL: Source, https://github.com/ojso/python-plugins
@@ -38,6 +38,14 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Topic :: Software Development :: Build Tools
 Requires-Python: >=3.10
+Provides-Extra: cryptography
+Requires-Dist: cryptography; extra == 'cryptography'
+Provides-Extra: pillow
+Requires-Dist: pillow; extra == 'pillow'
+Provides-Extra: qrcode
+Requires-Dist: qrcode; extra == 'qrcode'
+Provides-Extra: sqlalchemy
+Requires-Dist: sqlalchemy; extra == 'sqlalchemy'
 Description-Content-Type: text/x-rst
 
 python-plugins

{python_plugins-0.1.0 → python_plugins-0.1.2}/docs/conf.py

@@ -7,8 +7,8 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = 'python-plugins'
-copyright = '2024, HuaDong'
-author = 'HuaDong'
+copyright = '2024, David Hua'
+author = 'David Hua'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -27,5 +27,4 @@ exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = 'classic'
-html_static_path = ['_static']
 html_title = "python-plugins Documentation"

python_plugins-0.1.2/docs/usage.rst

@@ -0,0 +1,52 @@
+=====
+Usage
+=====
+
+.. _installation:
+
+Installation
+==============
+
+Install and update using pip:
+
+.. code-block:: console
+
+   (.venv) $ pip install -U python-plugins
+
+email
+======
+
+.. code-block:: python
+   
+   # smtp's host
+   host = "smtp.host"
+   port = "465"
+   # smtp's username and password
+   user = "test@test.com"
+   password = "your password"
+
+   # receiver and subject and content
+   to = "test2@test.com"
+   data = {
+      "to": to,
+      "subject": "subject of msg",
+      "content": "content of msg",
+   }
+
+   s = SmtpSSL(host, port, user, password)
+   r = s.send_emsg(data)
+
+mixins
+======
+
+.. code-block:: python
+
+   from flask_sqlalchemy import SQLAlchemy
+   from python_plugins.models.mixins import PrimaryKeyMixin
+   from python_plugins.models.mixins import UserMixin
+   from python_plugins.models.mixins import TimestampMixin
+
+   db = SQLAlchemy()
+
+   class User(PrimaryKeyMixin,UserMixin, TimestampMixin,db.models):
+      pass

{python_plugins-0.1.0 → python_plugins-0.1.2}/pyproject.toml

@@ -26,6 +26,12 @@ requires-python = ">=3.10"
 dependencies = [
 ]
 
+[project.optional-dependencies]
+sqlalchemy = ["SQLAlchemy"]
+cryptography = ["cryptography"]
+pillow = ["pillow"]
+qrcode = ["qrcode"]
+
 [project.urls]
 Documentation = "https://python-plugins.readthedocs.io"
 Source = "https://github.com/ojso/python-plugins"

python_plugins-0.1.2/requirements/test.in

@@ -0,0 +1,2 @@
+pytest
+Faker

python_plugins-0.1.2/src/python_plugins/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.1.2"

python_plugins-0.1.2/src/python_plugins/email/smtp.py

@@ -0,0 +1,34 @@
+import smtplib
+from email.message import EmailMessage
+
+
+class SmtpSSL:
+    def __init__(self, host, port, user, password):
+        self.host = host
+        self.port = port
+        self.user = user
+        self.password = password
+
+    def send_emsg(self, data):
+        emsg = EmailMessage()
+        emsg["Subject"] = data["subject"]
+        emsg.set_content(data["content"])
+
+        if data.get("From") is None:
+            emsg["From"] = self.user
+
+        emsg["To"] = data["to"]
+
+        if "cc" in data:
+            emsg["Cc"] = data["cc"]
+
+        if "bcc" in data:
+            emsg["Bcc"] = data["bcc"]
+
+        # print(emsg)
+
+        with smtplib.SMTP_SSL(self.host, self.port) as smtp:
+            # smtp.set_debuglevel(1)
+            smtp.login(self.user, self.password)
+            senderrs = smtp.send_message(emsg)
+        return senderrs

python_plugins-0.1.2/src/python_plugins/models/mixins/__init__.py

@@ -0,0 +1,4 @@
+from .primary_key_mixin import PrimaryKeyMixin
+from .timestamp_mixin import TimestampMixin, CreateTimestampMixin, UpdateTimestampMixin
+from .data_mixin import DataMixin
+from .user_minxin import UserMixin

python_plugins-0.1.2/src/python_plugins/models/mixins/data_mixin.py

@@ -0,0 +1,15 @@
+from sqlalchemy.orm import mapped_column
+from sqlalchemy.types import JSON
+
+
+class DataMixin:
+    data = mapped_column(type_=JSON)
+
+    def update_data(self, data: dict):
+        if self.data is None:
+            new_data = {}
+        else:
+            new_data = dict(self.data)
+        for k in data:
+            new_data[k] = data[k]
+        self.data = new_data

python_plugins-0.1.2/src/python_plugins/models/mixins/primary_key_mixin.py

@@ -0,0 +1,6 @@
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+
+
+class PrimaryKeyMixin:
+    id: Mapped[int] = mapped_column(primary_key=True)

python_plugins-0.1.2/src/python_plugins/models/mixins/timestamp_mixin.py

@@ -0,0 +1,20 @@
+from datetime import datetime
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+
+
+class TimestampMixin:
+    created_at: Mapped[datetime] = mapped_column(default=datetime.now)
+    updated_at: Mapped[datetime] = mapped_column(
+        default=datetime.now, onupdate=datetime.now
+    )
+
+
+class CreateTimestampMixin:
+    created_at: Mapped[datetime] = mapped_column(default=datetime.now)
+
+
+class UpdateTimestampMixin:
+    updated_at: Mapped[datetime] = mapped_column(
+        default=datetime.now, onupdate=datetime.now
+    )

python_plugins-0.1.2/src/python_plugins/models/mixins/user_minxin.py

@@ -0,0 +1,26 @@
+class UserMixin:
+    @property
+    def is_active(self):
+        return self.isactive
+
+    @property
+    def is_authenticated(self):
+        return True
+
+    @property
+    def is_anonymous(self):
+        return False
+
+    def get_id(self):
+        return self.id
+
+    def __eq__(self, other):
+        if isinstance(other, self.__class__):
+            return self.get_id() == other.get_id()
+        return NotImplemented
+
+    def __ne__(self, other):
+        equal = self.__eq__(other)
+        if equal is NotImplemented:
+            return NotImplemented
+        return not equal

python_plugins-0.1.2/tests/conftest.py

@@ -0,0 +1,9 @@
+import pytest
+
+from faker import Faker
+
+fakers = Faker()
+
+@pytest.fixture
+def fake():
+    return fakers

python_plugins-0.1.2/tests/test_email.py

@@ -0,0 +1,25 @@
+import pytest
+from python_plugins.email.smtp import SmtpSSL
+
+
+@pytest.mark.skip(reason="password is empty")
+def test_email(fake):
+    host = "smtp.qiye.aliyun.com"
+    port = "465"
+    user = "test@ojso.com"
+    # set password
+    password = ""
+
+    # set to's email
+    to = "test@ojso.com"
+    content = fake.paragraph()
+    data = {
+        "to": to,
+        "subject": "test." + fake.sentence(),
+        "content": content,
+    }
+
+    s = SmtpSSL(host, port, user, password)
+    r = s.send_emsg(data)
+
+    assert not r

python_plugins-0.1.0/CHANGES.rst

@@ -1,6 +0,0 @@
-v0.1.0
-------
-
-Released 2024-08-27
-
-- Init release

python_plugins-0.1.0/docs/usage.rst

@@ -1,14 +0,0 @@
-=====
-Usage
-=====
-
-.. _installation:
-
-Installation
-==============
-
-Install and update using pip:
-
-.. code-block:: console
-
-   (.venv) $ pip install -U python-plugins

python_plugins-0.1.0/src/python_plugins/__about__.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"