lint main

.gitignore

@@ -1,4 +1,4 @@
 __pycache__
 /tmp
-/.idea
+/.vscode
 /dist

pyproject.toml

@@ -1,32 +1,35 @@
 [build-system]
-requires = ['hatchling']
-build-backend = 'hatchling.build'
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
 [project]
 authors = [
-    { name = 'Marc Beninca', email = 'git@marc.beninca.link' },
+    { name = "Marc Beninca", email = "git@marc.beninca.link" },
 ]
 maintainers = [
-    { name = 'Marc Beninca', email = 'git@marc.beninca.link' },
+    { name = "Marc Beninca", email = "git@marc.beninca.link" },
 ]
 classifiers = [
-    'Programming Language :: Python :: 3',
-    'License :: OSI Approved :: GNU Affero General Public License v3',
-    'Operating System :: OS Independent',
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: GNU Affero General Public License v3",
+    "Operating System :: OS Independent",
 ]
 dependencies = []
-description = 'Read Write eXecute'
-dynamic = ['version']
+description = "Read Write eXecute"
+dynamic = ["version"]
 keywords = []
-license-files = { paths = ['license.md'] }
-name = 'rwx'
-readme = 'readme.md'
-requires-python = '>= 3.10'
+license-files = { paths = ["license.md"] }
+name = "rwx"
+readme = "readme.md"
+requires-python = ">= 3.10"
 
 [project.scripts]
-# command = 'package.module:function'
+# command = "package.module:function"
 
 [project.urls]
 
 [tool.hatch.version]
-path = 'rwx/__init__.py'
+path = "rwx/__init__.py"
+
+[tool.ruff]
+select = ["ALL"]

rwx/__init__.py

@@ -1 +1,2 @@
-__version__ = '0.0.1'
+"""Read Write eXecute."""
+__version__ = "0.0.1"

rwx/__main__.py

@@ -1,18 +1,14 @@
 #! /usr/bin/env python3
-
-import os
-
+from pathlib import Path
 import fs
-
-
-if __name__ == '__main__':
-    file_path = os.path.realpath(__file__)
-    root_path = os.path.dirname(file_path)
-    directory_path = os.path.join(root_path, 'tmp')
-    file_path = os.path.join(directory_path, 'file')
+if __name__ == "__main__":
+    file_path = Path(__file__).resolve()
+    root_path = file_path.parent
+    directory_path = root_path / "tmp"
+    file_path = directory_path / "file"
 
     fs.wipe(directory_path)
     fs.make_directory(directory_path)
-    fs.write(file_path, 'Martine écrit beaucoup.')
+    fs.write(file_path, "Martine écrit beaucoup.")
     fs.empty_file(file_path)
-    fs.write(file_path, 'Martine écrit moins.')
+    fs.write(file_path, "Martine écrit moins.")

rwx/cmd/__init__.py

@@ -4,12 +4,11 @@ packages: list[str] = []
 
 def need(command: str) -> None:
     match command:
-        case 'debootstrap':
-            package = 'debootstrap'
-        case 'mksquashfs' | 'unsquashfs':
-            package = 'squashfs-tools'
+        case "debootstrap":
+            package = "debootstrap"
+        case "mksquashfs" | "unsquashfs":
+            package = "squashfs-tools"
         case _:
             package = None
-    if package:
-        if package not in packages:
+    if package and package not in packages:
         packages.append(package)

rwx/cmd/squashfs/__init__.py

@@ -1,14 +1,15 @@
 import ps
+
 import rwx.cmd
 
-rwx.cmd.need('mksquashfs')
+rwx.cmd.need("mksquashfs")
 
 
 def mksquashfs(input_root: str, output_file: str):
     ps.run([
-        'mksquashfs',
+        "mksquashfs",
         input_root,
         output_file,
-        '-comp', 'zstd',
-        '-Xcompression-level', str(18),
+        "-comp", "zstd",
+        "-Xcompression-level", str(18),
     ])

rwx/deb/__init__.py

@@ -1,20 +1,20 @@
 import cmd
+
 import ps
 
-cmd.need('debootstrap')
+cmd.need("debootstrap")
 
-BOOTSTRAP_ARCHITECTURE = 'amd64'
-BOOTSTRAP_VARIANT = 'minbase'
+BOOTSTRAP_ARCHITECTURE = "amd64"
+BOOTSTRAP_VARIANT = "minbase"
 
 
 def bootstrap(root_path: str, suite: str, mirror_location: str):
     command = [
-        ('debootstrap',),
-        ('--arch', BOOTSTRAP_ARCHITECTURE),
-        ('--variant', BOOTSTRAP_VARIANT),
+        ("debootstrap",),
+        ("--arch", BOOTSTRAP_ARCHITECTURE),
+        ("--variant", BOOTSTRAP_VARIANT),
         (suite,),
         (root_path,),
         (mirror_location,),
     ]
-    completed_process = ps.run(command)
-    return completed_process
+    return ps.run(command)

rwx/err/__init__.py

@@ -0,0 +1,2 @@
+class Exception(Exception):
+    pass

rwx/fs/__init__.py

@@ -3,34 +3,34 @@ import shutil
 
 from rwx import ps
 
-CHARSET = 'UTF-8'
+CHARSET = "UTF-8"
 
 
 def create_image(file_path: str, size_bytes: int):
     ps.run(
-        ('qemu-img', 'create'),
-        ('-f', 'qcow2'),
+        ("qemu-img", "create"),
+        ("-f", "qcow2"),
         (file_path, size_bytes),
     )
 
 
 def empty_file(path: str):
-    write(path, str())
+    write(path, "")
 
 
 def get_mount_uuid(path: str):
     return ps.run_line(
-        ('findmnt',),
-        ('--noheadings',),
-        ('--output', 'UUID'),
+        ("findmnt",),
+        ("--noheadings",),
+        ("--output", "UUID"),
         (path,),
     )
 
 
 def get_path_mount(path: str):
     return ps.run_line(
-        ('stat',),
-        ('--format', '%m'),
+        ("stat",),
+        ("--format", "%m"),
         (path,),
     )
 
@@ -44,7 +44,7 @@ def make_directory(path: str):
 
 
 def read_file(file_path: str):
-    with open(file_path, 'br') as file_object:
+    with open(file_path, "br") as file_object:
         return file_object.read()
 
 
@@ -66,5 +66,5 @@ def wipe(path: str):
 
 
 def write(file_path: str, text: str, charset=CHARSET):
-    with open(file_path, 'bw') as file_object:
+    with open(file_path, "bw") as file_object:
         file_object.write(text.encode(charset))

rwx/grub/__init__.py

@@ -1,32 +1,33 @@
 import cmd
+
 import ps
 
-cmd.need('grub-mkimage')
+cmd.need("grub-mkimage")
 
-COMPRESSION = 'xz'
+COMPRESSION = "xz"
 ENV_BYTES = 1024
-ENV_COMMENT = '#'
-ENV_HEADER = f'''{ENV_COMMENT} GRUB Environment Block
-'''
+ENV_COMMENT = "#"
+ENV_HEADER = f"""{ENV_COMMENT} GRUB Environment Block
+"""
 MODULES = {
-    'i386-pc': [
-        ('biosdisk',),
-        ('ntldr',),
-    ]
+    "i386-pc": [
+        ("biosdisk",),
+        ("ntldr",),
+    ],
 }
 
 
 def make_image(image_format: str, image_path: str, modules: list[str],
-               memdisk_path: str, pubkey_path: str = None) -> None:
+               memdisk_path: str, pubkey_path: str | None = None) -> None:
     args = [
-        ('grub-mkimage',),
-        ('--compress', COMPRESSION),
-        ('--format', image_format),
-        ('--output', image_path),
-        ('--memdisk', memdisk_path),
+        ("grub-mkimage",),
+        ("--compress", COMPRESSION),
+        ("--format", image_format),
+        ("--output", image_path),
+        ("--memdisk", memdisk_path),
     ]
     if pubkey_path:
-        args.append(('--pubkey', pubkey_path))
+        args.append(("--pubkey", pubkey_path))
     args.extend(modules)
     if modules := MODULES.get(image_format, None):
         args.extend(modules)

rwx/log/__init__.py

@@ -2,21 +2,27 @@ import logging
 import sys
 
 
-def get_logger(name: str) -> logging.Logger:
+def get_file_logger(name: str) -> logging.Logger:
     formatter = logging.Formatter(
-        "%(name)s: %(asctime)s | %(levelname)s | %(filename)s:%(lineno)s | %(process)d >>> %(message)s"
+        "%(name)s: %(asctime)s | %(levelname)s | %(filename)s:%(lineno)s | %(process)d >>> %(message)s",
     )
-
-    # file_handler = logging.FileHandler('log.txt')
-    # file_handler.setFormatter(formatter)
-    # file_handler.setLevel(logging.INFO)
-
+    #
     out_handler = logging.StreamHandler(stream=sys.stdout)
     out_handler.setFormatter(formatter)
     out_handler.setLevel(logging.INFO)
-
+    #
     logger = logging.getLogger(name)
-    # logger.addHandler(file_handler)
     logger.addHandler(out_handler)
     logger.setLevel(logging.INFO)
+    #
     return logger
+def get_stream_logger() -> logging.Logger:
+    out_handler = logging.StreamHandler(stream=sys.stdout)
+    out_handler.setLevel(logging.INFO)
+    #
+    logger = logging.getLogger()
+    logger.addHandler(out_handler)
+    logger.setLevel(logging.INFO)
+    #
+    return logger
+stream = get_stream_logger()

rwx/prj/__init__.py

@@ -2,7 +2,7 @@ from os import path
 
 
 class Project:
-    def __init__(self, file_path: str):
+    def __init__(self, file_path: str) -> None:
         self.file: str = path.realpath(file_path)
         self.root: str = path.dirname(self.file)
         self.name: str = path.basename(self.root)

rwx/prj/sphinx.py

@@ -1,4 +1,5 @@
 from os import path
+
 from sphinx.cmd.build import build_main
 
 from rwx.fs import wipe
@@ -6,11 +7,11 @@ from rwx.prj import Project
 
 
 class SphinxProject(Project):
-    def __init__(self, file_path: str):
+    def __init__(self, file_path: str) -> None:
         super().__init__(file_path)
 
     def build(self):
-        output_root: str = path.join(self.root, 'out')
+        output_root: str = path.join(self.root, "out")
         wipe(output_root)
         arguments: list[str] = [
             "-E",

rwx/txt/__init__.py

@@ -1 +1 @@
-CHARSET = 'UTF-8'
+CHARSET = "UTF-8"