mirror of
https://github.com/ION606/github-to-fs.git
synced 2026-05-14 22:16:53 +00:00
added README
This commit is contained in:
@@ -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
@@ -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": {
|
||||
|
||||
Reference in New Issue
Block a user