Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Kohze/fireData
Firebase + R
https://github.com/Kohze/fireData
2017 firebase gsoc package r
Last synced: 8 days ago
JSON representation
Firebase + R
- Host: GitHub
- URL: https://github.com/Kohze/fireData
- Owner: Kohze
- License: mit
- Created: 2017-01-21T17:31:30.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-10-13T23:25:49.000Z (about 4 years ago)
- Last Synced: 2024-08-13T07:13:52.629Z (4 months ago)
- Topics: 2017, firebase, gsoc, package, r
- Language: R
- Size: 722 KB
- Stars: 75
- Watchers: 10
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- jimsghstars - Kohze/fireData - Firebase + R (R)
README
[](https://raw.githubusercontent.com/Kohze/fireData/master/LICENSE.txt)
[](https://travis-ci.org/Kohze/fireData)
[](https://codecov.io/gh/Kohze/fireData)
**Project Title:** FireData: Connecting R to Google Firebase
---
FireData integrates R Datascience with the abilities and possibilities of the Google Firebase Framework.
Firebase makes it possible to exchange in real-time information in the Cloud and thereby opening the R language to IoT hardware/data processing. Other than that it is also immensely useful for shiny application to integrate Social Authentications and persistent data & uploads.
This package was created within the framework of Google Summer of Code 2017 and 2018.
**Database Setup:**
- visit https://firebase.google.com/
- login and enter the "console"
- add new project
- find the API keys at the "overview" page clicking on add firebase to web-app
- certain functions requires OAuth 2.0 access which needed client_id and client_secret, these can be found from the [google developer console](https://console.developers.google.com/apis/credentials)
**R Package Setup:**
```
if (!require("devtools")) install.packages("devtools")
devtools::install_github("Kohze/fireData")
library(fireData)
```
**Authentification**
- using anonymous login
```r
token <- anonymous_login(project_api = "AIzaSyAjZLO9-CRV3gObpwdFz-k8AiTOxHSBmdc")
token$idToken
```
**General Functions:**
- uploading a data.frame:
```upload(x = mtcars, projectURL = "https://firedata-b0e54.firebaseio.com/", directory = "main")```
- patching a data.frame:
```patch(x = mtcars, projectURL = "https://firedata-b0e54.firebaseio.com/", directory = "main/-KxwWNTVdplXFRZwGMkH")```
- putting a data.frame:
```put(x = mtcars, projectURL = "https://firedata-b0e54.firebaseio.com/", directory = "main/-KxwWNTVdplXFRZwGMkH")```
- download a data.frame:
```download(projectURL = "https://firedata-b0e54.firebaseio.com/", fileName = "main/-KxwWNTVdplXFRZwGMkH")```
- register a new user
```createUser(projectAPI = "AIzaSyAjZLO9-CRV3gObpwdFz-k8AiTOxHSBmdc", email = "[email protected]", password = "12341234" )```
- create token for authenticated requests (can be used for the token argument of upload/download)
```auth(projectAPI = "AIzaSyAjZLO9-CRV3gObpwdFz-k8AiTOxHSBmdc", email = "[email protected]", password = "12341234")```
- reset user password
```resetPassword(projectAPI = "AIzaSyAjZLO9-CRV3gObpwdFz-k8AiTOxHSBmdc", email = "[email protected]")```
- backup the database and save as .json
```dataBackup(projectURL = "https://firedata-efa5a.firebaseio.com", secretKey = "2bYA6k72wKna90MqPGa6yuMG7jAysoDJZwJqYXsm", "test.json")```
fireData is already integrated into a several projects.
- SpatialMaps: A spatial proteomics platform that utilizes firebase as cross platform database.
- Cryptotrade-hq bot: A simple data collector (with shiny) that uses firebase for secure storage of API keys.
We are currently planning to add the new Cloud Firebase database and enhance the integration into R web applications.
---
**Aknowledgements:**
I hereby want to thank my GSOC mentors L. Pedraza, S. Schmidt for their project support and especially L. Gatto for his insights and experience to make this package a reality.