Recipe-scrapers

:poultry_leg: :rice: :shallow_pan_of_food: 15.0.0 :green_apple: :carrot: :tomato:

Welcome to version 15.0.0 of `recipe-scrapers`, a simple scraping tool for recipe webpages.

This version is a major version upgrade, and contains some breaking changes from the 14.x series.

In particular:

- The `scrape_me` function to the library has been removed from the 15.x series - please migrate to use the recommended `scrape_html` function instead.
- This includes removal of the generic `options` arguments that were previously passed to `requests`. Please configure the options for your HTTP client (`requests`, `httpx`, `urllib.request` or other) directly.
- If you need more time to migrate: don't worry, the 14.x series will continue to be maintained and updated until we're comfortable that the upgraded version is in regular use.

To get started and for usage examples, see the [`README` file](https://github.com/hhursev/recipe-scrapers/blob/20bad7e9d5afe1d5286373e407d43c14260a461f/README.rst).

Features
- Support for America's Test Kitchen, Cook's Country, and Cook's Illustrated have been added (1060) - thank you, smilerz!

Scrapers removed
Unfortunately the updated scraper interface is more restrictive, by-design, than 14.x - each scraper accepts an individual HTML page as input, and should not directly make additional HTTP requests. During adaptation to this interface, we dropped support for the following scrapers:

- coop.se
- gousto.co.uk
- kptncook.com
- madewithlau.com
- marleyspoon.com
- monsieur-cuisine.com
- woolworths.com.au

This makes scrapers simpler, and that means they're easier to review and support. But it is a trade-off against the coverage of recipe sites that we can achieve.

Dependencies removed

- `requests` is no longer a hard dependency of the library, but is available as an optional dependency.
- `responses` is no longer required to run unit tests for the library.

Edit: add missing (and important!) scrapers-removed section.
Edit: section-heading nesting consistency.

This is the third release candidate for the v15 major version of `recipe-scrapers`. There's no plan at the moment to discontinue the v14 / mainline branch, particularly due to the interface breaks here.

Breaking changes
* The `scrape_html` function no longer uses `requests` to download recipes by default. To opt-in to backwards-compatible behaviour, ensure that `requests` is installed (for example, by using `pip install recipe-scrapers[online]`) and pass the `online=True` argument to the function.
* The `scrape_me` function is no longer supported; please migrate to use the `scrape_html` function instead, and provide the HTML to scrape as an argument, or use the `online=True` feature of the function.

Deprecations
* The `wild_mode=True` argument is deprecated; please migrate to use the `supported_only=False` argument instead.

This is the second release candidate for the v15 major version of `recipe-scrapers`. There's no plan at the moment to discontinue the v14 / mainline branch, particularly due to the interface breaks here.

Breaking changes
* The `scrape_html` function no longer uses `requests` to download recipes by default. To opt-in to backwards-compatible behaviour, ensure that `requests` is installed (for example, by using `pip install recipe-scrapers[online]`) and pass the `online=True` argument to the function.
* The `scrape_me` function is no longer supported; please migrate to use the `scrape_html` function instead, and provide the HTML to scrape as an argument, or use the `online=True` feature of the function.

Deprecations
* The `wild_mode=True` argument is deprecated; please migrate to use the `supported_only=False` argument instead.

This is the first release candidate for the v15 major version of `recipe-scrapers`. There's no plan at the moment to discontinue the v14 / mainline branch, particularly due to the interface break here.

Breaking changes
The `scrape_me` method is no longer supported; instead, callers should retrieve the HTML they'd like to scrape, and provide the URL and HTML to the `scrape_html` method.

This is probably quite controversial! jayaddison (me) is responsible for this branch - please open feedback as issues in the bugtracker, and tag me on those.

The change removes a core dependency from this library, and removes any reliance on network connectivity from the library.

Adds support for:
- abeautifulmess.com (1258)
- aldi-nord (1352)
- aldi-sued (1353)
- barefootinthepines.com (1258)
- betterfoodguru.com (1258)
- beyondfrosting.com (1258)
- bitsofcarey.com (1258)
- brokenovenbaking.com (1258)
- cakemehometonight.com (1258)
- cambreabakes.com (1258)
- colleenchristensennutrition.com (1258)
- cookiesandcups.com (1258)
- cookomix.com (1393)
- cookwell.com (1271)
- hungryhappens.net (1278)
- kitchendivas.com (1386)
- krollskorner.com (1279)
- quitoque.fr (1163)
- rewe.de (1378)
- spainonafork.com (1268)
- thefoodietakesflight.com (1262)

Extends fields supported by:
- reciperunner (1376)
- recipetineats (1377)
- sallysblog (1375)
- saltpepperskillet (1334)
- simplycookit (1360)
- simplyquinoa (1333)
- skinnytaste (1332)
- spendwithpennies (1331)
- staysnatched (1330)
- sundpaabudget (1329)
- sunset (1328)
- sweetpeasandsaffron (1327)
- tastesoflizzyt (1326)
- tasty (1325)
- thehappyfoodie (1305)
- thekitchenmagpie (1296)
- thekitchn (1297)
- therecipecritic (1300)
- thevintagemixer (1301)
- thewoksoflife (1302)
- themodernproper (1298)
- thinlicious (1303)
- timesofindia (1287)
- tineno (1286)
- tudogostoso (1285)
- usapears (1284)
- vegrecipesofindia (1280)
- wellplated (1281)
- womensweekly (1282)
- zenbelly (1283)

Bugfixes:
- maangchi: ingredient header regex fixup (1311)
- mccormick: filter-out redundant step-number instructions (1355)
- modernproper, usapears: filter redundant nutrient names from value output (1304, 1294)
- thekitchn: fixup for site name output (1316)
- timesofindia: search for ingredients only within ingredient-data container (1290)
- usapears: fixups for `ratings`/`author` retrieval (1307)
- (library) utils: reject empty input to `get_yields` function (1314)
- (library) schema.org: don't return zero servings for empty-string `recipeYield` (1319)

Removals:
- sundpaabudget: removal nutritional information (1347)
- thexpertguides: remove scraper (1306)

Misc:
- python: declare Python3.13 support (1292)
- test data: add `LICENSE` notice (1348)
- ci: upgrade to Ubuntu 24.04 for most GitHub Actions workflows (1308)
- ci: upgrade MacOS version for unittest GitHub Actions workflow (1309)
- ci: enable `pip` caching in unittest, linters GitHub Actions workflows (1323)
- ci: restore `unittest-parallel` for unittest GitHub Actions workflow (1345)
- ci: suppress noisy static-value exception messaging during unittest GitHub Actions workflow (1335)
- ci: remove dependency on `tox` from GitHub Actions unittest and linters worklows (1339)
- tests: improve robustness of `DeprecationWarning` test cases (1343)
- project: update authorship and copyright details (346d473583dee06fd980c2bdb60bebfafdfec88c, 6a6a9144c2be5ce299ce3805ea9344e34afadaca, 1368)
- README: improve instructions for shell escaping (e0506615b71d49c301f4cf6252eb2d3142a3dbee)
- README: fixup for a reStructuredText syntax error (de6dc334934925b258b3e19d0b2a2f0b33f2812a)

Many thanks (again) Gamekohl hhursev jayaddison jknndy oahnh ReneNulschDE romainchassaigne! :tada:

Adds support for:
- donalskehan.com (1237)
- eatthismuch.com (1237)
- glutenfreeonashoestring.com (1220)
- miljuschka.nl (1254)
- theglutenfreeaustrian.com (1220)
- theloopywhisk.com (1220)

Bugfixes:
- Fix ingredient grouping retrieval for arla (1236)
- Remove workaround from kitchenstories (1240)
- Update/fix scraper for gesund+aktiv (1238)
- Update/fix scraper for realsimple (1242)
- Update/fix scraper for sallysblog (1243)
- Update/fix scraper for tofoo (1244)
- Update/fix scraper for wikicookbook (1239)

Misc:
- Drops support for Python 3.8 (1265)
- Modernize some type hints given that Python 3.9 has become baseline (1267)
- Adds an enforced order for nutritional expectations in JSON test data (1203)
- Refactor the `generate.py` scraper-generator script (1232)
- Raise a newly-added `RecipeSchemaNotFound` exception when the schema.org-fill plugin fails to find metadata on the page (1230)
- Require only `ingredients_list`, not also `ingredients`, in the test JSON data (1211)
- Cleanups: remove redundant methods and test expectation data (1197, 1228, 1255)

Thank you, jaspervzwi jknndy! :tada: