serkonda7 / symlinker-v Goto Github PK

View Code? Open in Web Editor NEW

8.0 1.0 1.0 215 KB

Utility tool to manage symlinks in your PATH

License: MIT License

AMPL 1.18% V 98.82%

symlink utility v cli manager symlinker

symlinker-v's Introduction

symlinker

Small and lightweight CLI utility tool to create and manage symlinks in the PATH.

Installation

You can download the latest stable release here.

OR build symlinker from source. In this case you need to install V first.

git clone https://github.com/serkonda7/symlinker.git
cd symlinker
v .

Now run sudo ./symlinker link -m ./symlinker and you are finished.

Note: At the moment only Linux is supported.

Usage

Usage: symlinker [command] [flags] [arguments]

Flags:
  -m, --machine          Execute the command machine-wide.

Commands:
  link <file>            Create a new symlink to <file>.
    -n, --name <name>      Use a custom name for the link.
  del <link1> <...>      Delete all specified symlinks.
  list                   List all symlinks.
    -r, --real             Also print the real path each symlink points to.
  update <link>          Rename a symlink or update it's real path. Use at least one of the flags.
    -n, --name <name>      The new name for the link.
    -p, --path <path>      The new path that will be linked.
  open [link]            Open a specific symlink or the general root dir in the file explorer.
  help [command]         Prints help information.
  version                Prints version information.

License

Licensed under the MIT License

symlinker-v's People

Contributors

Stargazers

Watchers

Forkers

ajunlonglive

symlinker-v's Issues

Warn on links which reference was removed

If list finds a link that is no longer valid, print a warning.

Custom representation for list command

Replace the generic array print output to improve visibility for a big amount of symlinks.

Command to create symlinks

Add check that link dirs are in PATH

Command to update symlinks

Add a new command like symlinker update <curr_name> --name <new_name> --path <new_path>
to update or rename existing links.

Delete symlinks

Improve argument parsing

Either use Vs cli module ~~or create a custom one for my needs~~.

Progress:

add
del
list
open

Investigate into Windows and macOS support

all: scope suggestions from machine to user scope

Allow multiple deletes at one time

Specifying more than one argument for del will delete all valid specified links.

test_get_links has inconsistent results

os.ls() returns files in inconsistent order.
It should be sorted to fix the issue.

cli output is randomly missing and list segfault

The execution results are very inconsistent.

cd command

sl cd <link> changes the terminal working dir to the dir of the linked file.

Create tests

Command methods

create_link
delete_link

~~- [ ] list_links~~

~~- [ ] update_link~~

~~- [ ] open_links~~

Internal stuff
~~- [ ] get_scope~~

scope_by_dir
get_dir

V panic if link exists already

module: main
 function: add_link()
  message: File exists
     file: symlinker.v
     line: 38

Add option to list the full symlink path

cannot update invalid links

Scope suggestion for update

Relative link prevention is untested

Inexistant files can be linked

Allow custom names for created symlinks

E.g. symlinker add -n name

update does not work

V panic if `add -n` is run without any args

module: builtin
 function: get()
  message: array.get: index out of range (i == 2, a.len == 2)
     file: /home/lukas/v/vlib/builtin/array.v
     line: 208