8000 GitHub - EANimesha/REST-fetch: A REST API service for development and testing
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

EANimesha/REST-fetch

 
 

Repository files navigation

About Us

GitHub contributors Issues PRs Forks Stars Join the chat at https://gitter.im/fetch-lobby/community

A community-owned REST API service for testers and developers. Fetch provides REST API endpoints for different types of placeholders, which can be easily used during testing and development without the need for creating sample data manually.

Technology Stack

  • MongoDB
  • Express
  • NodeJS
  • Typescript
  • CI/CD

Try it out

Installation

Before you setup project, make sure you have pre-commit installed on your machine. Skip the following if you have already installed.

There are 3 ways to install pre-commit package manager

  • Using pip:

$ pip install pre-commit

  • Using homebrew:

$ brew install pre-commit

  • Using conda (via conda-forge):

$ conda install -c conda-forge pre-commit

After completing the above steps, verify your installation by running

$ pre-commit --version

Project Installation

There are two ways of installing the project on your local Machine 🚀

  • Using Docker

    • Fork and clone the project
    • Install and configure your Docker, following this.
    • Rename .env.example to .env.
    • Install the git hook scripts
      • pre-commit install on terminal
    • Once docker is installed run the followig commands.
      • docker-compose build
      • Once the build is complete, run docker-compose up
  • Conventional Setup

    • Fork and clone the project
    • cd fetch/ and run npm install to install dependencies
    • Setup mongodb atlas following this tutorial
    • Enter the credentials in .env.example and rename it to .env.
    • Make sure to set USE_DOCKER= false in .env file.
    • Install the git hook scripts
      • pre-commit install on terminal
    • Run npm run dev to run the project in development

Testing

  • The endpoint usertest which follows the same schema as the users/ endpoint, must be used for testing
  • All other endpoints except usertest should involve methods which must not change the data on the server (read-only)
  • To test the endpoints provided by the application, tools such as postman can be used

Documentation

To understand the aim, scope and technologies used in the project, please see the documentation

Help & support

If you are stuck somewhere or do not understand what to do, feel free to reach out to mentors/ admin in discord.

Contribution

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please refer the contribution guideline before making any contribution.

Contributors

License

This project is licensed under the GPL V3 License - see the LICENSE.md file for details

About

A REST API service for development and testing

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 66.1%
  • EJS 16.0%
  • CSS 12.0%
  • Shell 3.4%
  • JavaScript 2.1%
  • Dockerfile 0.4%
0