https://github.com/joeyguerra/cmsnpto-announcements
Program that builds an HTML file from school announcements in a Google Drive folder.
https://github.com/joeyguerra/cmsnpto-announcements
Last synced: 3 months ago
JSON representation
Program that builds an HTML file from school announcements in a Google Drive folder.
- Host: GitHub
- URL: https://github.com/joeyguerra/cmsnpto-announcements
- Owner: joeyguerra
- License: mit
- Created: 2019-08-23T00:28:31.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-11T02:58:36.000Z (over 2 years ago)
- Last Synced: 2025-02-11T11:42:26.269Z (4 months ago)
- Language: JavaScript
- Size: 642 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Coppell North Middle School Anouncements
----------------------------------
## Overview
The Coppell North Middle School PTO emails the school announcements to parents who pay to receive them. This Node JS program builds HTML from the announcements saved on to the school's Google Drive.
## Requirements
You'll need NodeJS version >= 14.10. This app is written in Javascript, targeting the NodeJS runtime. I like to be able to quickly switch to different NodeJS versions. So I use [nvm](https://github.com/nvm-sh/nvm) to manage my NodeJS versions. I developed this program using version `v14.10.0`.
## Setup
This program integrates with Google Drive, requiring a `credentials.json` files containing account credentials to get access to the specified Google Drive folder. Contact me offline to get this file.
First step is to get all the necessary code by installing all the dependent libraries.
```bash
npm i
```
Second step is to create a file called `.env` (yes, staring with a dot (`.`)). The `.env` file should look like the following:
```bash
email=
password=
```
Third step is to get the `credentials.json` file (contact me).
Fourth step is to run the program like so in a terminal, command prompt or powershell:
```bash
npm start -- --date=10/2/2019 --folder="2020-2021"
```
The `--date` is the date to start looking for announcements. The `--folder` argument is the name of the folder to start searching for the files.
When you run `npm start -- --folder="2020-2021" --date=10/2/2019` in your terminal, you'll see a URL if this is the first time and you haven't authenticated with Google yet. Copy and paste that URL into your browser's URL field and hit `return`. This will direct you to Google. Go ahead and signin and accept. The program will start a web server which will intercept the HTTP redirect from Google's OAuth sequence, capture the `code` and write it in a file called `token.json`. Subsequent executions shouldn't require you to enter an authentication code until that `Token` expires.
The output of the program will be a text file called `output.html` in the app directory and a scheduled newsletter. Then just login to membership toolkit and release the newsletter.