Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
executable file 273 lines (208 sloc) 7.41 KB
# Copyright (C) 2009 Google Inc.
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# See the License for the specific language governing permissions and
# limitations under the License.
"""Utility library containing various helpers used by the API.
Contains miscellaneous functions used internally by the API.
__author__ = ' (David Byttow)'
import document
def IsIterable(inst):
"""Returns whether or not this is a list, tuple, set or dict .
Note that this does not return true for strings.
return hasattr(inst, '__iter__')
def IsDict(inst):
"""Returns whether or not the specified instance is a dict."""
return hasattr(inst, 'iteritems')
def IsUserDefinedNewStyleClass(obj):
"""Returns whether or not the specified instance is a user-defined type."""
# NOTE(davidbyttow): This seems like a reasonably safe hack for now...
# I'm not exactly sure how to test if something is a subclass of object.
# And no, "is InstanceType" does not work here. :(
return type(obj).__module__ != '__builtin__'
def CollapseJavaCollections(data):
"""Collapses the unnecessary extra data structures in the wire format.
Currently the wire format is built from marshalling of Java objects. This
introduces overhead of extra key/value pairs with respect to collections and
superfluous fields. As such, this method attempts to collapse those structures
out of the data format by collapsing the collection objects and removing
the java class fields.
This preserves the data that is passed in and only removes the collection
data: Some arbitrary dict, list or primitive type.
The same data structure with the collapsed and unnecessary objects
if IsDict(data):
java_class = data.get('javaClass')
if java_class:
del data['javaClass']
if java_class == 'java.util.HashMap':
return CollapseJavaCollections(data['map'])
elif java_class == 'java.util.ArrayList':
return CollapseJavaCollections(data['list'])
for key, val in data.iteritems():
data[key] = CollapseJavaCollections(val)
elif IsIterable(data):
for index in range(len(data)):
data[index] = CollapseJavaCollections(data[index])
return data
def ToLowerCamelCase(s):
"""Converts a string to lower camel case.
foo => foo
foo_bar => fooBar
foo__bar => fooBar
foo_bar_baz => fooBarBaz
s: The string to convert to lower camel case.
The lower camel cased string.
return reduce(lambda a, b: a + (a and b.capitalize() or b), s.split('_'))
def ToUpperCamelCase(s):
"""Converts a string to upper camel case.
foo => Foo
foo_bar => FooBar
foo__bar => FooBar
foo_bar_baz => FooBarBaz
s: The string to convert to upper camel case.
The upper camel cased string.
return ''.join(fragment.capitalize() for fragment in s.split('_'))
def DefaultKeyWriter(key_name):
"""This key writer rewrites keys as lower camel case.
Expects that the input is formed by '_' delimited words.
key_name: Name of the key to serialize.
Key name in lower camel-cased form.
return ToLowerCamelCase(key_name)
def _SerializeAttributes(obj, key_writer=DefaultKeyWriter):
"""Serializes attributes of an instance.
Iterates all attributes of an object and invokes serialize if they are
public and not callable.
obj: The instance to serialize.
key_writer: Optional function that takes a string key and optionally mutates
it before serialization. For example:
def randomize(key_name):
return key_name += str(random.random())
The serialized object.
data = {}
for attr_name in dir(obj):
if attr_name.startswith('_'):
attr = getattr(obj, attr_name)
if attr is None or callable(attr):
# Looks okay, serialize it.
data[key_writer(attr_name)] = Serialize(attr)
return data
def _SerializeList(l):
"""Invokes Serialize on all of its elements.
l: The list object to serialize.
The serialized list.
data = [Serialize(v) for v in l]
return {
'javaClass': 'java.util.ArrayList',
'list': data
def _SerializeDict(d, key_writer=DefaultKeyWriter):
"""Invokes serialize on all of its key/value pairs.
d: The dict instance to serialize.
key_writer: Optional key writer function.
The serialized dict.
data = {}
for k, v in d.iteritems():
data[key_writer(k)] = Serialize(v)
return {
'javaClass': 'java.util.HashMap',
'map': data
def Serialize(obj, key_writer=DefaultKeyWriter):
"""Serializes any instance.
If this is a user-defined instance
type, it will first check for a custom Serialize() function and use that
if it exists. Otherwise, it will invoke serialize all of its public
attributes. Lists and dicts are serialized trivially.
obj: The instance to serialize.
key_writer: Optional key writer function.
The serialized object.
if IsUserDefinedNewStyleClass(obj):
if obj and hasattr(obj, CUSTOM_SERIALIZE_METHOD_NAME):
method = getattr(obj, CUSTOM_SERIALIZE_METHOD_NAME)
if callable(method):
return method()
return _SerializeAttributes(obj, key_writer)
elif IsDict(obj):
return _SerializeDict(obj, key_writer)
elif IsIterable(obj):
return _SerializeList(obj)
return obj
class StringEnum(object):
"""Enum like class that is configured with a list of values.
This class effectively implements an enum for Elements, except for that
the actual values of the enums will be the string values."""
def __init__(self, *values):
for name in values:
setattr(self, name, name)
def ClipRange(r, clip_range):
"""Clips one range to another.
Given a range to be clipped and a clipping range, will result in a list
of 0-2 new ranges. If the range is completely inside of the clipping range
then an empty list will be returned. If it is completely outside, then
a list with only the same range will be returned.
Otherwise, other permutations may result in a single clipped range or
two ranges that were the result of a split.
r: The range to be clipped.
clip_range: The range that is clipping the other.
A list of 0-2 ranges as a result of performing the clip.
# Check if completely outside the clipping range.
if r.end <= clip_range.start or r.start >= clip_range.end:
return [r]
# Check if completely clipped.
if r.start >= clip_range.start and r.end <= clip_range.end:
return []
# Check if split.
if clip_range.start > r.start and clip_range.end < r.end:
return [document.Range(r.start, clip_range.start),
document.Range(clip_range.end, r.end)]
# Check if start trimmed.
if clip_range.start <= r.start:
return [document.Range(clip_range.end, r.end)]
# End is trimmed.
return [document.Range(r.start, clip_range.start)]
Jump to Line
Something went wrong with that request. Please try again.