Skip to content

Natural language parser for recipe ingredients that can also combine ingredients

Notifications You must be signed in to change notification settings

benjackwhite/recipe-ingredient-parser

 
 

Repository files navigation

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

About

Natural language parser for recipe ingredients that can also combine ingredients

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 99.6%
  • JavaScript 0.4%