API mocking for "JavaScript"

[avelino]

Using the same Clojure code base, support moclojer as a library, making it possible to import moclojer into JavaScript (transposed from ClojureScript).

Mock Service Worker is an API mocking library that allows you to write client-agnostic mocks and reuse them across any frameworks, tools, and environments.

⚠️ Node's experimental native fetch implementation, designed for the future

References:

• https://mswjs.io/
• https://github.com/nock/nock

Clojure syntax

(comment
  (let [service-fn (service-start!
                    [{:endpoint {:method "GET"
                                 :path "/hello/:username"
                                 :response {:status 200
                                            :headers {:Content-Type "application/json"}
                                            :body {:hello "{{path-params.username}}!"}}}}])]
    (-> service-fn
        (response-for :get "/hello/world")
        :body)))

• service-start!: imported moclojer server, receives an array of endpoints as a parameter
• endpoints: "object" that generates the form declared above, can be read from a configuration file (let's expose our yaml, edn and openapi file reading functions) or array (written directly)

distribution of the clojure package will be done by clojars #180, simplifying its use

JavaScript syntax

const moclojer = require('moclojer')
const endpoints = [{"endpoint": {"method": "GET",
                                 "path": "/hello/:username",
                                 "response": {"status": 200,
                                              "headers": {"Content-Type": "application/json"}
                                              "body": {"hello": "{{path-params.username}}!"}}}}]
moclojer.service-start!(endpoints)

[matheusfrancisco]

great I like it, just can´t forget the moclojer.stop() there is something I like when I used nock was callback fuctions, that I can get the request and the body inside the test I had mock the http

this is the way I use nock in nodejs

    nock("http://localhost:4444/").get("/123/oauth2/v2.0/token").reply(200,
        (uri, reqBody: any, cb) => {
          expect("grant_type=client_credentials&client_id=12345&client_secret=mock&scope=123").toEqual(reqBody);
          cb(null, {"access_token": "mock-token"});
        });

then cb is a callback I will return after the expect it will return {"access_token":...}

wdyt?

[avelino]

sharing what's on my local machine and I'm not working on it anymore (for now), it didn't make sense to be in a branch so I'm putting it here

framework:

(ns moclojer.framework
  (:require [io.pedestal.http :as http]
            [io.pedestal.test :refer [response-for]]
            [moclojer.router :as router]))

(defn service-start!
  "starts the service"
  [endpoints]
  (-> {::http/routes (router/smart-router {::router/config endpoints})}
      http/default-interceptors
      http/dev-interceptors
      http/create-servlet
      ::http/service-fn))
(comment
  (let [service-fn (service-start!
                    [{:endpoint {:method "GET"
                                 :path "/hello/:username"
                                 :response {:status 200
                                            :headers {:Content-Type "application/json"}
                                            :body {:hello "{{path-params.username}}!"}}}}])]
    (-> service-fn
        (response-for :get "/hello/world")
        :body)))

test:

(ns moclojer.specs.moclojer-test
  (:require [clojure.test :refer [deftest is]]
            [moclojer.specs.moclojer :as moclojer]))

(def external-body
  {:path "test/moclojer/resources/external-body-{{ path-params.name }}.yml"
   :provider "json"})
(def request
  {:path-params {:name "json"}})

(deftest render-template-test
  (let [template "Hello, {{ path-params.name }}!"]
    (is (= (moclojer/render-template template request)
           "Hello, json!"))))

(deftest enrich-external-body-test
  (is (= (moclojer/enrich-external-body external-body request)
         {:path "test/moclojer/resources/external-body-json.yml"
          :provider "json"})))

(deftest build-body-test
  (let [response {:external-body external-body}]
    (is (= (moclojer/build-body response request)
           (slurp "test/moclojer/resources/external-body-json.yml")))))

[avelino]

here PR #189

[avelino]

First Clojure version released v0.3.0, documentation here.

Now we need to support ClojureScript, can @matheusfrancisco work on the implementation?

[matheusfrancisco]

I will work on this.