Merge pull request #12 from Tracks12/dev

0.2a

Author: Tracks12

.gitignore

@@ -1,8 +1,15 @@
-.vscode/
+# Config
+.vscode
 
-__pycache__/
+# Builds
+/build
+/dist
+__pycache__
 *.pyc
 
+# Packages
 /libs/wslbuilder
+/Shell/
+/Translator/
 /WSLBuilder/
 *.vhdx

CONTRIBUTING.md

@@ -6,8 +6,6 @@
 
 This document defines the best development practices to follow when contributing to the project.
 
----
-
 ### 📁 Project Structure
 
 - `main.py`: Main entry point.
@@ -17,8 +15,6 @@ This document defines the best development practices to follow when contributing
 - `dev`: Continuous development branch.
 - `master`: Stable branch only.
 
----
-
 ### 🧱 Tool Writing Convention
 
 - Each tool must:

README.md

@@ -5,20 +5,20 @@ A multi-tool with a generic template for developing management tools like WSLBui
 ## Summary
 
 - [**ToolsManager.py**](#toolsmanagerpy)
-  - [Summary](#summary)
-  - [I. Preview](#i-preview)
-  - [II. Prerequisites](#ii-prerequisites)
-    - [II.1 Dependencies](#ii1-dependencies)
-  - [III. Uses](#iii-uses)
-    - [III.1 Command Prompt](#iii1-command-prompt)
-    - [III.2 Main Program](#iii2-main-program)
-  - [IV. Tool Management](#iv-tool-management)
-    - [IV.1 Tool Structure](#iv1-tool-structure)
-    - [IV.2 Tools Registry](#iv2-tools-registry)
-    - [IV.3 Tools Index](#iv3-tools-index)
-  - [V. Options \& Configurations](#v-options--configurations)
-  - [VI. Contributing](#vi-contributing)
-  - [VII. License](#vii-license)
+	- [Summary](#summary)
+	- [I. Preview](#i-preview)
+	- [II. Prerequisites](#ii-prerequisites)
+		- [II.1 Dependencies](#ii1-dependencies)
+	- [III. Uses](#iii-uses)
+		- [III.1 Command Prompt](#iii1-command-prompt)
+		- [III.2 Main Program](#iii2-main-program)
+	- [IV. Tool Management](#iv-tool-management)
+		- [IV.1 Tool Structure](#iv1-tool-structure)
+		- [IV.2 Tools Registry](#iv2-tools-registry)
+		- [IV.3 Tools Index](#iv3-tools-index)
+	- [V. Options \& Configurations](#v-options--configurations)
+	- [VI. Contributing](#vi-contributing)
+	- [VII. License](#vii-license)
 
 ## I. Preview
 
@@ -59,6 +59,8 @@ To use the tool manager, you need to open a terminal prompt and run the python s
 > [!Important]
 > Some tools present in the registry have dependencies contained in the [`libs/`](libs/) folder in the form of a `*.rar` file, you must unzip them by typing the command `$ python setup.py`
 
+[Summary](#summary)
+
 ### III.1 Command Prompt
 
 Usage: `$ python main.py <argument>`
@@ -167,9 +169,11 @@ class Hello(Tool):
 
 ### IV.3 Tools Index
 
-| Tool                             | Version |
-| -------------------------------- | ------- |
-| [WSLBuilder](docs/WSLBuilder.md) | v0.1a   |
+| Tool                             | Version | Description                                |
+| -------------------------------- | ------- | ------------------------------------------ |
+| [Shell](docs/Shell.md)           | v1.0    | Prompt interface with custom schedules     |
+| [Translator](docs/Translator.md) | v1.0    | Translation tool manager                   |
+| [WSLBuilder](docs/WSLBuilder.md) | v1.1    | Managing Docker images compatible with WSL |
 
 [Summary](#summary)
 

config.json

@@ -1,5 +1,5 @@
 {
-  "colors": false,
+  "colors": true,
   "encoding": "utf-8",
   "splash": true
 }

core/__init__.py

@@ -49,9 +49,7 @@ def helper(commands: tuple) -> None:
 		c	= int(2 if(i in range((len(commands)-1), (len(commands)))) else c)
 		sep	= str('\n' if(i in (len(commands)-5, len(commands)-2)) else '')
 
-		command = str(f"{colors[c]}{command[1]}{Colors.end}{sep}")
-
-		screen.append(command)
+		screen.append(f"{colors[c]}{command[1]}{Colors.end}{sep}")
 
 	print(("\n").join([ f" {s}" for s in screen ]), end="\n\n")
 
@@ -68,11 +66,18 @@ def launch(tool: Tool, args: list[str]) -> bool:
 		return(True)
 
 def sortTools(tools: list[Tool]) -> list[Tool]:
-	table = list[str]([ f" *  Name{' '*(14-len('Name'))}Command{' '*(16-len('Command'))}Path" ])
+	table = list[str]([ f" *  Name{' '*(14-len('Name'))}Version{' '*(9-len('Version'))}Command{' '*(16-len('Command'))}Path" ])
 	for i, tool in enumerate(tools, start=1):
-		table.append(f"{' '*(2-len(str(i)))}{Colors.green}{i}{Colors.end}. {tool.name}{' '*(14-len(tool.name))}{Colors.cyan}{tool.command[1]}{Colors.end}{' '*(16-len(tool.command[1]))}{Colors.yellow}{tool.path}{Colors.end}")
-
-	print(f"\n{'\n'.join([f" {t}" for t in table])}", end="\n"*2)
+		table.append("".join([
+			f"{' '*(2-len(str(i)))}{Colors.green}{i}{Colors.end}.",
+			f"{' '*1}{tool.name}",
+			f"{' '*(14-len(tool.name))}{Colors.purple}{tool.version}{Colors.end}"
+			f"{' '*(9-len(tool.version))}{Colors.cyan}{tool.command[1]}{Colors.end}"
+			f"{' '*(16-len(tool.command[1]))}{Colors.yellow}{tool.path}{Colors.end}"
+		]))
+
+	_ = "\n".join([ f" {t}" for t in table ])
+	print(f"\n{_}", end="\n"*2)
 	return(tools)
 
 def splash(spacing: int = 2) -> None:

core/tool.py

@@ -115,7 +115,10 @@ def _helper(self, jumps: list[int] = []) -> None:
 
 		for i, a in enumerate(self._args):
 			l = f"{a[0][0]}, {a[0][1]} {a[0][2]}"
-			table.append(f"{l}{' '*(34-len(l))}{a[1]}{"\n"*(1 if(i in jumps) else 0)}")
+			table.append("".join([
+				f"{l}{' '*(34-len(l))}{a[1]}",
+				'\n'*(1 if(i in jumps) else 0)
+			]))
 
 		print("\n".join([ f" {t}" for t in table ]))
 

docs/Shell.md

@@ -0,0 +1,15 @@
+# **Shell**
+
+[Back to index](../README.md)
+
+## Summary
+
+- [**Shell**](#shell)
+	- [Summary](#summary)
+	- [I. Preview](#i-preview)
+
+## I. Preview
+
+[Summary](#summary)
+
+[Back to index](../README.md)

docs/Translator.md

@@ -0,0 +1,15 @@
+# **Translator**
+
+[Back to index](../README.md)
+
+## Summary
+
+- [**Translator**](#translator)
+	- [Summary](#summary)
+	- [I. Preview](#i-preview)
+
+## I. Preview
+
+[Summary](#summary)
+
+[Back to index](../README.md)

main.py

@@ -4,6 +4,7 @@
 try:
 	# --- Importing external dependencies ---
 	from os import system as shell
+	from os.path import basename
 	from platform import system
 	from re import split
 	from sys import argv, version_info
@@ -84,14 +85,17 @@ def arg(cfg: Config) -> bool:
 			__table = list[str]([
 				f"{INFO['name']} by {INFO['author']}",
 				f"Github: {INFO['github']}\n",
-				"Usage: python main.py <argument>\n",
+				f"Usage: python {basename(__file__)} <argument>\n",
 				f"Arguments:{' '*(34-len('Arguments:'))}Descriptions:"
 			])
 
 			for i, arg in enumerate(__args["prefix"]):
 				__left = f"{arg[0][0]}, {arg[0][1]} {arg[1]}"
 				__desc = f"\n{' '*35}* ".join(__args['desc'][i]) if(isinstance(__args['desc'][i], tuple)) else __args['desc'][i]
-				__table.append(f"{__left}{' '*(34-len(__left))}{__desc}{"\n"*(1 if(i in (len(__args['desc'])-4, len(__args['desc'])-1)) else 0)}")
+				__table.append("".join([
+					f"{__left}{' '*(34-len(__left))}{__desc}",
+					"\n"*(1 if(i in (len(__args['desc'])-4, len(__args['desc'])-1)) else 0)
+				]))
 
 			print("\n".join([ f" {t}" for t in __table ]))
 

setup.py

@@ -2,15 +2,21 @@
 # -*- coding: utf-8 -*-
 
 from os import listdir
-from os.path import abspath, isdir
+from os.path import abspath, basename, isdir
 from shutil import rmtree
+from sys import argv
 
 from core.rarfile import RarFile
 
 LIBS_REGISTRY = list[str]([
 	"wslbuilder"
 ])
 
+EXTRACT_PATH = abspath("libs/")
+
+def ask(msg: str = "Are you sure ?") -> bool:
+	return(bool((input(f"{msg} [y/N] ").lower() or "n") == "y"))
+
 def clearLibs(paths: list[str]) -> None:
 	for p in paths:
 		try:
@@ -19,22 +25,34 @@ def clearLibs(paths: list[str]) -> None:
 		except(FileNotFoundError):
 			pass
 
-def setup() -> bool:
-	__extractPath	= abspath("libs/")
-	__rarPaths		= [ abspath(f"{__extractPath}/{m}.rar") for m in LIBS_REGISTRY ]
-	__libsPath		= [ abspath(f"{__extractPath}/{m}") for m in LIBS_REGISTRY ]
+def install(registry: list[str]) -> bool:
+	__rarPaths		= [ abspath(f"{EXTRACT_PATH}/{m}.rar") for m in registry ]
+	__libsPath		= [ abspath(f"{EXTRACT_PATH}/{m}") for m in registry ]
+	__checkExists	= [ lib for lib in listdir(EXTRACT_PATH) if isdir(abspath(f"{EXTRACT_PATH}/{lib}")) if lib in registry ]
+
+	if(len(__checkExists)):
+		for ce in __checkExists:
+			print(f" (-) {ce}")
+
+		if(not ask("Did you want to uninstall these packages ?")):
+			print("[ CANCEL ]: Abort reinstallation !")
+			return(False)
 
-	if(len([ d for d in listdir(__extractPath) if isdir(abspath(f"{__extractPath}/{d}")) ])):
 		print("[ INFO ]: Clearing installation ...")
 		clearLibs(__libsPath)
+		print("[ INFO ]: Installation cleared !")
 
 	for i, rp in enumerate(__rarPaths):
 		try:
 			with RarFile(rp) as __rf:
 				print(f" ( ) Unpacking {rp} ... [{i}/{len(__rarPaths)}]", end="\r")
-				__rf.extractall(__extractPath)
+				__rf.extractall(EXTRACT_PATH)
 				print(f" (*) {rp} Unpacked{' '*16}")
 
+		except(FileNotFoundError):
+			print(f"[ ERROR ]: {rp} not found{' '*(16+len(rp))}")
+			pass
+
 		except(Exception) as e:
 			clearLibs(__libsPath)
 			print(f"\n[ ERROR ]: {e}{' '*(16+len(rp))}")
@@ -43,5 +61,80 @@ def setup() -> bool:
 	print("[ OK ]: Installation finished !")
 	return(True)
 
+def uninstall(registry: list[str]) -> bool:
+	__libsPath		= [ abspath(f"{EXTRACT_PATH}/{m}") for m in registry ]
+	__checkExists	= [ lib for lib in listdir(EXTRACT_PATH) if isdir(abspath(f"{EXTRACT_PATH}/{lib}")) if lib in registry ]
+
+	if(len(__checkExists)):
+		for ce in __checkExists:
+			print(f" (-) {ce}")
+
+		if(not ask("Did you want to uninstall these packages ?")):
+			print("[ CANCEL ]: Abort uninstallation !")
+			return(False)
+
+		print("[ INFO ]: Uninstallation finished !")
+		clearLibs(__libsPath)
+
+	return(True)
+
+def arg() -> bool:
+	__args = dict({
+		"prefix": tuple[tuple[tuple[str], str]]((
+			(("-i", "--install"), "<lib>"),
+			(("-p", "--purge"), ""),
+			(("-r", "--registry"), ""),
+			(("-u", "--uninstall"), "<lib>"),
+			(("-h", "--help"), "")
+		)),
+		"desc": tuple[str | tuple[str]]((
+			"Install a dependency",
+			"Purge all dependencies",
+			"Show libs registry",
+			"Uninstall a dependency",
+			"Show the helper commands menu"
+		))
+	})
+
+	try:
+		if(argv[1] in __args["prefix"][0][0]): # -i, --install
+			install([ argv[2] ])
+
+		elif(argv[1] in __args["prefix"][1][0]): # -p, --purge
+			uninstall(LIBS_REGISTRY)
+
+		elif(argv[1] in __args["prefix"][2][0]): # -r, --registry
+			print("[ INFO ]: Listing the package registry:")
+			for i, lib in enumerate(LIBS_REGISTRY, 1):
+				print(f" {' '*(3-len(str(i)))}{i}. {lib} -> {abspath(f'{EXTRACT_PATH}/{lib}.rar')}")
+		
+		elif(argv[1] in __args["prefix"][3][0]): # -u, --uninstall
+			uninstall([ argv[2] ])
+
+		elif(argv[1] in __args["prefix"][-1][0]): # -h, --help
+			__table = list[str]([
+				f"Usage: python {basename(__file__)} <argument>\n",
+				f"Arguments:{' '*(34-len('Arguments:'))}Descriptions:"
+			])
+
+			for i, arg in enumerate(__args["prefix"]):
+				__left = f"{arg[0][0]}, {arg[0][1]} {arg[1]}"
+				__desc = f"\n{' '*35}* ".join(__args['desc'][i]) if(isinstance(__args['desc'][i], tuple)) else __args['desc'][i]
+				__table.append("".join([
+					f"{__left}{' '*(34-len(__left))}{__desc}",
+					"\n"*(1 if(i in (len(__args['desc'])-2, len(__args['desc'])-1)) else 0)
+				]))
+
+			print("\n".join([ f" {t}" for t in __table ]))
+
+	except(IndexError, KeyError):
+		print(f"/!\\ - Insufficient arguments !")
+		return(False)
+
+	return(True)
+
+def setup() -> bool:
+	return(install(LIBS_REGISTRY))
+
 if(__name__ == "__main__"):
-	setup()
+	arg() if(len(argv) > 1) else setup()