Skip to content

Commit

Permalink
Update usage instructions to work with Poetry
Browse files Browse the repository at this point in the history
  • Loading branch information
IsaacCheng9 committed Jun 25, 2024
1 parent 80736e2 commit f462b70
Showing 1 changed file with 22 additions and 22 deletions.
44 changes: 22 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,11 @@
# Travel Buddy

[![code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
![CI](https://github.com/IsaacCheng9/travel-buddy/actions/workflows/main.yml/badge.svg)

**UPDATE (25th June 2024):** The application is no longer fully functional due
to outdated code for scraping data from websites.

**UPDATE (30th August 2022):** The route analysis and related features such as
location autocomplete are currently unavailable as our key for the Google Maps
API has expired.
Expand All @@ -19,34 +22,31 @@ planet by providing route analysis and a carpool marketplace.
<img width="2056" alt="image" src="https://user-images.githubusercontent.com/47993930/160259727-5bda8093-7a97-498a-b338-8806284647eb.png">
<img width="2056" alt="image" src="https://user-images.githubusercontent.com/47993930/160259626-7fe98e35-d7b0-4a2e-abf8-a2faa9b0e492.png">

## Installation
## Usage

### Installing Dependencies

Run the following command from the [project root](./) directory:

### Python Version
```bash
poetry install
```

The application has been developed and tested to work on _Python 3.8_ and
onwards.
### Running the Application

### Running the Application Locally
Run the following command from the [project root](./) directory:

To run the application, you should follow the following steps:
```bash
poetry run app
```

1. Clone this GitHub repository.
2. Ensure that you're in the root directory: `travel-buddy`
3. Install the required Python libraries: `pip install -r requirements.txt`
4. Install the code as a package on your local machine with the command:
`pip install -e .`
5. Run the application with the command: `python -m travel_buddy.app`
6. Navigate to <http://127.0.0.1:5000/> in your web browser.
### Running Tests

### Running Tests Locally
Run the following command from the [project root](./) directory:

1. Clone this GitHub repository.
2. Ensure that you're in the root directory: `travel-buddy`
3. Install the required Python libraries: `pip install -r requirements.txt`
4. Install the code as a package on your local machine with the command:
`pip install -e .`
5. Run all tests with the command `python -m pytest`
6. View test results in the terminal.
```bash
poetry run pytest
```

## Demo Instructions

Expand Down

0 comments on commit f462b70

Please sign in to comment.