# Paprika-Recipes: Easily manage your paprika recipes
[Paprika](https://www.paprikaapp.com/) is a lovely recipe app that works so much better than I ever expected a recipe app to, and although its totally possible to edit recipes without leaving the app, that can be a little inconvenient. This console app and library are built to make creating and editing your recipes easy by providing you tools for editing or creating individual recipes, downloading your whole recipe list, and even working with recipe exports generated by the app.
## Installation
```
pip install paprika-recipes
```
## Usage
### Modifying via Paprika's API
This app can interact directly with Paprika's API using the commands documented here, but before beginning, you will need to store your paprika account information in your system keyring by running:
```
paprika-recipes store-password
```
You'll be asked for your e-mail and password; after that point, the console app will fetch your password from your system keyring instead of prompting you for it.
The instructions below assume that you've answered "yes" when asked whether you'd like to use this account by default, but if you didn't -- see `--help` for instructions.
#### Modifying one of your existing recipes
You can modify a recipe on your Paprika account by running the following
```
paprika-recipes edit-recipe
```
You'll be presented with a list of recipes on your account and after
you select the recipe you'd like to edit, your editor will be opened
to allow you to make the modifications you want to make.
Just save and close your editor to upload your updated recipe to Paprika.
If you have decided that you've made a mistake and would like to abort,
just delete all of the contents of the file before saving and closing
your editor. We won't update your recipe if you do that.
You can also provide search parameters as command-line arguments to
limit the list of recipes presented to you, and if your search terms
match just one of your recipes, we'll open the editor straight away.
#### Creating a new recipe on your Paprika account
You can create a new recipe on your Paprika account by running the following
```
paprika-recipes create-recipe
```
Your editor will be opened to a brand new empty recipe. Just write out
your recipe's instructions and whatever other fields you'd like to fill
out, then save and close your editor -- we'll upload your recipe to your
Paprika account as soon as your editor has closed.
If you have decided that you've made a mistake and would like to abort,
just delete all of the contents of the file before saving and closing
your editor. We won't update your recipe if you do that.
#### Downloading your whole recipe collection
If you want to download your whole recipe archive instead of editing or creating a single recipe at a time, you can download your whole recipe collection into a directory on your computer.
The expected workflow for changing your recipes when using this method is a three-step process:
1. Downloading your paprika recipes from your account.
2. Modifying the extracted yaml recipe files or creating new ones.
3. Uploading your changed or new recipes back to your account.
##### Downloading
```
paprika-recipes download-recipes /path/to/export/your/recipes
```
##### Uploading
```
paprika-recipes upload-recipes /path/to/where/you/exported/your/recipes
```
### Modifying via Exported Archives
The expected workflow for changing your recipes is a three-step process:
1. Extracting your `paprikarecipes` file to a directory.
2. Modifying the extracted yaml recipe files.
3. Compress your recipes back into an archive.
#### Extracting
```
paprika-recipes extract-archive /path/to/your/export.paprikarecipes /path/to/extract/recipes/to/
```
#### Compressing
```
paprika-recipes create-archive /path/you/earlier/extracted/recipes/to/ /path/to/a/new/export.paprikarecipes
```
Raw data
{
"_id": null,
"home_page": "https://github.com/coddingtonbear/paprika-recipes/",
"name": "paprika-recipes",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Adam Coddington",
"author_email": "me@adamcoddington.net",
"download_url": "",
"platform": null,
"description": "# Paprika-Recipes: Easily manage your paprika recipes\n\n[Paprika](https://www.paprikaapp.com/) is a lovely recipe app that works so much better than I ever expected a recipe app to, and although its totally possible to edit recipes without leaving the app, that can be a little inconvenient. This console app and library are built to make creating and editing your recipes easy by providing you tools for editing or creating individual recipes, downloading your whole recipe list, and even working with recipe exports generated by the app.\n\n## Installation\n\n```\npip install paprika-recipes\n```\n\n## Usage\n\n### Modifying via Paprika's API\n\nThis app can interact directly with Paprika's API using the commands documented here, but before beginning, you will need to store your paprika account information in your system keyring by running:\n\n```\npaprika-recipes store-password\n```\n\nYou'll be asked for your e-mail and password; after that point, the console app will fetch your password from your system keyring instead of prompting you for it.\n\nThe instructions below assume that you've answered \"yes\" when asked whether you'd like to use this account by default, but if you didn't -- see `--help` for instructions.\n\n#### Modifying one of your existing recipes\n\nYou can modify a recipe on your Paprika account by running the following\n\n```\npaprika-recipes edit-recipe\n```\n\nYou'll be presented with a list of recipes on your account and after\nyou select the recipe you'd like to edit, your editor will be opened\nto allow you to make the modifications you want to make.\nJust save and close your editor to upload your updated recipe to Paprika.\n\nIf you have decided that you've made a mistake and would like to abort,\njust delete all of the contents of the file before saving and closing\nyour editor. We won't update your recipe if you do that.\n\nYou can also provide search parameters as command-line arguments to\nlimit the list of recipes presented to you, and if your search terms\nmatch just one of your recipes, we'll open the editor straight away.\n\n#### Creating a new recipe on your Paprika account\n\nYou can create a new recipe on your Paprika account by running the following\n\n```\npaprika-recipes create-recipe\n```\n\nYour editor will be opened to a brand new empty recipe. Just write out\nyour recipe's instructions and whatever other fields you'd like to fill\nout, then save and close your editor -- we'll upload your recipe to your\nPaprika account as soon as your editor has closed.\n\nIf you have decided that you've made a mistake and would like to abort,\njust delete all of the contents of the file before saving and closing\nyour editor. We won't update your recipe if you do that.\n\n#### Downloading your whole recipe collection\n\nIf you want to download your whole recipe archive instead of editing or creating a single recipe at a time, you can download your whole recipe collection into a directory on your computer.\n\nThe expected workflow for changing your recipes when using this method is a three-step process:\n\n1. Downloading your paprika recipes from your account.\n2. Modifying the extracted yaml recipe files or creating new ones.\n3. Uploading your changed or new recipes back to your account.\n\n##### Downloading\n\n```\npaprika-recipes download-recipes /path/to/export/your/recipes\n```\n\n##### Uploading\n\n```\npaprika-recipes upload-recipes /path/to/where/you/exported/your/recipes\n```\n\n### Modifying via Exported Archives\n\nThe expected workflow for changing your recipes is a three-step process:\n\n1. Extracting your `paprikarecipes` file to a directory.\n2. Modifying the extracted yaml recipe files.\n3. Compress your recipes back into an archive.\n\n#### Extracting\n\n```\npaprika-recipes extract-archive /path/to/your/export.paprikarecipes /path/to/extract/recipes/to/\n```\n\n#### Compressing\n\n```\npaprika-recipes create-archive /path/you/earlier/extracted/recipes/to/ /path/to/a/new/export.paprikarecipes\n```\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Easily view and edit the contents of exports from the Paprika app.",
"version": "2.4.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "1912c09f557bbc3fe43d1cea17a16248",
"sha256": "0f85aba244d427a94414496321094df8fb7f75f5bad7e1284c8a8addd0604790"
},
"downloads": -1,
"filename": "paprika_recipes-2.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1912c09f557bbc3fe43d1cea17a16248",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 21811,
"upload_time": "2022-12-09T17:46:54",
"upload_time_iso_8601": "2022-12-09T17:46:54.315968Z",
"url": "https://files.pythonhosted.org/packages/0b/01/287fbca2eed9d725dc64fce8a4857e0983db7781b0f02e5828336ca68716/paprika_recipes-2.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-09 17:46:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "coddingtonbear",
"github_project": "paprika-recipes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pyyaml",
"specs": [
[
"<",
"6.0"
],
[
">=",
"5.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.0"
],
[
"<",
"3.0"
]
]
},
{
"name": "keyring",
"specs": [
[
"<",
"22.0"
],
[
">=",
"21.0"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"12.3.0"
],
[
"<",
"13.0"
]
]
},
{
"name": "questionary",
"specs": [
[
"<",
"2.0"
],
[
">=",
"1.10.0"
]
]
},
{
"name": "appdirs",
"specs": [
[
"<",
"2.0"
],
[
">=",
"1.4"
]
]
},
{
"name": "typing_extensions",
"specs": [
[
">=",
"4.4.0"
],
[
"<",
"5.0"
]
]
}
],
"lcname": "paprika-recipes"
}
JSON
