/bbc-feeds

A python package to get news, weather, and sports from BBC

Primary LanguagePythonMIT LicenseMIT

bbc-feeds


A python package to get news, weather, and sports from BBC.

Installation

pip3 install bbc-feeds

Usage

  1. Import the library: import bbc_feeds
  2. Call a class and then a function with bbc_feeds.news().all(). In this example news is the class and the function is all. This will return a list of news stories as a dictionary.

Example

The below example gets the first three stories from the homepage (all) and prints out the story name and summary.

import bbc_feeds

stories = bbc_feeds.news().all(limit=3)

for story in stories:
    print(story.title)
    print(story.summary)

To get a list of the dictionary keys available use the keys() function.

Functions

News

Function Name Category RSS Feed Optional Parameters
news().all() Home http://feeds.bbci.co.uk/news/rss.xml limit
news().world() World http://feeds.bbci.co.uk/news/world/rss.xml limit
news().uk() UK http://feeds.bbci.co.uk/news/uk/rss.xml limit
news().north_america() America and Canada http://feeds.bbci.co.uk/news/world/us_and_canada/rss.xml limit
news().entertainment() Entertainment & Arts http://feeds.bbci.co.uk/news/entertainment_and_arts/rss.xml limit
news().business() Business http://feeds.bbci.co.uk/news/business/rss.xml limit
news().tech() Technology http://feeds.bbci.co.uk/news/technology/rss.xml limit
news().science() Science and Environment http://feeds.bbci.co.uk/news/science_and_environment/rss.xml limit
news().top_stories() Home http://feeds.bbci.co.uk/news/rss.xml?edition=int limit
edition

top_stories() has the optional parameter edition which is used to set the edition to use when getting the top stories. You can set edition to the following:

  • uk - UK Top stories
  • us - US Top stories
  • int - International Top stories

Sports

Function Name Category RSS Feed Optional Parameters
sports().all() Home https://feeds.bbci.co.uk/sport/rss.xml limit
sports().cricket() Cricket https://feeds.bbci.co.uk/sport/cricket/rss.xml limit
sports().soccer() Soccer https://feeds.bbci.co.uk/sport/football/rss.xml limit
sports().tennis() Tennis https://feeds.bbci.co.uk/sport/tennis/rss.xml limit
sports().athletics() Athletics https://feeds.bbci.co.uk/sport/athletics/rss.xml limit
sports().golf() Golf https://feeds.bbci.co.uk/sport/golf/rss.xml limit
sports().boxing() Boxing https://feeds.bbci.co.uk/sport/boxing/rss.xml limit
sports().swimming() Swimming https://feeds.bbci.co.uk/sport/swimming/rss.xml limit
sports().cycling() Cycling https://feeds.bbci.co.uk/sport/cycling/rss.xml limit
sports().formula1() Formula1 https://feeds.bbci.co.uk/sport/formula1/rss.xml limit

Weather

All functions have an optional parameter limit, where you can limit the number of entries.

CLI

Usage: bbc [OPTIONS] COMMAND [ARGS]...

  Get BBC feeds of several categories

Options:
  --help  Show this message and exit.

Commands:
  news
  sports
  weather