https://github.com/wf001/learn-lacinia

A sample implementation of a GraphQL API powered by Clojure.
https://github.com/wf001/learn-lacinia

apollo clojure lacinia sakila-db

Last synced: 21 days ago
JSON representation

A sample implementation of a GraphQL API powered by Clojure.

• Host: GitHub
• URL: https://github.com/wf001/learn-lacinia
• Owner: wf001
• License: mit
• Created: 2024-09-16T10:50:21.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-10-18T09:54:53.000Z (2 months ago)
• Last Synced: 2024-11-30T22:41:44.584Z (22 days ago)
• Topics: apollo, clojure, lacinia, sakila-db
• Language: Clojure
• Homepage: https://esa-pages.io/p/sharing/21463/posts/111/e113dfd2123683adf27d.html
• Size: 3.23 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Learn Lacinia

Contains a sample implementation of a GraphQL API and REST API powered by Clojure. The API allows to get sample data and demonstrates basic GraphQL functionality. 

`FYI`: this repository is fork of [toyokumo/build-api-with-clojure](https://github.com/toyokumo/build-api-with-clojure/tree/4fe72afb467612b5a46d17d3081769069e2415cb). The foundamentals like the usage of some middlewares are explained on [their tech blog](https://tech.toyokumo.co.jp/entry/list-of-clojure-articles).

## What’s Powering the API

- `Lacinia`: A GraphQL server library used to provide GraphQL API by Clojure.

- `Ring`: A Clojure web applications library.

- `Apollo`: A GraphQL server library used to provide GraphQL API by TypeScript.

- `MySQL`: A relational database to store customer and related data.

- `Prisma`: A Node.js ORM used to interact with the database in a more structured way.

- `Sakila sample database`: A standard schema that can be used for examples in books, tutorials, articles, samples, and so forth, developed by Mike Hillyer, a former member of the MySQL AB documentation team. See also [the document](https://dev.mysql.com/doc/sakila/en/). All data depends on Sakila sample database.

## How it works

You can use the following query to retrieve a paginated list of customers for example:

```graphql

query Customers {

    paginatedCustomers(offset: 0, limit: 10) {

        totalCount

        customers {

            customer_id

            store_id

            first_name

            last_name

            email

            address_id

            active

        }

    }

}

```

This will return a paginated list of customers with a total count and basic customer details such as customer_id, first_name, and last_name.

## For more information

For more detailed information such as the way of setting up or running query, please refer to [the full document](https://esa-pages.io/p/sharing/21463/posts/111/e113dfd2123683adf27d.html).

## License

This project is licensed under the MIT License. See [the LICENSE file](https://github.com/wf001/learn-lacinia/blob/main/LICENSE) for more details.