bbrpy 0.2.1

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

Alternatively, you can install it using pip:

pip install bbrpy

Or pipx to install it on an isolated environment:

pipx install bbrpy

💻 Usage

The tool provides two main commands:

Display Battery Information

bbrpy info

This command shows basic battery information including:

• Computer name
• Last scan time
• Design capacity
• Current full charge capacity

Generate Battery Report

bbrpy generate [--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

The tool uses:

• powercfg Windows command-line tool for battery data
• Plotly for interactive visualizations
• Pandas for data processing
• Typer for CLI interface

©️ License

MIT License