bbrpy 0.3.0

Better Battery Report for Windows

---

✨ Better Battery Report: A Python CLI tool that generates enhanced battery reports for Windows systems ✨

---

📋 Features

• Display basic battery information
• Generate battery health reports with interactive visualizations
• Export reports as HTML files with Plotly graphs
• Track battery capacity changes over time

📦 Installation

Since this is a CLI application, it's recommended to run it using uvx:

uvx bbrpy

[!IMPORTANT] This will only install the essential dependencies for running the tool, making it lightweight and portable. For extended use, it may be necessary to install extra dependency groups as well.

It can also be installed into a persistent environment and added to the PATH:

uv tool install bbrpy

Alternatively, you can install it globally using pip:

pip install bbrpy

💻 Usage

The tool provides two main commands:

Display Battery Information

bbrpy info

This command shows basic battery information including:

• Report scan time
• Capacity Status (current / design)

Generate Battery Report

bbrpy report [--output PATH]

Options:

• --output: Specify the output path for the HTML report (default: "./reports/battery_report.html")

This command:

1. Generates a battery report using powercfg
2. Creates an interactive visualization of battery capacity history
3. Opens the report in your default web browser

📘 Requirements

• Windows operating system
• Python 3.12 or higher
• Administrative privileges (for powercfg command)

⚙️ Technical Details

• powercfg Windows command-line tool for battery data
• pydantic_xml for the default report serialization
• plotly for interactive visualizations
• pandas for data processing
• typer for CLI interface

©️ License

MIT License