0.0.3 • Published 4 months ago

evidence-connector-js v0.0.3

Weekly downloads
-
License
MIT
Repository
-
Last release
4 months ago

Evidence JS Source Plugin

This is a JavaScript source plugin for Evidence. It allows you to run arbitrary JavaScript code as a data source. It's meant to be a quick way to get data into Evidence without having to create a new connector.

  1. Install this plugin in an Evidence app with
    npm install evidence-connector-js
  2. Register the plugin in your project in your evidence.plugins.yaml file with
    datasources:
      evidence-connector-js: {}
  3. Launch the development server with npm run dev and navigate to the settings menu (localhost:3000/settings) to add a data source using this plugin.
  4. Create a new source in the sources directory with a .js file like pokedex.js. The JS file should export a data object.

    let url = 'https://pokeapi.co/api/v2/pokemon/'
    
    const response = await fetch(url)
    const json = await response.json()
    const data = json.results
    
    export { data }
  5. You can then reference your data in markdown queries.

    ```sql pokedex
    select * from pokedex
    ```

Credentials

You can pass credentials via environment variables to your JS file. They must be prefixed with EVIDENCE_.

let key = process.env.EVIDENCE_API_KEY
let url = 'https://whatever.com/api'

const response = await fetch(url, {
    headers: {
        'x-api-key': key
    }
})

const json = await response.json()
const data = json.results

export { data }
0.0.3

4 months ago

0.0.2

5 months ago

0.0.1

5 months ago