atomicshop 2.5.5__py3-none-any.whl → 2.5.6__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.5.5'
+__version__ = '2.5.6'

atomicshop/addons/mains/install_wsl_ubuntu_lts_admin.py

@@ -0,0 +1,14 @@
+import sys
+from atomicshop.wrappers import wslw
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python main.py <directory_path_to_save_Ubuntu_package>")
+        sys.exit(1)
+
+    wslw.install_wsl(directory_path=sys.argv[1])
+
+
+if __name__ == '__main__':
+    main()

atomicshop/filesystem.py

@@ -3,6 +3,7 @@ import pathlib
 from pathlib import Path, PurePath, PureWindowsPath, PurePosixPath
 import glob
 import shutil
+from contextlib import contextmanager
 
 from .print_api import print_api, print_status_of_list
 from .basics import strings, list_of_dicts
@@ -11,6 +12,51 @@ from . import hashing
 
 
 WINDOWS_DIRECTORY_SPECIAL_CHARACTERS = ['<', '>', ':', '"', '/', '\\', '|', '?', '*']
+FILE_NAME_REPLACEMENT_DICT: dict = {
+    '$': '_',
+    ' ': '_',
+    '(': '_',
+    ')': '_',
+    '[': '_',
+    ']': '_',
+    '{': '_',
+    '}': '_',
+    "'": "_",
+    '"': '_',
+    '`': '_',
+    ';': '_',
+    '&': '_',
+    '|': '_',
+    '*': '_',
+    '?': '_',
+    '~': '_',
+    '#': '_',
+    '=': '_',
+    '+': '_',
+    '%': '_',
+    ',': '_',
+    '^': '_',
+    ':': '_',
+    '@': '_',
+    '!': '_',
+    '°': '_',
+    '§': '_',
+    '²': '_',
+    '³': '_',
+    'µ': '_',
+    '€': '_',
+    '£': '_',
+    '¥': '_',
+    '¢': '_',
+    '©': '_',
+    '®': '_',
+    '™': '_',
+    '×': '_',
+    '÷': '_',
+    '¶': '_',
+    '·': '_',
+    '¹': '_'
+}
 
 
 def get_working_directory() -> str:
@@ -217,6 +263,52 @@ def create_directory(directory_fullpath: str):
     pathlib.Path(directory_fullpath).mkdir(parents=True, exist_ok=True)
 
 
+def rename_file(source_file_path: str, target_file_path: str) -> None:
+    """
+    The function renames file from source to target.
+
+    :param source_file_path: string, full path to source file.
+    :param target_file_path: string, full path to target file.
+
+    :return: None
+    """
+
+    # Rename file.
+    os.rename(source_file_path, target_file_path)
+
+
+@contextmanager
+def temporary_rename(file_path: str, temp_file_path) -> None:
+    """
+    The function will rename the file to temporary name and then rename it back to original name.
+
+    :param file_path: string, full path to file.
+    :param temp_file_path: string, temporary name to rename the file to.
+    :return: None.
+
+    Usage:
+        original_file = 'example.txt'
+        temporary_file = 'temp_example.txt'
+
+        with temporary_rename(original_file, temporary_file):
+            # Inside this block, the file exists as 'temp_example.txt'
+            print(f"File is temporarily renamed to {temporary_file}")
+            # Perform operations with the temporarily named file here
+
+        # Outside the block, it's back to 'example.txt'
+        print(f"File is renamed back to {original_file}")
+    """
+
+    original_name = file_path
+    try:
+        # Rename the file to the temporary name
+        os.rename(original_name, temp_file_path)
+        yield
+    finally:
+        # Rename the file back to its original name
+        os.rename(temp_file_path, original_name)
+
+
 def move_file(source_file_path: str, target_file_path: str, no_overwrite: bool = False) -> None:
     """
     The function moves file from source to target.

atomicshop/process.py

@@ -1,4 +1,5 @@
 import os
+import sys
 import functools
 from typing import Union
 import shlex
@@ -238,6 +239,16 @@ def match_pattern_against_running_processes_cmdlines(pattern: str, first: bool =
     return matched_cmdlines
 
 
+def run_powershell_command(command):
+    try:
+        result = subprocess.run(["powershell", "-Command", command], capture_output=True, text=True, check=True)
+        print_api(result.stdout)
+        return result.stdout
+    except subprocess.CalledProcessError as e:
+        print_api(f"An error occurred: {e}", color='red', error_type=True)
+        return e
+
+
 """
 subprocess.Popen and subprocess.run are both functions in Python's subprocess module used for executing shell commands, 
 but they serve different purposes and offer different levels of control over command execution.

atomicshop/wrappers/dockerw/install_docker.py

@@ -70,11 +70,12 @@ def install_docker_ubuntu():
     # Verify the installation.
     result: list = process.execute_with_live_output('sudo docker run hello-world')
 
+    print_api('\n'.join(result))
+
     if 'Hello from Docker!' in '\n'.join(result):
         print_api('Docker installed successfully.', color='green')
         return True
     else:
         print_api('Docker installation failed.', color='red')
-        print_api(result, color='red')
         print_api('Please check the logs above for more information.', color='red')
         return False

atomicshop/wrappers/wslw.py

@@ -0,0 +1,112 @@
+import os
+import sys
+from pathlib import Path
+
+from ..import process, permissions
+from ..print_api import print_api
+
+
+def is_installed():
+    # Command to check the status of the WSL feature
+    command = "Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux"
+
+    # Check if WSL is enabled
+    if "Enabled" in process.run_powershell_command(command):
+        return True
+    else:
+        return False
+
+
+def is_ubuntu_installed() -> bool:
+    """
+    Check if Ubuntu is installed on WSL.
+    :return: bool, True if Ubuntu is installed, False otherwise.
+    """
+
+    # Command to list installed WSL distributions
+    command = "wsl --list --quiet"
+
+    is_ubuntu_exists: bool = False
+    # Check each distribution for being Ubuntu 22.04
+    for distro in process.run_powershell_command(command).splitlines():
+        if "ubuntu" in distro.lower():
+            is_ubuntu_exists = True
+            break
+
+    return is_ubuntu_exists
+
+
+def is_ubuntu_version_installed(version: str = "22.04") -> bool:
+    """
+    Check if specific version of Ubuntu is installed on WSL.
+    :param version: string, Ubuntu version to check for. Default is 22.04.
+    :return: bool, True if Ubuntu is installed, False otherwise.
+    """
+
+    # Command to get Ubuntu version
+    command = f"wsl -d Ubuntu lsb_release -a"
+
+    # Execute the command
+    result = process.run_powershell_command(command)
+
+    is_version_installed: bool = False
+    # Parse the output for the version number
+    for line in result.splitlines():
+        if "Release" in line and version in line:
+            is_version_installed = True
+            break
+
+    return is_version_installed
+
+
+def install_wsl(directory_path: str, enable_virtual_machine_platform: bool = False):
+    """
+    Install WSL on Windows 10.
+    :param directory_path: string, directory path to save Ubuntu package.
+    :param enable_virtual_machine_platform: bool, True to enable Virtual Machine Platform feature.
+    """
+
+    # Check for admin privileges
+    if not permissions.is_admin():
+        sys.exit("Script must be run as administrator")
+
+    # Check if WSL is already installed
+    if is_installed():
+        print_api("WSL is already installed", color='green')
+    else:
+        # Enable WSL
+        print_api("Enabling Windows Subsystem for Linux...")
+        process.run_powershell_command(
+            "Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux")
+
+        # Check if the system needs a reboot
+        if "You must restart your computer" in process.run_powershell_command(
+                "Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux"):
+            print_api("Please restart your computer to complete the installation of WSL and rerun the script.")
+            sys.exit(0)
+
+    if enable_virtual_machine_platform:
+        # Check if Hyper-V is enabled
+        if "Enabled" in process.run_powershell_command(
+                "Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V"):
+            print_api("Hyper-V is enabled")
+        else:
+            # Command to enable Virtual Machine Platform
+            command = "Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All"
+
+            print_api("Enabling Virtual Machine Platform...")
+            process.run_powershell_command(command)
+
+    # Check if Ubuntu is already installed. If so, exit with a message.
+    if is_ubuntu_version_installed():
+        print_api("Ubuntu is already installed", color='green')
+        sys.exit(0)
+
+    # Download and Install Ubuntu
+    print_api("Installing Ubuntu for WSL...")
+    package_file_path: str = str(Path(directory_path, "Ubuntu.appx"))
+    process.run_powershell_command(
+        f"Invoke-WebRequest -Uri https://aka.ms/wslubuntu2204 -OutFile {package_file_path} -UseBasicParsing")
+    process.run_powershell_command(f"Add-AppxPackage {package_file_path}")
+
+    print_api("Ubuntu installation is complete. You can now launch Ubuntu from the Start Menu.")

{atomicshop-2.5.5.dist-info → atomicshop-2.5.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: atomicshop
-Version: 2.5.5
+Version: 2.5.6
 Summary: Atomic functions and classes to make developer life easier
 Author: Denis Kras
 License: MIT License
@@ -170,6 +170,7 @@ To get a local copy up and running follow these simple steps.
 ## Usage
 
 To follow. For now, check the files in the library. I tried my best with understandable naming and grouping convention.
+There are some ready to use scripts in the 'addons/mains' folder. You can use them as a reference.
 
 
 

{atomicshop-2.5.5.dist-info → atomicshop-2.5.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-atomicshop/__init__.py,sha256=xmtfFZeXXUAxvAj0CHGUrttT5dq6j-uH7vNaNZjugMA,122
+atomicshop/__init__.py,sha256=tCeFenBN36rswxpsPeUGcOeOeSmu5wl3QX2WWwVdrHk,122
 atomicshop/_basics_temp.py,sha256=6cu2dd6r2dLrd1BRNcVDKTHlsHs_26Gpw8QS6v32lQ0,3699
 atomicshop/appointment_management.py,sha256=N3wVGJgrqJfsj_lqiRfaL3FxMEe57by5Stzanh189mk,7263
 atomicshop/archiver.py,sha256=E4dgAuh6ARtAWRW6Q0RdnMRMzsE_S1NjMiajHRIVG9s,5537
@@ -12,7 +12,7 @@ atomicshop/diff_check.py,sha256=RON9cSTgy3jAnwUmAUkOyfF6bgrBKOq9Sbgyl3RYodw,1235
 atomicshop/dns.py,sha256=bNZOo5jVPzq7OT2qCPukXoK3zb1oOsyaelUwQEyK1SA,2500
 atomicshop/domains.py,sha256=Rxu6JhhMqFZRcoFs69IoEd1PtYca0lMCG6F1AomP7z4,3197
 atomicshop/emails.py,sha256=I0KyODQpIMEsNRi9YWSOL8EUPBiWyon3HRdIuSj3AEU,1410
-atomicshop/filesystem.py,sha256=j2Up11t5VCxHAC7uT54AkRqnqL9WFAdpnBlJc8o2dPk,25854
+atomicshop/filesystem.py,sha256=nVun_XRMynayrvudsr2B47keFFCcjXf8VagotH8YwKI,28085
 atomicshop/functions.py,sha256=VqLjxAxhaxUr-Ad8P1cw9bZGdZpbtqfCaXQyHf3CM9g,509
 atomicshop/github_wrapper.py,sha256=7pZkhliP4vdcdeVtbgTDEzBS3lUw3-mp5PMWUDA19V0,4347
 atomicshop/hashing.py,sha256=k_HXR7FnPUzLUKk8EiewJ_gLFBlWncZluiBwzplFMWs,3548
@@ -23,7 +23,7 @@ atomicshop/keyboard_press.py,sha256=1W5kRtOB75fulVx-uF2yarBhW0_IzdI1k73AnvXstk0,
 atomicshop/pbtkmultifile_argparse.py,sha256=aEk8nhvoQVu-xyfZosK3ma17CwIgOjzO1erXXdjwtS4,4574
 atomicshop/permissions.py,sha256=CYTDVOI0jh9ks0ZLnnOuPzppgCszFEc9-92DTkVTYi4,522
 atomicshop/print_api.py,sha256=3n1CoiXvDcDGg00n5gEmQYInHryIhWbcpNjVobO1Gao,11468
-atomicshop/process.py,sha256=RRcbTXwDg00eDRsZjUQwcTkVKybn9PKtOf6X7EVIOmU,13809
+atomicshop/process.py,sha256=i_25PrSqSBbTcstCi_8rWVXAEYco81l6b9x1l_egTOY,14193
 atomicshop/process_name_cmd.py,sha256=TNAK6kQZm5JKWzEW6QLqVHEG98ZLNDQiSS4YwDk8V8c,3830
 atomicshop/process_poller.py,sha256=t79SwTX_4scH2WIH_ziw27aodG1ibhEFWbsVsmTyOVA,10846
 atomicshop/python_functions.py,sha256=onZ272J1IiSQToqdzEvvWAFHe0EAJnNkAVv0mYkeNNw,4464
@@ -45,6 +45,7 @@ atomicshop/addons/a_setup_scripts/install_psycopg2_ubuntu.sh,sha256=lM7LkXQ2AxfF
 atomicshop/addons/a_setup_scripts/install_pywintrace_0.3.cmd,sha256=lEP_o6rWcBFUyup6_c-LTL3Q2LRMqryLuG3mJw080Zc,115
 atomicshop/addons/mains/factw_fact_extractor_docker_image_main_sudo.py,sha256=DDKX3Wp2SmzMCEtCIEOUbEKMob2ZQ7VEQGLEf9uYXrs,320
 atomicshop/addons/mains/install_docker_ubuntu_main_sudo.py,sha256=3VDGDO41Vubzf64DaBapLlFYX52dEdyPBNfolSsbGcM,161
+atomicshop/addons/mains/install_wsl_ubuntu_lts_admin.py,sha256=3RjHoCEg6BCfONEKeH6vGDd9ZLun5dOp-jiDSlFbmKU,291
 atomicshop/addons/package_setup/CreateWheel.cmd,sha256=hq9aWBSH6iffYlZyaCNrFlA0vxMh3j1k8DQE8IARQuA,189
 atomicshop/addons/package_setup/Setup in Edit mode.cmd,sha256=299RsExjR8Mup6YyC6rW0qF8lnwa3uIzwk_gYg_R_Ss,176
 atomicshop/addons/package_setup/Setup.cmd,sha256=IMm0PfdARH7CG7h9mbWwmWD9X47l7tddwQ2U4MUxy3A,213
@@ -128,11 +129,12 @@ atomicshop/wrappers/numpyw.py,sha256=sBV4gSKyr23kXTalqAb1oqttzE_2XxBooCui66jbAqc
 atomicshop/wrappers/process_wrapper_pbtk.py,sha256=ycPmBRnv627RWks6N8OhxJQe8Gu3h3Vwj-4HswPOw0k,599
 atomicshop/wrappers/psutilw.py,sha256=W9PSEZmrm_Ct_-6oKqAcbgbyF21CwcIbbHOkVqgMiow,20866
 atomicshop/wrappers/pyopensslw.py,sha256=OBWxA6EJ2vU_Qlf4M8m6ilcG3hyYB4yB0EsXUf7NhEU,6804
+atomicshop/wrappers/wslw.py,sha256=I6Im5unWniiXXK4TDonK3a9N9DrotdJCtHxmtRv-z6o,4149
 atomicshop/wrappers/certauthw/certauth.py,sha256=hKedW0DOWlEigSNm8wu4SqHkCQsGJ1tJfH7s4nr3Bk0,12223
 atomicshop/wrappers/certauthw/certauthw.py,sha256=4WvhjANI7Kzqrr_nKmtA8Kf7B6rute_5wfP65gwQrjw,8082
 atomicshop/wrappers/ctyping/process_winapi.py,sha256=QcXL-ETtlSSkoT8F7pYle97ubGWsjYp8cx8HxkVMgAc,2762
 atomicshop/wrappers/dockerw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/wrappers/dockerw/install_docker.py,sha256=DIItfa3FhLCSYS8_8twXusIprG__Gs4qbwnYMsr8N0s,2769
+atomicshop/wrappers/dockerw/install_docker.py,sha256=dpSOmD690oLukoLCo0u6Pzh5fRyCWBuSQEtG8VwC3jk,2765
 atomicshop/wrappers/factw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/factw/fact_config.py,sha256=J-K9Zn50WcDC7ubb-boraSZExfBk7a6M52NhRJVlsjk,895
 atomicshop/wrappers/factw/get_file_data.py,sha256=ChKC0OjgjFlNubZQBwcGhRO3L2pccc27RLRlAMIUix4,1641
@@ -186,8 +188,8 @@ atomicshop/wrappers/socketw/socket_server_tester.py,sha256=VfNthyBvgI5tL9v3Qprh4
 atomicshop/wrappers/socketw/socket_wrapper.py,sha256=aXBwlEIJhFT0-c4i8iNlFx2It9VpCEpsv--5Oqcpxao,11624
 atomicshop/wrappers/socketw/ssl_base.py,sha256=k4V3gwkbq10MvOH4btU4onLX2GNOsSfUAdcHmL1rpVE,2274
 atomicshop/wrappers/socketw/statistics_csv.py,sha256=t3dtDEfN47CfYVi0CW6Kc2QHTEeZVyYhc57IYYh5nmA,826
-atomicshop-2.5.5.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
-atomicshop-2.5.5.dist-info/METADATA,sha256=iVRLGp_JpWMG68tjZ0d3rvth64JzLho7ZRriSNsfNAE,10167
-atomicshop-2.5.5.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-atomicshop-2.5.5.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
-atomicshop-2.5.5.dist-info/RECORD,,
+atomicshop-2.5.6.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
+atomicshop-2.5.6.dist-info/METADATA,sha256=R3xh983G78wSve1rqT6gdglDmTK5kH3fcMYnG-Q6O_I,10267
+atomicshop-2.5.6.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
+atomicshop-2.5.6.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
+atomicshop-2.5.6.dist-info/RECORD,,