git - Merge branch 'master' into export

Prepare branch to be merged into master

Author: phibos

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,47 @@
+<!--- Verify first that your issue/request has not already been reported -->
+
+##### Issue type
+<!--- Pick one below and delete the rest: -->
+ - Bug Report
+ - Feature Idea
+ - Documentation Report
+
+##### OverPy version
+<!--- Paste verbatim output from “python -c 'import overpy; print(overpy.__version__)'” or the hash of the git commit between quotes below. -->
+```
+
+```
+
+##### OS
+<!---
+Add information about the os you are using OverPy on.
+Pick one below and delete the rest:
+-->
+ - Ubuntu 14.04
+ - Ubuntu 16.04
+ - Debian 8.0
+
+#### Python version
+<!-- Pick at least one below and delete the rest -->
+
+ - Python 2.7
+ - Python 3.2
+ - Python 3.3
+ - Python 3.4
+ - Python 3.5
+
+##### Summary
+<!--- Explain the problem briefly. -->
+
+##### Steps to reproduce
+<!---
+Try to describe the steps how to reproduce the issue.
+-->
+
+<!--- You can also add links to gist.github.com. -->
+
+##### Expected results
+<!--- What did you expect to happen? -->
+
+##### Actual results
+<!--- What actually happened? -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+##### Issue type
+<!--- Pick one below and delete the rest: -->
+ - Feature
+ - Bugfix
+ - Documentation
+ - ...
+
+##### Summary
+<!--- Describe your change. -->
+
+<!---
+If you are fixing an existing issue, please include also "Fixes #nnn" in your commit message.
+Please respect the preferred format of the commit message.
+-->

.travis.yml

@@ -5,12 +5,17 @@ python:
   - "3.2"
   - "3.3"
   - "3.4"
+  - "3.5"
+  - "3.6"
   - "pypy"
   - "pypy3"
 
+before_install:
+  - if [[ $TRAVIS_PYTHON_VERSION == '3.2' ]]; then pip install 'coverage<4.0.0'; fi
+  - pip install coveralls
+
 install:
   - pip install .
-  - pip install coveralls
   - pip install pytest-cov
 
 script:

CHANGELOG.rst

@@ -1,6 +1,27 @@
 Changelog
 =========
 
+0.x (`master`_)
+~~~~~~~~~~~~~~~
+
+.. note:: This version is not yet released and is under development.
+
+0.4 (2016-12-08)
+~~~~~~~~~~~~~~~~
+
+* Add SAX parser
+* Add option to choose DOM or SAX parser
+* Fix issues with CI builds with Python 3.2
+* Add Python 3.5 to CI builds
+* Fix issues (Thanks to all contributors)
+* Add property for default API URL
+* Add examples
+* Build Fixes
+* GitHub templates
+* Parse center information
+* Parse geometry information
+* Support Areas
+
 0.3.1 (2015-04-30)
 ~~~~~~~~~~~~~~~~~~
 

CONTRIBUTING.rst

@@ -0,0 +1,47 @@
+Contributing
+============
+
+First of all, thank you for your interest in contributing to OverPy!
+
+
+Filing bug reports
+------------------
+
+Bug reports are very welcome.
+Please fill them on the `GitHub issue tracker`_.
+Good bug reports come with extensive descriptions of the error and how to reproduce it.
+
+
+Patches
+-------
+
+All patches to OverPy should be submitted in the form of pull requests to the main OverPy repository, `DinoTools/python-overpy`_.
+These pull requests should satisfy the following properties:
+
+Code
+^^^^
+
+- The pull request should focus on one particular improvement to OverPy.
+- Create different pull requests for unrelated features or bugfixes.
+- Python code should follow `PEP 8`_, especially in the "do what code around you does" sense.
+
+Documentation
+^^^^^^^^^^^^^
+
+When introducing new functionality, please remember to write documentation.
+
+Tests
+^^^^^
+
+It is recommended to add tests for new code you add.
+
+Review
+------
+
+Finally, pull requests must be reviewed before merging.
+Everyone can perform reviews; this is a very valuable way to contribute, and is highly encouraged.
+
+
+.. _GitHub issue tracker: https://github.com/DinoTools/python-overpy/issues
+.. _DinoTools/python-overpy: https://github.com/DinoTools/python-overpy
+.. _PEP 8: https://www.python.org/dev/peps/pep-0008/

MANIFEST.in

@@ -0,0 +1,11 @@
+include README.rst CHANGELOG.rst
+include LICENSE
+include MANIFEST.in
+include docs/make.bat docs.Makefile
+include docs/source/conf.py
+include docs/source/*.rst
+include examples/*.py
+include tests/*.py
+include tests/json/*.json
+include tests/response/*.html
+include tests/xml/*.xml

docs/source/api.rst

@@ -23,6 +23,9 @@ Elements
 .. autoclass:: Element
     :members:
 
+.. autoclass:: Area
+    :members:
+
 .. autoclass:: Node
     :members:
 
@@ -39,6 +42,9 @@ Relation Members
 .. autoclass:: RelationMember
     :members:
 
+.. autoclass:: RelationArea
+    :members:
+
 .. autoclass:: RelationNode
     :members:
 

docs/source/contributing.rst

@@ -0,0 +1 @@
+.. include:: ../../CONTRIBUTING.rst

docs/source/example.rst

@@ -35,7 +35,7 @@ Lets start with an example from the Overpass API documentation.
     {}
 
 Line 1:
-    Import the required Pyhton module
+    Import the required Python module
 
 Line 2:
     Create a new instance of the Overpass() class.
@@ -257,4 +257,4 @@ Line 20-21:
     The function will return all Node elements connected with the Way element.
 
 Line 22-25:
-    The resolved nodes have been added to the result set and are available to be used again later.
+    The resolved nodes have been added to the result set and are available to be used again later.

docs/source/faq.rst

@@ -0,0 +1,11 @@
+Frequently Asked Questions
+==========================
+
+429 Too Many Requests
+---------------------
+
+If to many requests are send from the same IP address the server blocks some requests to avoid that a user uses up all resources.
+For more information have a look at the `Overpass API documentation <http://overpass-api.de/command_line.html>`_.
+
+OverPy tries to fetch missing information automatically.
+To limit the number of requests you should try to fetch all required information/data(relations, ways, nodes, tags, ...) with the initial query.