2022-12-15 04:01:14 +00:00
<!doctype html> < html > < head > < title > Module fs — Hilbish< / title > < meta charset = utf-8 > < meta name = viewport content = "width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no" > < meta name = theme-color content = "#ff89dd" > < meta content = "/Hilbish/hilbish-flower.png" property = "og:image" > < meta property = "og:site_name" content = "Hilbish" > < meta content = "Module fs — Hilbish" property = "og:title" > < meta content = "filesystem interaction and functionality library" property = "og:description" > < meta content = "filesystem interaction and functionality library" name = description > < meta name = revisit-after content = "2 days" > < meta name = keywords content = "Lua,Hilbish,Linux,Shell" > < meta property = "og:locale" content = "en_GB" > < link rel = canonical href = https://rosettea.github.io/Hilbish/ > < meta property = "og:url" content = "https://rosettea.github.io/Hilbish/" > < link href = https://cdn.jsdelivr.net/npm/bootstrap@5.2.0-beta1/dist/css/bootstrap.min.css rel = stylesheet integrity = sha384-0evHe/X+R7YkIZDRvuzKMRqM+OrBnVFBL6DOitfPri4tjfHxaWutUpFmBp4vmVor crossorigin = anonymous > < script src = https://cdn.jsdelivr.net/npm/bootstrap@5.2.0-beta1/dist/js/bootstrap.bundle.min.js integrity = sha384-pprn3073KE6tl6bjs2QrFaJGz5/SUsLqktiwsUTF55Jfv3qYSDhgCecCxMW52nD2 crossorigin = anonymous > < / script >
2023-01-18 10:40:16 +00:00
< link rel = stylesheet href = https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.1.1/css/all.min.css integrity = "sha512-KfkfwYDsLkIlwQp6LFnl8zNdLGxu9YAA1QvwINks4PhcElQSvqcyVLLD9aMhXd13uQjoXtEKNosOWaZqXgel0g==" crossorigin = anonymous referrerpolicy = no-referrer > < style > . heading > . heading-link { opacity : 0 } . heading : hover > . heading-link { visibility : visible ; opacity : 1 ; transition : all .1 s ease-in } < / style > < / head > < body class = "d-flex flex-column min-vh-100" style = overflow-x:hidden > < svg xmlns = "http://www.w3.org/2000/svg" style = "display:none" > < symbol id = "check-circle-fill" fill = "currentcolor" viewBox = "0 0 16 16" > < path d = "M16 8A8 8 0 110 8a8 8 0 0116 0zm-3.97-3.03a.75.75.0 00-1.08.022L7.477 9.417 5.384 7.323a.75.75.0 00-1.06 1.06L6.97 11.03a.75.75.0 001.079-.02l3.992-4.99a.75.75.0 00-.01-1.05z" / > < / symbol > < symbol id = "info-fill" fill = "currentcolor" viewBox = "0 0 16 16" > < path d = "M8 16A8 8 0 108 0a8 8 0 000 16zm.93-9.412-1 4.705c-.07.34.029.533.304.533.194.0.487-.07.686-.246l-.088.416c-.287.346-.92.598-1.465.598-.703.0-1.002-.422-.808-1.319l.738-3.468c.064-.293.006-.399-.287-.47l-.451-.081.082-.381 2.29-.287zM8 5.5a1 1 0 110-2 1 1 0 010 2z" / > < / symbol > < symbol id = "exclamation-triangle-fill" fill = "currentcolor" viewBox = "0 0 16 16" > < path d = "M8.982 1.566a1.13 1.13.0 00-1.96.0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889.0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535.0.954.462.9.995l-.35 3.507a.552.552.0 01-1.1.0L7.1 5.995A.905.905.0 018 5zm.002 6a1 1 0 110 2 1 1 0 010-2z" / > < / symbol > < / svg > < header > < nav class = "navbar navbar-expand-md sticky-top bg-light" > < div class = container-fluid > < a class = navbar-brand href = /Hilbish > < img src = /Hilbish/hilbish-flower.png alt height = 24 class = "d-inline-block align-text-top" >
2022-12-15 04:01:14 +00:00
Hilbish< / a >
< button class = navbar-toggler type = button data-bs-toggle = collapse data-bs-target = #navbarSupportedContent aria-controls = navbarSupportedContent aria-expanded = false aria-label = "Toggle navigation" >
2023-01-18 10:40:16 +00:00
< span class = navbar-toggler-icon > < / span > < / button > < div class = "collapse navbar-collapse" id = navbarSupportedContent > < ul class = "navbar-nav me-auto mb-2 mb-lg-0" > < li class = nav-item > < a href = /Hilbish/ class = nav-link > Home< / a > < / li > < li class = nav-item > < a href = /Hilbish/install/ class = nav-link > Install< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/ class = nav-link > Docs< / a > < / li > < li class = nav-item > < a href = /Hilbish/blog/ class = nav-link > Blog< / a > < / li > < / ul > < / div > < / div > < / nav > < / header > < div class = "container py-3 row" > < div class = container style = width:240px > < div class = "p-3 col" > < ul class = "nav nav-pills mb-auto-collapse" id = navbarSupportedContent > < li class = nav-item > < a href = /Hilbish/docs/ class = nav-link > < strong > Introduction< / strong > < / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/getting-started/ class = nav-link > < strong > Getting Started< / strong > < / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/faq/ class = nav-link > < strong > Frequently Asked Questions< / strong > < / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/features/ class = nav-link > < strong > Features< / strong > < / a > < / li > < ul style = list-style:none > < li class = nav-item > < a href = /Hilbish/docs/features/runner-mode/ class = nav-link > Runner Mode< / a > < / li > < / ul > < li class = nav-item > < a href = /Hilbish/docs/api/ class = nav-link > < strong > API< / strong > < / a > < / li > < ul style = list-style:none > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.aliases/ class = nav-link > Interface hilbish.aliases< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.completions/ class = nav-link > Interface hilbish.completions< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.editor/ class = nav-link > Interface hilbish.editor< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.history/ class = nav-link > Interface hilbish.history< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.jobs/ class = nav-link > Interface hilbish.jobs< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.os/ class = nav-link > Interface hilbish.os< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.runner/ class = nav-link > Interface hilbish.runner< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.timers/ class = nav-link > Interface hilbish.timers< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/hilbish.userdir/ class = nav-link > Interface hilbish.userDir< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/bait/ class = nav-link > Module bait< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/commander/ class = nav-link > Module commander< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/fs/ class = nav-link > Module fs< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/hilbish/ class = nav-link > Module hilbish< / a > < / li > < li class = nav-item > < a href = /Hilbish/docs/api/terminal/ class = nav-link > Module terminal< / a > < / li > < / ul > < / ul > < / div > < / div > < div class = "p-3 col" > < div > < h1 > Module fs< / h1 > < p > < em > filesystem interaction and functionality library< br > < / em > < / p > < h3 id = introduction class = heading > Introduction
< a href = #introduction class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h3 > < p > The fs module provides easy and simple access to filesystem functions
2022-12-15 04:01:14 +00:00
and other things, and acts an addition to the Lua standard library’ s
2023-01-18 10:40:16 +00:00
I/O and filesystem functions.< / p > < h3 id = functions class = heading > Functions
2023-02-07 22:28:19 +00:00
< a href = #functions class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h3 > < h4 id = abspath---string class = heading > abs(path) -> string
< a href = #abspath---string class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Gives an absolute version of < code > path< / code > .< / p > < h4 id = basenamepath---string class = heading > basename(path) -> string
< a href = #basenamepath---string class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Gives the basename of < code > path< / code > . For the rules,
2023-01-18 10:40:16 +00:00
see Go’ s filepath.Base< / p > < h4 id = cddir class = heading > cd(dir)
2023-02-07 22:28:19 +00:00
< a href = #cddir class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Changes directory to < code > dir< / code > < / p > < h4 id = dirpath---string class = heading > dir(path) -> string
< a href = #dirpath---string class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Returns the directory part of < code > path< / code > . For the rules, see Go’ s
filepath.Dir< / p > < h4 id = globpattern---matches-table class = heading > glob(pattern) -> matches (table)
< a href = #globpattern---matches-table class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Glob all files and directories that match the pattern.
For the rules, see Go’ s filepath.Glob< / p > < h4 id = join---string class = heading > join(… ) -> string
< a href = #join---string class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Takes paths and joins them together with the OS’ s
2023-01-18 10:40:16 +00:00
directory separator (forward or backward slash).< / p > < h4 id = mkdirname-recursive class = heading > mkdir(name, recursive)
< a href = #mkdirname-recursive class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Makes a directory called < code > name< / code > . If < code > recursive< / code > is true, it will create its parent directories.< / p > < h4 id = readdirdir-- class = heading > readdir(dir) ->
< a href = #readdirdir-- class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Returns a table of files in < code > dir< / code > .< / p > < h4 id = statpath-- class = heading > stat(path) ->
< a href = #statpath-- class = heading-link > < i class = "fas fa-paperclip" > < / i > < / a > < / h4 > < p > Returns a table of info about the < code > path< / code > .
2022-12-21 01:00:32 +00:00
It contains the following keys:
name (string) - Name of the path
size (number) - Size of the path
mode (string) - Permission mode in an octal format string (with leading 0)
isDir (boolean) - If the path is a directory< / p > < / div > < div class = "footer mt-auto" > < p class = "card-small text-muted" > Want to help improve this page? < a href = https://github.com/Rosettea/Hilbish/issues/new/choose > Create an issue.< / a > < / p > < / div > < / div > < / div > < footer class = "footer mt-auto mt-auto py-3 bg-light row" > < div class = "col mb-3" > < / div > < div class = "col mb-3" > < a href = /Hilbish class = "d-flex align-items-center mb-3 link-dark text-decoration-none" > < img src = /Hilbish/hilbish-flower.png alt height = 48 class = "d-inline-block align-text-top" > < / a > < p class = text-muted > Rosettea © 2022< br > Made with < i class = "fa-solid fa-heart" style = color:#f6345b > < / i > < / p > < / div > < div class = "col mb-3" > < / div > < div class = "col mb-3" > < / div > < div class = "col mb-3" > < / div > < div class = "col mb-3" > < h5 > Hilbish< / h5 > < ul class = "nav flex-column" > < li class = "nav-item mb-2" > < a href = /Hilbish class = "nav-link p-0 text-muted" > Home< / a > < / li > < li class = "nav-item mb-2" > < a href = /Hilbish/docs/faq class = "nav-link p-0 text-muted" > FAQ< / a > < / li > < li class = "nav-item mb-2" > < a href = https://github.com/Rosettea/Hilbish class = "nav-link p-0 text-muted" > Source< / a > < / li > < li class = "nav-item mb-2" > < a href = https://github.com/Rosettea/Hilbish/releases class = "nav-link p-0 text-muted" > Releases< / a > < / li > < li class = "nav-item mb-2" > < a href = /Hilbish/docs class = "nav-link p-0 text-muted" > Documentation< / a > < / li > < / ul > < / div > < div class = "col mb-3" > < / div > < / footer > < / body > < / html >