Tammy Hartline's
E-Portfolio

Follow Me on LinkedIn!

Home About Me Original Artifacts Enhancement Plan Software Engineering Algorithms & Data Structures Databases Code Review Enhancements Summary Run Instructions Career Objective Site & Repo Links

Enhanced Program - Run Instructions 📄

---

How to Access the Live Enhanced Animal Shelter Dashboard Application 🔗

Visit https://tammyhartlinescapstone.onrender.com

---

How to Run the Enhanced Animal Shelter Dashboard on Your Local Machine 💻

This guide provides step-by-step instructions to set up and run the enhanced Animal Shelter program directly from the GitHub repository.

Prerequisites

1. Ensure you have Python installed on your system (version 3.7 or higher recommended).

2. Install Git on your system if it’s not already installed.

Setup and Installation

1. Clone the repository: Open a terminal and run the following command: git clone https://github.com/tjhartline/capstone.git

2. Navigate to the project directory: cd capstone

3. Install the required dependencies: pip install -r requirements.txt

Running the Program

1. Running the Dash Application:

   • In the terminal, ensure you’re in the project directory.

   • Run the following command:

     python app.py

   • Open a web browser and navigate to http://localhost:8050 to view and interact with the dashboard.

2. Running the Unit Tests:
   • In the terminal, ensure you’re in the project directory.

   • Run the following command:

     python -m unittest test_animal_shelter.py

   • The test results will be displayed in the terminal, showing which tests passed or failed.

Notes

• The Dash application will automatically use the animals.db database file. If it doesn’t exist, it will be created and populated with data from the aac_shelter_outcomes.csv file included in the repository.
• The unit tests use a separate test database that is created and deleted during the testing process.
• All necessary files, including the Grazioso Salvare logo, are included in the cloned repository.

By following these instructions, you can run and test all components of the enhanced Animal Shelter program, demonstrating the improvements in database management, data visualization, and overall software design.

For any issues or questions, please refer to the repository’s README or open an issue on the GitHub page.