Skip to main content

Lighthouse runner is a Python package that wraps the Lighthouse tool for easy integration into Python projects.

Project description

Lighthouse runner for python

About This Repository

This repository is based on the original work of Adam Cupiał and was forked from his lighthouse-python repository. While the original repository had not been updated in five years, I found it to be a valuable resource and decided to update it (I have made some changes, fixed some bugs) and turn it into a package for PyPI. I want to acknowledge the original author for creating the foundation of this project and making it available to the community.

Description

This library is a simple wrapper around lighthouse-cli runner that runs the audit and parses a result in friendly manner.

Installation

if lighthouse is not installed:

npm install -g lighthouse
pip install lighthouse-python-plus

Usage

from lighthouse import LighthouseRunner

report = LighthouseRunner('https://github.com/adamcupial', form_factor='desktop', quiet=False).report
assert report.score['performance'] > 0.5
print(report.audits['performance'].failed)

report has 3 properties:

  • score: returns dict where keys are categories and values are scores (0 to 1)
  • timings: returns dict where keys are timings and values are timedelta objects
  • audits: dict where keys are categories and values are objects with passed and failed lists attached

To see all the usage examples of this library, please check out the demo folder.

Dependencies

  • python 3.6+
  • node package lighthouse>=10.3.0 installed

Changes

You can find all changes in CHANGELOG!

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

lighthouse_python_plus-1.1.0.tar.gz (5.0 kB view hashes)

Uploaded Source

Built Distribution

lighthouse_python_plus-1.1.0-py3-none-any.whl (6.2 kB view hashes)

Uploaded Python 3

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