NAME

Web::NewsAPI::Source - Object class representing a News API source

SYNOPSIS

use v5.10;
use Web::NewsAPI;

my $newsapi = Web::NewsAPI->new(
   api_key => $my_secret_api_key,
);

say "Here are some sources for English-language science news...";
my @sources = $newsapi->sources(
   category => 'science',
   language => 'en'
);
for my $source ( @sources ) {
   say $source->name;
   if ( defined $source->id ) {
       say "...it has the NewsAPI ID " . $source->id;
   }
   else {
       say "...but it doesn't have a NewsAPI ID.";
   }
}

DESCRIPTION

Objects of this class represent a News API news source. Generally, you won't create these objects yourself; you'll get them as a result of calling sources() on a Web::NewsAPI object.

METHODS

Object attributes

These are all read-only attributes, based on information provided by News API. They are all strings, except for url, which is a URI object. Any of them might be undefined, except for name.

id

my $id = $source->id;

name

my $name = $source->name;

description

my $desc = $source->description;

url

my $url = $source->url;

category

my $category = $source->category;

language

my $language_code = $source->language;

country

my $country_code = $source_country;

AUTHOR

Jason McIntosh (jmac@jmac.org)