ecostyles 0.2.0

Custom Altair themes and styling utilities

ecostyles

A Python package for consistent Altair chart styling and themes.

Installation

You can install the package directly from GitHub:

pip install git+https://github.com/jhellingsdata/ecostyles.git

Usage

from ecostyles import EcoStyles

# Create styles instance
styles = EcoStyles()

# Register and enable a theme
styles.register_and_enable_theme(theme_name="article")  # or "cotd", "newsletter"

# Create your Altair chart
import altair as alt
chart = alt.Chart(data).mark_line().encode(...)

# Use helper methods
chart_with_source = styles.add_source(chart, "ONS")   # returns a new chart; multi-line supported
styles.save(chart, "path/to/save", "chart_name")       # or styles.save(chart, name="chart_name") to save to cwd

Features

• Pre-defined color palettes and themes
• Helper methods for common chart modifications
• Consistent styling across projects
• Support for dark mode
• Easy export to various formats

Requirements

• Python >= 3.10
• altair >= 6.2.0
• pandas >= 1.1.3
• vl-convert-python >= 1.7.0
• country-converter >= 1.0.0

License

This project is licensed under the MIT License - see the LICENSE file for details.