hugojosefson / openmeal-api

API module for skolmaten.se via Open Meal Information API

API for Open Meal Information

Introduction

This is an unofficial API module for accessing Swedish school lunch menus from skolmaten.se via Open Meal Information as specified at https://orebrokommun.github.io/Open-Meal-Information/.

Prerequisite

Node.js, at least v10.13.0.

Recommended to install latest via nvm:

nvm install stable

Installation in a project

yarn add @hugojosefson/openmeal-api
 # or
npm install --save @hugojosefson/openmeal-api

Programmatic access

It is recommended to import or require the module, and use its exported functions programmatically.

API

Table of Contents

• getDataProviders
  • Parameters
• getDataProviderSkolmaten
  • Parameters
• getDistributors
  • Parameters
• filterDistributors
  • Parameters
• getMeals
  • Parameters
• extractOnlyMeals
  • Parameters

getDataProviders

Returns data providers.

Parameters

• dataprovidersJsonUrl string url for the data providers json. Defaults to https://raw.githubusercontent.com/Orebrokommun/Open-Meal-Information/master/dataproviders.json as per https://orebrokommun.github.io/Open-Meal-Information/doc/list-data-providers.html

Returns Promise A Promise of the data property of the response from the server.

getDataProviderSkolmaten

Returns the data provider with name === 'Skolmaten'.

Parameters

• dataprovidersJsonUrl string url for the data providers json. Defaults to https://raw.githubusercontent.com/Orebrokommun/Open-Meal-Information/master/dataproviders.json as per https://orebrokommun.github.io/Open-Meal-Information/doc/list-data-providers.html

Returns Promise A Promise of the data property of the response from the server.

getDistributors

Returns distributors from a data provider.

Parameters

• dataprovider object data provider object to fetch distributors from.
  • dataprovider.baseUrl string baseUrl of the data provider.

Returns Promise A Promise of the data property of the response from the server.

filterDistributors

Filters distributors based on partial name and/or partial address.

Parameters

• options object
  • options.distributors Array current distributors to filter, for example from getDistributors or the result of previous call to this function.
  • options.name (string | undefined) if specified, only include distributors in result which contain this string in their name, case insensitively.
  • options.address (string | undefined) if specified, only include distributors in result which contain this string in their addressRegion or addressLocality, case insensitively.

Returns Promise<Array> A Promise of an array of distributors matching the criteria.

getMeals

Fetches meals for a distributor.

Parameters

• options object
  • options.dataprovider object data provider object to fetch distributors from.
    • options.dataprovider.baseUrl string baseUrl of the data provider.
  • options.distributor object distributor whose meals to fetch.
    • options.distributor.distributorID string the distributor's ID.
  • options.startDate (string | undefined) start date on the form YYYY-MM-DD.
  • options.endDate (string | undefined) end date on the form YYYY-MM-DD.

Returns Promise A Promise of the data property of the response from the server.

extractOnlyMeals

Extracts an array of only meals objects from a response from getMeals().

Parameters

• response object response from calling getMeals().

Returns Promise<Array> A Promise of an array containing all meal objects from the supplied response.

Usage on CLI

You can also try it from the command-line.

./node_modules/.bin/openmeal-api

Prints usage information for the CLI.

openmeal-api's Issues

try it from chatbot

Implement getDataproviders()

https://orebrokommun.github.io/Open-Meal-Information/doc/list-data-providers.html

Create repo and skeleton lib

extract hard-coded cli options to constant

src/cli.mjs

Implement getDistributors()

https://orebrokommun.github.io/Open-Meal-Information/doc/list-distributors.html

publish on npm

cache responses from api

• Are there relevant HTTP cache headers available?
  • Nope. It's just Cache-Control: no-cache.
• ...any good ones?
  • Eh, no.
• What's the best approach?
  • Looks like request-promise-cache.

Implement filterDistributors({{distributors, name, address}})

Implement getMeals({distributor, startDate, endDate})

https://orebrokommun.github.io/Open-Meal-Information/doc/get-meals.html