CSS: 'CSS',

WEBCOMPONENTS: 'Web Components',

MISC: 'Misc',

SECURITY: 'Security',

MULTIMEDIA: 'Multimedia',

DOM: 'DOM',

FILE: 'File APIs',

OFFLINE: 'Offline / Storage',

DEVICE: 'Device',

COMMUNICATION: 'Realtime / Communication',

JAVASCRIPT: 'JavaScript',

NETWORKING: 'Network / Connectivity',

INPUT: 'User input',

PERFORMANCE: 'Performance',

GRAPHICS: 'Graphics',

NO_ACTIVE_DEV: 'No active development',

PROPOSED: 'Proposed',

IN_DEVELOPMENT: 'In development',

BEHIND_A_FLAG: 'Behind a flag',

ENABLED_BY_DEFAULT: 'Enabled by default',

DEPRECATED: 'Deprecated',

REMOVED: 'Removed',

NO_LONGER_PURSUING: 'No longer pursuing',

MAJOR_NEW_API: ('A major new independent API (e.g. adding a large # '

'independent concepts with many methods/properties/objects)'),

MAJOR_MINOR_NEW_API: ('Major changes to an existing API OR a minor new '

'independent API (e.g. adding a large # of new '

'methods/properties or introducing new concepts to '

'augment an existing API)'),

SUBSTANTIVE_CHANGES: ('Substantive changes to an existing API (e.g. small '

'number of new methods/properties)'),

MINOR_EXISTING_CHANGES: (

'Minor changes to an existing API (e.g. adding a new keyword/allowed '

'argument to a property/method)'),

EXTREMELY_SMALL_CHANGE: ('Extremely small tweaks to an existing API (e.g. '

'how existing keywords/arguments are interpreted)'),

MAINSTREAM_NEWS: 'Likely in mainstream tech news',

WARRANTS_ARTICLE: 'Will this feature generate articles on sites like html5rocks.com',

IN_LARGER_ARTICLE: 'Covered as part of a larger article but not on its own',

SMALL_NUM_DEVS: 'Only a very small number of web developers will care about',

SUPER_SMALL: "So small it doesn't need to be covered in this dashboard.",

SHIPPED: 'Shipped',

IN_DEV: 'In development',

PUBLIC_SUPPORT: 'Public support',

MIXED_SIGNALS: 'Mixed public signals',

NO_PUBLIC_SIGNALS: 'No public signals',

PUBLIC_SKEPTICISM: 'Public skepticism',

OPPOSED: 'Opposed',

DEFACTO_STD: 'De-facto standard',

ESTABLISHED_STD: 'Established standard',

WORKING_DRAFT: 'Working draft or equivalent',

EDITORS_DRAFT: "Editor's draft",

PUBLIC_DISCUSSION: 'Public discussion',

NO_STD_OR_DISCUSSION: 'No public standards discussion',

DEV_STRONG_POSITIVE: 'Strongly positive',

DEV_POSITIVE: 'Positive',

DEV_MIXED_SIGNALS: 'Mixed signals',

DEV_NO_SIGNALS: 'No signals',

DEV_NEGATIVE: 'Negative',

DEV_STRONG_NEGATIVE: 'Strongly negative',

# def to_dict(self):

# return dict([(p, unicode(getattr(self, p))) for p in self.properties()])

def format_for_template(self):

return self.to_dict()

def to_dict(self):

output = {}

for key, prop in self.properties().iteritems():

value = getattr(self, key)

if value is None or isinstance(value, SIMPLE_TYPES):

output[key] = value

elif isinstance(value, datetime.date):

# Convert date/datetime to ms-since-epoch ("new Date()").

#ms = time.mktime(value.utctimetuple())

#ms += getattr(value, 'microseconds', 0) / 1000

#output[key] = int(ms)

output[key] = unicode(value)

elif isinstance(value, db.GeoPt):

output[key] = {'lat': value.lat, 'lon': value.lon}

elif isinstance(value, db.Model):

output[key] = to_dict(value)

elif isinstance(value, users.User):

output[key] = value.email()

else:

raise ValueError('cannot encode ' + repr(prop))

created = db.DateTimeProperty(auto_now_add=True)

updated = db.DateTimeProperty(auto_now=True)

property_name = db.StringProperty(required=True)

bucket_id = db.IntegerProperty(required=True)

date = db.DateProperty(verbose_name='When the data was fetched',

required=True)

#hits = db.IntegerProperty(required=True)

#total_pages = db.IntegerProperty()

day_percentage = db.FloatProperty()

"""Container for a feature."""

DEFAULT_MEMCACHE_KEY = '%s|features' % (settings.MEMCACHE_KEY_PREFIX)

def format_for_template(self):

d = self.to_dict()

d['id'] = self.key().id()

d['category'] = FEATURE_CATEGORIES[self.category]

d['visibility'] = VISIBILITY_CHOICES[self.visibility]

d['impl_status_chrome'] = IMPLEMENTATION_STATUS[self.impl_status_chrome]

d['meta'] = {

'needsflag': self.impl_status_chrome == BEHIND_A_FLAG,

'milestone_str': self.shipped_milestone or d['impl_status_chrome']

}

d['ff_views'] = {'value': self.ff_views,

'text': VENDOR_VIEWS[self.ff_views]}

d['ie_views'] = {'value': self.ie_views,

'text': VENDOR_VIEWS[self.ie_views]}

d['safari_views'] = {'value': self.safari_views,

'text': VENDOR_VIEWS[self.safari_views]}

d['standardization'] = {'value': self.standardization,

'text': STANDARDIZATION[self.standardization]}

d['web_dev_views'] = {'value': self.web_dev_views,

'text': WEB_DEV_VIEWS[self.web_dev_views]}

#d['owner'] = ', '.join(self.owner)

return d

def format_for_edit(self):

d = self.to_dict()

#d['id'] = self.key().id

d['owner'] = ', '.join(self.owner)

d['doc_links'] = ', '.join(self.doc_links)

d['sample_links'] = ', '.join(self.sample_links)

d['search_tags'] = ', '.join(self.search_tags)

return d

@classmethod

def get_all(self, limit=None, order='-updated', filterby=None,

update_cache=False):

KEY = '%s|%s|%s' % (Feature.DEFAULT_MEMCACHE_KEY, order, limit)

# TODO(ericbidelman): Support more than one filter.

if filterby is not None:

s = ('%s%s' % (filterby[0], filterby[1])).replace(' ', '')

KEY += '|%s' % s

feature_list = memcache.get(KEY)

if feature_list is None or update_cache:

query = Feature.all().order(order) #.order('name')

# TODO(ericbidelman): Support more than one filter.

if filterby:

query.filter(filterby[0], filterby[1])

features = query.fetch(limit)

feature_list = [f.format_for_template() for f in features]

memcache.set(KEY, feature_list)

return feature_list

@classmethod

def get_all_with_statuses(self, statuses, update_cache=False):

if not statuses:

return []

KEY = '%s|%s' % (Feature.DEFAULT_MEMCACHE_KEY, sorted(statuses))

feature_list = memcache.get(KEY)

if feature_list is None or update_cache:

# There's no way to do an OR in a single datastore query, and there's a

# very good chance that the self.get_all() results will already be in

# memcache, so use an array comprehension to grab the features we

# want from the array of everything.

feature_list = [feature for feature in self.get_all(update_cache=update_cache)

if feature['impl_status_chrome'] in statuses]

memcache.set(KEY, feature_list)

return feature_list

@classmethod

def get_feature(self, feature_id, update_cache=False):

KEY = '%s|%s' % (Feature.DEFAULT_MEMCACHE_KEY, feature_id)

feature = memcache.get(KEY)

if feature is None or update_cache:

unformatted_feature = Feature.get_by_id(feature_id)

if unformatted_feature:

feature = unformatted_feature.format_for_template()

feature['updated_display'] = unformatted_feature.updated.strftime("%Y-%m-%d")

memcache.set(KEY, feature)

return feature

@classmethod

def get_chronological(self, limit=None, update_cache=False):

KEY = '%s|%s|%s' % (Feature.DEFAULT_MEMCACHE_KEY, 'cronorder', limit)

feature_list = memcache.get(KEY)

if feature_list is None or update_cache:

q = Feature.all()

q.order('-shipped_milestone')

q.order('name')

features = q.fetch(None)

features = [f for f in features if (IN_DEVELOPMENT < f.impl_status_chrome < NO_LONGER_PURSUING)]

# Append no active, in dev, proposed features.

q = Feature.all()

q.order('impl_status_chrome')

q.order('name')

q.filter('impl_status_chrome <=', IN_DEVELOPMENT)

pre_release = q.fetch(None)

pre_release.extend(features)

# Append no longer pursuing features.

q = Feature.all()

q.order('impl_status_chrome')

q.order('name')

q.filter('impl_status_chrome =', NO_LONGER_PURSUING)

no_longer_pursuing = q.fetch(None)

pre_release.extend(no_longer_pursuing)

feature_list = [f.format_for_template() for f in pre_release]

memcache.set(KEY, feature_list)

return feature_list

@classmethod

def get_shipping_samples(self, limit=None, update_cache=False):

KEY = '%s|%s|%s' % (Feature.DEFAULT_MEMCACHE_KEY, 'samples', limit)

feature_list = memcache.get(KEY)

if feature_list is None or update_cache:

# Get all shipping features. Ordered by shipping milestone (latest first).

q = Feature.all()

q.filter('impl_status_chrome =', ENABLED_BY_DEFAULT)

q.order('-impl_status_chrome')

q.order('-shipped_milestone')

q.order('name')

features = q.fetch(None)

# Get non-shipping features (sans removed or deprecated ones) and

# append to bottom of list.

q = Feature.all()

q.filter('impl_status_chrome <', ENABLED_BY_DEFAULT)

q.order('-impl_status_chrome')

q.order('-shipped_milestone')

q.order('name')

others = q.fetch(None)

features.extend(others)

# Filter out features without sample links.

feature_list = [f.format_for_template() for f in features

if len(f.sample_links)]

memcache.set(KEY, feature_list)

return feature_list

# Metadata.

created = db.DateTimeProperty(auto_now_add=True)

updated = db.DateTimeProperty(auto_now=True)

updated_by = db.UserProperty(auto_current_user=True)

created_by = db.UserProperty(auto_current_user_add=True)

# General info.

category = db.IntegerProperty(required=True)

name = db.StringProperty(required=True)

summary = db.StringProperty(required=True, multiline=True)

# Chromium details.

bug_url = db.LinkProperty()

impl_status_chrome = db.IntegerProperty(required=True)

shipped_milestone = db.IntegerProperty()

shipped_android_milestone = db.IntegerProperty()

shipped_ios_milestone = db.IntegerProperty()

shipped_webview_milestone = db.IntegerProperty()

shipped_opera_milestone = db.IntegerProperty()

shipped_opera_android_milestone = db.IntegerProperty()

owner = db.ListProperty(db.Email)

footprint = db.IntegerProperty()

visibility = db.IntegerProperty(required=True)

#webbiness = db.IntegerProperty() # TODO: figure out what this is

# Standards details.

standardization = db.IntegerProperty(required=True)

spec_link = db.LinkProperty()

prefixed = db.BooleanProperty()

ff_views = db.IntegerProperty(required=True, default=NO_PUBLIC_SIGNALS)

ie_views = db.IntegerProperty(required=True, default=NO_PUBLIC_SIGNALS)

safari_views = db.IntegerProperty(required=True, default=NO_PUBLIC_SIGNALS)

ff_views_link = db.LinkProperty()

ie_views_link = db.LinkProperty()

safari_views_link = db.LinkProperty()

# Web dev details.

web_dev_views = db.IntegerProperty(required=True)

doc_links = db.StringListProperty()

sample_links = db.StringListProperty()

#tests = db.StringProperty()

search_tags = db.StringListProperty()

def __init__(self, *args, **kwargs):

#super(forms.CharField, self).__init__(*args, **kwargs)

attrs = {}

if kwargs.get('placeholder'):

attrs['placeholder'] = kwargs.get('placeholder')

del kwargs['placeholder']

label = kwargs.get('label') or ''

if label:

del kwargs['label']

self.max_length = kwargs.get('max_length') or None

super(forms.CharField, self).__init__(label=label,

SHIPPED_HELP_TXT = ('First milestone the feature shipped with this status '

'(either enabled by default, experimental, or deprecated)')

#name = PlaceholderCharField(required=True, placeholder='Feature name')

name = forms.CharField(required=True, label='Feature')

summary = forms.CharField(label='', required=True, max_length=500,

widget=forms.Textarea(attrs={'cols': 50, 'placeholder': 'Summary description', 'maxlength': 500}))

# owner = PlaceholderCharField(

# required=False, placeholder='Owner(s) email',

# help_text='Comma separated list of full email addresses (@chromium.org preferred).')

category = forms.ChoiceField(required=True,

choices=FEATURE_CATEGORIES.items())

owner = forms.CharField(

required=False, label='Owner(s) email',

help_text='Comma separated list of full email addresses. Prefer @chromium.org.')

bug_url = forms.URLField(required=False, label='Bug URL',

help_text='OWP Launch Tracking, crbug, etc.')

impl_status_chrome = forms.ChoiceField(required=True,

label='Status in Chrome',

choices=IMPLEMENTATION_STATUS.items())

#shipped_milestone = PlaceholderCharField(required=False,

# placeholder='First milestone the feature shipped with this status (either enabled by default or experimental)')

shipped_milestone = forms.IntegerField(required=False, label='',

help_text='Chrome for desktop: ' + SHIPPED_HELP_TXT)

shipped_android_milestone = forms.IntegerField(required=False, label='',

help_text='Chrome for Android: ' + SHIPPED_HELP_TXT)

shipped_ios_milestone = forms.IntegerField(required=False, label='',

help_text='Chrome for iOS: ' + SHIPPED_HELP_TXT)

shipped_webview_milestone = forms.IntegerField(required=False, label='',

help_text='Chrome for Android web view: ' + SHIPPED_HELP_TXT)

shipped_opera_milestone = forms.IntegerField(required=False, label='',

help_text='Opera for desktop: ' + SHIPPED_HELP_TXT)

shipped_opera_android_milestone = forms.IntegerField(required=False, label='',

help_text='Opera for Android: ' + SHIPPED_HELP_TXT)

prefixed = forms.BooleanField(

required=False, initial=False, label='Prefixed?')

standardization = forms.ChoiceField(

label='Standardization', choices=STANDARDIZATION.items(),

initial=EDITORS_DRAFT,

help_text=("The standardization status of the API. In bodies that don't "

"use this nomenclature, use the closest equivalent."))

spec_link = forms.URLField(required=False, label='Spec link',

help_text="Prefer editor's draft.")

doc_links = forms.CharField(label='Doc links', required=False, max_length=500,

widget=forms.Textarea(attrs={'cols': 50, 'placeholder': 'Links to documentation (comma separated)', 'maxlength': 500}),

help_text='Comma separated URLs')

sample_links = forms.CharField(label='Samples links', required=False, max_length=500,

widget=forms.Textarea(attrs={'cols': 50, 'placeholder': 'Links to samples (comma separated)', 'maxlength': 500}),

help_text='Comma separated URLs')

footprint = forms.ChoiceField(label='Technical footprint',

choices=FOOTPRINT_CHOICES.items(),

initial=MAJOR_MINOR_NEW_API)

visibility = forms.ChoiceField(

label='Developer visibility',

choices=VISIBILITY_CHOICES.items(),

initial=WARRANTS_ARTICLE,

help_text=('How much press / media / web developer buzz will this '

'feature generate?'))

web_dev_views = forms.ChoiceField(

label='Web developer views',

choices=WEB_DEV_VIEWS.items(),

initial=DEV_NO_SIGNALS,

help_text=('How positive has the reaction from developers been? If '

'unsure, default to "No signals".'))

safari_views = forms.ChoiceField(label='Safari views',

choices=VENDOR_VIEWS.items(),

initial=NO_PUBLIC_SIGNALS)

safari_views_link = forms.URLField(required=False, label='',

help_text='Citation link.')

ff_views = forms.ChoiceField(label='Firefox views',

choices=VENDOR_VIEWS.items(),

initial=NO_PUBLIC_SIGNALS)

ff_views_link = forms.URLField(required=False, label='',

help_text='Citation link.')

ie_views = forms.ChoiceField(label='Edge',

choices=VENDOR_VIEWS.items(),

initial=NO_PUBLIC_SIGNALS)

ie_views_link = forms.URLField(required=False, label='',

help_text='Citation link.')

search_tags = forms.CharField(label='Search tags', required=False,

help_text='Comma separated keywords used only in search')

comments = forms.CharField(label='', required=False, max_length=500, widget=forms.Textarea(

attrs={'cols': 50, 'placeholder': 'Additional comments, caveats, info...', 'maxlength': 500}))

class Meta:

model = Feature

#exclude = ('shipped_webview_milestone',)

def __init__(self, *args, **keyargs):

super(FeatureForm, self).__init__(*args, **keyargs)

meta = getattr(self, 'Meta', None)

exclude = getattr(meta, 'exclude', [])

for field_name in exclude:

if field_name in self.fields:

del self.fields[field_name]

for field, val in self.fields.iteritems():

if val.required:

"""Describes a user for whitelisting."""

#user = db.UserProperty(required=True, verbose_name='Google Account')

email = db.EmailProperty(required=True)

#is_admin = db.BooleanProperty(default=False)

created = db.DateTimeProperty(auto_now_add=True)

updated = db.DateTimeProperty(auto_now=True)

def format_for_template(self):

d = self.to_dict()

d['id'] = self.key().id()

"""Container for a histogram."""

bucket_id = db.IntegerProperty(required=True)

property_name = db.StringProperty(required=True)

@classmethod

def get_all(self):

output = {}

buckets = self.all().fetch(None)

for bucket in buckets:

output[bucket.bucket_id] = bucket.property_name