Swiftpack.co - Package - vapor-community/pagination

Swift Vapor CircleCI

Vapor Pagination

Pagination is based off of the Fluent 2 pagination system.

Getting Started

Add this to your Package.swift file

.package(url: "https://github.com/vapor-community/pagination.git", from: "1.0.0")

Conform your model to Paginatable

extension MyModel: Paginatable { }

Once you have done that, it's as simple as returning your query in paginated format.

func test(_ req: Request) throws -> Future<Paginated<MyModel>> {
    return try MyModel.query(on: req).paginate(for: req)
}

Even return items off of the query builder

func test(_ req: Request) throws -> Future<Paginated<MyModel>> {
    return try MyModel.query(on: req).filter(\MyModel.name == "Test").paginate(for: req)
}

Making a request with the parameters is easy is appending ?page= and/or ?per=

curl "http://localhost:8080/api/v1/models?page=1&per=10"

A response looks like this

{
  "data": [{
    "updatedAt": "2018-03-07T00:00:00Z",
    "createdAt": "2018-03-07T00:00:00Z",
    "name": "My Test Model"
  }],
  "page": {
    "position": {
      "current": 1,
      "max": 1
    },
    "data": {
      "per": 10,
      "total": 2
    }
  }
}

Github

link
Stars: 60
Help us keep the lights on

Releases

2.0.0-alpha.1 - Feb 25, 2019

⚠️ This is a major release and currently this version does not have breaking changes. Do note that v2.0.0 will be integrated into the Fluent 4 release and these releases are only here for people to take advantage of the new Advanced Queries for the time being.

1.0.9 - Nov 16, 2018

Fixes a crash when setting the amount to 0

1.0.8 - Oct 10, 2018

1.0.7 - Sep 3, 2018

1.0.6 - Jun 26, 2018

Models no longer need to conform to Content