appengine/findit_copy/.tmp/coverage/appengine_findit_common_cache_decorator.html - Issue 2003423003: Merge branch 'blacklist_paths' into only_analyze_top_n_frames

Unified Diff: appengine/findit_copy/.tmp/coverage/appengine_findit_common_cache_decorator.html

Issue 2003423003: Merge branch 'blacklist_paths' into only_analyze_top_n_frames Base URL: https://chromium.googlesource.com/infra/infra.git@blacklist_paths

Patch Set: Created 4 years, 7 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View side-by-side diff with in-line comments

Download patch

« no previous file with comments | « appengine/findit_copy/.tmp/coverage/appengine_findit_common_buildbucket_client.html ('k') | appengine/findit_copy/.tmp/coverage/appengine_findit_common_change_log.html » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')

Index: appengine/findit_copy/.tmp/coverage/appengine_findit_common_cache_decorator.html

diff --git a/appengine/findit_copy/.tmp/coverage/appengine_findit_common_cache_decorator.html b/appengine/findit_copy/.tmp/coverage/appengine_findit_common_cache_decorator.html

new file mode 100644

index 0000000000000000000000000000000000000000..48d6604d48d70bb465394d1a5524eb2b6efac00d

--- /dev/null

+++ b/appengine/findit_copy/.tmp/coverage/appengine_findit_common_cache_decorator.html

@@ -0,0 +1,408 @@

+<!doctype html PUBLIC "-//W3C//DTD html 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">

+<html>

+<head>

+ <meta http-equiv='Content-Type' content='text/html; charset=utf-8'>

+ <meta http-equiv='X-UA-Compatible' content='IE=emulateIE7' />

+ <title>Coverage for appengine/findit/common/cache_decorator: 100%</title>

+ <link rel='stylesheet' href='style.css' type='text/css'>

+ <script type='text/javascript' src='jquery.min.js'></script>

+ <script type='text/javascript' src='jquery.hotkeys.js'></script>

+ <script type='text/javascript' src='jquery.isonscreen.js'></script>

+ <script type='text/javascript' src='coverage_html.js'></script>

+ <script type='text/javascript' charset='utf-8'>

+ jQuery(document).ready(coverage.pyfile_ready);

+ </script>

+</head>

+<body id='pyfile'>

+<div id='header'>

+ <div class='content'>

+ <h1>Coverage for appengine/findit/common/cache_decorator :

+ 100%

+ </h1>

+ <img id='keyboard_icon' src='keybd_closed.png'>

+ <h2 class='stats'>

+ 39 statements  

+ 39 run

+ 0 missing

+ 2 excluded

+ 0 partial

+ </h2>

+ </div>

+</div>

+<div class='help_panel'>

+ <img id='panel_icon' src='keybd_open.png'>

+Hot-keys on this page

+ <div>

+

+ r

+ m

+ x

+ p   toggle line displays

+

+

+ j

+ k   next/prev highlighted chunk

+

+

+ 0   (zero) top of page

+

+

+ 1   (one) first highlighted chunk

+

+ </div>

+</div>

+<div id='source'>

+ <table cellspacing='0' cellpadding='0'>

+ <tr>

+ <td class='linenos' valign='top'>

+<a href='#n1'>1</a>

+<a href='#n2'>2</a>

+<a href='#n3'>3</a>

+<a href='#n4'>4</a>

+<a href='#n5'>5</a>

+<a href='#n6'>6</a>

+<a href='#n7'>7</a>

+<a href='#n8'>8</a>

+<a href='#n9'>9</a>

+<a href='#n10'>10</a>

+<a href='#n11'>11</a>

+<a href='#n12'>12</a>

+<a href='#n13'>13</a>

+<a href='#n14'>14</a>

+<a href='#n15'>15</a>

+<a href='#n16'>16</a>

+<a href='#n17'>17</a>

+<a href='#n18'>18</a>

+<a href='#n19'>19</a>

+<a href='#n20'>20</a>

+<a href='#n21'>21</a>

+<a href='#n22'>22</a>

+<a href='#n23'>23</a>

+<a href='#n24'>24</a>

+<a href='#n25'>25</a>

+<a href='#n26'>26</a>

+<a href='#n27'>27</a>

+<a href='#n28'>28</a>

+<a href='#n29'>29</a>

+<a href='#n30'>30</a>

+<a href='#n31'>31</a>

+<a href='#n32'>32</a>

+<a href='#n33'>33</a>

+<a href='#n34'>34</a>

+<a href='#n35'>35</a>

+<a href='#n36'>36</a>

+<a href='#n37'>37</a>

+<a href='#n38'>38</a>

+<a href='#n39'>39</a>

+<a href='#n40'>40</a>

+<a href='#n41'>41</a>

+<a href='#n42'>42</a>

+<a href='#n43'>43</a>

+<a href='#n44'>44</a>

+<a href='#n45'>45</a>

+<a href='#n46'>46</a>

+<a href='#n47'>47</a>

+<a href='#n48'>48</a>

+<a href='#n49'>49</a>

+<a href='#n50'>50</a>

+<a href='#n51'>51</a>

+<a href='#n52'>52</a>

+<a href='#n53'>53</a>

+<a href='#n54'>54</a>

+<a href='#n55'>55</a>

+<a href='#n56'>56</a>

+<a href='#n57'>57</a>

+<a href='#n58'>58</a>

+<a href='#n59'>59</a>

+<a href='#n60'>60</a>

+<a href='#n61'>61</a>

+<a href='#n62'>62</a>

+<a href='#n63'>63</a>

+<a href='#n64'>64</a>

+<a href='#n65'>65</a>

+<a href='#n66'>66</a>

+<a href='#n67'>67</a>

+<a href='#n68'>68</a>

+<a href='#n69'>69</a>

+<a href='#n70'>70</a>

+<a href='#n71'>71</a>

+<a href='#n72'>72</a>

+<a href='#n73'>73</a>

+<a href='#n74'>74</a>

+<a href='#n75'>75</a>

+<a href='#n76'>76</a>

+<a href='#n77'>77</a>

+<a href='#n78'>78</a>

+<a href='#n79'>79</a>

+<a href='#n80'>80</a>

+<a href='#n81'>81</a>

+<a href='#n82'>82</a>

+<a href='#n83'>83</a>

+<a href='#n84'>84</a>

+<a href='#n85'>85</a>

+<a href='#n86'>86</a>

+<a href='#n87'>87</a>

+<a href='#n88'>88</a>

+<a href='#n89'>89</a>

+<a href='#n90'>90</a>

+<a href='#n91'>91</a>

+<a href='#n92'>92</a>

+<a href='#n93'>93</a>

+<a href='#n94'>94</a>

+<a href='#n95'>95</a>

+<a href='#n96'>96</a>

+<a href='#n97'>97</a>

+<a href='#n98'>98</a>

+<a href='#n99'>99</a>

+<a href='#n100'>100</a>

+<a href='#n101'>101</a>

+<a href='#n102'>102</a>

+<a href='#n103'>103</a>

+<a href='#n104'>104</a>

+<a href='#n105'>105</a>

+<a href='#n106'>106</a>

+<a href='#n107'>107</a>

+<a href='#n108'>108</a>

+<a href='#n109'>109</a>

+<a href='#n110'>110</a>

+<a href='#n111'>111</a>

+<a href='#n112'>112</a>

+<a href='#n113'>113</a>

+<a href='#n114'>114</a>

+<a href='#n115'>115</a>

+<a href='#n116'>116</a>

+<a href='#n117'>117</a>

+<a href='#n118'>118</a>

+<a href='#n119'>119</a>

+<a href='#n120'>120</a>

+<a href='#n121'>121</a>

+<a href='#n122'>122</a>

+<a href='#n123'>123</a>

+<a href='#n124'>124</a>

+<a href='#n125'>125</a>

+<a href='#n126'>126</a>

+<a href='#n127'>127</a>

+<a href='#n128'>128</a>

+<a href='#n129'>129</a>

+<a href='#n130'>130</a>

+<a href='#n131'>131</a>

+<a href='#n132'>132</a>

+<a href='#n133'>133</a>

+<a href='#n134'>134</a>

+<a href='#n135'>135</a>

+<a href='#n136'>136</a>

+<a href='#n137'>137</a>

+<a href='#n138'>138</a>

+<a href='#n139'>139</a>

+<a href='#n140'>140</a>

+<a href='#n141'>141</a>

+<a href='#n142'>142</a>

+<a href='#n143'>143</a>

+<a href='#n144'>144</a>

+<a href='#n145'>145</a>

+<a href='#n146'>146</a>

+<a href='#n147'>147</a>

+<a href='#n148'>148</a>

+<a href='#n149'>149</a>

+<a href='#n150'>150</a>

+<a href='#n151'>151</a>

+<a href='#n152'>152</a>

+<a href='#n153'>153</a>

+<a href='#n154'>154</a>

+<a href='#n155'>155</a>

+<a href='#n156'>156</a>

+<a href='#n157'>157</a>

+<a href='#n158'>158</a>

+<a href='#n159'>159</a>

+<a href='#n160'>160</a>

+<a href='#n161'>161</a>

+<a href='#n162'>162</a>

+ </td>

+ <td class='text' valign='top'>

+# Use of this source code is governed by a BSD-style license that can be

+# found in the LICENSE file.

+

+"""This module provides a decorator to cache the results of a function.

+

+  Examples:

+  1. Decorate a function:

+    @cache_decorator.Cached()

+    def Test(a):

+      return a + a

+

+    Test('a')

+    Test('a')  # Returns the cached 'aa'.

+

+  2. Decorate a method in a class:

+    class Downloader(object):

+      def __init__(self, url, retries):

+        self.url = url

+        self.retries = retries

+

+      @property

+      def identifier(self):

+        return self.url

+

+      @cache_decorator.Cached():

+      def Download(self, path):

+        return urllib2.urlopen(self.url + '/' + path).read()

+

+      d1 = Downloader('http://url', 4)

+      d1.Download('path')

+

+      d2 = Downloader('http://url', 5)

+      d2.Download('path')  # Returned the cached downloaded data.

+"""

+

+import functools

+import hashlib

+import inspect

+import pickle

+

+from google.appengine.api import memcache

+

+

+class Cacher(object):

+  """An interface to cache and retrieve data.

+

+  Subclasses should implement the Get/Set functions.

+  TODO: Add a Delete function (default to no-op) if needed later.

+  """

+  def Get(self, key):

+    """Returns the cached data for the given key if available.

+

+    Args:

+      key (str): The key to identify the cached data.

+    """

+    raise NotImplementedError()

+

+  def Set(self, key, data, expire_time=0):

+    """Cache the given data which is identified by the given key.

+

+    Args:

+      key (str): The key to identify the cached data.

+      data (object): The python object to be cached.

+      expire_time (int): Number of seconds from current time (up to 1 month).

+    """

+    raise NotImplementedError()

+

+

+class MemCacher(Cacher):

+  """An memcache-backed implementation of the interface Cacher.

+

+  The data to be cached should be pickleable.

+  """

+  def Get(self, key):

+    return memcache.get(key)

+

+  def Set(self, key, data, expire_time=0):

+    memcache.set(key, data, time=expire_time)

+

+

+def _DefaultKeyGenerator(func, args, kwargs):

+  """Generates a key from the function and arguments passed to it.

+

+  Args:

+    func (function): An abitrary function.

+    args (list): Positional arguments passed to ``func``.

+    kwargs (dict): Keyword arguments passed to ``func``.

+

+  Returns:

+    A string to represent a call to the given function with the given arguments.

+  """

+  params = inspect.getcallargs(func, *args, **kwargs)

+  for var_name in params:

+    if not hasattr(params[var_name], 'identifier'):

+      continue

+

+    if callable(params[var_name].identifier):

+      params[var_name] = params[var_name].identifier()

+    else:

+      params[var_name] = params[var_name].identifier

+

+  return hashlib.md5(pickle.dumps(params)).hexdigest()

+

+

+def Cached(namespace=None,

+           expire_time=0,

+           key_generator=_DefaultKeyGenerator,

+           cacher=MemCacher()):

+  """Returns a decorator to cache the decorated function's results.

+

+  However, if the function returns None, empty list/dict, empty string, or other

+  value that is evaluated as False, the results won't be cached.

+

+  This decorator is to cache results of different calls to the decorated

+  function, and avoid executing it again if the calls are equivalent. Two calls

+  are equivalent, if the namespace is the same and the keys generated by the

+  ``key_generator`` are the same.

+

+  The usage of this decorator requires that:

+  - If the default key generator is used, parameters passed to the decorated

+    function should be pickleable, or each of the parameter has an identifier

+    property or method which returns pickleable results.

+  - If the default cacher is used, the returned results of the decorated

+    function should be pickleable.

+

+  Args:

+    namespace (str): A prefix to the key for the cache. Default to the

+        combination of module name and function name of the decorated function.

+    expire_time (int): Expiration time, relative number of seconds from current

+        time (up to 1 month). Defaults to 0 -- never expire.

+    key_generator (function): A function to generate a key to represent a call

+        to the decorated function. Defaults to :func:`_DefaultKeyGenerator`.

+    cacher (Cacher): An instance of an implementation of interface `Cacher`.

+        Defaults to one of `MemCacher` which is based on memcache.

+

+  Returns:

+    The cached results or the results of a new run of the decorated function.

+  """

+  def GetPrefix(func, namespace):

+    return namespace or '%s.%s' % (func.__module__, func.__name__)

+

+  def Decorator(func):

+    """Decorator to cache a function's results."""

+    @functools.wraps(func)

+    def Wrapped(*args, **kwargs):

+      prefix = GetPrefix(func, namespace)

+      key = '%s-%s' % (prefix, key_generator(func, args, kwargs))

+

+      result = cacher.Get(key)

+      if result is not None:

+        return result

+

+      result = func(*args, **kwargs)

+      if result:

+        cacher.Set(key, result, expire_time=expire_time)

+

+      return result

+

+    return Wrapped

+

+  return Decorator

+ </td>

+ </tr>

+ </table>

+</div>

+<div id='footer'>

+ <div class='content'>

+

+ <a class='nav' href='index.html'>« index</a>     <a class='nav' href='http://nedbatchelder.com/code/coverage'>coverage.py v3.7.1</a>

+

+ </div>

+</div>

+</body>

+</html>