Skip to content

Updating Readme.md file to detail how to get local testing/coverage report #610

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 48 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,51 @@ pip install datascience
```

A log of all changes can be found in CHANGELOG.md.

## Setting up Local Development Environment

### For Windows Users

#### Setting up Windows Subsystem for Linux (WSL)

Before proceeding, it's recommended to set up Windows Subsystem for Linux (WSL) for better compatibility with development tools. Follow the official Microsoft documentation to install and set up WSL: [Install Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/install)

Once WSL is set up, open your preferred Linux distribution and continue with the following steps.

#### Installing Required Dependencies

Ensure you have Python, pip, and other necessary tools installed within your WSL environment.

sudo apt update
sudo apt install python3 python3-pip

### Generating local test report

1. Clone the repository:
git clone https://github.com/<your_username>/datascience.git

2. Navigate to the project directory
cd datascience

3. Install required packages:
pip install -r requirements.txt

4. Run tests using pytest
python3 pytest

5. Generate coverage report:
python3 coverage run -m pytest

6. View coverage report:
python3 coverage report

Optionally, integrate with Coveralls for code coverage tracking:
python3 coveralls

That's it! You have now successfully set up your local development environment and generated a test report.

After reviewing the results, you can determine which of the files under the source code folder need more tests based on their corresponding percentages.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to add the lines from here onwards :)


Our aim is to have 97% of overall codebase coverage to ensure that there are no discrepencies.

Thank you for considering to help our project, we really appreciate it :)