From 185c095750ac2c6b788a1703658e12c2e32480b4 Mon Sep 17 00:00:00 2001 From: TehreemAkhtar Date: Sun, 20 Oct 2024 17:29:16 +0500 Subject: [PATCH] Refine and update installation steps --- README.md | 48 +++++++++++++++++++++++++++++++++++------------- 1 file changed, 35 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 53ec853..71c083c 100644 --- a/README.md +++ b/README.md @@ -46,10 +46,10 @@
  • Getting Started 🚀
  • @@ -108,28 +108,50 @@ may find a `Language & region` section where you can find all of the supported c ## Getting Started -This is an example of how you may give instructions on setting up your project locally. To get a local copy up and -running follow these simple example steps. +This section provides instructions for two different use cases: -### Installation +1. **Installing the GNews package** for immediate use. +2. **Setting up the GNews project** for local development. + +### 1. Installing the GNews package + +To install the package and start using it in your own projects, follow these steps: ``` shell pip install gnews ``` +### 2. Setting Up GNews for Local Development -### Setup with Docker +If you want to make modifications locally, follow these steps to set up the development environment. -#### Developing with docker +#### Option 1: Setup with Docker 1. Install [docker and docker-compose](https://docs.docker.com/get-docker/). -2. Set-up your .env environment placing the mongo db credentials. -3. Run `docker-compose up --build` +2. Configure the `.env` file by placing your MongoDB credentials. +3. Run the following command to build and start the Docker containers: + +``` shell +docker-compose up --build +``` -#### Install using clone +#### Option 2: Install Using Git Clone -1. Clone this repository `https://github.com/ranahaani/GNews.git` -2. Start your virtual environment `virtualenv gnews` -3. Install the requirements with `pip install -r requirements.txt` +1. Clone this repository: +``` shell +git clone https://github.com/ranahaani/GNews.git +``` + +2. Set up a virtual environment: +```shell +virtualenv venv +source venv/bin/activate # MacOS/Linux +.\venv\Scripts\activate # Windows +``` + +3. Install the required dependencies: +```shell +pip install -r requirements.txt +```