Skip to content

FOSS-Community/LinkLiberate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

424c648 ยท Dec 24, 2024

History

54 Commits
Jan 8, 2024
Apr 10, 2024
Dec 24, 2023
Dec 24, 2024
Jan 28, 2024
Jan 5, 2024
Jan 7, 2024
Jan 5, 2024
Jan 5, 2024
Jan 5, 2024
Jan 5, 2024
Jan 10, 2024
Jan 7, 2024
Jan 8, 2024
Jan 10, 2024
Jan 5, 2024
Jan 28, 2024
Jan 28, 2024
Jan 28, 2024

Repository files navigation

๐Ÿ”—LinkLiberate๐Ÿชฝ

LinkLiberate is a URL shortener that is free and open source. It is built with Python, powered by FastAPI.

Version Code Coverage License GitHub Issues GitHub Pull Requests Release Date Commits Last Commit Contributors Repo Size Code Size Code Style: Black

Material Bread logo


๐Ÿค” Pre-requisites

  • python3
  • pdm

๐Ÿ Python Version Support

This project is designed to be compatible with specific versions of Python for optimal performance and stability.

Supported Python Version

  • Python 3.11.6

โ—๏ธ For the best experience and performance, it is recommended to use the version mentioned above.

Before diving into the project, ensure that you have the correct Python version installed. To check the version of Python you currently have, execute the following command in your terminal:

python --version

๐Ÿ Installing Python 3.11.3 with pyenv

Protip: Managing multiple Python versions is a breeze with pyenv. It allows you to seamlessly switch between different Python versions without the need to reinstall them.

If you haven't installed pyenv yet, follow their official guide to set it up.

Once you have pyenv ready, install the recommended Python version by running:

pyenv install 3.11.6

When you navigate to this project's directory in the future, pyenv will automatically select the recommended Python version, thanks to the .python-version file in the project root.

๐Ÿ“ฆ Setup

Local setup ๐Ÿ› ๏ธ with Docker ๐Ÿณ

  • Using docker-compose: You can also use docker-compose to run the project locally by running the following command:

    • Clone the repository: Get the project source code from GitHub:
    git clone https://github.com/FOSS-Community/LinkLiberate.git
    • Navigate to the Project Directory:
    cd LinkLiberate
    • Run the project using docker-compose:
    docker-compose up

Local setup ๐Ÿ› ๏ธ without Docker ๐Ÿณ

Setting Up the Project with PDM

PDM (Python Development Master) is utilized for dependency management in this project. To set up and run the project:

  • Installing PDM: Before you begin, ensure you have PDM installed. If not, refer to the official documentation to install PDM.

  • Clone the Repository: Get the project source code from GitHub:

    git clone https://github.com/FOSS-Community/LinkLiberate.git
  • Navigate to the Project Directory:

    cd LinkLiberate
  • Install Dependencies: Use PDM to install the project's dependencies:

    pdm install
  • Start the Project: Use PDM to run the project:
    pdm run start

Setting Up and Testing the Project

To ensure the code quality and functionality of the project, follow the steps below:

Installing Git Hooks with pre-commit

Before making any commits, it's essential to ensure that your code meets the quality standards. This project utilizes pre-commit hooks to automatically check your changes before any commit.

Install the pre-commit hooks with the following command:

pre-commit install

Running Tests

To ensure the project's functionality, you should run all the provided tests. Execute the following command to run the tests:

pdm run test

These endpoints typically return the health status or readiness of the server, helping in diagnostics and monitoring.

๐Ÿ—’๏ธ How to contribute

โ—๏ธImportant: Please read the Code of Conduct and go through Contributing Guideline before contributing to paste.py

  • Feel free to open an issue for any clarifications or suggestions.