README.MD

Restify

Restify is an application built for the EVO Framework that allows you to generate RESTful APIs on the fly without the need to write any code. These APIs can be used for various purposes, including data management, data entry processes, dashboards, or communication with third-party applications.

Features

• No Code Required: Automatically generate RESTful APIs without writing a single line of code.
• Data Management: Use the generated APIs for managing data in your applications.
• Data Entry: Facilitate data entry processes through RESTful endpoints.
• Dashboard Integration: Seamlessly integrate with dashboards for real-time data management.
• Third-Party Communication: Use the APIs to interact with external services or applications.

---

Table of contents

• Getting Started
• Endpoints
  • Endpoints
  • Query Parameters Explanation
  • Loading Associations
  • Offset and Limit
  • Select Specific Fields
  • Postman Collection Generator
  • Example Postman Collection
• Customization
  • Model Hooks
  • Global Hooks
  • Validation
  • Features
  • Base Path
  • Soft Delete
• Permissions
  • Default Permission Handler
  • Model Rest Permission Handler
  • Using permissions.Has
• Context
  • Forced Conditions
  • Override
  • Error Handling
• Example

---

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• EVO Framework: Installation Guide
• Golang (version 1.22 or higher)

Usage

1. Import Restify into your EVO application:

   import (
       "github.com/getevo/evo/v2"
       "github.com/getevo/restify"
   )
   
   func main() {
       evo.Setup()
       evo.Register(restify.App{})
       evo.Run()
   }

2. Add Restify support to your model:

   type User struct {
       UserID   int    `gorm:"primaryKey;autoIncrement"`
       UserName string `gorm:"column:username;index;size:255"`
       Name     string `gorm:"column:name;size:255"`
       restify.API     // this signature enables Restify
   }

3. Register your model with Restify:

   func (App) Register() {
       db.UseModel(User{})
   }