Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amancevice/fest
Sync public facebook page events to Google Calendar
https://github.com/amancevice/fest
aws facebook google-calendar heroku python
Last synced: about 2 months ago
JSON representation
Sync public facebook page events to Google Calendar
- Host: GitHub
- URL: https://github.com/amancevice/fest
- Owner: amancevice
- License: mit
- Created: 2017-12-14T23:15:57.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-03-10T15:21:52.000Z (10 months ago)
- Last Synced: 2024-10-10T04:07:55.084Z (2 months ago)
- Topics: aws, facebook, google-calendar, heroku, python
- Language: Python
- Homepage:
- Size: 300 KB
- Stars: 13
- Watchers: 7
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Facebook Event State Transfer
[](https://github.com/amancevice/fest/actions/workflows/pytest.yml)
[](https://codeclimate.com/github/amancevice/fest/test_coverage)
[](https://codeclimate.com/github/amancevice/fest/maintainability)
Sync public facebook page events to Google Calendar.
## Prerequisites
Before beginning you will need to create and configure a [facebook app](./docs/facebook.md#facebook) and use it to acquire a page access token for Graph API.
You will also need to set up a Google [service account](./docs/google.md#google) to acquire a credentials file to authenticate with Google APIs.
## Installation
Install `fest` using pip:
```bash
pip install fest
```
### Basic Use
Use clients for facebook's Graph API and Google's Calendar API to create `FacebookPage` and `GoogelCalendar` objects, then synchronize:
```python
import facebook
from googleapiclient import discovery
import fest
# Connect to Graph API & Calendar API
graphapi = facebook.GraphAPI('')
calendarapi = discovery.build('calendar', 'v3', cache_discovery=False)
# Get Page/Calendar objects
page = fest.FacebookPage(graphapi, '')
gcal = fest.GoogleCalendar(calendarapi, '')
# Sync Calendar <= Page
req = gcal.sync(page, time_filter='upcoming')
res = req.execute()
```
## Deployment
Several methods of deployment are provided.
### AWS
A pair of [terraform](https://github.com/amancevice/terraform-aws-facebook-gcal-sync) [modules](https://github.com/amancevice/terraform-aws-facebook-gcal-sync-secrets) module are provided to deploy this tool as a Lambda function on AWS and invoke it on a cron using CloudWatch.
```hcl
# WARNING Be extremely cautious when using secret versions in terraform
# NEVER store secrets in plaintext and encrypt your remote state
# I recommend applying the secret versions in a separate workspace with no remote backend,
# or curating them manually in the console or AWS CLI.
resource "aws_secretsmanager_secret_version" "facebook" {
secret_id = module.facebook_gcal_sync.facebook_secret.id
secret_string = "my-facebook-app-token"
}
resource "aws_secretsmanager_secret_version" "google" {
secret_id = module.facebook_gcal_sync.google_secret.id
secret_string = file("./path/to/my/svc/acct/creds.json")
}
module facebook_gcal_sync {
source = "amancevice/facebook-gcal-sync/aws"
version = "~> 1.0"
facebook_page_id = ""
facebook_secret_name = "facebook/my-app"
google_calendar_id = ""
google_secret_name = "google/my-svc-acct"
}
```
### Heroku
A [terraform module](https://github.com/amancevice/terraform-heroku-facebook-gcal-sync) module is provided to deploy this tool as a Heroku application.
```hcl
module facebook_gcal_sync {
source = "amancevice/facebook-gcal-sync/heroku"
app_name = ""
facebook_page_id = ""
google_calendar_id = ""
google_credentials_file = ""
facebook_page_token = ""
}
```
Alternatively, deploy with one click:
[](https://heroku.com/deploy)