atomicshop 2.16.10__py3-none-any.whl → 2.16.12__py3-none-any.whl

atomicshop/__init__.py

@@ -1,4 +1,4 @@
 """Atomic Basic functions and classes to make developer life easier"""
 
 __author__ = "Den Kras"
-__version__ = '2.16.10'
+__version__ = '2.16.12'

atomicshop/basics/enums.py

@@ -32,10 +32,10 @@ def __comparison_usage_example(
         main folder.
 
     Usage:
-        from atomicshop.filesystem import get_file_paths_from_directory, ComparisonOperator
+        from atomicshop.filesystem import get_paths_from_directory, ComparisonOperator
 
         # Get full paths of all the 'engine_config.ini' files.
-        engine_config_path_list = get_file_paths_from_directory(
+        engine_config_path_list = get_paths_from_directory(
             directory_fullpath=some_directory_path,
             file_name_check_tuple=(config_file_name, ComparisonOperator.EQ))
     """

atomicshop/basics/list_of_classes.py

@@ -0,0 +1,29 @@
+from operator import attrgetter
+
+
+def sort_by_attributes(
+        list_instance: list,
+        attribute_list: list,
+        reverse: bool = False,
+        case_insensitive: bool = False
+):
+    """
+    Sort a list of objects by their attributes.
+
+    :param list_instance: list of objects.
+    :param attribute_list: list of attributes (strings). The sorting will be done by the attributes in the list.
+        In the appearing order in the list.
+    :param reverse: bool, sort in reverse order.
+    :param case_insensitive: bool, sorting will be case-insensitive.
+    """
+
+    for attribute in attribute_list:
+        if case_insensitive:
+            list_instance = sorted(
+                list_instance, key=lambda obj: getattr(obj, attribute).lower(), reverse=reverse
+            )
+        else:
+            list_instance = sorted(
+                list_instance, key=attrgetter(attribute), reverse=reverse
+            )
+    return list_instance

atomicshop/dns.py

@@ -5,6 +5,7 @@ import dns.resolver
 from .print_api import print_api
 from .permissions import permissions
 from .wrappers.pywin32w.wmis import win32networkadapter
+from .wrappers.winregw import winreg_network
 
 
 # Defining Dictionary of Numeric to String DNS Query Types.
@@ -71,10 +72,7 @@ def get_default_dns_gateway() -> tuple[bool, list[str]]:
     :return: tuple(is dynamic boolean, list of DNS server IPv4s).
     """
 
-    resolver = dns.resolver.Resolver()
-    dns_servers = list(resolver.nameservers)
-
-    is_dynamic = win32networkadapter.is_adapter_dns_gateway_from_dhcp(use_default_interface=True)
+    is_dynamic, dns_servers = winreg_network.get_default_dns_gateway()
     return is_dynamic, dns_servers
 
 

atomicshop/file_io/docxs.py

@@ -74,20 +74,20 @@ def search_for_hyperlink_in_files(directory_path: str, hyperlink: str, relative_
         raise NotADirectoryError(f"Directory doesn't exist: {directory_path}")
 
     # Get all the docx files in the specified directory.
-    files = filesystem.get_file_paths_from_directory(
-        directory_path, file_name_check_pattern="*\.docx",
+    files = filesystem.get_paths_from_directory(
+        directory_path, get_file=True, file_name_check_pattern="*\.docx",
         add_relative_directory=True, relative_file_name_as_directory=True)
 
     found_in_files: list = list()
     for file_path in files:
-        hyperlinks = get_hyperlinks(file_path['file_path'])
+        hyperlinks = get_hyperlinks(file_path.path)
         if hyperlink in hyperlinks:
             found_in_files.append(file_path)
 
     if relative_paths:
         result_list = list()
         for found_file in found_in_files:
-            result_list.append(found_file['relative_dir'])
+            result_list.append(found_file.relative_dir)
     else:
         result_list = found_in_files
 

atomicshop/file_io/file_io.py

@@ -21,6 +21,15 @@ def write_file_decorator(function_name):
 
         print_api(message=f"Writing file: {kwargs['file_path']}", **kwargs)
 
+        if kwargs['enable_long_file_path']:
+            # A simpler string method would be to add '\\?\' to the beginning of the file path.
+            # kwargs['file_path'] = rf"\\?\{kwargs['file_path']}"
+
+            # Enable long file path.
+            from ctypes import windll
+            # Enable long file path.
+            windll.kernel32.SetFileAttributesW(kwargs['file_path'], 0x80)
+
         try:
             with open(kwargs['file_path'], kwargs['file_mode'], encoding=kwargs['encoding']) as output_file:
                 # Pass the 'output_file' object to kwargs that will pass the object to the executing function.
@@ -78,6 +87,7 @@ def write_file(
         file_path: str,
         file_mode: str = 'w',
         encoding: str = None,
+        enable_long_file_path: bool = False,
         file_object=None,
         **kwargs) -> None:
     """
@@ -89,6 +99,8 @@ def write_file(
         Default is 'w'.
     :param encoding: string, write the file with encoding. Example: 'utf-8'. 'None' is default, since it is default
         in 'open()' function.
+    :param enable_long_file_path: Boolean, by default Windows has a limit of 260 characters for file path. If True,
+        the long file path will be enabled, and the limit will be 32,767 characters.
     :param file_object: file object of the 'open()' function in the decorator. Decorator executes the 'with open()'
         statement and passes to this function. That's why the default is 'None', since we get it from the decorator.
     :return: