https://github.com/kevinmichaelchen/api-search

🔎 gRPC layer over the Meilisearch search engine
https://github.com/kevinmichaelchen/api-search

meilisearch

Last synced: 5 days ago
JSON representation

🔎 gRPC layer over the Meilisearch search engine

• Host: GitHub
• URL: https://github.com/kevinmichaelchen/api-search
• Owner: kevinmichaelchen
• Created: 2022-05-06T01:37:57.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-05-07T19:10:50.000Z (over 2 years ago)
• Last Synced: 2025-01-10T20:00:58.522Z (8 days ago)
• Topics: meilisearch
• Language: Go
• Homepage:
• Size: 66.4 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# api-search

[![Lines Of Code](https://tokei.rs/b1/github/kevinmichaelchen/api-search?category=code)](https://github.com/kevinmichaelchen/api-search)

A proof-of-concept search service, powered by

[**Meilisearch**](https://www.meilisearch.com/) and

[**meilisearch-go**](https://github.com/meilisearch/meilisearch-go).

## Project structure

| Directory                                    | Description                               |

|----------------------------------------------|-------------------------------------------|

| [`./cmd`](./cmd)                             | CLI for making gRPC requests              |

| [`./idl`](./idl)                             | Protobufs (Interface Definition Language) |

| [`./internal/app`](./internal/app)           | App dependency injection / initialization |

| [`./internal/idl`](./internal/idl)           | Auto-generated protobufs                  |

| [`./internal/service`](./internal/service)   | Service layer / Business logic            |

## Getting started

```bash

docker-compose up -d

go run main.go

```

## Usage

Check out the [full API](./idl/coop/drivers/search/v1beta1/api.proto).

### Generating fake documents

Generate a fake CSV file of drivers with

```bash

go run cmd/search/*.go generate --size 1000

```

You can view its contents with:

```bash

xsv sort --select last_name,first_name fake-drivers.csv | xsv table | bat --file-name fake-drivers.csv

```

### Ingestion

Index the CSV records into Meilisearch with:

```bash

go run cmd/search/*.go ingest drivers --file fake-drivers.csv

```

### Querying

Perform a search query with:

```bash

go run cmd/search/*.go query --query Nichole

```

Response would look like:

```json

{

  "hits": [

    {

      "driver": {

        "id": "c9q7k6vrirfhbdec6e00",

        "firstName": "Nichole",

        "lastName": "Bailey",

        "email": "[email protected]",

        "phone": "108-674-1932"

      }

    }

  ]

}

```