Skip to content

Commit

Permalink
Update readme and gitignore to use pipenv (#69)
Browse files Browse the repository at this point in the history
* Add pipenv to README.md
* Add Pipfile.lock to .gitignore

Co-authored-by: Mo Beigi <[email protected]>
  • Loading branch information
gogvale and mobeigi authored Jun 25, 2020
1 parent da812fd commit 5cc26f1
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 8 deletions.
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ ipython_config.py
# However, in case of collaboration, if having platform-specific dependencies or dependencies
# having no cross-platform support, pipenv may install dependencies that don't work, or not
# install all needed dependencies.
#Pipfile.lock
Pipfile.lock

# celery beat schedule file
celerybeat-schedule
Expand Down
15 changes: 8 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,19 +27,20 @@ This tool **does not** use the Facebook API.

## Requirements
* Facebook account
* python3.6+ (and all required python3 modules)
* python3.6+
* pipenv
* Scheduler tool to automatically run script periodically (optional)
* Google Drive API access (optional)

## Instructions
### Option 1: Save ICS file to filesystem
1. Clone repo
`git clone [email protected]:mobeigi/fb2cal.git`
2. Rename `config/config-template.ini` to `config/config.ini` and enter your Facebook email and password.
2. Rename `config/config-template.ini` to `config/config.ini` and enter your Facebook email and password (no quotes).
3. Install required python modules
`pip install -r requirements.txt`
`pipenv install`
4. Run the script manually:
`python src/fb2cal.py`
`pipenv run python src/fb2cal.py`
5. Import the created `birthdays.ics` file into Calendar applications (i.e. Google Calendar)
### Option 2: Automatically Upload ICS file to Google Drive
1. Clone repo
Expand All @@ -55,9 +56,9 @@ This tool **does not** use the Facebook API.
3. Rename credentials JSON file to **credentials.json** and put it in the `src` folder
4. Rename `config/config-template.ini` to `config/config.ini` and enter your Facebook email and password as well as a name for your calender to be saved on Google Drive. Change `upload_to_drive` to `True`. Initially, the value for the **drive_file_id** field should be empty.
5. Install required python modules
`pip install -r requirements.txt`
6. Run script manually once for testing purposes:
`python ./fb2cal.py`
`pipenv install`
1. Run script manually once for testing purposes:
`pipenv run python ./fb2cal.py`
7. Check Google Drive to ensure your ICS file was made.
8. Setup Cron Jobs/Task Scheduler/Automator to repeatedly run the script to periodically generate an updated ICS file. See **Scheduled Task Frequency** section for more info.
9. Use the following link to import your ICS file into Calendar applications (i.e. Google Calendar):
Expand Down

0 comments on commit 5cc26f1

Please sign in to comment.