# Pygal


[![Build Status](https://github.com/Kozea/pygal/actions/workflows/ci.yml/badge.svg)](https://github.com/Kozea/pygal/actions/workflows/ci.yml)
[![Coverage Status](https://coveralls.io/repos/Kozea/pygal/badge.svg?branch=master&service=github)](https://coveralls.io/github/Kozea/pygal?branch=master)
[![Documentation Status](https://readthedocs.org/projects/pygal/badge/?version=latest)](https://readthedocs.org/projects/pygal/?badge=latest)


- [Pygal](#pygal)
    - [Description](#description)
    - [Installation](#installation)
    - [Test](#test)
    - [Contribute](#contribute)
    - [License](#license)

## Description

**pygal** is a dynamic SVG charting library written in python.
All the documentation is on [www.pygal.org](http://www.pygal.org)


## Installation

As simple as:

```
    $ pip install pygal
```



## Test

Pygal is tested with py.test:


```
    $ pip install pytest
    $ py.test
```


## Contribute

We welcome contributions to pygal! Before you start, please read and respect our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).

You are welcomed to fork the project and make pull requests.
Be sure to create a branch for each feature, write tests if needed and run the current tests!



## License

Copyright © 2012-2026 Kozea

See [LICENCE](./LICENSE)