deltona 0.0.1__tar.gz

deltona-0.0.1/LICENSE.txt

@@ -0,0 +1,18 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 deltona authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER 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.

deltona-0.0.1/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.3
+Name: deltona
+Version: 0.0.1
+Summary: A lot of uncategorised utilities.
+License: MIT
+Keywords: bluetooth,command line,file management,git,multimedia
+Author: Andrew Udvare
+Author-email: audvare@gmail.com
+Requires-Python: >=3.10,<3.14
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Classifier: Topic :: Desktop Environment :: K Desktop Environment (KDE)
+Classifier: Topic :: Desktop Environment
+Classifier: Topic :: File Formats
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Multimedia
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Provides-Extra: admin
+Provides-Extra: desktop
+Provides-Extra: git
+Provides-Extra: media
+Provides-Extra: string
+Provides-Extra: wine
+Provides-Extra: www
+Requires-Dist: beautifulsoup4 (>=4.13.4,<5.0.0) ; extra == "www"
+Requires-Dist: binaryornot (>=0.4.4,<0.5.0)
+Requires-Dist: click (>=8.2.1,<9.0.0)
+Requires-Dist: colorlog (>=6.9.0,<7.0.0)
+Requires-Dist: gitpython (>=3.1.44,<4.0.0) ; extra == "git"
+Requires-Dist: html5lib (>=1.1,<2.0) ; extra == "www"
+Requires-Dist: keyring (>=25.6.0,<26.0.0)
+Requires-Dist: mutagen (>=1.47.0,<2.0.0) ; extra == "media"
+Requires-Dist: paramiko (>=3.5.1,<4.0.0) ; extra == "admin"
+Requires-Dist: pexpect (>=4.9.0,<5.0.0) ; extra == "wine"
+Requires-Dist: pillow (>=11.2.1,<12.0.0) ; extra == "www"
+Requires-Dist: platformdirs (>=4.3.8,<5.0.0) ; extra == "media" or extra == "wine"
+Requires-Dist: psutil (>=7.0.0,<8.0.0) ; extra == "wine"
+Requires-Dist: pydbus (>=0.6.0,<0.7.0) ; (sys_platform == "linux") and (extra == "desktop")
+Requires-Dist: pygithub (>=2.6.1,<3.0.0) ; extra == "git"
+Requires-Dist: pygobject (>=3.52.3,<4.0.0) ; (sys_platform == "linux") and (extra == "desktop")
+Requires-Dist: pyperclip (>=1.9.0,<2.0.0) ; extra == "desktop"
+Requires-Dist: python-xz (>=0.5.0,<0.6.0) ; extra == "wine"
+Requires-Dist: pyyaml (>=6.0.2,<7.0.0) ; extra == "string"
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: send2trash (>=1.8.3,<2.0.0)
+Requires-Dist: typing-extensions (>=4.13.2,<5.0.0)
+Requires-Dist: unidecode (>=1.4.0,<2.0.0) ; extra == "string"
+Requires-Dist: yt-dlp (>=2025.5.22,<2026.0.0) ; extra == "string"
+Project-URL: Documentation, https://deltona.readthedocs.org
+Project-URL: Homepage, https://tatsh.github.io/deltona/
+Project-URL: Issues, https://github.com/Tatsh/deltona/issues
+Project-URL: Repository, https://github.com/Tatsh/deltona
+Description-Content-Type: text/markdown
+
+# deltona
+
+[![Python versions](https://img.shields.io/pypi/pyversions/deltona.svg?color=blue&logo=python&logoColor=white)](https://www.python.org/)
+[![PyPI - Version](https://img.shields.io/pypi/v/deltona)](https://pypi.org/project/deltona/)
+[![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Tatsh/deltona)](https://github.com/Tatsh/deltona/tags)
+[![License](https://img.shields.io/github/license/Tatsh/deltona)](https://github.com/Tatsh/deltona/blob/master/LICENSE.txt)
+[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/deltona/v0.0.1/master)](https://github.com/Tatsh/deltona/compare/v0.0.1...master)
+[![QA](https://github.com/Tatsh/deltona/actions/workflows/qa.yml/badge.svg)](https://github.com/Tatsh/deltona/actions/workflows/qa.yml)
+[![Tests](https://github.com/Tatsh/deltona/actions/workflows/tests.yml/badge.svg)](https://github.com/Tatsh/deltona/actions/workflows/tests.yml)
+[![Coverage Status](https://coveralls.io/repos/github/Tatsh/deltona/badge.svg?branch=master)](https://coveralls.io/github/Tatsh/deltona?branch=master)
+[![Documentation Status](https://readthedocs.org/projects/deltona/badge/?version=latest)](https://deltona.readthedocs.org/?badge=latest)
+[![mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
+[![pydocstyle](https://img.shields.io/badge/pydocstyle-enabled-AD4CD3)](http://www.pydocstyle.org/en/stable/)
+[![pytest](https://img.shields.io/badge/pytest-zz?logo=Pytest&labelColor=black&color=black)](https://docs.pytest.org/en/stable/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Downloads](https://static.pepy.tech/badge/deltona/month)](https://pepy.tech/project/deltona)
+[![Stargazers](https://img.shields.io/github/stars/Tatsh/deltona?logo=github&style=flat)](https://github.com/Tatsh/deltona/stargazers)
+
+[![@Tatsh](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%2F%3Factor%3Ddid%3Aplc%3Auq42idtvuccnmtl57nsucz72%26query%3D%24.followersCount%26style%3Dsocial%26logo%3Dbluesky%26label%3DFollow%2520%40Tatsh&query=%24.followersCount&style=social&logo=bluesky&label=Follow%20%40Tatsh)](https://bsky.app/profile/Tatsh.bsky.social)
+[![Mastodon Follow](https://img.shields.io/mastodon/follow/109370961877277568?domain=hostux.social&style=social)](https://hostux.social/@Tatsh)
+
+A lot of uncategorised utilities.
+
+This project will eventually be split into different projects by category.
+
+## Installation
+
+### Poetry
+
+```shell
+poetry add deltona
+```
+
+### Pip
+
+```shell
+pip install deltona
+```
+
+## Usage
+
+See [the documentation](https://deltona.readthedocs.org/?badge=latest) for commands
+and the library.
+

deltona-0.0.1/README.md

@@ -0,0 +1,44 @@
+# deltona
+
+[![Python versions](https://img.shields.io/pypi/pyversions/deltona.svg?color=blue&logo=python&logoColor=white)](https://www.python.org/)
+[![PyPI - Version](https://img.shields.io/pypi/v/deltona)](https://pypi.org/project/deltona/)
+[![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Tatsh/deltona)](https://github.com/Tatsh/deltona/tags)
+[![License](https://img.shields.io/github/license/Tatsh/deltona)](https://github.com/Tatsh/deltona/blob/master/LICENSE.txt)
+[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/deltona/v0.0.1/master)](https://github.com/Tatsh/deltona/compare/v0.0.1...master)
+[![QA](https://github.com/Tatsh/deltona/actions/workflows/qa.yml/badge.svg)](https://github.com/Tatsh/deltona/actions/workflows/qa.yml)
+[![Tests](https://github.com/Tatsh/deltona/actions/workflows/tests.yml/badge.svg)](https://github.com/Tatsh/deltona/actions/workflows/tests.yml)
+[![Coverage Status](https://coveralls.io/repos/github/Tatsh/deltona/badge.svg?branch=master)](https://coveralls.io/github/Tatsh/deltona?branch=master)
+[![Documentation Status](https://readthedocs.org/projects/deltona/badge/?version=latest)](https://deltona.readthedocs.org/?badge=latest)
+[![mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
+[![pydocstyle](https://img.shields.io/badge/pydocstyle-enabled-AD4CD3)](http://www.pydocstyle.org/en/stable/)
+[![pytest](https://img.shields.io/badge/pytest-zz?logo=Pytest&labelColor=black&color=black)](https://docs.pytest.org/en/stable/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Downloads](https://static.pepy.tech/badge/deltona/month)](https://pepy.tech/project/deltona)
+[![Stargazers](https://img.shields.io/github/stars/Tatsh/deltona?logo=github&style=flat)](https://github.com/Tatsh/deltona/stargazers)
+
+[![@Tatsh](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%2F%3Factor%3Ddid%3Aplc%3Auq42idtvuccnmtl57nsucz72%26query%3D%24.followersCount%26style%3Dsocial%26logo%3Dbluesky%26label%3DFollow%2520%40Tatsh&query=%24.followersCount&style=social&logo=bluesky&label=Follow%20%40Tatsh)](https://bsky.app/profile/Tatsh.bsky.social)
+[![Mastodon Follow](https://img.shields.io/mastodon/follow/109370961877277568?domain=hostux.social&style=social)](https://hostux.social/@Tatsh)
+
+A lot of uncategorised utilities.
+
+This project will eventually be split into different projects by category.
+
+## Installation
+
+### Poetry
+
+```shell
+poetry add deltona
+```
+
+### Pip
+
+```shell
+pip install deltona
+```
+
+## Usage
+
+See [the documentation](https://deltona.readthedocs.org/?badge=latest) for commands
+and the library.

deltona-0.0.1/deltona/__init__.py

@@ -0,0 +1,4 @@
+"""Many uncategorised utilities for CLI and Python."""
+from __future__ import annotations
+
+__version__ = '0.0.1'

deltona-0.0.1/deltona/adp.py

@@ -0,0 +1,173 @@
+"""Salary calculator."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import UTC, datetime
+from typing import TYPE_CHECKING, TypedDict, cast, override
+
+import requests
+
+from .string import strip_ansi_if_no_colors
+
+if TYPE_CHECKING:
+    from .typing import INCITS38Code
+
+__all__ = ('SalaryResponse', 'calculate_salary')
+
+# Find the API key by looking at requests on this page
+# http://www.symmetry.com/try-it-for-free/calculators
+API_KEY = 'RnFqNFA0NVlRTExEenRwWjNiRnJrTXY4WkZHZEpkcENEeFFzQ3F0Nnh5VT0='
+POST_URI = ('https://calculators.symmetry.com/api/calculators/'
+            'hourly?report=none')
+REFERER = 'https://www.symmetry.com/'
+
+
+class ContentDict(TypedDict):
+    federal: float
+    fica: float
+    medicare: float
+    netPay: float
+    state: float
+
+
+class ResponseDict(TypedDict):
+    content: ContentDict
+
+
+@dataclass
+class SalaryResponse:
+    """Response from the Symmetry API."""
+    federal: float
+    """Federal tax amount."""
+    fica: float
+    """FICA tax amount."""
+    fuckery: float
+    """Difference between gross and net pay."""
+    gross: float
+    """Gross pay amount."""
+    medicare: float
+    """Medicare tax amount."""
+    net_pay: float
+    """Net pay amount."""
+    state: float
+    """State tax amount."""
+    @override
+    def __str__(self) -> str:
+        return strip_ansi_if_no_colors(f"""Gross     \033[1;32m{self.gross:8.2f}\033[0m
+Federal   \033[1;32m{self.federal:8.2f}\033[0m
+FICA      \033[1;32m{self.fica:8.2f}\033[0m
+Medicare  \033[1;32m{self.medicare:8.2f}\033[0m
+State     \033[1;32m{self.state:8.2f}\033[0m
+------------------
+Net       \033[1;32m{self.net_pay:8.2f}\033[0m
+
+------------------
+Fuckery   \033[1;31m{self.fuckery:8.2f}\033[0m""")
+
+
+def calculate_salary(*,
+                     hours: int = 70,
+                     pay_rate: float = 70.0,
+                     state: INCITS38Code = 'FL') -> SalaryResponse:
+    """
+    Calculate a US salary using the Symmetry API.
+
+    Parameters
+    ----------
+    hours : int
+        The number of hours worked. Default is 70.
+    pay_rate : float
+        The pay rate per hour. Default is 70.0.
+    state : INCITS38Code
+        The state code. Default is 'FL'.
+
+    Returns
+    -------
+    SalaryResponse
+        The response from the Symmetry API.
+    """
+    check_date = int(datetime.now(tz=UTC).timestamp() * 1000)
+    gross_pay = hours * pay_rate
+    req = requests.post(POST_URI,
+                        headers={
+                            'accept': 'application/json, text/javascript, */*; q=0.01',
+                            'cache-control': 'no-cache',
+                            'dnt': '1',
+                            'origin': 'https://www.symmetry.com',
+                            'pcc-api-key': API_KEY,
+                            'referer': REFERER
+                        },
+                        json={
+                            'checkDate': check_date,
+                            'state': state.upper(),
+                            'rates': [{
+                                'payRate': str(pay_rate),
+                                'hours': str(hours),
+                            }],
+                            'grossPay': str(gross_pay),
+                            'grossPayType': 'PAY_PER_PERIOD',
+                            'grossPayYTD': '0',
+                            'payFrequency': 'MONTHLY',
+                            'exemptFederal': 'false',
+                            'exemptFica': 'false',
+                            'exemptMedicare': 'false',
+                            'federalFilingStatusType': 'SINGLE',
+                            'federalAllowances': '0',
+                            'additionalFederalWithholding': '0',
+                            'roundFederalWithholding': 'false',
+                            'print': {
+                                'checkDate': check_date,
+                                'checkNumber': '',
+                                'checkNumberOnCheck': 'false',
+                                'companyAddressLine1': '',
+                                'companyAddressLine2': '',
+                                'companyAddressLine3': '',
+                                'companyName': '',
+                                'companyNameOnCheck': 'false',
+                                'employeeAddressLine1': '',
+                                'employeeAddressLine2': '',
+                                'employeeAddressLine3': '',
+                                'employeeName': '',
+                                'id': '',
+                                'remarks': ''
+                            },
+                            'otherIncome': [],
+                            'payCodes': [],
+                            'stockOptions': [],
+                            'stateInfo': {
+                                'parms': [{
+                                    'name': 'TOTALALLOWANCES',
+                                    'value': '0'
+                                }, {
+                                    'name': 'additionalStateWithholding',
+                                    'value': '0'
+                                }, {
+                                    'name': 'SPOUSEBLINDNESS',
+                                    'value': 'false'
+                                }, {
+                                    'name': 'stateExemption',
+                                    'value': 'false'
+                                }, {
+                                    'name': 'PERSONALBLINDNESS',
+                                    'value': 'false'
+                                }, {
+                                    'name': 'HEADOFHOUSEHOLD',
+                                    'value': 'false'
+                                }, {
+                                    'name': 'FULLTIMESTUDENT',
+                                    'value': 'false'
+                                }]
+                            },
+                            'voluntaryDeductions': [],
+                            'presetDeductions': []
+                        },
+                        timeout=30)
+    req.raise_for_status()
+    data = cast('ResponseDict', req.json())['content']
+    return SalaryResponse(federal=data['federal'],
+                          fica=data['fica'],
+                          fuckery=gross_pay - data['netPay'],
+                          gross=gross_pay,
+                          medicare=data['medicare'],
+                          net_pay=data['netPay'],
+                          state=data['state'])

deltona-0.0.1/deltona/chromium.py

@@ -0,0 +1,133 @@
+"""Chromium-related functions."""
+from __future__ import annotations
+
+from functools import cache
+from io import BytesIO
+from pathlib import Path
+from typing import TYPE_CHECKING, cast
+
+import requests
+
+if TYPE_CHECKING:
+    from types import ModuleType
+
+    from .typing import StrPath
+
+
+def _get_pil_image_module() -> ModuleType:  # pragma: no cover
+    from PIL import Image  # noqa: PLC0415
+    return Image
+
+
+def fix_chromium_pwa_icon(config_path: StrPath,
+                          app_id: str,
+                          icon_src_uri: str,
+                          profile: str = 'Default',
+                          *,
+                          masked: bool = False,
+                          monochrome: bool = False) -> None:
+    """
+    Fix a Chromium PWA icon that failed to sync.
+
+    Parameters
+    ----------
+    config_path : StrPath
+        Path to the Chromium configuration directory.
+    app_id : str
+        App ID of the PWA.
+    icon_src_uri : str
+        URI of the icon source.
+    profile : str
+        Profile name. Default is ``'Default'``.
+    masked : bool
+        If ``True``, save the icon as a maskable icon. Default is ``False``.
+    monochrome : bool
+        If ``True``, save the icon as a monochrome icon. Default is ``False``.
+
+
+    See Also
+    --------
+    https://issues.chromium.org/issues/40595456
+
+    Raises
+    ------
+    ValueError
+        If the icon is not square.
+    """
+    image_mod = _get_pil_image_module()
+    config_path = Path(config_path) / profile / 'Web Applications' / app_id
+    r = requests.get(icon_src_uri, timeout=15)
+    r.raise_for_status()
+    img = image_mod.open(BytesIO(r.content))
+    width, height = img.size
+    if width != height:
+        msg = 'Icon is not square.'
+        raise ValueError(msg)
+    sizes = list(reversed([1 << x for x in range(4, min(10, width.bit_length()))]))
+    for size in sizes:
+        img.resize((size, size), image_mod.LANCZOS).save(config_path / 'Icons' / f'{size}.png')
+    if masked:
+        for size in sizes:
+            img.resize((size, size),
+                       image_mod.LANCZOS).save(config_path / 'Icons Maskable' / f'{size}.png')
+    if monochrome:
+        for size in sizes:
+            img.resize((size, size),
+                       image_mod.LANCZOS).save(config_path / 'Icons Monochrome' / f'{size}.png')
+
+
+@cache
+def get_last_chrome_major_version() -> str:
+    """
+    Get last major Chrome version from the profile directory.
+
+    Tries the following, in order:
+
+    * Chrome Beta
+    * Chrome
+    * Chrome Canary
+    * Chromium
+
+    Returns
+    -------
+    str
+        If no ``Last Version`` file is found, returns empty string.
+    """
+    for location in ('~/.config/google-chrome-beta', '~/AppData/Local/Google/Chrome Beta/User Data'
+                     '~/Library/Application Support/Google/Chrome Beta', '~/.config/google-chrome',
+                     '~/AppData/Local/Google/Chrome/User Data',
+                     '~/Library/Application Support/Google/Chrome',
+                     '~/.config/google-chrome-unstable',
+                     '~/AppData/Local/Google/Chrome Canary/User Data',
+                     '~/Library/Application Support/Google/Chrome Canary', '~/.config/chromium',
+                     '~/AppData/Local/Google/Chromium/User Data',
+                     '~/Library/Application Support/Google/Chromium'):
+        if (p := (Path(location).expanduser() / 'Last Version')).exists():
+            return p.read_text().split('.', 1)[0]
+    return ''
+
+
+@cache
+def get_latest_chrome_major_version() -> str:
+    """Get the latest Chrome major version."""
+    return cast(
+        'str',
+        requests.get(
+            ('https://versionhistory.googleapis.com/v1/chrome/platforms/win/channels/stable/'
+             'versions'),
+            timeout=5).json()['versions'][0]['version'].split('.')[0])
+
+
+@cache
+def generate_chrome_user_agent(os: str = 'Windows NT 10.0; Win64; x64') -> str:
+    """
+    Get a Chrome user agent.
+
+    Parameters
+    ----------
+    os : str
+        The operating system. Default is ``'Windows NT 10.0; Win64; x64'``.
+    """
+    last_major = get_last_chrome_major_version() or get_latest_chrome_major_version()
+    return (f'Mozilla/5.0 ({os}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/{last_major}.0.0.0'
+            ' Safari/537.36')

deltona-0.0.1/deltona/commands/__init__.py

@@ -0,0 +1 @@
+"""Commands."""