HTTP Client

Attach a postman-like http client to your vals, with bookmarks and history support

Usage

Wrap your http handler in an the httpClient middleware.

Create valimport {httpClient} from "https://esm.town/v/pomdtr/http_client"

export default httpClient((req) => {
   return new Response("Hello World!")
})

The http client will be shown on the root.

Adding bookmarks

You might want to bookmark some requests you need often. You can do it by passing a bookmark list as a middleware option:

Create valimport {httpClient} from "https://esm.town/v/pomdtr/http_client"

export default httpClient((req) => {
   return new Response("Hello World!")
}, {
  bookmarks: [
    {
      "label": "Dummy Request",
      "request": new Request("https://dummyjson.com/products")
    }
]})

Customizing the client path

Create valimport {httpClient} from "https://esm.town/v/pomdtr/http_client"

export default httpClient((req) => {
   return new Response("Hello World!")
}, {
  path: "/http-client"
})

TODO

• fix syntax highlighting on successive request
• allow to prefill the initial request

Val Town CDN

If you only want to get the source of a val, you should use https://esm.town/ instead.

Usage

curl https://pomdtr-cdn.web.val.run/<author>/<name>.<extension>[?v=<version>]

To see the code of this val, use https://pomdtr-cdn.web.val.run/pomdtr/cdn.ts

Examples

Fetching the val code

$  curl https://pomdtr-cdn.web.val.run/pomdtr/add.tsx

You can also use js, jsx and ts extension (only the content-type change, there is no transpilation).

Fetching private val

Pass an api token as an username

$ curl "https://<token>@pomdtr-cdn.web.val.run/pomdtr/privateVal.ts"

Fetching the val README

$ curl https://pomdtr-cdn.web.val.run/pomdtr/add.md

Getting an image

$ curl https://pomdtr-cdn.web.val.run/pomdtr/add.png

Fetching a specific version of a val

$ curl https://pomdtr-cdn.web.val.run/pomdtr/cdn.ts?v=66

You need to be authenticated to use this method.

Fetching the val metadata

$ curl https://pomdtr-cdn.web.val.run/pomdtr/add.json

Test Explorer

Click on the play button next to list items to run them.

Usage

1. Fork this val

2. Create new tests in any of vals (and export them) (see @pomdtr/example_test)

Create valimport { assertEquals } from "https://deno.land/std@0.216.0/assert/mod.ts";
import { Test } from "https://esm.town/v/<account>/test_explorer";

export const exampleTestSuccess = new Test(() => {
  assertEquals(1 + 1, 2);
});

export const exampleTestFailure = new Test(() => {
  assertEquals(1 + 1, 3);
});

3. Go to https://<account>-test_explorer.web.val.run to run your test
   • click on the val name to go to the val the tests are originating from
   • click on the test name to run it

ℹ️ You probably want to protect your test explorer behind an authentication middleware like @pomdtr/basicAuth

Discovery mechanism

In order to define a test, the user need to import the Test class from https://val.town/v/<account>/Test. So we can use the api to search for vals containing the https://val.town/v/<account>/Test string to locate the vals containing tests.

Next, we need to extract the tests from the val exports. We use exported instanceof Test to filter them (at some point we will probably use static analysis for this).

TODO

• persist test results in sqlite
• Improve styling (help welcome ❤️)
• View logs in a modal
• Batch http requests