Wreq или Servant для клиента http API?

Question

Я работал в двух разных проектах, чтобы реализовать привязку клиента к инструменту Pivotal Tracker. One project использует wreq library, а the other полагается на servant.

Я хочу объединить оба проекта, но я не уверен, какой подход к дизайну использовать. Таким образом, вопросы, которые помогли бы мне разобраться в этом являются:

1. Есть ли какие-либо конкретные преимущества определения моего API как тип (помимо удобочитаемости)?

2. Какая обработка ошибок будет генерировать меньше кода для пользователей библиотеки, EitherT ServantError IO() службы или стиля исключения wreq?

Answer 1

Оба используют http-client под капотом.

В Haskell, наиболее потребляющей частью написания привязок web-api, являются определения данных и спецификация сериализации JSON. В реализации wreq используются линзы, wreq - это объектная HTTP-библиотека.

После этого, вы хотели бы, чтобы предоставить некоторые функции (с помощью IO) для извлечения данных из правильных конечных точек:

getStory :: Options -> Int -> Int -> IO Story 
getStory options projectId storyId = 
    getOne options $ "/projects/" ++ show projectId ++ "/stories/" ++ show storyId 

или

type API = "services" :> "v5" :> "stories" 
      :> Header "X-TrackerToken" Text 
      :> Capture ":storyId" StoryId 
      :> Get '[JSON] Story 

story :: Text -> StoryId -> EitherT ServantErr IO Story 
story :<|> ... = client api ... 

Они не так различны. С wreq (или http-client напрямую) вы, вероятно, реализуете некоторую вспомогательную функцию (например, getOne), чтобы делать выборки; когда с servant вы получите его «бесплатно».