recipe-ingredient-parser-v3

Natural language parser for recipes and lists of ingredients. Can parse a string into an object and also combine an array of these ingredient objects.

About

This project was built on top of code written by nsafai.

What's different from the original?

• No longer uses the "natural" library
• Works with Node.js, browser, React Native
• Added support for the Italian and German languages.
• Added support for numbers written in words (for example six cups milk)
• Added support for preposition before name of ingredient (for example six cups of milk or sei tazze di latte)

To install

npm install recipe-ingredient-parser-v3 or yarn add recipe-ingredient-parser-v3

To use

import { parse } from 'recipe-ingredient-parser-v3';

And then use on a string, for example: parse('1 teaspoon basil', 'eng'); or parse('1 grammo di zucchero', 'ita');

Will return an object:

{
  quantity: 1,
  unit: 'teaspoon',
  ingredient: 'basil',
  minQty: 1,
  maxQty: 1
};

Combine ingredient objects

combine([{
  quantity: 1,
  unit: 'teaspoon',
  ingredient: 'basil',
  minQty: 1,
  maxQty: 2,
},
{
  quantity: 2,
  unit: 'teaspoon',
  ingredient: 'basil',
  minQty: 2,
  maxQty: 2
}]);

Will return

[{
  quantity: 3,
  unit: 'teaspoon',
  ingredient: 'basil',
  minQty: 3,
  maxQty: 4
}]

Languages supported

Languages currently supported:

• English eng
• German deu
• Italian ita

Unicode Fractions

Will also correctly parse unicode fractions into the proper amount

Development

Clone the repo and yarn to install packages. If yarn test comes back good after your code changes, give yourself a pat on the back.

Publishing

Checkout https://docs.npmjs.com/getting-started/publishing-npm-packages for more info