Readinglist

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

**Deployment instructions**

Until the database schema migration system is released (mozilla-services/cliquet139),
changes on schema have to be applied manually:

::

ALTER FUNCTION as_epoch(TIMESTAMP) IMMUTABLE;
CREATE INDEX idx_records_last_modified_epoch ON records(as_epoch(last_modified));
CREATE INDEX idx_deleted_last_modified_epoch ON deleted(as_epoch(last_modified));

**New features**

- Add setting to enable to asynchronous PostgreSQL using `Psycogreen <https://pypi.python.org/pypi/psycogreen>`_.
(*default: disabled*). See installation documentation for more details on this.
- Add ability to execute only action in loads tests using the ``LOAD_ACTION``
environment variable. See contributing documentation for more details (208).
- Add new load tests with several kinds of batch operations (204)

**Bug fixes**

- Fix pagination URL in Next-page headers (fixes 210)
- Fix regression on records URL unicity when using ujson (205)
- Fix hashing of user_id for BasicAuth (mozilla-services/cliquet128)
- Force PostgreSQl session timezone to UTC (mozilla-services/cliquet122)
- Make sure the `paginate_by` setting overrides the passed `limit`
argument (mozilla-services/cliquet129)
- Fix limit comparison under Python3 (mozilla-services/cliquet143)
- Do not serialize using JSON if not necessary (mozilla-services/cliquet131)
- Fix crash of classic logger with unicode (mozilla-services/cliquet142)
- Fix crash of CloudStorage backend when remote returns 500 (mozilla-services/cliquet142)
- Fix behaviour of CloudStorage with backslashes in querystring (mozilla-services/cliquet142)
- Fix python3.4 segmentation fault (mozilla-services/cliquet142)
- Add missing port in Next-Page header (mozilla-services/cliquet147)


**Internal changes**

- Use postgres cache in loads tests (203)
- Use ujson again, it was removed in the 1.3.2 release (132)
- Add index for as_epoch(last_modified) (130). Please add the following
statements to SQL for the migration::
- Prevent fetching to many records for one user collection (130)
- Use UPSERT for the heartbeat (141)
- Improve tests of basic auth (128)

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

**New features**

- Add PostgreSQL connection pooling, with new settings
``cliquet.storage_pool_maxconn`` and ``cliquet.cache_pool_maxconn``
(*Default: 50*) (mozilla-services/cliquet112)
- Add `StatsD <https://github.com/etsy/statsd/>`_ support,
enabled with ``cliquet.statsd_url = udp://server:port`` (mozilla-services/cliquet114)
- Add `Sentry <https://sentry.readthedocs.io>`_ support,
enabled with ``cliquet.sentry_url = http://user:passserver/1`` (mozilla-services/cliquet110)

**Bug fixes**

- Fix FxA verification cache not being used (mozilla-services/cliquet103)
- Fix heartbeat database check (mozilla-services/cliquet109)
- Fix PATCH endpoint crash if request has no body (mozilla-services/cliquet115)

**Internal changes**

- Switch to `ujson <https://pypi.python.org/pypi/ujson>`_ for JSON
de/serialization optimizations (mozilla-services/cliquet108)
- Use async connections for psycopg (201)
- Imrpove the documentation layout (200)

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

**Breaking changes**

* `cliquet.storage.postgresql` now uses UUID as record primary key (mozilla-services/cliquet70)
* Settings ``cliquet.session_backend`` and ``cliquet.session_url`` were
renamed ``cliquet.cache_backend`` and ``cliquet.cache_url`` respectively.
* FxA user ids are not hashed anymore (mozilla-services/cliquet82)
* Setting ``cliquet.retry_after`` was renamed ``cliquet.retry_after_seconds``
* OAuth2 redirect url now requires to be listed in
``fxa-oauth.webapp.authorized_domains`` (e.g. ``*.mozilla.com``)
* Batch are now limited to 25 requests by default (mozilla-services/cliquet90)
* OAuth relier has been disabled by default (193)

**New features**

* Every setting can be specified via an environment variable
(e.g. ``cliquet.storage_url`` with ``CLIQUET_STORAGE_URL``)
* Logging now relies on `structlog <http://structlog.org>`_ (mozilla-services/cliquet78)
* Logging output can be configured to stream JSON (mozilla-services/cliquet78)
* New cache backend for PostgreSQL (mozilla-services/cliquet44)
* Documentation was improved on various aspects (mozilla-services/cliquet64, mozilla-services/cliquet86)
* Handle every backend errors and return 503 errors (mozilla-services/cliquet21)
* State verification for OAuth2 dance now expires after 1 hour (mozilla-services/cliquet83)
* Add the preview field for an article (156)
* Setup the readinglist OAuth scope (16)
* Add a uwsgi file (180)

**Bug fixes**

* FxA OAuth views errors are now JSON formatted (mozilla-services/cliquet67)
* Prevent error when pagination token has bad format (mozilla-services/cliquet72)
* List of CORS exposed headers were fixed in POST on collection (mozilla-services/cliquet54)
* Fix environment variables not overriding configuration (mozilla-services/cliquet100)
* Got rid of custom *CAST* in PostgreSQL storage backend to prevent installation
errors without superuser (ref 174, mozilla-services/cliquet99)

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

**Breaking changes**

- Most configuration entries were renamed, see `config/readinglist.ini`
example to port your configuration
- Status field was removed, archived and deleted fields were added
(requires a database flush.)
- Remove Python 2.6 support

**New features**

- Add the /fxa-oauth/params endpoint
- Add the DELETE /articles endpoint
(Needs cliquet.delete_collection_enabled configuration)
- Add the Response-Behavior header on PATCH /articles
- Add HTTP requests / responses examples in the documentation
- Use Postgresql as the default database backend

**Internal changes**

- Main code base was split into a separate project
`Cliquet <https://github.com/mozilla-services/cliquet>`_
- Perform continuated pagination in loadtests
- Use PostgreSQL for loadtests

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

**Bug fixes**

- Fix CORS preflight request permissions (PR 119)

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

**Breaking changes**

- Internal user ids for FxA are now prefixed, all existing records
will be lost (refs 109)

**Bug fixes**

- Fix CORS headers on validation error responses (ref 104)
- Fix handling of defaults in batch requests (ref 111, 112)