1063130 - [Compat Data] Add features to compat data store

Status: RESOLVED FIXED

(developer.mozilla.org Graveyard :: General, enhancement)

Description

[John Whitlock [:jwhitlock]]

What problems would this solve?
===============================
Features are the rows in the grids of compatibility tables on MDN.

Who would use this?
===================
People looking for compatibility data for a particular feature

What would users see?
=====================
Feature names, some in 'canonical' format (what is used in code)

What would users do? What would happen as a result?
===================================================
A developer would see what browsers support a given feature, and perhaps see what specifications define the feature.

Is there anything else we should know?
======================================
Draft API docs at http://web-platform-compat.readthedocs.org/en/latest/draft/resources.html#features

Comment 1

[MDN Team (:mdn-dev)]

Commits pushed to master at https://github.com/mozilla/web-platform-compat

https://github.com/mozilla/web-platform-compat/commit/fb9d14785ebfc2c0521cbc81384b014e0ed3af7a
bug 1063130 - Better errors for Cached*

CachedModel - attribute miss raises AttributeError
CachedQueryset - failed get raises DoesNotExist

https://github.com/mozilla/web-platform-compat/commit/cc655475c08411f541c59ef42d20027ddb30bc85
bug 1063130 - JSON API - render nullable FKs

Null Foreign Keys were rendered as string "None", now rendered as null.

https://github.com/mozilla/web-platform-compat/commit/3f7caef1fbd4fb1c6502973d8c09e60b266e6a2a
bug 1063130 - add features model, API endpoint

* Adds django-mptt for Modified Preorder Tree Traversal.
* Adds MPTTRelationField to handle MPTT related querysets like ancestors
  and siblings.
* Adds OptionalCharField to display empty strings as null

https://github.com/mozilla/web-platform-compat/commit/5e0b389cd53d68ad993cd45720f4017464222a34
bug 1063130 - Verify slug behaviour

https://github.com/mozilla/web-platform-compat/commit/e055f040bf8fdb7d446fadad0f61308da2e2911b
bug 1063130 - Add canonical translation option

feature.name can either be a human-readable name or the "canonical" form
of the name, such as "<input>" for the HTML input element.  These are
stored in the database as the "zxx" translation (the ISO 639-2 "no
linguistic content" identifier), because JSONField doesn't store
strings.  They appear as strings in the JSON API output.

https://github.com/mozilla/web-platform-compat/commit/56b7fcce9237317a2f80b9deb7bc4c46599da819
bug 1063130 - flake8 for Python 3

https://github.com/mozilla/web-platform-compat/commit/bedf09c3fc66cbfe6f7ca499eaac1b945195a9bc
bug 1063130 - Add some links to historical rep

Relations that are represented by a primary key named "(relation)_id"
are eligible for being included in the "links" attribute in the
historical resource.  Reverse relations, such as the to-many relations,
are not eligible.

https://github.com/mozilla/web-platform-compat/commit/e93a46e6b564943871a90e830c057925d184e71f
bug 1063130 - Improve load_webcompat_data

* browsers are MDN sorted (alpha by desktop, alpha by mobile, then
  Firefox OS)
* versions are version sorted (unspecified, then 1.0, then 1.5, then
* 1.10, etc.)
* Convert version "1" into version "1.0" (but "1.1" stays "1.1")
* Default to INFO level debugging, -v to get DEBUG, -q to get WARNING

https://github.com/mozilla/web-platform-compat/commit/1059522513f00a11135da191816b3da79a2a1e7a
bug 1063130 - Load features from webcompat data

All feature names are treated as non-canonical English strings.  Import
is very slow due to incremental cache updates.

https://github.com/mozilla/web-platform-compat/commit/5fc44ba9e207448b9b070f5bc6ba476f6b0c4240
bug 1063130 - Add setting for instance cache

When USE_INSTANCE_CACHE is True, instances are loaded from the cache and
changes trigger cascading cache invalidation.  When USE_INSTANCE_CACHE
is False, instances are always loaded from the database and there is no
cache invalidation.  This is useful for bulk imports.

https://github.com/mozilla/web-platform-compat/commit/4862a328b09d8cb3de6ef291ceb714a04882d6d4
bug 1063130 - Update requirements

Django 1.6.7
memcache updates that are py3-friendly

https://github.com/mozilla/web-platform-compat/commit/d480e23e6406d507d4e6fe461ed3ebd4433c8cdd
bug 1063130 - Drop extended feature relations

Extended relations were causing representations to get huge.  Instead,
lean on views and eventually add JSON API's "include" functionality.
* Drop features.ancestors - clients can use view or follow parent
  relations with caching
* Drop features.siblings - clients can use children of parent item
* Drop features.descendants - clients can use view or follow chidren
  relations with caching

https://github.com/mozilla/web-platform-compat/commit/3dd019d80841779c2c0f8b2b9e6b63f8e9d58878
bug 1063130 - Install subset of features

Web compat project includes 3000+ features.  This makes the features
list API endpoint unusable, until pagination is in place.  For now, just
import the 57 CSS features starting with 'c', which gives a useful
working set.

https://github.com/mozilla/web-platform-compat/commit/95f1dfd1ff018333316333e0574917441d951a90
bug 1063130 - Use LocMemCache in tests

https://github.com/mozilla/web-platform-compat/commit/2e98992f1cd7c4d5541800e883ee4319814416f1
bug 1063130 - Add filtering by feature.parent

* /api/v1/features gives all features
* /api/v1/features?parent=1 gives children of feature #1
* /api/v1/features?parent= gives "root" features

https://github.com/mozilla/web-platform-compat/commit/4173464608cda50873a4ecc62331f08550e328bb
fixes bug 1063130 - Add basic feature browser