app_report 0.0.3 (experimental)

Python client to AppReport API

## app_report-python

app_report-python is a Python client to the [AppReport API](http://reports.simpleservic.es/), it allows you to generate pdf reports based on Jasper library in a simple way.

### Installation

• For Web2py framework users, please read [Using the AppReport client on Web2py Apps](https://github.com/simpleservices/app_report-python/wiki/Using-the-AppReport-client-on-Web2py-Apps).

• For Windows users, please read [How to install pip on Windows](https://github.com/simpleservices/app_report-python/wiki/How-to-install-pip-on-Windows).

• Or, if you are using Python on Linux, follow this steps:

  ```console # create a file requirements.txt and add this line: app_report

  System Message: WARNING/2 (<string>, line 13); backlink

  Inline literal start-string without end-string.

  System Message: WARNING/2 (<string>, line 13); backlink

  Inline interpreted text or phrase reference start-string without end-string.

  # after save it, run the install command: $ pip install -r requirements.txt ```

  System Message: WARNING/2 (<string>, line 17); backlink

  Inline literal start-string without end-string.

  System Message: WARNING/2 (<string>, line 17); backlink

  Inline interpreted text or phrase reference start-string without end-string.

### Try it now

• This example assumes that you already drawn your report using some tool like [i-report designer](http://community.jaspersoft.com/project/ireport-designer) and uploaded the .jrxml file to the [AppReport site](http://reports.simpleservic.es/), as a "report template",

  to make the things easy, we did it for you :) yay donuts for us.

  ```python import app_report from app_report.helpers.reports import jasper_report from urllib2 import urlopen

  System Message: WARNING/2 (<string>, line 27); backlink

  Inline literal start-string without end-string.

  System Message: WARNING/2 (<string>, line 27); backlink

  Inline interpreted text or phrase reference start-string without end-string.

  app_report.AppReport.configure({

  'app_name': 'shop', 'access_key': 'udPONmbmD01MnxzMVgiL', 'secret_key': 'ExINJLBR1I6Au6Hu0gQQoQmTMXAZuHk1Tkx3N19V'

  System Message: WARNING/2 (<string>, line 36)

  Definition list ends without a blank line; unexpected unindent.

  })

  xml_data = urlopen('http://reports.simpleservic.es/sample_resources/products.xml').read() report = jasper_report(template_name='products', data=xml_data, xpath_expression='/products/product')

  open('report.pdf', 'w').write(report)

  ```

  System Message: WARNING/2 (<string>, line 43); backlink

  Inline literal start-string without end-string.

  System Message: WARNING/2 (<string>, line 43); backlink

  Inline interpreted text or phrase reference start-string without end-string.

<b>Just it!</b> AppReport is a really simple, no more complex configurations or boring installations are required, just connect to AppReport API and start generating reports!

## Contribute You can contribute sending pull requests, don't forget to write tests for your code and check the pep8 conventions :)

```console $ pip install -r development-requirements.txt $ pip install -r test-requirements.txt

$ fab test

$ fab check_pep8 # p.s. the "Maximum Line Length" (of 79 chars) convention are being ignored. ```