Skip to content
This repository was archived by the owner on Feb 12, 2026. It is now read-only.

Latest commit

 

History

History
43 lines (29 loc) · 1.34 KB

File metadata and controls

43 lines (29 loc) · 1.34 KB

File Object

Access file system like you access any objects

Why?

Sometimes you want to write a small script that deals files and it can be annoying to deal with file system API's. This Project provides proxied object that allow you to access files and folders as if the are present in the memory.

Installation

$ npm i node_file_object

Usage

const createFileObject = require("node_file_object");

// Path is optional if not speficied '/' will be used
// path supplied here should be a folder path
const fileObject = createFileObject({ path: "/home/username" });

// List all files and folders in directory as strings
console.log(Object.keys(fileObject));

// List all files and folders as array of objects with additional attributes
console.log(fileObject.getChildren());

// READ the content of a given file
console.log(fileObject[".zshrc"].getContent());

// Walk through file system like you do on an object
// /home/username/Documents/notes.md
const documents = fileObject["Documents"];
console.log(documents["notes.md"].getContent());

Downsides?

Since it is meant to function like direct object access it uses synchronous file API's which might cause performance issues when used in large projects (since it has to wait for IO to complete). But this project will prove useful for smaller scripts where this does not matter.