semvec/pypi-packages huggingface dataset:
bra_scraper 0.1.6
An interface for fetching statistical data from BRÅ. This is not an official service!
License: MIT

# BRÅ Scraper

This is a Python module for fetching statistical data about reported crime from [Brottsförbyggande rådet](http://statistik.bra.se/solwebb/action/index).

### Installation

`pip install -r requirements.txt`


### Usage

Init scraper:

```python
from bra_scraper.BRA import BRA
scraper = BRA()
```

List topics.

```python
print scraper.topics
```

Explore a topic.

```python

# Get a topic by name (or url)
topic = scraper.topic(u"Månads- och kvartalsvis - Land och län 1975-2014, land och region 2015-")

# Get available regions
print topic.regions

# Get available crimes
print topic.crimes

```

Make query.

```python
# Query date range
data = topic.query(period_start="2016-01-01", period_end="2016-06-30")

# Query by region and crimes
data = topic.query(regions=["Bjuv kommun"], crimes=[u"Våldsbrott"])

```

Save results.

```python
data.to_csv("my_data_dump.csv")
```

### Command line usage

With `run.py` you can run the scraper from the command line. Run `python run.py --help` for help:

```
  -t TOPIC, --topic TOPIC
                        name of the topic to be scraped (from http://statistik
                        .bra.se/solwebb/action/start?menykatalogid=1)
  -o OUTFILE, --outfile OUTFILE
                        store result in this file
  -ps PERIOD_START, --period_start PERIOD_START
                        start date (for example 2016-09-01)
  -pe PERIOD_END, --period_end PERIOD_END
                        end date (for example 2016-09-01)
```