ondiekelijah / Bookmarks-Manager

A bookmark manager API that allows for simple bookmark management. User creation and authentication with access tokens, adding bookmarks, updating, deleting, and viewing existing bookmarks are all features. It also offers bookmark link visit tracking and statistics.

Home Page:https://develiebookmarks-api.herokuapp.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

BookmarksAPI

A bookmark manager API that allows for simple bookmark management. User creation and authentication with access tokens, adding bookmarks, updating, deleting, and viewing existing bookmarks are all features. It also offers bookmark link visit tracking and statistics.

Build and Test

Read the docs here

Installation

  1. Navigate into your desired folder, then clone this repo as shown, remember the dot (.) so as to avoid duplicating this repo's name again.

git clone https://github.com/Dev-Elie/BookmarksAPI.git .

  1. Change to that specific directory

cd directory path

  1. Create a virtual environment & activate it

Windows

#create a venv
py -3 -m venv venv
# activate venv
venv\Scripts\activate

macOS/Linux

#create a venv
python3 -m venv venv
# activate venv
source venv/bin/activate
  1. Install the requirements from the requirements.txt file.

pip install -r requirements.txt

  1. Create a .env file in the root of the directory then add the following contents, adding values for each depending on your configs.
DATABASE_HOSTNAME=
DATABASE_PORT=
DATABASE_PASSWORD=
DATABASE_NAME=
DATABASE_USERNAME=
SECRET_KEY=
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=
  1. Run a database migration

alembic upgrade head

  1. Start the server

uvicorn app.main:app --reload

About

A bookmark manager API that allows for simple bookmark management. User creation and authentication with access tokens, adding bookmarks, updating, deleting, and viewing existing bookmarks are all features. It also offers bookmark link visit tracking and statistics.

https://develiebookmarks-api.herokuapp.com/


Languages

Language:Python 97.6%Language:Mako 1.7%Language:Dockerfile 0.7%