pyravelry 0.0.8

Python wrapper for the Ravelry API, which is a database of knitting / crocheting patterns.

pyravelry

This is python wrapper for the Ravelry API (a database of knitting / crocheting patterns).

• Github repository: https://github.com/theuerc/pyravelry/
• Documentation https://theuerc.github.io/pyravelry/
• Official Ravelry API Documentation https://www.ravelry.com/api

Use of this API wrapper requires a Ravelry Account and a username and apikey as specified in the HTTP Basic Auth section of the Ravelry API Documentation. Be sure to get read/write permissions if you want full access to all of the endpoints.

Quick Start:

$pip install pyravelry
$python -i
>>> from pyravelry import Client, Settings
>>> settings = Settings(RAVELRY_USERNAME=..., RAVELRY_API_KEY=...)
>>> client = Client(settings=settings)
>>> results = client.search.query(query="merino", limit=10, types=["Yarn"])
>>> results[0].title
'MerinoSeide'
>>> results.pandas.loc[:, ["title", "type_name", "record.type"]].head()
           title type_name record.type
0    MerinoSeide      yarn        Yarn
1    Merinosukka      yarn        Yarn
2      MERINO100      yarn        Yarn
3  Merino-Tussah      yarn        Yarn
4    Merinosilke      yarn        Yarn
>>> results.polars["title", "type_name", "record.type"].head()
shape: (5, 3)
┌───────────────┬───────────┬─────────────┐
│ title         ┆ type_name ┆ record.type │
│ ---           ┆ ---       ┆ ---         │
│ str           ┆ str       ┆ str         │
╞═══════════════╪═══════════╪═════════════╡
│ MerinoSeide   ┆ yarn      ┆ Yarn        │
│ Merinosukka   ┆ yarn      ┆ Yarn        │
│ MERINO100     ┆ yarn      ┆ Yarn        │
│ Merino-Tussah ┆ yarn      ┆ Yarn        │
│ Merinosilke   ┆ yarn      ┆ Yarn        │
└───────────────┴───────────┴─────────────┘

More information about this API wrapper can be found in the pyravelry documentation.