Skip to content

Commit

Permalink
adding back readme
Browse files Browse the repository at this point in the history
  • Loading branch information
oneillm71 authored Mar 1, 2020
1 parent 8877a8f commit 48b32a3
Showing 1 changed file with 74 additions and 0 deletions.
74 changes: 74 additions & 0 deletions readMe.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
# Text Penguin

This program is an SPA where the user can upload a document that is a .pdf or .docx in order to have the contents of the document analyzed by three different algorithms:
Term Frequency-Inverse Document Frequency, Sentiment Analysis, and Latent Direchlet Allocation. The documents can be saved in files called "Projects", which will act as a means to organize the documents for a single project if need be.
The projects can be accessed later by the user as long as they have created a login.

# Technologies

In order to build this project, you will need to install:

* [Python3](https://www.python.org/downloads/)
* [Pip](https://pip.pypa.io/en/stable/installing/)
* [Django](https://docs.djangoproject.com/en/2.2/topics/install/)

After downloading Python3 and Pip from the websites shown above, you can install Django (on Ubuntu) using:
```
pip install Django
```

# Running

To run the app on your laptop, log into the virtual environment and use the Linux command:
```
source env/bin/activate
python3 manage.py runserver
```


## Deployment
Deployment utilized [Heroku's](https://www.heroku.com/home) deployment platform. The deployment can be found here: [Text Penguin](http://textpenguin.herokuapp.com/)

Notes about deployment:
* download output file currently not functional in deployment, but works in local development environment.
* user must be logged in to create a project, otherwise error occurs
* upload file function not currently in production
* text must be entered with a new line separating each "document"

Testing login:
username: clubpenguin
password: gamecocks

PLEASE LOG OUT AFTER USAGE. ONLY ONE PERSON MAY BE LOGGED INTO ACCOUNT AT A TIME.

## Testing

To run unit tests, navigate to the directory with the manage.py file and enter command:

`python3 manage.py test`

Tests will return results automatically, as they've been deesigned with the Django testing capabilities.

------------------------------------------------------------------------------------------------

All behavioral tests are found in the behavioral_tests folder under the main directory.

All behavioral tests are found in behavioral_tests.py

To run these tests you will need to download:
* [Selenium WebDriver](https://selenium.dev/)
* [Chromedriver](https://chromedriver.chromium.org/getting-started)
* [Google Chrome](https://www.google.com/chrome/?brand=CHBD&gclid=Cj0KCQiAs67yBRC7ARIsAF49CdXCaIEU_NeWPhVZImm3eyi8GQy1ClK_T5cCN30L4XPLMcAiAnwWdwEaAvIMEALw_wcB&gclsrc=aw.ds)

After your installation is complete, you can run the test using `python3 behavioral_tests.py`


## Authors

|Name: |Gmail: |
|----------------------|--------------------------------------|
|Samyu Comandur |[email protected] |
|Ainsley McWaters |[email protected] |
|Suzie Prentice |[email protected] |
|Matt O’Neill |[email protected] |
|Steven Maxwell |[email protected] |

0 comments on commit 48b32a3

Please sign in to comment.