Is-Vegan
Helps you to find out which food ingredients are vegan / non-vegan.
https://github.com/hmontazeri/is-vegan
Category: Consumption
Sub Category: Agriculture and Nutrition
Keywords
food ingredients npm vegan
Last synced: about 6 hours ago
JSON representation
Repository metadata
Is-Vegan helps you to find out which food ingredients are vegan / non-vegan
- Host: GitHub
- URL: https://github.com/hmontazeri/is-vegan
- Owner: hmontazeri
- License: mit
- Created: 2018-02-04T02:43:38.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-10-04T20:39:13.000Z (over 1 year ago)
- Last Synced: 2025-03-15T16:04:36.642Z (about 2 months ago)
- Topics: food, ingredients, npm, vegan
- Language: JavaScript
- Homepage:
- Size: 640 KB
- Stars: 483
- Watchers: 12
- Forks: 34
- Open Issues: 26
- Releases: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
README.md
is-vegan
Is-Vegan helps you to find out which food ingredients are vegan / non-vegan. It can answer that on 1 ingredient or on a list of ingredients. It uses a 850+ entries list of non-vegan ingredients.
Why?
We are aware that 'veganism' and the definition of it can be a hot topic. We created the non-vegan list keeping in mind that veganism in dietary terms, it denotes the practice of dispensing with all products derived wholly or partly from animals.
Our first step is the approach to help people understand, which products, and where applicable its ingredients, do not involve, or have involved, the use of any animal product, by-product or derivative. It is not driven about any vegan lifestyle choice or stereotype.
We welcome and appreciate any help and concerence regarding the nonvegan/canbevegan list.
Currently we are unfortunatly not adressing any other forms of exploitation of, and cruelty to, animals for clothing, cosmetics or any other purpose.
Thank you all for your comments, we appreciate the discussion, as we grow and learn from your input.
Sources
We want to make sure that you understand how is-vegan is implemented. We analyzed as many good information websites for vegan / non-vegan ingredients as we found to get a very accurate list of ingredients. However, feel free to send a pull request with an updated version of the list.
Websites we parsed:
and we added also a few ourselves...
Usage
Add
yarn add is-vegan
or
npm install is-vegan --save
example
const isVegan = require('is-vegan');
// or
import * as isVegan from 'is-vegan';
// example for single ingredient
isVegan.isVeganIngredient('soy'); // true
isVegan.isVeganIngredient('milk'); // false
// example for list of ingredients
isVegan.isVeganIngredientList(['aspic', 'albumin']); // false
isVegan.isVeganIngredientList(['soy', 'cacao butter']); // true
// example for list of ingredients
isVegan.containsNonVeganIngredients(['aspic', 'albumin', 'soy']); // ['aspic', 'albumin']
isVegan.containsNonVeganIngredients(['soy', 'cacao butter']); // []
// example for list of ingredients wich contain flagged and non-vegan ingredients
isVegan.checkIngredients(['soy', 'cacao butter', 'pork', 'beef', 'glycine']);
// returns
// {
// nonvegan: ['pork', 'beef'],
// flagged: ['glycine']
// }
// example for list of ingredients in Italian language
isVegan.setIngredientsLanguage('it'); // 'it' is the two-letter ISO 639-1 code for the Italian language
isVegan.checkIngredients([
'manzo',
'maiale',
'glicina',
'biotina',
'soia',
'aglio',
]);
// returns
// {
// nonvegan: ['manzo', 'maiale'],
// flagged: ['glicina', 'biotina']
// }
// or
import { checkIngredients } from 'is-vegan';
// example for list of ingredients wich contain flagged and non-vegan ingredients
checkIngredients(['soy', 'cacao butter', 'pork', 'beef', 'glycine']);
// returns
// {
// nonvegan: ['pork', 'beef'],
// flagged: ['glycine']
// }
real world example
Products searched on USDA Food Composition Databases
const isVegan = require('is-vegan');
// MOSER ROTH, DARK CHOCOLATE
isVegan.isVeganIngredientList([
'COCOA LIQUOR',
'SUGAR',
'COCOA BUTTER',
'ALKALIZED REDUCED FAT COCOA POWDER',
'SOY LECITHIN EMULSIFIER',
'GROUND VANILLA',
]); // returns true
Checkout: RunKit "is-vegan-playground" for more examples
Free API
Test
yarn test
Thanks for translating the lists to italian
Alfred Workflow by Kyle Brumm (kjbrum)
TODO
- extend list
Authors
- Hamed Montazeri
- Meike Rittmeier
Owner metadata
- Name: Hamed Montazeri
- Login: hmontazeri
- Email:
- Kind: user
- Description: Born in 🇮🇷 raised in 🇩🇪
- Website: https://hmontazeri.me
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/1557035?v=4
- Repositories: 20
- Last ynced at: 2025-04-22T08:46:53.077Z
- Profile URL: https://github.com/hmontazeri
GitHub Events
Total
- Watch event: 5
- Delete event: 23
- Issue comment event: 11
- Push event: 19
- Pull request event: 34
- Create event: 13
Last Year
- Watch event: 5
- Delete event: 23
- Issue comment event: 11
- Push event: 19
- Pull request event: 34
- Create event: 13
Committers metadata
Last synced: 9 days ago
Total Commits: 152
Total Committers: 12
Avg Commits per committer: 12.667
Development Distribution Score (DDS): 0.454
Commits in past year: 0
Committers in past year: 0
Avg Commits per committer in past year: 0.0
Development Distribution Score (DDS) in past year: 0.0
Name | Commits | |
---|---|---|
Hamed Montazeri | h****i@m****m | 83 |
Hamed Montazeri | h****i | 35 |
gianantoniopini | 6****i | 14 |
mikamkr | 3****r | 5 |
Hamed Montazeri | m****a@H****l | 4 |
Charles Koehl | c****s@e****m | 3 |
Abigail | a****l@a****e | 2 |
Victor Glindås | g****s@g****m | 2 |
Sutrisno Suryajaya | s****p@g****m | 1 |
bjarkt | b****t@o****g | 1 |
Hani | 5****y | 1 |
dependabot[bot] | d****] | 1 |
Committer domains:
- openmailbox.org: 1
- abigail.be: 1
- etherscapes.com: 1
- mhp.com: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 18
Total pull requests: 44
Average time to close issues: 4 months
Average time to close pull requests: 3 months
Total issue authors: 14
Total pull request authors: 14
Average comments per issue: 2.5
Average comments per pull request: 1.48
Merged pull request: 13
Bot issues: 0
Bot pull requests: 27
Past year issues: 0
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 0
Past year pull request authors: 0
Past year average comments per issue: 0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- leemi (2)
- fluxsauce (2)
- kjbrum (2)
- teolemon (2)
- hjek (1)
- underyx (1)
- TobiToxota (1)
- petitpingouinfluffy (1)
- bladespinner (1)
- jonathanronen (1)
- endevagames (1)
- lucasrodes (1)
- msuntharesan (1)
- k4pran (1)
Top Pull Request Authors
- dependabot[bot] (27)
- hmontazeri (3)
- Glinkis (2)
- gianantoniopini (2)
- bjarkt (1)
- mikamkr (1)
- sutris (1)
- Abigail (1)
- JustinHoldstock (1)
- charleskoehl (1)
- hanimay (1)
- yochum (1)
- jarrett-m (1)
- annalisetarhan (1)
Top Issue Labels
- help wanted (9)
- enhancement (7)
- question (1)
Top Pull Request Labels
- dependencies (27)
Package metadata
- Total packages: 1
-
Total downloads:
- npm: 68 last-month
- Total dependent packages: 3
- Total dependent repositories: 5
- Total versions: 30
- Total maintainers: 1
npmjs.org: is-vegan
Is-Vegan is a library which helps you to find out which ingridiends are not vegan
- Homepage: https://github.com/hmontazeri/is-vegan
- Licenses: MIT
- Latest release: 1.2.0 (published almost 5 years ago)
- Last Synced: 2025-04-29T14:07:17.301Z (1 day ago)
- Versions: 30
- Dependent Packages: 3
- Dependent Repositories: 5
- Downloads: 68 Last month
-
Rankings:
- Stargazers count: 3.184%
- Forks count: 4.262%
- Dependent repos count: 5.227%
- Dependent packages count: 5.757%
- Average: 6.944%
- Downloads: 16.291%
- Maintainers (1)
Dependencies
- babel-cli 6.26.0 development
- babel-core 6.26.0 development
- babel-eslint 8.2.1 development
- babel-jest 22.1.0 development
- babel-loader 7.1.2 development
- babel-polyfill 6.26.0 development
- babel-preset-env 1.6.1 development
- babel-preset-es2015 6.24.1 development
- babel-preset-latest 6.24.1 development
- babel-preset-stage-2 6.24.1 development
- eslint 4.15.0 development
- eslint-config-standard 11.0.0-beta.0 development
- eslint-loader 1.9.0 development
- eslint-plugin-import 2.8.0 development
- eslint-plugin-node 5.2.1 development
- eslint-plugin-promise 3.6.0 development
- eslint-plugin-standard 3.0.1 development
- jest 22.1.4 development
- nodemon 1.14.11 development
- uglifyjs-webpack-plugin 1.1.8 development
- webpack 3.10.0 development
- webpack-node-externals 1.6.0 development
- 854 dependencies
Score: 13.061160088192207