nv-file-basic
v1.0.10
Published
nv-file-basic ============== - simple async wrap of node fs-module - add some symbol-link functions
Downloads
5
Readme
nv-file-basic
- simple async wrap of node fs-module
- add some symbol-link functions
install
- npm install nv-file-basic
usage
const fbsc = require("nv-file-basic")
example
char_dev
"/dev/ttyS0"
await fbsc.is_char_dev("/dev/ttyS0")
>true
blk_dev
"/dev/sda1"
await fbsc.is_blk_dev("/dev/sda1")
>true
sock
var srv = http.createServer();
srv.listen("sock")
await fbsc.is_sock("./sock")
>true
fifo
mkfifo fifo
await fbsc.is_fifo("./fifo")
file AND dir
nv-file-basic# ls -l
total 20
-rw-r--r-- 1 root root 1539 Feb 27 09:56 consts.js
-rw-r--r-- 1 root root 4454 Feb 27 10:03 index.js
drwxr-xr-x 3 root root 4096 Feb 26 01:58 node_modules
-rw-r--r-- 1 root root 58 Feb 26 01:58 package.json
lrwxrwxrwx 1 root root 8 Feb 27 10:04 s0 -> index.js
lrwxrwxrwx 1 root root 2 Feb 27 10:05 s1-to-s0 -> s0
lrwxrwxrwx 1 root root 26 Feb 27 10:05 s2 -> ../nv-file-reader/index.js
.....
> await fbsc.is_file("./consts.js")
true
>
> await fbsc.is_dir("./node_modules")
true
>
> await fbsc.is_slink("./s0")
true
>
await fbsc.readlink("./s0")
'/opt/JS/NV5_/nv-file-/pkgs/nv-file-basic/index.js'
>
> await fbsc.readlink("./s1-to-s0")
'/opt/JS/NV5_/nv-file-/pkgs/nv-file-basic/s0'
>
await fbsc.readlink_r("./s1-to-s0")
'/opt/JS/NV5_/nv-file-/pkgs/nv-file-basic/index.js'
>
invalid symbol-link
nv-file-basic# ls -l /usr/bin/ | egrep ghci
lrwxrwxrwx 1 root root 35 Sep 10 2019 ghci -> /mnt/sdb/HASKELL/installed/bin/ghci
nv-file-basic#
nv-file-basic# cat /mnt/sdb/HASKELL/installed/bin/ghci
cat: /mnt/sdb/HASKELL/installed/bin/ghci: No such file or directory
nv-file-basic#
> await fbsc.readlink("/usr/bin/ghci")
'/mnt/sdb/HASKELL/installed/bin/ghci'
>
> await fbsc.is_valid_slink("/usr/bin/ghci")
false
>
# touch x
# ln -s x s3
# ln -s s3 s4
# ln -s s4 s5
# rm x
> await fbsc.readlink_r("./s5")
'/opt/JS/NV5_/nv-file-/pkgs/nv-file-basic/x'
>
> await fbsc.is_valid_slink("./s5")
true //different behavior with fs.exist
> await fbsc.is_valid_slink("./s4")
true //different behavior with fs.exist
> await fbsc.is_valid_slink("./s3")
false
>
> await fbsc.is_valid_slink_r("./s5")
false
> await fbsc.get_tname("./x")
'noexist'
>
children
> await fbsc.get_children("./node_modules")
[
'/opt/JS/NV5_/nv-file-/pkgs/nv-file-basic/node_modules/.package-lock.json',
'/opt/JS/NV5_/nv-file-/pkgs/nv-file-basic/node_modules/nv-path-basic'
]
>
lstat
> await fbsc.lstat("./index.js")
{
dev: 2050,
nlink: 1,
uid: 0,
gid: 0,
rdev: 0,
blksize: 4096,
ino: 691999,
size: 5445,
blocks: 16,
atimeMs: 1645972913639.7522,
mtimeMs: 1645972908643.701,
ctimeMs: 1645972908655.7012,
birthtimeMs: 1645972908643.701,
atime: 2022-02-27T14:41:53.640Z,
mtime: 2022-02-27T14:41:48.644Z,
ctime: 2022-02-27T14:41:48.656Z,
birthtime: 2022-02-27T14:41:48.644Z,
permission: {
owner_can_read: true,
owner_can_write: true,
owner_can_exec: false,
group_can_read: true,
group_can_write: false,
group_can_exec: false,
other_can_read: true,
other_can_write: false,
other_can_exec: false
},
type: 'file'
}
>
CONSTS
CONSTS: {
TNAMES: {
slink: 'slink',
valid_slink: 'valid_slink',
invalid_slink: 'invalid_slink',
file: 'file',
dir: 'dir',
blk_dev: 'blk_dev',
char_dev: 'char_dev',
fifo: 'fifo',
sock: 'sock',
noexist: 'noexist'
},
CONST_TNAME_TO_NUM: {
S_IFMT: 61440,
S_IFREG: 32768,
S_IFDIR: 16384,
S_IFCHR: 8192,
S_IFBLK: 24576,
S_Ififo: 4096,
S_IFLNK: 40960,
S_IFSOCK: 49152
},
NUM_TO_CONST_TNAME: {
'4096': 'S_Ififo',
'8192': 'S_IFCHR',
'16384': 'S_IFDIR',
'24576': 'S_IFBLK',
'32768': 'S_IFREG',
'40960': 'S_IFLNK',
'49152': 'S_IFSOCK',
'61440': 'S_IFMT'
},
CONST_TNAME_TO_TNAME: {
S_IFREG: 'file',
S_IFDIR: 'dir',
S_IFCHR: 'char_dev',
S_IFBLK: 'blk_dev',
S_Ififo: 'fifo',
S_IFLNK: 'slink',
S_IFSOCK: 'sock'
},
TNAME_TO_CONST_TNAME: {
file: 'S_IFREG',
dir: 'S_IFDIR',
char_dev: 'S_IFCHR',
blk_dev: 'S_IFBLK',
fifo: 'S_Ififo',
slink: 'S_IFLNK',
sock: 'S_IFSOCK'
},
num_to_tname: [Function: num_to_tname],
tname_to_num: [Function: tname_to_num],
PNAMES: {
owner_can_read: 'owner_can_read',
owner_can_write: 'owner_can_write',
owner_can_exec: 'owner_can_exec',
group_can_read: 'group_can_read',
group_can_write: 'group_can_write',
group_can_exec: 'group_can_exec',
other_can_read: 'other_can_read',
other_can_write: 'other_can_write',
other_can_exec: 'other_can_exec'
},
CONST_PNAME_TO_PNAME: {
S_IRUSR: 'owner_can_read',
S_IWUSR: 'owner_can_write',
S_IXUSR: 'owner_can_exec',
S_IRGRP: 'group_can_read',
S_IWGRP: 'group_can_write',
S_IXGRP: 'group_can_exec',
S_IROTH: 'other_can_read',
S_IWOTH: 'other_can_write',
S_IXOTH: 'other_can_exec'
},
PNAME_TO_CONST_PNAME: {
owner_can_read: 'S_IRUSR',
owner_can_write: 'S_IWUSR',
owner_can_exec: 'S_IXUSR',
group_can_read: 'S_IRGRP',
group_can_write: 'S_IWGRP',
group_can_exec: 'S_IXGRP',
other_can_read: 'S_IROTH',
other_can_write: 'S_IWOTH',
other_can_exec: 'S_IXOTH'
},
CONST_PNAME_TO_NUM: {
S_IRUSR: 256,
S_IWUSR: 128,
S_IXUSR: 64,
S_IRGRP: 32,
S_IWGRP: 16,
S_IXGRP: 8,
S_IROTH: 4,
S_IWOTH: 2,
S_IXOTH: 1
},
NUM_TO_CONST_PNAME: {
'1': 'S_IXOTH',
'2': 'S_IWOTH',
'4': 'S_IROTH',
'8': 'S_IXGRP',
'16': 'S_IWGRP',
'32': 'S_IRGRP',
'64': 'S_IXUSR',
'128': 'S_IWUSR',
'256': 'S_IRUSR'
},
num_to_pname: [Function: num_to_pname],
pname_to_num: [Function: pname_to_num]
}
this is a getter, return a promise
> await fbsc.FH_SYMS_
{
kCapture: Symbol(kCapture),
kHandle: Symbol(kHandle),
kFd: Symbol(kFd),
kRefs: Symbol(kRefs),
kClosePromise: Symbol(kClosePromise)
}
>
APIS
const _readdir = _promisify(fs.readdir);
const _readlink = _promisify(fs.readlink);
const _lstat = _promisify(fs.lstat);
const _exist = _promisify(fs.exists);
const exist = async (p) => {
const is_slink = async (p) => {
const is_file = async (p) => {
const is_dir = async (p) => {
const is_blk_dev = async (p) => {
const is_char_dev = async (p) => {
const is_fifo = async (p) => {
const is_sock = async (p) => {
const _get_tname_with_stat = (stat) => {
const get_tname = async (p) => {
const _get_children_with_stat = async (p,stat) => {
const get_children = async (p) => {
const _is_leaf_with_stat = async (p,stat) => {
const is_leaf = async(p) => {
const _readlink_without_resolve = async(p) => {
const readlink = async (p)=> {
const readlink_r = async (p) => {
const is_valid_slink = async (p) => {
const is_invalid_slink = async (p) => {
const is_valid_slink_r = async (p) => {
const is_invalid_slink_r = async (p) => {
const size = async (p) => {
const _permission_with_stat = (stat) => {
const permission = async (p)=> {
const lstat = async (p)=> {
LICENSE
- ISC