1.0.2 • Published 7 years ago

fireaction v1.0.2

Weekly downloads
2
License
MIT
Repository
github
Last release
7 years ago

fireaction

Easy copy and move actions within a firebase database

JavaScript Style Guide Build Status

Why?

I simply got tired of rewriting the same copy (and remove) code for every firebase project.

Installation

# with npm
npm install --save fireaction

# with yarn
yarn add fireaction

For browsers, use the build in dist/fireaction.js

Usage

In nodejs:

var Fireaction = require('fireaction')

// ...
// require and setup firebase
//...
// get firebase database ref
const ref = firebase.database().ref()

// configure fireaction with firebase database ref
const fireaction = new Fireaction(ref)

// copy from one path to the other
// async with either callback
fireaction.copy(src, dest, function (err, data) {/*  */})
// or promise
fireaction.copy(src, dest)
	.then(function (sourceData) {/* ... */})

Options

Fireaction copy and move methods can take in a third object argument instead of a callback:

const options = { withKey: true }

fireaction(src, dest, options, callback)
OptionType (default)Description
withKeyboolean (true)Copies parent key with value into destination path
overrideboolean (false)Overrides existing data in destination path

Running Tests

  • npm run lint: runs the linter (standard)
  • npm run unit: runs the unit tests
  • npm test: runs both the linter and the tests

Creating a build for browser

Build is run by webpack, so install dependencies:

# with npm
npm install

# with yarn
yarn

Then run build:

npm run build

NB: It is better to build using npm start which will lint and test before building.

Contributing

To contribute:

  • Take a look at existing issues.
  • Create fixes/updates.
  • Write tests.
  • Lint, run tests and build.
  • Send detailed PR.

License

Licensed under MIT

Copyright (c) 2017 ghostffcode