twd-m4sc0 1.4.1__py3-none-any.whl → 1.5.1__py3-none-any.whl

twd/twd.py

@@ -2,6 +2,9 @@ import os
 import argparse
 import sys
 import json
+import hashlib
+import time
+import re
 from importlib.metadata import version, PackageNotFoundError
 
 TWD_DIR = os.path.join(os.path.expanduser("~"), ".twd")
@@ -14,6 +17,10 @@ DEFAULT_CONFIG = {
 
 os.makedirs(TWD_DIR, exist_ok=True)
 
+def create_alias_id():
+    data = str(time.time()) + str(os.urandom(16))
+    return hashlib.sha256(data.encode()).hexdigest()[:12]
+
 def load_config():
     if not os.path.exists(CONFIG_FILE):
         with open(CONFIG_FILE, 'w') as file:
@@ -34,13 +41,19 @@ TWD_FILE = os.path.expanduser(CONFIG.get("data_file", "~/.twd/data"))
 def ensure_data_file_exists():
     if not os.path.exists(TWD_FILE):
         with open(TWD_FILE, 'w') as f:
-            f.write("")
+            json.dump({}, f)
 
 ensure_data_file_exists()
 
 def get_absolute_path(path):
     return os.path.abspath(path)
 
+def validate_alias(alias):
+    """Ensure the alias contains only valid characters."""
+    if not re.match(r'^[\w-]+$', alias):
+        raise ValueError(f"Invalid alias: '{alias}'. Aliases can only contain alphanumeric characters, dashes, and underscores.")
+    return alias
+
 def output_handler(message=None, path=None, output=True, simple_output=False, message_type=0):
     if not output or CONFIG["output_behaviour"] == 0:
         return
@@ -56,30 +69,53 @@ def output_handler(message=None, path=None, output=True, simple_output=False, me
         elif not simple_output and message:
             print(f"0;{message}")
 
-def save_directory(path=None, output=True, simple_output=False):
+def save_directory(path=None, alias=None, output=True, simple_output=False):
     if path is None:
         path = os.getcwd()
     else:
         path = get_absolute_path(path)
 
-    with open(TWD_FILE, "w") as f:
-        f.write(path)
+    if alias:
+        alias = validate_alias(alias)
+
+    try:
+        with open(TWD_FILE, 'r') as f:
+            data = json.load(f)
+    except json.JSONDecodeError:
+        data = {}
+
+    alias_id = create_alias_id()
+    data[alias_id] = {
+        "path": path,
+        "alias": alias if alias else alias_id,
+        "created_at": time.time()
+    }
 
-    output_handler(f"Saved TWD to {path}", path, output, simple_output)
+    with open(TWD_FILE, 'w') as f:
+        json.dump(data, f, indent=4)
+
+    output_handler(f"Saved TWD to {path} with alias '{alias or alias_id}'", path, output, simple_output)
 
 def load_directory():
     if not os.path.exists(TWD_FILE):
         return None
+    
     with open(TWD_FILE, "r") as f:
-        return f.read().strip()
+        try:
+            return json.load(f)
+        except json.JSONDecodeError:
+            return None
 
 def go_to_directory(output=True, simple_output=False):
-    TWD = load_directory()
+    dirs = load_directory()
 
-    if TWD is None:
+    if not dirs:
         output_handler("No TWD found", None, output, simple_output)
         return 1
     else:
+        last_alias, last_entry = list(dirs.items())[-1]
+        TWD = last_entry['path']
+
         if os.path.exists(TWD):
             output_handler(f"cd {TWD}", TWD, output, simple_output, message_type=1)
             return 0
@@ -88,21 +124,35 @@ def go_to_directory(output=True, simple_output=False):
             return 1
 
 def show_directory(output=True, simple_output=False):
-    TWD = load_directory()
+    dirs = load_directory()
 
-    if TWD is None or TWD == '':
+    if not dirs:
         output_handler("No TWD set", None, output, simple_output)
-    else:
-        output_handler(f"Current TWD: {TWD}", TWD, output, simple_output)
+        return
+
+    max_alias_len = max(len(entry['alias']) for entry in dirs.values()) if dirs else 0
+    max_id_len = max(len(alias_id) for alias_id in dirs.keys()) if dirs else 0
+    max_path_len = max(len(entry['path']) for entry in dirs.values()) if dirs else 0
+
+    header = f"{'Alias'.ljust(max_alias_len)}  {'ID'.ljust(max_id_len)}  {'Path'.ljust(max_path_len)}  Created At"
+    print(header)
+    print("-" * len(header))
+
+    for alias_id, entry in dirs.items():
+        alias = entry['alias'].ljust(max_alias_len)
+        path = entry['path'].ljust(max_path_len)
+        created_at = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(entry['created_at']))
+        alias_id_str = alias_id.ljust(max_id_len)
+        output_handler(f"{alias}  {alias_id_str}  {path}  {created_at}", None, output, simple_output)
+
 
 def unset_directory(output=True, simple_output=False, force=False):
     if not os.path.exists(TWD_FILE):
         output_handler(f"No TWD file found", None, output, simple_output)
     else:
         if not force:
-            output_handler(r'''
-If you want to execute unsetting the current TWD, please use "--force" and run again.
-
+            output_handler(r'''If you want to execute deleting and therefore unsetting all set TWD's, please use "--force" or "-f" and run again.
+                           
 
 This feature is to prevent accidental execution.''', None, True, False)
             return
@@ -120,15 +170,22 @@ def main():
 
     parser = argparse.ArgumentParser(description="Temporarily save and navigate to working directories.")
 
-    parser.add_argument('-s', '--save', nargs='?', const='', help="Save the current or specified directory")
+    # Positional arguments
+    parser.add_argument('directory', nargs='?', help="Directory to save")
+    parser.add_argument('alias', nargs='?', help="Alias for the saved directory (optional)")
+
+    # Optional Arguments/Flags
+    parser.add_argument('-s', '--save', action='store_true', help="Save the current or specified directory")
+    parser.add_argument('-d', '--directory', help="Directory to save")
+    parser.add_argument('-a', '--alias', help="Alias for the saved directory")
     parser.add_argument('-g', '--go', action='store_true', help="Go to the saved directory")
     parser.add_argument('-l', '--list', action='store_true', help="Show saved TWD")
     parser.add_argument('-u', '--unset', action='store_true', help="Unset the saved TWD")
     parser.add_argument('-v', '--version', action='version', version=f'TWD Version: {get_package_version()}', help='Show the current version of TWD installed')
+    parser.add_argument('-f', '--force', action='store_true', help="Force an action")
     parser.add_argument('--shell', action='store_true', help="Output shell function for integration")
     parser.add_argument('--simple-output', action='store_true', help="Only print essential output (new directory, absolute path, etc.)")
     parser.add_argument('--no-output', action='store_true', help="Prevents the console from sending output")
-    parser.add_argument('-f', '--force', action='store_true', help="Force an action")
     args = parser.parse_args()
 
     output = not args.no_output
@@ -154,8 +211,16 @@ def main():
         ''')
         return 0
 
-    if args.save is not None:
-        save_directory(args.save if args.save else None, output, simple_output)
+    directory = args.directory or args.directory
+    alias = args.alias or args.alias
+
+    if args.save:
+        if not directory:
+            directory = args.directory or os.getcwd()
+
+        alias = args.alias or args.alias
+
+        save_directory(directory, alias, output, simple_output)
     elif args.go:
         return go_to_directory(output, simple_output)
     elif args.list:

{twd_m4sc0-1.4.1.dist-info → twd_m4sc0-1.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: twd_m4sc0
-Version: 1.4.1
+Version: 1.5.1
 Summary: A tool to temporarily save and go to a working directory
 Home-page: https://github.com/m4sc0/twd
 Author: m4sc0

twd_m4sc0-1.5.1.dist-info/RECORD

@@ -0,0 +1,11 @@
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/test_twd.py,sha256=XrxOo99oqida_7qZ48pA6BCazZekDmG5syw9NvjZWDU,484
+twd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+twd/__main__.py,sha256=gM_Py51pQFH3CXdDIuPzBW6eNlFH1UHeRAmgAPWQyik,61
+twd/twd.py,sha256=N-wBGkLgFQ5f5Prml56-MdpBBR9y1OekZZTeZxNz-go,7986
+twd_m4sc0-1.5.1.dist-info/LICENSE,sha256=eQSDjcD_fvOwfjmrzxKJhtZsSI39seMawuvsgeD_dfw,1062
+twd_m4sc0-1.5.1.dist-info/METADATA,sha256=FJkYLm_PtFlwmqbIo5a2n9LiKnvjN3kAbUNS5nlxX6I,2341
+twd_m4sc0-1.5.1.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+twd_m4sc0-1.5.1.dist-info/entry_points.txt,sha256=QfYDHHjipkVN4oalpACFmIeYHb7GQCJY4SC12bTsiQQ,37
+twd_m4sc0-1.5.1.dist-info/top_level.txt,sha256=PXToru2Yr2Xh3F_F-pHXtuOQVp5x7KKCPFf94P_VI5U,10
+twd_m4sc0-1.5.1.dist-info/RECORD,,

twd_m4sc0-1.4.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/test_twd.py,sha256=XrxOo99oqida_7qZ48pA6BCazZekDmG5syw9NvjZWDU,484
-twd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-twd/__main__.py,sha256=gM_Py51pQFH3CXdDIuPzBW6eNlFH1UHeRAmgAPWQyik,61
-twd/twd.py,sha256=giOvr8bdsKXpzLUJpKRAOrb1b4Hmk5iRtB5VbPp1zhE,5626
-twd_m4sc0-1.4.1.dist-info/LICENSE,sha256=eQSDjcD_fvOwfjmrzxKJhtZsSI39seMawuvsgeD_dfw,1062
-twd_m4sc0-1.4.1.dist-info/METADATA,sha256=I_ws3VlH60rr8NFZ8zU--i8yclxKVpvG643RdlvaaZY,2341
-twd_m4sc0-1.4.1.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-twd_m4sc0-1.4.1.dist-info/entry_points.txt,sha256=QfYDHHjipkVN4oalpACFmIeYHb7GQCJY4SC12bTsiQQ,37
-twd_m4sc0-1.4.1.dist-info/top_level.txt,sha256=PXToru2Yr2Xh3F_F-pHXtuOQVp5x7KKCPFf94P_VI5U,10
-twd_m4sc0-1.4.1.dist-info/RECORD,,