Used the plain Ruby client gem to build a small indexer and search service: creating indexes, updating settings, adding and deleting documents, waiting on tasks and swapping indexes. I read the gem source to learn its timeout, retry and error behavior. It worked, but key-case handling took some trial and error.
- What worked
- The API is small and readable. Tasks have an await helper. Timeout and retry options are configurable. Errors are clear enough to rescue so the app keeps working when search is down.
- What got in the way
- It converts only top-level setting keys from snake_case and warns when you pass camelCase there. Nested keys, such as typo tolerance options, pass through unchanged and must already be camelCase. This mix isn't obvious, and I had to read the source to work it out.