Pyramid-royal

------------------

- Add sqlalchemy extension.
- Change the way links are added to resource representation.
- Fix issue 6: HTTP 500 error when using POST verb on Item resources.
- Breaking changes:

- `royal.resource:Base` constructor now takes request as third positional
argument.
- `royal.resource:Base.resource_url` and `Base.url` method signatures change.

- Add `presources` script to print all resources declared with royal.
- Add declarative configuration decorators `collection_config` & `item_config`.
- No more utility class: resource configuration uses pyramid introspectables to
store configuration rather than utility internal dict.
- Move `royal.utility` to ` royal.directives`

-----

- Add update_schema and replace_schema to be symetric with create_schema.

-----

- Started some documentation.
- Set default root factory to ``royal.resource.Root``
- Exception view which catches all exception is only added when ``debug=false``
in application settings.

-----

- Depends on pyramid without any version spec.

-----

- Add a default ``multipart/form-data`` deserializer.
- No more views on ``voluptuous.MultipleInvalid`` as ``voluptuous`` has been
removed from dependencies.

---

- Breaking changes:

- Query params are not anymore passed to resources methods
via ``**kwargs`` but as a ``dict``. TBD: use a ``multidict``.
- Working on return value of ``Collection.create`` method. TBD: Add adapters
to permit multiple way of calling resource methods from view and adapt
renderering

- Add ``renderer_adapter`` decorator to register adapter via ``config.scan``.
- Add renderer adapter to configuration introspectables under *Renderer
adapters* category.
- Add ``add_deserializer`` config directive and
decorator ``royal.deserializer_config`` to add deserializers for specific
content_type.
- Remove decorator ``log_error_dict`` in favor of pyramid_exclog extension.