bsnotifier

Battery Status Notifier (bsnotifier)

Command line application that shows a popup window when the battery is low. This Python script can be used to notify battery status in i3wm environments.

Table of contents

• Get started
  • Installation
  • Usage
  • How to use it with i3
  • Options
• Developers
  • Testing release with Tox
    • Requirements
    • Set Python versions
    • Run
  • Static code analysis tools
    • Set up the Git hooks custom directory
    • Python Static Checkers
    • Shell Static Checkers
    • Run using Tox - recommended
    • Run manually
• License
• Changelog

Get started

Installation

This application can be simply installed by running:

pip install bsnotifier

if you want to install from a source distribution:

git clone https://github.com/eccanto/battery-status-notifier
cd battery-status-notifier/
python setup.py install

Usage

To start the notifier you must run the command line application:

bsnotifier

By default the application will check the battery status every 1:30 minutes, if the battery percentage is less than 10% a popup window will be shown.

How to use it with i3

Auto start the notifier application in i3:

1. Linking the application executable to make it accessible to other users.

   BSNOTIFIER_PATH="$(which bsnotifier)"
   sudo ln -s "${BSNOTIFIER_PATH}" /usr/bin/bsnotifier
   

2. Edit i3 config file.

   # ~/.config/i3/config
   ...
   exec --no-startup-id bsnotifier -o "$(mktemp)"
   ...
   

Options

$ bsnotifier --help

Usage: bsnotifier [OPTIONS]

  Command line application that shows a popup window when the battery is low.

Options:
  -i, --interval INTEGER  The time interval in seconds that the script waits
                          before checking the battery again (default: 150.0
                          seconds).
  -l, --level INTEGER     The battery percentage at which the popup window is
                          displayed (default: 10).
  -s, --silent            Do not play the sound when popup window is
                          displayed.
  -o, --output PATH       Log file path (default: .bsnotifier.log).
  --help                  Show this message and exit.

Developers

Testing release with Tox

Requirements

Python requirements:

pip3 install -r requirements_testing.txt

Set Python versions

1. Install pyenv
2. Install python versions:

   for python_version in "3.7" "3.8" "3.9" "3.10" "3.11" ; do pyenv install ${python_version}; done
   

3. Enable python versions:

   pyenv local "3.7" "3.8" "3.9" "3.10" "3.11"
   

Run

We use tox and pytest to run the test suite:

tox

to run the test suite for a particular Python version, you can do:

tox -e py37

Static code analysis tools

These are the linters that will help us to follow good practices and style guides of our source code. We will be using the following static analysis tools, which will be executed when generating a new push in the repository (git hooks).

Set up the Git hooks custom directory

After cloning the repository run the following command in the repository root:

git config core.hooksPath .githooks

Python Static Checkers

Tools used:

• brunette: A best practice Python code formatter.

• isort: Python utility / library to sort imports alphabetically, and automatically separated into sections and by type.

• prospector: Prospector is a tool to analyse Python code and output information about errors, potential problems, convention violations and complexity.

  Tools executed by Prospector:

  • pylint: Pylint is a Python static code analysis tool which looks for programming errors, helps enforcing a coding standard, sniffs for code smells and offers simple refactoring suggestions.
  • bandit: Bandit is a tool designed to find common security issues.
  • dodgy: It is a series of simple regular expressions designed to detect things such as accidental SCM diff checkins, or passwords or secret keys hard coded into files.
  • mccabe: Complexity checker.
  • mypy: Mypy is an optional static type checker for Python.
  • pydocstyle: pydocstyle is a static analysis tool for checking compliance with Python PEP 257.
  • pycodestyle: pycodestyle is a tool to check your Python code against some of the style conventions in PEP 8.
  • pyflakes: Pyflakes analyzes programs and detects various errors.
  • pyroma: Pyroma is a product aimed at giving a rating of how well a Python project complies with the best practices of the Python packaging ecosystem, primarily PyPI, pip, Distribute etc, as well as a list of issues that could be improved.

Shell Static Checkers

Tools used:

• shellcheck: Finds bugs in your shell scripts (bash).

  Installation:

  apt install shellcheck
  

Run using Tox - recommended

tox -e code_checkers

Run manually

bash scripts/code_checkers.sh

License

MIT

Changelog

• 1.0.0 - Initial version.
• 1.0.1 - I3 support.
• 1.0.2 - Close the popup window when connecting the battery, and update the information in real time.