Skip to main content

Media Cloud news article metadata extraction

Project description

Meta Extractor

🚧 under construction 🚧

This is a package to extract a domain, title, publication date, text, and language content from the URL or text of an online news story. The methods for each are extracted from the larger Media Cloud project, but also build on numerous 3rd party libraries. The metadata extracted includes:

  • the original URL of publication
  • the canonical domain published on
  • the date of publication
  • the primary language used in the article text
  • the title of the article
  • the text content of the news article
  • the name of the library used to extract the article content

Usage

If you pass in a URL, it will follow redirects and fetch the HTML for you.

from mcmetadata import extract
metadata = extract(url="https://my.awesome.news/story-path")

You can also pass in HTML you already have on hand. Note that in this case it is also useful to pass in the URL because that is used for some for some of the metadata extraction.

from mcmetadata import extract
metadata = extract(url="https://my.awesome.news/story-path",
                   html_text="<html><head><title>my webpage ... </html>")

Distribution

  1. Run pytest to make sure all the test pass
  2. Update the version number in mcextractor/__init__.py
  3. Make a brief note in the version history section below about the changes
  4. Run python setup.py sdist to create an install package
  5. Run twine upload --repository-url https://test.pypi.org/legacy/ dist/* to upload it to PyPI's test platform
  6. Run twine upload dist/* to upload it to PyPI

Version History

  • v0.2.0: first packaging release for use in other places
  • v0.1.1: first version for testing with collaborators

Authors

Created as part of the Media Cloud Project:

  • Tyler Horan
  • Rahul Bhargava

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mediacloud-metadata-0.2.0.tar.gz (12.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page