MainShortcuts2 2.0.0__tar.gz

mainshortcuts2-2.0.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.1
+Name: MainShortcuts2
+Version: 2.0.0
+Summary: Сокращение и улучшение функций
+Home-page: https://github.com/MainPlay-TG/MainShortcuts2.py
+Author: MainPlay TG
+Author-email: xbox.roman6666666666@gmail.com
+Requires-Python: >=3.6,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Project-URL: Repository, https://github.com/MainPlay-TG/MainShortcuts2.py
+Description-Content-Type: text/markdown
+
+# MainShortcuts
+## Описание
+Сокращение и упрощение встроенных операций Python
+## Установка
+Для установки через PIP используйте
+```bash
+pip install -U mainshortcuts
+```
+## Использование
+Для импорта рекомендуется сокращённое название
+```python
+import MainShortcuts as ms
+```
+Или же создайте/добавьте импорт MainCore в вашу программу
+```bash
+MS-getCoreMini program.py
+```
+Встроенная информация о модуле
+```python
+ms.__version__ -> str # Версия модуля
+ms.__depends__ -> dict # Обязательные и необязательные зависимости
+```
+### Выход с кодом ошибки
+Закрывает процесс программы с указанным кодом ошибки
+```python
+# Любой ненулевой код означает ошибку
+ms.exit() # Выход с кодом 0 (нет ошибки)
+ms.exit(1) # Выход с кодом 1
+```
+### Очистка терминала
+Очищает окно терминала от всего текста
+```python
+ms.clear() # Очистить окно терминала
+mc.cls() # То же самое, но с названием из Windows CMD
+```
+**Поддерживается только на Windows и Linux**
+### Загрузка/сохранение данных
+Для удобной загрузки или сохранения данных можно использовать класс `cfg`
+```python
+cfg=ms.cfg("config.json",json_args={"mode":"p"})
+cfg.load() # Загрузить данные
+print(cfg.data) # Вывести данные
+cfg.data={"example":"Пример данных"} # Изменить данные
+cfg.save() # Сохранить данные
+```
+Тип сохранения определяется по расширению, но можно это изменить
+```python
+cfg=ms.cfg("data",type="pickle") # Использовать Pickle для файла данных
+# Предупреждение: использование Pickle может быть не безопасным!
+```
+Чтобы посмотреть поддерживаемые типы сохранения, импортируйте часть модуля
+```python
+from MainShortcuts.cfg import types
+print(", ".join(types))
+```
+Также можно изменить расположение файла, тип и аргументы во время любой загрузки или сохранения, это не повлияет на обычные настройки
+```python
+cfg.load("data.toml",toml_args={"encoding":"utf-8"})
+cfg.save("data.pkl")
+```

mainshortcuts2-2.0.0/README.md

@@ -0,0 +1,60 @@
+# MainShortcuts
+## Описание
+Сокращение и упрощение встроенных операций Python
+## Установка
+Для установки через PIP используйте
+```bash
+pip install -U mainshortcuts
+```
+## Использование
+Для импорта рекомендуется сокращённое название
+```python
+import MainShortcuts as ms
+```
+Или же создайте/добавьте импорт MainCore в вашу программу
+```bash
+MS-getCoreMini program.py
+```
+Встроенная информация о модуле
+```python
+ms.__version__ -> str # Версия модуля
+ms.__depends__ -> dict # Обязательные и необязательные зависимости
+```
+### Выход с кодом ошибки
+Закрывает процесс программы с указанным кодом ошибки
+```python
+# Любой ненулевой код означает ошибку
+ms.exit() # Выход с кодом 0 (нет ошибки)
+ms.exit(1) # Выход с кодом 1
+```
+### Очистка терминала
+Очищает окно терминала от всего текста
+```python
+ms.clear() # Очистить окно терминала
+mc.cls() # То же самое, но с названием из Windows CMD
+```
+**Поддерживается только на Windows и Linux**
+### Загрузка/сохранение данных
+Для удобной загрузки или сохранения данных можно использовать класс `cfg`
+```python
+cfg=ms.cfg("config.json",json_args={"mode":"p"})
+cfg.load() # Загрузить данные
+print(cfg.data) # Вывести данные
+cfg.data={"example":"Пример данных"} # Изменить данные
+cfg.save() # Сохранить данные
+```
+Тип сохранения определяется по расширению, но можно это изменить
+```python
+cfg=ms.cfg("data",type="pickle") # Использовать Pickle для файла данных
+# Предупреждение: использование Pickle может быть не безопасным!
+```
+Чтобы посмотреть поддерживаемые типы сохранения, импортируйте часть модуля
+```python
+from MainShortcuts.cfg import types
+print(", ".join(types))
+```
+Также можно изменить расположение файла, тип и аргументы во время любой загрузки или сохранения, это не повлияет на обычные настройки
+```python
+cfg.load("data.toml",toml_args={"encoding":"utf-8"})
+cfg.save("data.pkl")
+```

mainshortcuts2-2.0.0/pyproject.toml

@@ -0,0 +1,20 @@
+[tool.poetry]
+version = "2.0.0"
+name = "MainShortcuts2"
+description = "Сокращение и улучшение функций"
+authors = [ "MainPlay TG <xbox.roman6666666666@gmail.com>",]
+readme = "README.md"
+repository = "https://github.com/MainPlay-TG/MainShortcuts2.py"
+packages = [
+    { include = "MainShortcuts2", from = "src" },
+]
+
+[tool.poetry.scripts]
+ms2-import_example = "MainShortcuts2.__main__:import_example"
+
+[tool.poetry.dependencies]
+python = "^3.6"
+
+[build-system]
+requires = [ "poetry-core",]
+build-backend = "poetry.core.masonry.api"

mainshortcuts2-2.0.0/src/MainShortcuts2/__init__.py

@@ -0,0 +1,9 @@
+"""Упрощение и сокращение вашего кода благодаря этой библиотеке
+Разработчик: MainPlay TG
+https://t.me/MainPlayCh"""
+__all__ = ["ms", "MS2"]
+__scripts__ = ["ms2-import_example"]
+from ._module_info import version as __version__
+# 2.0.0
+from .core import MS2
+ms = MS2()

mainshortcuts2-2.0.0/src/MainShortcuts2/_module_info.py

@@ -0,0 +1,2 @@
+name = "MainShortcuts2"
+version = "2.0.0"

mainshortcuts2-2.0.0/src/MainShortcuts2/cfg.py

@@ -0,0 +1,125 @@
+import os
+from .core import MS2
+from .path import PATH_TYPES, path2str
+from typing import *
+ms: MS2 = None
+# 2.0.0
+types = ["json", "json5", "pickle", "toml"]
+ext2type = {
+    "json": "json",
+    "json5": "json5",
+    "pickle": "pickle",
+    "pkl": "pickle",
+    "toml": "toml",
+}
+
+
+def _check_type(path: str, type: Union[str, None]):
+  type = type.lower()
+  if not type is None:
+    if not type in types:
+      raise Exception("Type %r not supported" % type)
+    return type
+  _, ext = os.path.splitext(path).lower()
+  if ext in ext2type:
+    return ext2type[ext]
+  raise Exception("Cannot determine type by extension %r" % ext)
+
+
+def _load_type(cfg):
+  path: str = cfg.path
+  type: str = cfg.type
+  if type == "json":
+    def load(**kw):
+      kw["like_json5"] = False
+      kw["path"] = path
+      return ms.json.read(**kw)
+
+    def save(**kw):
+      kw["data"] = cfg.data
+      kw["path"] = path
+      return ms.json.write(**kw)
+  if type == "json5":
+    def load(**kw):
+      kw["like_json5"] = True
+      kw["path"] = path
+      return ms.json.read(**kw)
+
+    def save(**kw):
+      kw["data"] = cfg.data
+      kw["path"] = path
+      return ms.json.write(**kw)
+  if type == "pickle":
+    import pickle
+
+    def load(**kw):
+      with open(path, "rb") as f:
+        kw["file"] = f
+        return pickle.load(**kw)
+
+    def save(**kw):
+      buf = pickle.dumps(**kw)
+      with open(path, "wb") as f:
+        return f.write(buf)
+  if type == "toml":
+    import toml
+
+    def load(encoding="utf-8", **kw):
+      with open(path, "r", encoding=encoding) as f:
+        kw["f"] = f
+        return toml.load(**kw)
+
+    def save(encoding="utf-8", **kw):
+      kw["o"] = cfg.data
+      buf = toml.dumps(**kw)
+      with open(path, "w", encoding=encoding) as f:
+        return f.write(buf)
+  return load, save
+
+
+class cfg:
+  # 2.0.0
+  def __init__(self, path: PATH_TYPES, data: dict = None, default: dict = None, type=None):
+    self.data = {} if data is None else data
+    self.default = {} if default is None else default
+    self.path = path2str(path, True)
+    self.type = _check_type(path, type)
+    self._load_func, self._save_func = _load_type(self)
+
+  def load(self, **kw):
+    self.data = self._load_func(**kw)
+  read = load
+
+  def save(self, **kw) -> int:
+    return self._save_func(**kw)
+  write = save
+
+  def fill_defaults(self):
+    for i in self.default:
+      if not i in self:
+        self[i] = self.default[i]
+
+  def dload(self, **kw):
+    self.load(**kw)
+    self.fill_defaults()
+
+  def __contains__(self, k):
+    return k in self.data
+
+  def __delitem__(self, k):
+    del self.data[k]
+
+  def __getitem__(self, k):
+    return self.data[k]
+
+  def __setitem__(self, k, v):
+    self.data[k] = v
+
+  def items(self):
+    return self.data.items()
+
+  def keys(self):
+    return self.data.keys()
+
+  def values(self):
+    return self.data.values()

mainshortcuts2-2.0.0/src/MainShortcuts2/core.py

@@ -0,0 +1,142 @@
+import os
+import sys
+from logging import Logger
+# 2.0.0
+
+
+class NoLogger:
+  def __init__(*a, **b):
+    pass
+
+  def __getattr__(self, k):
+    return lambda *a, **b: None
+
+
+class MS2:
+  def __init__(self, *,
+               __file__: str = None,
+               __name__: str = None,
+               logger: Logger = None,
+               **kw):
+    self._cfg = None
+    self._dict = None
+    self._dir = None
+    self._file = None
+    self._json = None
+    self._list = None
+    self._path = None
+    self._proc = None
+    self._str = None
+    self._term = None
+    self._utils = None
+    self._win = None
+    self.encoding = "utf-8"
+    self.env = os.environ
+    self.log: Logger = NoLogger() if logger is None else logger
+    self.prog_file = __file__
+    self.prog_name = __name__
+    self.reload()
+
+  def reload(self):
+    self.args = sys.argv
+    self.import_code = "from MainShortcuts2 import ms\nms.prog_file,ms.prog_name=__file__,__name__\nms.reload()"
+    self.imported = self.prog_name != "__main__"
+    self.pid = os.getpid()
+    self.prog_dir = os.path.dirname(self.prog_file)
+    self.running = self.prog_name == "__main__"
+
+  @property
+  def cfg(self):
+    if self._cfg is None:
+      from .cfg import cfg
+      self._cfg = cfg
+      self._cfg.ms = self
+    return self._cfg
+
+  @property
+  def dict(self):
+    if self._dict is None:
+      from . import dict
+      self._dict = dict
+      self._dict.ms = self
+    return self._dict
+
+  @property
+  def dir(self):
+    if self._dir is None:
+      from . import dir
+      self._dir = dir
+      self._dir.ms = self
+    return self._dir
+
+  @property
+  def file(self):
+    if self._file is None:
+      from . import file
+      self._file = file
+      self._file.ms = self
+    return self._file
+
+  @property
+  def json(self):
+    if self._json is None:
+      from . import json
+      self._json = json
+      self._json.ms = self
+    return self._json
+
+  @property
+  def list(self):
+    if self._list is None:
+      from . import list
+      self._list = list
+      self._list.ms = self
+    return self._list
+
+  @property
+  def path(self):
+    if self._path is None:
+      from . import path
+      self._path = path
+      self._path.ms = self
+    return self._path
+
+  @property
+  def proc(self):
+    if self._proc is None:
+      from . import proc
+      self._proc = proc
+      self._proc.ms = self
+    return self._proc
+
+  @property
+  def str(self):
+    if self._str is None:
+      from . import str
+      self._str = str
+      self._str.ms = self
+    return self._str
+
+  @property
+  def term(self):
+    if self._term is None:
+      from . import term
+      self._term = term
+      self._term.ms = self
+    return self._term
+
+  @property
+  def utils(self):
+    if self._utils is None:
+      from . import utils
+      self._utils = utils
+      self._utils.ms = self
+    return self._utils
+
+  @property
+  def win(self):
+    if self._win is None:
+      from . import win
+      self._win = win
+      self._win.ms = self
+    return self._win

mainshortcuts2-2.0.0/src/MainShortcuts2/dict.py

@@ -0,0 +1,45 @@
+from .core import MS2
+from typing import *
+ms: MS2 = None
+# 2.0.0
+
+
+def merge(old: dict, new: dict) -> dict:
+  """Рекурсиво объединить словари"""
+  out = old.copy()
+  for k, v in new.items():
+    if k in out:
+      if type(out[k]) == dict and type(v) == dict:
+        out[k] = merge(out[k], v)
+      else:
+        out[k] = v
+    else:
+      out[k] = v
+  return out
+
+
+def reverse(d: dict) -> dict:
+  """Развернуть порядок ключей"""
+  keys = list(d.keys())[::-1]
+  r = {}
+  for k in keys:
+    r[k] = d[k]
+  return r
+
+
+def sort(d: dict, *, key: None = None, reverse: bool = False) -> dict:
+  """Сортировать порядок ключей"""
+  keys = list(d.keys)
+  keys.sort(key=key, reverse=reverse)
+  r = {}
+  for k in keys:
+    r[k] = d[k]
+  return r
+
+
+def swap(d: dict) -> dict:
+  """Вывернуть словарь (повторяющиеся значения будут перезаписаны)"""
+  r = {}
+  for k, v in d.items():
+    r[v] = k
+  return r

mainshortcuts2-2.0.0/src/MainShortcuts2/dir.py

@@ -0,0 +1,102 @@
+import os
+from .core import MS2
+from .path import Path, PATH_TYPES, path2str
+from typing import *
+ms: MS2 = None
+# 2.0.0
+
+
+class NotADirError(Exception):
+  pass
+
+
+def _check(path, **kw) -> str:
+  kw["path"] = path
+  path = path2str(**kw)
+  if os.path.exists(path):
+    if not os.path.isdir(path):
+      raise NotADirError(path)
+  return path
+
+
+def create(path: PATH_TYPES, force: bool = True, **kw):
+  path = path2str(path)
+  if os.path.isdir(path):
+    return
+  if force:
+    if os.path.isfile(path):
+      ms.path.delete(path)
+  kw["name"] = _check(path)
+  os.makedirs(**kw)
+
+
+def _list_filter(path: Path, *, exts: Iterable[str], func: Callable[[Path], bool], links: bool, type: str):
+  if not exts is None:
+    if not path.ext in exts:
+      return False
+  if not func is None:
+    if not func(path):
+      return False
+  if not links is None:
+    if os.path.islink(path.path) != links:
+      return False
+  if not type is None:
+    if path.type != type:
+      return False
+  return True
+
+
+def list(path: PATH_TYPES = ".", *, exts: Iterable[str] = None, func: Callable[[Path], bool] = None, links: bool = None, type: str = None) -> list[Path]:
+  r = []
+  kw = {}
+  kw["exts"] = list(exts)
+  kw["func"] = func
+  kw["links"] = bool(links)
+  kw["type"] = type
+  for i in os.listdir(_check(path)):
+    i = Path(i)
+    if _list_filter(i, **kw):
+      r.append(i)
+  return i
+
+
+def copy(path: PATH_TYPES, dest: PATH_TYPES, **kw):
+  kw["dest"] = dest
+  kw["path"] = _check(path)
+  return ms.path.copy(**kw)
+
+
+def delete(path: PATH_TYPES, **kw):
+  kw["path"] = _check(path)
+  return ms.path.delete(**kw)
+
+
+def in_dir(path: str, dir: str, **kw) -> bool:
+  kw["dir"] = dir
+  kw["path"] = _check(path)
+  return ms.path.in_dir(**kw)
+
+
+def link(path: PATH_TYPES, dest: PATH_TYPES, **kw):
+  kw["dest"] = dest
+  kw["path"] = _check(path)
+  return ms.path.link(**kw)
+
+
+def move(path: PATH_TYPES, dest: PATH_TYPES, **kw):
+  kw["dest"] = dest
+  kw["path"] = _check(path)
+  return ms.path.move(**kw)
+
+
+def rename(path: PATH_TYPES, name: PATH_TYPES, **kw):
+  kw["name"] = name
+  kw["path"] = _check(path)
+  return ms.path.rename(**kw)
+
+
+cp = copy
+ln = link
+mv = move
+rm = delete
+rn = rename

mainshortcuts2-2.0.0/src/MainShortcuts2/file.py

@@ -0,0 +1,92 @@
+import builtins
+import os
+from .core import MS2
+from .path import PATH_TYPES, path2str
+from typing import *
+ms: MS2 = None
+# 2.0.0
+
+
+class NotAFileError(Exception):
+  pass
+
+
+def _check(path, **kw) -> str:
+  kw["path"] = path
+  path = path2str(**kw)
+  if os.path.exists(path):
+    if not os.path.isfile(path):
+      raise NotAFileError(path)
+  return path
+
+
+def read(path: PATH_TYPES, encoding: str = None, **kw) -> str:
+  kw["encoding"] = ms.encoding if encoding is None else encoding
+  kw["file"] = _check(path)
+  kw["mode"] = "r"
+  with builtins.open(**kw) as f:
+    return f.read()
+
+
+def write(path: PATH_TYPES, data: str, encoding: str = None, **kw) -> int:
+  kw["encoding"] = ms.encoding if encoding is None else encoding
+  kw["file"] = _check(path)
+  kw["mode"] = "w"
+  with builtins.open(**kw) as f:
+    return f.write(data)
+
+
+def load(path: PATH_TYPES, **kw) -> bytes:
+  kw["file"] = _check(path)
+  kw["mode"] = "rb"
+  with builtins.open(**kw) as f:
+    return f.read()
+
+
+def save(path: PATH_TYPES, data: bytes, **kw) -> int:
+  kw["file"] = _check(path)
+  kw["mode"] = "wb"
+  with builtins.open(**kw) as f:
+    return f.write(data)
+
+
+def copy(path: PATH_TYPES, dest: PATH_TYPES, **kw):
+  kw["dest"] = dest
+  kw["path"] = _check(path)
+  return ms.path.copy(**kw)
+
+
+def delete(path: PATH_TYPES, **kw):
+  kw["path"] = _check(path)
+  return ms.path.delete(**kw)
+
+
+def in_dir(path: str, dir: str, **kw) -> bool:
+  kw["dir"] = dir
+  kw["path"] = _check(path)
+  return ms.path.in_dir(**kw)
+
+
+def link(path: PATH_TYPES, dest: PATH_TYPES, **kw):
+  kw["dest"] = dest
+  kw["path"] = _check(path)
+  return ms.path.link(**kw)
+
+
+def move(path: PATH_TYPES, dest: PATH_TYPES, **kw):
+  kw["dest"] = dest
+  kw["path"] = _check(path)
+  return ms.path.move(**kw)
+
+
+def rename(path: PATH_TYPES, name: PATH_TYPES, **kw):
+  kw["name"] = name
+  kw["path"] = _check(path)
+  return ms.path.rename(**kw)
+
+
+cp = copy
+ln = link
+mv = move
+rm = delete
+rn = rename