MMU Xplore Research Paper Tracker This guide details the steps to set up, configure, and run the MMU Xplore Research Paper Tracker project locally.

1. Clone the Repository Start by cloning the codebase to your local machine.

Bash git clone cd 2. Create & Activate Virtual Environment It is recommended to use a virtual environment to manage dependencies isolated from your system Python.

Bash

Create the virtual environment

python -m venv .venv

Activate the virtual environment

On Windows:

source .venv/Scripts/activate

3. Install Dependencies Install the required Python packages listed in the requirements file.

Bash pip install -r requirements.txt 4. Database Setup Before running the server, you must apply the database migrations. Bash

Apply migrations to set up the database schema

python manage.py migrate

Note: If you have made changes to the models.py files, run python manage.py makemigrations before running migrate.

5. Run the Server Ensure you are in the directory containing manage.py and start the development server.

Bash python manage.py runserver You can now access the project at http://127.0.0.1:8000/.

Testing

To run the tests for this Django project, use the following commands:

Run All Tests

python manage.py test

Run Tests for a Specific App

python manage.py test myapp

Run Tests with Verbose Output

python manage.py test --verbosity=2

Run Tests with Coverage (if coverage is installed)

First, install coverage:

pip install coverage

Then run:

coverage run manage.py test
coverage report

Using Amara

Amara is not directly integrated into this Django project. If you are referring to a separate testing or automation tool, please provide more details. For Django-specific testing, refer to the testing section above.