Sous Chefs

newslynx-sc-reddit provides access to the following Sous Chefs

Reddit Search to Event

  • Extracts events from a Reddit API query.
  • This Sous Chef runs the python module newslynx_sc_reddit.Search.
  • API Slug: reddit-search-to-event

API Usage

Add this Sous Chef to your authenticated org

$ newslynx api sous-chefs create -d=newslynx_sc_reddit/reddit_search_to_event.yaml

Create a Recipe with this Sous Chef with command line options.

$ newslynx api recipes create sous_chef=reddit-search-to-event **options

Alternatively pass in a recipe file.

$ newslynx api recipes create sous_chef=reddit-search-to-event --data=recipe.yaml

Save the outputted id of this recipe, and execute it via the API. NOTE This will place the recipe in a task queue.

$ newslynx api recipes cook id=<id>

Alternatively, run the Recipe, passing in arbitrary runtime options, and stream it’s output: NOTE Will not execute the SousChef’s load method.

$ newslynx api recipes cook id=<id> --passthrough **options

Development

Pass runtime options to reddit-search-to-event and stream output. NOTE Will not execute the SousChef’s load method.

$ newslynx sc newslynx_sc_reddit/reddit_search_to_event.yaml option=value1

Alternatively pass in a recipe file

$ newslynx sc newslynx_sc_reddit/reddit_search_to_event.yaml --recipe=recipe.yaml

Options

In addition to default recipe options, reddit-search-to-event also accepts the following

  • query
    • The query to the Reddit API to return the initial batch of events.
    • Required
    • Should be rendered with a text form.
    • Accepts inputs of type:
      • string
    • More details on this option can be found here
  • sort
    • The sort order to return from the Reddit API.
    • Required
    • Should be rendered with a select form.
    • Choose from:
      • new
    • Accepts inputs of type:
      • string
    • Defaults to new
    • More details on this option can be found here
  • subreddit
    • The name of the subreddit to filter results by.
    • Required
    • Should be rendered with a text form.
    • Accepts inputs of type:
      • string
    • Defaults to None
  • must_link
    • Only create an event if there is a link to an existing content item.
    • Required
    • Should be rendered with a checkbox-single form.
    • Choose from:
      • False
    • Accepts inputs of type:
      • boolean
    • Defaults to False
  • event_status
    • Set the status of the resulting events. Choose from pending and approved. Defaults to pending.
    • Should be rendered with a select form.
    • Choose from:
      • pending
      • approved
    • Accepts inputs of type:
      • string
    • Defaults to pending
  • set_event_title
    • Set’s the title of the resulting events. This can be a python format string which has access to all of an event’s top-level keys: IE: “Content from {authors} at {created}.”
    • Should be rendered with a text form.
    • Accepts inputs of type:
      • string
    • Defaults to None
  • set_event_description
    • Set’s the description of the output events. This can be a python format string which has access to all of an event’s top-level keys: IE: “{title}.”
    • Should be rendered with a paragraph form.
    • Accepts inputs of type:
      • string
    • Defaults to None
  • set_event_tag_ids
    • A list of Tag IDs or slugs to automatically apply to events created by this recipe.
    • Should be rendered with a checkbox form.
    • Choose from:
    • Accepts inputs of type:
      • string
      • numeric
    • Defaults to []
  • set_event_content_items
    • A list of Content Item IDs and Titles to automatically apply to events created by this Recipe.
    • Should be rendered with a search form.
    • Choose from:
    • Accepts inputs of type:
      • json
    • Defaults to []