added README

This commit is contained in:
2024-05-22 20:41:35 -04:00
parent 7f088501f8
commit 9aeaee05b0
2 changed files with 36 additions and 1 deletions
+35
View File
@@ -0,0 +1,35 @@
# Github to File System (gh-to-fs)
This package allows a user to interact with the github api as if using the `fs` module.
# Differences
- ANY synchronous function (i.e. `writeFileSync`, `readFileSync`, etc) **MUST** be awaited
- The module must be initialized (see below)
# A Simple Example
```Javascript
// import the project
import customFs from 'github-to-fs';
// create the custom FS object
const cfs = new customFs('https://api.github.com/repos/ION606/github-to-fs', token);
// write the file to the repo
await cfs.writeFileSync('example.txt', 'hello world!');
// read the contents of the file
console.log((await cfs.readFileSync('example.txt')).toString());
// remove the file
await cfs.rmSync('example.txt');
// make sure the file is gone
console.log((await cfs.readFileSync('example.txt')).toString());
```
# Common Errors
## 409
This is a github error that happens seemingly at random. I can not control this and
it is currently a known problem with the GitHub API
- Created by ION606
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "github-to-fs",
"version": "1.0.0",
"version": "1.0.1",
"description": "a package that allows you to use github like file storage",
"main": "customFileSystem.js",
"scripts": {