generated from nyuoss/glaceon-python-template-repository
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
8467b5c
commit 0db7433
Showing
1 changed file
with
38 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -4,9 +4,9 @@ | |
The objective of the Google Suite Tasks Dashboard is to provide Google users with a centralized platform to efficiently manage tasks across the Google Task and Google Docs applications. By creating this solution, users can easily access and track their tasks in one location. | ||
|
||
## Features | ||
1. Crawling tasks from Google Docs. | ||
1. Extract tasks from Google Docs. | ||
2. View-only dashboard for user's tasks. | ||
3. Fetching tasks directly from Google Tasks API. | ||
3. Crawling tasks directly from Google Tasks API. | ||
|
||
## Installation instructions | ||
1. Clone the repository [glaceon-google-suite-tasks](https://github.com/nyuoss/glaceon-google-suite-tasks). | ||
|
@@ -22,6 +22,16 @@ The objective of the Google Suite Tasks Dashboard is to provide Google users wit | |
|
||
`pdm update` | ||
|
||
5. To connect AWS RDS through SSH, run the command with postgresql database installed | ||
|
||
```bash | ||
psql -h opensource-db.chwy4eqkclzc.us-east-1.rds.amazonaws.com -p 5432 -U postgres -d task-db | ||
``` | ||
|
||
6. To create the table in the database (please connect Fan([email protected]) for database password ) | ||
|
||
`create_databse.sql` | ||
|
||
## Usage instructions | ||
### Running Flask app | ||
Change directory to `src/open_source_python_template` folder: | ||
|
@@ -45,10 +55,32 @@ Open browser and go to the following host address: | |
|
||
## Contribution Guidelines | ||
|
||
### Backend | ||
Entry point of the Flask application is `__init__.py`. | ||
### Getting Started | ||
The below is an overview of how the project is structured. We recommend going through this section to have a basic understanding of where feature-related code files are located before making a contribution. | ||
#### Backend | ||
Entry point of the Flask application is `src/open_source_python_template/__init__.py`. | ||
|
||
Methods for crawling tasks from Google Sheet API is defined in `src/open_source_python_template/crawlTasks.py`. | ||
|
||
### Frontend | ||
App Script for extracting tasks from Google Docs is `src/open_source_python_template/extractTasks.js`. | ||
|
||
#### Frontend | ||
Frontend HTML templates can be found in `templates/` folder, such as `index.html`. | ||
|
||
Static elements and styles can be found in `static/` folder, such as `style.css`. | ||
Static elements, scripts, and styles can be found in `static/` folder, such as `style.css`. | ||
|
||
### Making Contributions | ||
### Issues | ||
1. Create an Issue: Before you make significant changes or improvements, please check if an existing issue already addresses your concern. If not, submit a new issue providing as much relevant information as possible. | ||
2. Discuss: Participation in issue discussion is highly encouraged. Share your thoughts, suggestions, and ways to resolve issues. | ||
|
||
### Pull Requests | ||
1. Create a Branch: Always create a new branch for your work. It should be named appropriately based on the nature of the change (e.g., feature-add-login, bugfix-address-crash). | ||
2. Make Your Changes: Perform your changes or additions in your branch, adhering to the coding standards and documentation style of the project. | ||
3. Write Tests: Ensure that your changes are covered by tests, which help in maintaining code quality and robustness. | ||
4. Document Your Changes: Update `README.md` with details of changes to the interface, this includes new dependencies, useful file locations, and connected components. | ||
5. Pull Request: Push your changes to your fork and submit a pull request (PR) to the original repository. It should describe the changes, reference the issues they affect, and note any specific areas where you would like feedback. Please use our PR template for documentation. | ||
6. Code Review: Wait for the project maintainers to review your PR. Be open to making changes based on feedback. | ||
|
||
### Style Guides | ||
Please follow the coding style and conventions that are used in the project. We have setup a CI/CD pipeline to check for coding styles, please refrain from raising a PR if the formatter returns an error and make fixes accordingly to comply. |