Skip to content

Natural language parser for recipe ingredients that can also combine ingredients

Notifications You must be signed in to change notification settings

suprmat95/recipe-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?

  • added support for the Italian language.
  • 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
  • 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.

Natural Language Parsing

This project uses Natural, for more information, see https://dzone.com/articles/using-natural-nlp-module

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.7%
  • JavaScript 0.3%