:param filenode:

    """

    color_dict = {}

    def gen_color():

        """generator for getting 10k of evenly distibuted colors using hsv color

        and golden ratio.

        """

        import colorsys

        n = 10000

        golden_ratio = 0.618033988749895

        h = 0.22717784590367374

        #generate 10k nice web friendly colors in the same order

        for c in xrange(n):

            h += golden_ratio

            h %= 1

            HSV_tuple = [h, 0.95, 0.95]

            RGB_tuple = colorsys.hsv_to_rgb(*HSV_tuple)

            yield map(lambda x:str(int(x * 256)), RGB_tuple)

    cgenerator = gen_color()

    def get_color_string(cs):

        if color_dict.has_key(cs):

            col = color_dict[cs]

        else:

            col = color_dict[cs] = cgenerator.next()

        return "color: rgb(%s)! important;" % (', '.join(col))

    def url_func(changeset):

        tooltip_html = "<div style='font-size:0.8em'><b>Author:</b>" + \

        " %s<br/><b>Date:</b> %s</b><br/><b>Message:</b> %s<br/></div>"

        tooltip_html = tooltip_html % (changeset.author,

                                               changeset.date,

                                               tooltip(changeset.message))

        lnk_format = '%5s:%s' % ('r%s' % changeset.revision,

                                 short_id(changeset.raw_id))

        uri = link_to(

                lnk_format,

                url('changeset_home', repo_name=changeset.repository.name,

                    revision=changeset.raw_id),

                style=get_color_string(changeset.raw_id),

                class_='tooltip',

                tooltip_title=tooltip_html

              )

        uri += '\n'

        return uri

    return literal(annotate_highlight(filenode, url_func, **kwargs))

def repo_name_slug(value):

    """Return slug of name of repository

    This function is called on each creation/modification

    of repository to prevent bad names in repo

    """

    slug = remove_formatting(value)

    slug = strip_tags(slug)

    for c in """=[]\;'"<>,/~!@#$%^&*()+{}|: """:

        slug = slug.replace(c, '-')

    slug = recursive_replace(slug, '-')

    slug = collapse(slug, '-')

    return slug

def get_changeset_safe(repo, rev):

    from vcs.backends.base import BaseRepository

    from vcs.exceptions import RepositoryError

    if not isinstance(repo, BaseRepository):

        raise Exception('You must pass an Repository '

                        'object as first argument got %s', type(repo))

    try:

        cs = repo.get_changeset(rev)

    except RepositoryError:

        from rhodecode.lib.utils import EmptyChangeset

        cs = EmptyChangeset()

    return cs

flash = _Flash()

#==============================================================================

# MERCURIAL FILTERS available via h.

#==============================================================================

from mercurial import util

from mercurial.templatefilters import person as _person

def _age(curdate):

    """turns a datetime into an age string."""

    if not curdate:

        return ''

    from datetime import timedelta, datetime

    agescales = [("year", 3600 * 24 * 365),

                 ("month", 3600 * 24 * 30),

                 ("day", 3600 * 24),

                 ("hour", 3600),

                 ("minute", 60),

                 ("second", 1), ]

    age = datetime.now() - curdate

    age_seconds = (age.days * agescales[2][1]) + age.seconds

    pos = 1

    for scale in agescales:

        if scale[1] <= age_seconds:

            if pos == 6:pos = 5

            return time_ago_in_words(curdate, agescales[pos][0]) + ' ' + _('ago')

        pos += 1

    return _('just now')

age = lambda  x:_age(x)

capitalize = lambda x: x.capitalize()

email = util.email

email_or_none = lambda x: util.email(x) if util.email(x) != x else None

person = lambda x: _person(x)

short_id = lambda x: x[:12]

def bool2icon(value):

    """

    Returns True/False values represented as small html image of true/false

    icons

    :param value: bool value

    """

    if value is True:

        return HTML.tag('img', src="/images/icons/accept.png", alt=_('True'))

    if value is False:

        return HTML.tag('img', src="/images/icons/cancel.png", alt=_('False'))

    return value

def action_parser(user_log):

    """

    This helper will map the specified string action into translated

    fancy names with icons and links

    @param action:

    """

    action = user_log.action

    action_params = None

    x = action.split(':')

    if len(x) > 1:

        action, action_params = x

    def get_cs_links():

        if action == 'push':

            revs_limit = 5

            revs = action_params.split(',')

            cs_links = " " + ', '.join ([link(rev,

                    url('changeset_home',

                    repo_name=user_log.repository.repo_name,

                    revision=rev)) for rev in revs[:revs_limit] ])

            if len(revs) > revs_limit:

                html_tmpl = '<span title="%s"> %s </span>'

                cs_links += html_tmpl % (', '.join(r for r in revs[revs_limit:]),

                                         _('and %s more revisions') \

                                            % (len(revs) - revs_limit))

            return literal(cs_links)

        return ''

    def get_fork_name():

        if action == 'user_forked_repo':

            from rhodecode.model.scm import ScmModel

            repo_name = action_params

            repo = ScmModel().get(repo_name)

            if repo is None:

                return repo_name

            return link_to(action_params, url('summary_home',

                                              repo_name=repo.name,),

                                              title=repo.dbrepo.description)

        return ''

    map = {'user_deleted_repo':_('User [deleted] repository'),

           'user_created_repo':_('User [created] repository'),

           'user_forked_repo':_('User [forked] repository as: ') + get_fork_name(),

           'user_updated_repo':_('User [updated] repository'),

           'admin_deleted_repo':_('Admin [delete] repository'),

           'admin_created_repo':_('Admin [created] repository'),

           'admin_forked_repo':_('Admin [forked] repository'),

           'admin_updated_repo':_('Admin [updated] repository'),

           'started_following_repo':_('User [started following] repository'),

           'stopped_following_repo':_('User [stopped following] repository'),

            }

    action_str = map.get(action, action)

#==============================================================================

# PERMS

#==============================================================================

from rhodecode.lib.auth import HasPermissionAny, HasPermissionAll, \

HasRepoPermissionAny, HasRepoPermissionAll

#==============================================================================

# GRAVATAR URL

#==============================================================================

import hashlib

import urllib

from pylons import request

def gravatar_url(email_address, size=30):

    ssl_enabled = 'https' == request.environ.get('HTTP_X_URL_SCHEME')

    default = 'identicon'

    baseurl_nossl = "http://www.gravatar.com/avatar/"

    baseurl_ssl = "https://secure.gravatar.com/avatar/"

    baseurl = baseurl_ssl if ssl_enabled else baseurl_nossl

    # construct the url

    gravatar_url = baseurl + hashlib.md5(email_address.lower()).hexdigest() + "?"

    gravatar_url += urllib.urlencode({'d':default, 's':str(size)})

    return gravatar_url

def safe_unicode(str):

    """safe unicode function. In case of UnicodeDecode error we try to return

    unicode with errors replace, if this failes we return unicode with 

    string_escape decoding """

    try:

        u_str = unicode(str)

    except UnicodeDecodeError:

        try:

            u_str = unicode(str, 'utf-8', 'replace')

        except UnicodeDecodeError:

            #incase we have a decode error just represent as byte string

            u_str = unicode(str(str).encode('string_escape'))

    return u_str

height:20px;

font-size:1.1em;

font-weight:700;

text-align:left;

padding-left:10px;

}

table.code-browser tbody td {

padding-left:10px;

height:20px;

}

table.code-browser .browser-file {

background:url("../images/icons/document_16.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

text-align:left;

}

table.code-browser .browser-dir {

background:url("../images/icons/folder_16.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

text-align:left;

}

.box .search {

clear:both;

overflow:hidden;

margin:0;

padding:0 20px 10px;

}

.box .search div.search_path {

background:none repeat scroll 0 0 #EEE;

border:1px solid #CCC;

color:blue;

margin-bottom:10px;

padding:10px 0;

}

.box .search div.search_path div.link {

font-weight:700;

margin-left:25px;

}

.box .search div.search_path div.link a {

color:#003367;

cursor:pointer;

text-decoration:none;

}

#path_unlock {

color:red;

font-size:1.2em;

padding-left:4px;

}

.info_box * {

background:url("../../images/pager.png") repeat-x scroll 0 0 #EBEBEB;

color:#4A4A4A;

font-weight:700;

height:1%;

display:inline;

border-color:#DEDEDE #C4C4C4 #C4C4C4 #CFCFCF;

border-style:solid;

border-width:1px;

padding:4px 6px;

}

.info_box span {

margin-left:3px;

margin-right:3px;

}

.info_box input#at_rev {

text-align:center;

padding:5px 3px 3px 2px;

}

.info_box input#view {

text-align:center;

padding:4px 3px 2px 2px;

}

.yui-overlay,.yui-panel-container {

visibility:hidden;

position:absolute;

z-index:2;

}

.yui-tt {

visibility:hidden;

position:absolute;

color:#666;

background-color:#FFF;

font-family:arial, helvetica, verdana, sans-serif;

border:2px solid #003367;

font:100% sans-serif;

width:auto;

opacity:1px;

padding:8px;

white-space: pre;

}

.ac {

vertical-align:top;

}

.ac .yui-ac {

position:relative;

font-family:arial;

font-size:100%;

}

.ac .perm_ac {

width:15em;

}

.ac .yui-ac-input {

width:100%;

}

.ac .yui-ac-container {

position:absolute;

top:1.6em;

width:100%;

}

.ac .yui-ac-content {

position:absolute;

width:100%;

border:1px solid gray;

background:#fff;

overflow:hidden;

z-index:9050;

}

.ac .yui-ac-shadow {

position:absolute;

width:100%;

background:#000;

-moz-opacity:0.1px;

opacity:.10;

filter:alpha(opacity =   10);

z-index:9049;

margin:.3em;

}

.ac .yui-ac-content ul {

width:100%;

margin:0;

padding:0;

}

.ac .yui-ac-content li {

cursor:default;

white-space:nowrap;

margin:0;

padding:2px 5px;

}

.ac .yui-ac-content li.yui-ac-prehighlight {

background:#B3D4FF;

}

.ac .yui-ac-content li.yui-ac-highlight {

background:#556CB5;

color:#FFF;

}

.follow{

background:url("../images/icons/heart_add.png") no-repeat scroll 3px;

height: 16px;

width: 20px;

cursor: pointer;

display: block;

float: right;

margin-top: 2px;

}

.following{

background:url("../images/icons/heart_delete.png") no-repeat scroll 3px;

height: 16px;

width: 20px;

cursor: pointer;

display: block;

float: right;

margin-top: 2px;

}

.currently_following{

}

.add_icon {

background:url("../images/icons/add.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

padding-top:1px;

text-align:left;

}

.edit_icon {

background:url("../images/icons/folder_edit.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

padding-top:1px;

text-align:left;

}

.delete_icon {

background:url("../images/icons/delete.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

padding-top:1px;

text-align:left;

}

.refresh_icon {

background:url("../images/icons/arrow_refresh.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

padding-top:1px;

text-align:left;

}

.rss_icon {

background:url("../images/icons/rss_16.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

padding-top:1px;

text-align:left;

}

.atom_icon {

background:url("../images/icons/atom.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

padding-top:1px;

text-align:left;

}

.archive_icon {

background:url("../images/icons/compress.png") no-repeat scroll 3px;

height:16px;

padding-left:20px;

text-align:left;

padding-top:1px;

}

.action_button {

border:0;

display:block;

}

.action_button:hover {

border:0;

text-decoration:underline;

cursor:pointer;

}

#switch_repos {

position:absolute;

height:25px;

z-index:1;

}

#switch_repos select {

min-width:150px;

max-height:250px;

z-index:1;

}

.breadcrumbs {

border:medium none;

color:#FFF;

float:left;

text-transform:uppercase;

font-weight:700;

font-size:14px;

margin:0;

padding:11px 0 11px 10px;

}

.breadcrumbs a {

color:#FFF;

}

.flash_msg ul {

margin:0;

padding:0 0 10px;

}

.error_msg {

background-color:#FFCFCF;

background-image:url("../../images/icons/error_msg.png");

border:1px solid #FF9595;

color:#C30;

}

.warning_msg {

background-color:#FFFBCC;

background-image:url("../../images/icons/warning_msg.png");

border:1px solid #FFF35E;

color:#C69E00;

}

.success_msg {

background-color:#D5FFCF;

background-image:url("../../images/icons/success_msg.png");

border:1px solid #97FF88;

color:#090;

}

.notice_msg {

background-color:#DCE3FF;

background-image:url("../../images/icons/notice_msg.png");

border:1px solid #93A8FF;

color:#556CB5;

}

.success_msg,.error_msg,.notice_msg,.warning_msg {

background-position:10px center;

background-repeat:no-repeat;

font-size:12px;

font-weight:700;

min-height:14px;

line-height:14px;

margin-bottom:0;

margin-top:0;

display:block;

overflow:auto;

padding:6px 10px 6px 40px;

}

#msg_close {

background:transparent url("../../icons/cross_grey_small.png") no-repeat scroll 0 0;

cursor:pointer;

height:16px;

position:absolute;

right:5px;

top:5px;

width:16px;

}

div#legend_container table,div#legend_choices table {

width:auto !important;

}

table#permissions_manage {

width:0 !important;

}

table#permissions_manage span.private_repo_msg {

font-size:0.8em;

opacity:0.6px;

}

table#permissions_manage td.private_repo_msg {

font-size:0.8em;

}

table#permissions_manage tr#add_perm_input td {

vertical-align:middle;

}

div.gravatar {

background-color:#FFF;

border:1px solid #D0D0D0;

float:left;

margin-right:0.7em;

padding:2px 2px 0;

}

#header,#content,#footer {

min-width:1024px;

}

#content {

min-height:100%;

clear:both;

overflow:hidden;

padding:14px 30px;

}