fs-gui

    1.5.0 • Public • Published

    fs-gui

    Overview

    Welcome to the fs-gui. This package allows you to add file selection menus to your programs. See below to example usage.

    How to use

    1. First you have to install the package using npm i fs-gui or fork the repo
    2. You need to require it in your code.
    const Explorer = require("fs-gui")
    1. Use the functions below, you can change Explorer for whatever you would like.

    • Explorer.searchDir(message)

      The searchDir function creates a selection menu for selecting a directory.

      This function returns the path of the directory selected.

      The message parameter is the message to show the user, [e.g. "Select a folder"]


    • Explorer.searchAll(message)

      The searchAll function creates a selection menu for selecting all files.

      This function returns the path to file/directory chosen.

      The message parameter is the message to show the user, [e.g. "Select a file or folder"]


    • Explorer.searchCustom(message, ext)

      The searchCustom function creates a selection menu for selecting all files. This function returns the path to file/directory chosen

      The message parameter is the message to show the user, [e.g. "Select a file or folder"].

      The ext parameter is an array, containing the file extensions. [e.g. [".txt",".pdf"]]

    • Explorer.createFile(data)

      The createFile functions creates a menu, showing the normal folders, but adds an extra option Create File. Once selected Create File asks for the name and extension. The data parameter is the contents of the file. It must be string.

    • Explorer.createCustomFile(data, name)

      Similar to createFile, but the name is already specified.

    • Explorer.createFolder()

      The createFolder functions creates a menu, showing the normal folders, but adds an extra option Create Folder. Once selected Create Folder asks for the folder name.

    • Explorer.deleteFile()

      The delete folder function is like the searchAll function, but for deleting files

    • Explorer.deletFolder()

      The delete folder function is like the searchDir function, but for deleting folders.

    Examples

    The examples below are assuming your code has the following line

    const Explorer = require("fs-gui")
    • If you wanted the user to select a pdf file
    Explorer.searchCustom("Select a PDF", [".pdf"])
    • If you wanted the user to select a directory in the node_modules folder
    process.chdir("node_modules")
    Explorer.searchDir("Select a directory")

    Install

    npm i fs-gui

    DownloadsWeekly Downloads

    0

    Version

    1.5.0

    License

    CC-BY-4.0

    Unpacked Size

    15.3 kB

    Total Files

    6

    Last publish

    Collaborators

    • redyetidev