python-plugins 0.2.0__tar.gz → 0.2.2__tar.gz

{python_plugins-0.2.0 → python_plugins-0.2.2}/CHANGES.rst

@@ -1,9 +1,23 @@
+v0.2.2
+------
+
+Released 2024-12-27
+
+- update-icons
+
+v0.2.1
+------
+
+Released 2024-11-23
+
+- utils.walk_remove_dir
+
 v0.2.0
 ------
 
 Released 2024-11-20
 
-- add forms
+- add random
 
 
 v0.1.9
@@ -11,7 +25,7 @@ v0.1.9
 
 Released 2024-11-19
 
-- add forms
+- add convert
 
 
 v0.1.8
@@ -55,7 +69,7 @@ v0.1.3
 
 Released 2024-09-19
 
-- support random_str,jwt,hash_file,fernet
+- support hash_file,fernet
 
 v0.1.2
 ------

{python_plugins-0.2.0 → python_plugins-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: python-plugins
-Version: 0.2.0
+Version: 0.2.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
@@ -27,6 +27,7 @@ License: MIT License
         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
+License-File: LICENSE.rst
 Keywords: plugin,utils
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -49,8 +50,6 @@ Provides-Extra: requests
 Requires-Dist: requests; extra == 'requests'
 Provides-Extra: sqlalchemy
 Requires-Dist: sqlalchemy; extra == 'sqlalchemy'
-Provides-Extra: wtforms
-Requires-Dist: wtforms; extra == 'wtforms'
 Description-Content-Type: text/x-rst
 
 python-plugins

{python_plugins-0.2.0 → python_plugins-0.2.2}/docs/index.rst

@@ -8,8 +8,6 @@ Welcome to python-plugins's documentation!
    :caption: Contents:
 
    usage
-   api
-   examples
    changes
 
 Indices and tables

{python_plugins-0.2.0 → python_plugins-0.2.2}/docs/usage.rst

@@ -54,19 +54,39 @@ mixins
 
    db = SQLAlchemy(model_class=Base)
 
-   class User(db.models,PrimaryKeyMixin, DataMixin, TimestampMixin, UserMixin):
+   class User(db.Model,PrimaryKeyMixin, DataMixin, TimestampMixin, UserMixin):
       __tablename__ = "users"
 
-remove_pycache
+walk_remove_dir
 =======================
 
 .. code-block:: python
 
-    from  python_plugins.utils import remove_pycache
+    from  python_plugins.utils import remove,remove_pycache,remove_ipynb_checkpoints
 
     remove_pycache()   # default is "."
     remove_pycache("./tests")
 
+    remove(dir,rm_dir_name)
+
+
+encrypt,decrypt
+================
+
+.. code-block:: python
+
+    from python_plugins.crypto import encrypt_txtfile,decrypt_txtfile
+
+    # encrypt
+    encrypt_txtfile(txtfile)
+    encrypt_txtfile(txtfile,".")
+    encrypt_txtfile(txtfile, newfile, password=password)
+    
+    # decrypt
+    decrypt_txtfile(encryptedfile)
+    decrypt_txtfile(encryptedfile,".")
+    decrypt_txtfile(encryptedfile, srcfile, password=password)     
+
 
 weixin.wechat
 ==================
@@ -83,4 +103,4 @@ weixin.wechat
    mywechat = MyWechat("name")
    mywechat.verify(query)
    mywechat.chat(query,content)
-   
+   

{python_plugins-0.2.0 → python_plugins-0.2.2}/pyproject.toml

@@ -30,7 +30,6 @@ dependencies = [
 cryptography = ["cryptography"]
 requests = ["requests"]
 sqlalchemy = ["SQLAlchemy"]
-wtforms = ["WTForms"]
 pillow = ["pillow"]
 qrcode = ["qrcode"]
 jwt = ["PyJWT"]

python_plugins-0.2.2/requirements/develop.in

@@ -0,0 +1 @@
+lxml

{python_plugins-0.2.0 → python_plugins-0.2.2}/requirements/test.in

@@ -4,4 +4,3 @@ cryptography
 SQLAlchemy
 PyJWT
 requests
-WTForms

python_plugins-0.2.2/src/python_plugins/__about__.py

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

python_plugins-0.2.2/src/python_plugins/utils/__init__.py

@@ -0,0 +1,4 @@
+from .walk_remove_dir import remove
+from .walk_remove_dir import remove_pycache
+from .walk_remove_dir import remove_ipynb_checkpoints
+

python_plugins-0.2.2/src/python_plugins/utils/update-icons.py

@@ -0,0 +1,49 @@
+"""Generate example page with overview of all icons."""
+
+from lxml import etree
+
+
+def parse(filename):
+    """Parse SVG file containing icons."""
+    symbols = set()
+    data = etree.parse(filename)
+    svg = data.getroot()
+    for symbol in svg:
+        symbols.add(symbol.attrib["id"])
+    return sorted(symbols)
+
+
+def generate(version):
+    """Write the HTML template file."""
+    head = f"""{{% extends "base.html" %}}
+{{% from 'macro/icon.html' import render_icon %}}
+<!-- DO NOT EDIT! Use update-icons.py for updating this file. -->
+{{% block content %}}
+<h2>Icons</h2>
+<p>These are all the icons which are currently supported by Bootstrap-Flask.</p>
+<ul class="row row-cols-3 row-cols-sm-4 row-cols-lg-6 row-cols-xl-8 list-unstyled list">
+"""
+    names = parse(f"icons/bootstrap-icons.svg")
+    with open(f"bootstrap{version}/templates/icons.html", "w") as file:
+        file.write(head)
+        number = 0
+        for name in sorted(names):
+            item = f"""<li class="col mb-4">
+<a class="d-block text-dark text-body-emphasis text-decoration-none" href="https://icons.getbootstrap.com/icons/{name}/">
+<div class="px-3 py-4 mb-2 bg-light text-center rounded">
+{{{{ render_icon('{name}', 32) }}}}
+</div>
+</a>
+<div class="name text-body-secondary text-decoration-none text-center pt-1">{name}</div>
+</li>
+"""
+            file.write(item)
+            number += 1
+        file.write("</ul>\n")
+        file.write(f"<p>This is a total of {number} icons.</p>\n")
+        file.write("{% endblock %}\n")
+        print(f"For Bootstrap{version}, a total of {number} icons are supported.")
+
+
+for value in (4, 5):
+    generate(value)

python_plugins-0.2.2/src/python_plugins/utils/walk_remove_dir.py

@@ -0,0 +1,19 @@
+import os
+import shutil
+
+def remove(dir_path,rm_dir_name):
+    for root, dirs, files in os.walk(dir_path):
+        if "venv" in root or "git" in root:
+            continue
+        for dir in dirs:
+            if dir == rm_dir_name:
+                rm_path = os.path.join(root, dir)
+                print(f"Removing {rm_path}")
+                shutil.rmtree(rm_path)
+
+def remove_pycache(dir_path="."):
+    remove(dir_path,"__pycache__")
+
+def remove_ipynb_checkpoints(dir_path="."):
+    remove(dir_path,".ipynb_checkpoints")
+

{python_plugins-0.2.0 → python_plugins-0.2.2}/tests/test_utils.py

@@ -1,6 +1,7 @@
 import pytest
 
 from python_plugins.utils import remove_pycache
+from python_plugins.utils import remove_ipynb_checkpoints
 
 @pytest.mark.skip
 def test_remove_pycache():

python_plugins-0.2.0/docs/api.rst

@@ -1,4 +0,0 @@
-API
-===
-
-

python_plugins-0.2.0/docs/examples.rst

@@ -1 +0,0 @@
-.. include:: ../examples/README.rst

python_plugins-0.2.0/examples/README.rst

@@ -1,17 +0,0 @@
-=============
-Examples
-=============
-
-Install
-=========
-
-Type these commands in the terminal:
-
-.. code-block:: bash
-
-    $ git clone https://github.com/ojso/python-plugins.git
-    $ cd python-plugins/examples
-    $ python3 -m venv venv
-    $ source venv/bin/activate
-    $ pip install python-plugins
-    

python_plugins-0.2.0/src/python_plugins/__about__.py

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

python_plugins-0.2.0/src/python_plugins/forms/fields/__init__.py

@@ -1,2 +0,0 @@
-from .json import JSONField
-from .datetime import DateTimeField

python_plugins-0.2.0/src/python_plugins/forms/fields/datetime.py

@@ -1,100 +0,0 @@
-import time
-import datetime
-import wtforms.fields
-from ..widgets.datetime import DateTimePickerWidget
-from ..widgets.datetime import TimePickerWidget
-
-class DateTimeField(wtforms.fields.DateTimeField):
-    """
-    Allows modifying the datetime format of a DateTimeField using form_args.
-    """
-
-    widget = DateTimePickerWidget()
-
-    def __init__(self, label=None, validators=None, format=None, **kwargs):
-        """Constructor
-
-        :param label:
-            Label
-        :param validators:
-            Field validators
-        :param format:
-            Format for text to date conversion. Defaults to '%Y-%m-%d %H:%M:%S'
-        :param kwargs:
-            Any additional parameters
-        """
-        super().__init__(
-            label, validators, format or "%Y-%m-%d %H:%M:%S", **kwargs
-        )
-
-
-class TimeField(wtforms.fields.Field):
-    """
-    A text field which stores a `datetime.time` object.
-    Accepts time string in multiple formats: 20:10, 20:10:00, 10:00 am, 9:30pm, etc.
-    """
-
-    widget = TimePickerWidget()
-
-    def __init__(
-        self,
-        label=None,
-        validators=None,
-        formats=None,
-        default_format=None,
-        widget_format=None,
-        **kwargs
-    ):
-        """
-        Constructor
-
-        :param label:
-            Label
-        :param validators:
-            Field validators
-        :param formats:
-            Supported time formats, as a enumerable.
-        :param default_format:
-            Default time format. Defaults to '%H:%M:%S'
-        :param kwargs:
-            Any additional parameters
-        """
-        super().__init__(label, validators, **kwargs)
-
-        self.formats = formats or (
-            "%H:%M:%S",
-            "%H:%M",
-            "%I:%M:%S%p",
-            "%I:%M%p",
-            "%I:%M:%S %p",
-            "%I:%M %p",
-        )
-
-        self.default_format = default_format or "%H:%M:%S"
-
-    def _value(self):
-        if self.raw_data:
-            return " ".join(self.raw_data)
-        elif self.data is not None:
-            return self.data.strftime(self.default_format)
-        else:
-            return ""
-
-    def process_formdata(self, valuelist):
-        if valuelist:
-            date_str = " ".join(valuelist)
-
-            if date_str.strip():
-                for format in self.formats:
-                    try:
-                        timetuple = time.strptime(date_str, format)
-                        self.data = datetime.time(
-                            timetuple.tm_hour, timetuple.tm_min, timetuple.tm_sec
-                        )
-                        return
-                    except ValueError:
-                        pass
-
-                raise ValueError(self.gettext("Invalid time format"))
-            else:
-                self.data = None

python_plugins-0.2.0/src/python_plugins/forms/fields/json.py

@@ -1,19 +0,0 @@
-import json
-from wtforms.fields import TextAreaField
-
-class JSONField(TextAreaField):
-    def process_formdata(self, valuelist):
-        if valuelist:
-            if not valuelist[0]:
-                self.data = None
-                return
-            try:
-                self.data = json.loads(valuelist[0])
-            except ValueError:
-                raise ValueError(self.gettext("Invalid JSON"))
-
-    def _value(self):
-        if self.data:
-            return json.dumps(self.data, ensure_ascii=False)
-        else:
-            return ""

python_plugins-0.2.0/src/python_plugins/forms/fields/select.py

@@ -1,123 +0,0 @@
-import re
-import wtforms.fields
-from ..widgets.select import Select2Widget
-from ..widgets.select import Select2TagsWidget
-
-
-class Select2Field(wtforms.fields.SelectField):
-    """
-    `Select2 <https://github.com/ivaynberg/select2>`_ styled select widget.
-
-    You must include select2.js, form-x.x.x.js and select2 stylesheet for it to
-    work.
-    """
-
-    widget = Select2Widget()
-
-    def __init__(
-        self,
-        label=None,
-        validators=None,
-        coerce=str,
-        choices=None,
-        allow_blank=False,
-        blank_text=None,
-        **kwargs
-    ):
-        super(Select2Field, self).__init__(label, validators, coerce, choices, **kwargs)
-        self.allow_blank = allow_blank
-        self.blank_text = blank_text or " "
-
-    def iter_choices(self):
-        if self.allow_blank:
-            yield ("__None", self.blank_text, self.data is None)
-
-        for choice in self.choices:
-            if isinstance(choice, tuple):
-                yield (choice[0], choice[1], self.coerce(choice[0]) == self.data)
-            else:
-                yield (
-                    choice.value,
-                    choice.name,
-                    self.coerce(choice.value) == self.data,
-                )
-
-    def process_data(self, value):
-        if value is None:
-            self.data = None
-        else:
-            try:
-                self.data = self.coerce(value)
-            except (ValueError, TypeError):
-                self.data = None
-
-    def process_formdata(self, valuelist):
-        if valuelist:
-            if valuelist[0] == "__None":
-                self.data = None
-            else:
-                try:
-                    self.data = self.coerce(valuelist[0])
-                except ValueError:
-                    raise ValueError(self.gettext("Invalid Choice: could not coerce"))
-
-    def pre_validate(self, form):
-        if self.allow_blank and self.data is None:
-            return
-
-        super(Select2Field, self).pre_validate(form)
-
-
-class Select2TagsField(wtforms.fields.StringField):
-    """`Select2 <http://ivaynberg.github.com/select2/#tags>`_ styled text field.
-    You must include select2.js, form-x.x.x.js and select2 stylesheet for it to work.
-    """
-
-    widget = Select2TagsWidget()
-    _strip_regex = re.compile(
-        r"#\d+(?:(,)|\s$)"
-    )  # e.g., 'tag#123, anothertag#425 ' => 'tag, anothertag'
-
-    def __init__(
-        self,
-        label=None,
-        validators=None,
-        save_as_list=False,
-        coerce=str,
-        allow_duplicates=False,
-        **kwargs
-    ):
-        """Initialization
-
-        :param save_as_list:
-            If `True` then populate ``obj`` using list else string
-        :param allow_duplicates
-            If `True` then duplicate tags are allowed in the field.
-        """
-        self.save_as_list = save_as_list
-        self.allow_duplicates = allow_duplicates
-        self.coerce = coerce
-
-        super(Select2TagsField, self).__init__(label, validators, **kwargs)
-
-    def process_formdata(self, valuelist):
-        if valuelist:
-            entrylist = valuelist[0]
-            if self.allow_duplicates and entrylist.endswith(" "):
-                # This means this is an allowed duplicate (see form.js, `createSearchChoice`), so its ID was modified.
-                # Hence, we need to restore the original IDs.
-                entrylist = re.sub(self._strip_regex, "\\1", entrylist)
-            if self.save_as_list:
-                self.data = [
-                    self.coerce(v.strip()) for v in entrylist.split(",") if v.strip()
-                ]
-            else:
-                self.data = self.coerce(entrylist)
-
-    def _value(self):
-        if isinstance(self.data, (list, tuple)):
-            return ",".join(v for v in self.data)
-        elif self.data:
-            return self.data
-        else:
-            return ""

python_plugins-0.2.0/src/python_plugins/forms/fields/switch.py

@@ -1,10 +0,0 @@
-from wtforms.fields import BooleanField
-
-
-class SwitchField(BooleanField):
-    """
-    A wrapper field for ``BooleanField`` that renders as a Bootstrap switch.
-    """
-
-    def __init__(self, label=None, **kwargs):
-        super().__init__(label, **kwargs)

python_plugins-0.2.0/src/python_plugins/forms/fields/taglist.py

@@ -1,9 +0,0 @@
-from wtforms.fields import StringField
-
-class TagListField(StringField):
-    def process_formdata(self, valuelist):
-        if valuelist:
-            self.data = [x.strip() for x in valuelist[0].split(",")]
-
-    def _value(self):
-        return ",".join(self.data) if self.data is not None else ""

python_plugins-0.2.0/src/python_plugins/forms/mixins/user.py

@@ -1,29 +0,0 @@
-from wtforms import StringField
-from wtforms import PasswordField
-from wtforms import BooleanField
-from wtforms import SubmitField
-from wtforms.validators import ValidationError
-from wtforms.validators import DataRequired
-from wtforms.validators import EqualTo
-from wtforms.validators import Length
-
-
-class LoginForm:
-    username = StringField("Username", validators=[DataRequired()])
-    password = PasswordField("Password", validators=[DataRequired()])
-    remember_me = BooleanField("Remember Me")
-    submit = SubmitField("login")
-
-
-class RegisterForm:
-    username = StringField(
-        "Username", validators=[DataRequired(), Length(min=6, max=50)]
-    )
-    email = StringField("Email", validators=[DataRequired()])
-    password = PasswordField(
-        "Password", validators=[DataRequired(), Length(min=8, max=50)]
-    )
-    password_repeat = PasswordField(
-        "Repeat Password", validators=[DataRequired(), EqualTo("password")]
-    )
-    submit = SubmitField("Register")

python_plugins-0.2.0/src/python_plugins/forms/widgets/datetime.py

@@ -1,30 +0,0 @@
-from wtforms.widgets import TextInput
-
-
-class DatePickerWidget(TextInput):
-    """Date picker widget."""
-
-    def __call__(self, field, **kwargs):
-        kwargs.setdefault("data-role", "datepicker")
-        kwargs.setdefault("data-date-format", "YYYY-MM-DD")
-
-        self.date_format = kwargs["data-date-format"]
-        return super().__call__(field, **kwargs)
-
-
-class DateTimePickerWidget(TextInput):
-    """Datetime picker widget."""
-
-    def __call__(self, field, **kwargs):
-        kwargs.setdefault("data-role", "datetimepicker")
-        kwargs.setdefault("data-date-format", "YYYY-MM-DD HH:mm:ss")
-        return super().__call__(field, **kwargs)
-
-
-class TimePickerWidget(TextInput):
-    """Date picker widget."""
-
-    def __call__(self, field, **kwargs):
-        kwargs.setdefault("data-role", "timepicker")
-        kwargs.setdefault("data-date-format", "HH:mm:ss")
-        return super().__call__(field, **kwargs)

python_plugins-0.2.0/src/python_plugins/forms/widgets/file.py

@@ -1,4 +0,0 @@
-from wtforms.widgets import FileInput
-
-class ImageInput(FileInput):
-    field_flags = {"accept": "image/*"}

python_plugins-0.2.0/src/python_plugins/forms/widgets/select.py

@@ -1,26 +0,0 @@
-from wtforms.widgets import Select
-from wtforms.widgets import TextInput
-
-
-class Select2Widget(Select):
-    """Select2 Widget."""
-
-    def __call__(self, field, **kwargs):
-        kwargs.setdefault("data-role", "select2")
-        allow_blank = getattr(field, "allow_blank", False)
-        if allow_blank and not self.multiple:
-            kwargs["data-allow-blank"] = "1"
-
-        return super().__call__(field, **kwargs)
-
-
-class Select2TagsWidget(TextInput):
-    """Select2Tags Widget."""
-
-    def __call__(self, field, **kwargs):
-        kwargs.setdefault("data-role", "select2-tags")
-        kwargs.setdefault(
-            "data-allow-duplicate-tags",
-            "true" if getattr(field, "allow_duplicates", False) else "false",
-        )
-        return super().__call__(field, **kwargs)

python_plugins-0.2.0/src/python_plugins/utils/__init__.py

@@ -1 +0,0 @@
-from .remove_pycache import remove_pycache

python_plugins-0.2.0/src/python_plugins/utils/remove_pycache.py

@@ -1,13 +0,0 @@
-import os
-import shutil
-
-def remove_pycache(dir_path="."):
-    for root, dirs, files in os.walk(dir_path):
-        if "venv" in root or "git" in root:
-            continue
-        for dir in dirs:
-            if dir == "__pycache__":
-                pycache_path = os.path.join(root, dir)
-                print(f"Removing {pycache_path}")
-                shutil.rmtree(pycache_path)
-

python_plugins-0.2.0/tests/test_forms.py

@@ -1,65 +0,0 @@
-from wtforms.form import Form
-from python_plugins.forms.fields import JSONField
-from python_plugins.forms.fields import DateTimeField
-from python_plugins.forms.mixins.user import LoginForm
-from python_plugins.forms.mixins.user import RegisterForm
-
-
-class DummyPostData(dict):
-    def getlist(self, key):
-        v = self[key]
-        if not isinstance(v, (list, tuple)):
-            v = [v]
-        return v
-
-
-class UserLoginForm(Form, LoginForm):
-    pass
-
-
-class UserRegisterForm(Form, RegisterForm):
-    pass
-
-
-def test_fields():
-    class F(Form):
-        json_field = JSONField()
-        datetime_field = DateTimeField()
-
-    formdata = DummyPostData(
-        json_field="[1,2,3]",
-        datetime_field="2000-01-01 12:12:12",
-    )
-
-    f = F(formdata)
-    assert f.validate()
-
-    json_field_text = f.json_field()
-    assert '<textarea id="json_field" name="json_field">' in json_field_text
-    assert "[1, 2, 3]</textarea>" in json_field_text
-
-    datetime_field_text = f.datetime_field()
-    assert "<input" in datetime_field_text
-    assert (
-        'data-date-format="YYYY-MM-DD HH:mm:ss" data-role="datetimepicker"'
-        in datetime_field_text
-    )
-    assert 'value="2000-01-01 12:12:12"' in datetime_field_text
-
-
-def test_user_form():
-    login_form = UserLoginForm()
-
-    for k in login_form:
-        # print(k.label())
-        # print(k())
-        assert k() is not None
-
-    assert "username" in login_form.username()
-
-    register_form = UserRegisterForm()
-
-    for k in register_form:
-        # print(k.label())
-        # print(k())
-        assert k() is not None