# -*- coding: utf-8 -*-

#

# Kallithea documentation build configuration file, created by

# sphinx-quickstart on Sun Oct 10 16:46:37 2010.

#

# This file is execfile()d with the current directory set to its containing dir.

#

# Note that not all possible configuration values are present in this

# autogenerated file.

#

# All configuration values have a default; values that are commented out

# serve to show the default.

import sys

import os

# If extensions (or modules to document with autodoc) are in another directory,

# add these directories to sys.path here. If the directory is relative to the

# documentation root, use os.path.abspath to make it absolute, like shown here.

sys.path.insert(0, os.path.abspath('..'))

# -- General configuration -----------------------------------------------------

# If your documentation needs a minimal Sphinx version, state it here.

#needs_sphinx = '1.0'

# Add any Sphinx extension module names here, as strings. They can be extensions

# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.

extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest',

              'sphinx.ext.intersphinx', 'sphinx.ext.todo',

              'sphinx.ext.viewcode']

# Add any paths that contain templates here, relative to this directory.

templates_path = ['_templates']

# The suffix of source filenames.

source_suffix = '.rst'

# The encoding of source files.

#source_encoding = 'utf-8-sig'

# The master toctree document.

master_doc = 'index'

# General information about the project.

project = u'Kallithea'

# The version info for the project you're documenting, acts as replacement for

# |version| and |release|, also used in various other places throughout the

# built documents.

#

# The short X.Y version.

root = os.path.dirname(os.path.dirname(__file__))

sys.path.append(root)

from kallithea import __version__

version = __version__

# The full version, including alpha/beta/rc tags.

release = __version__

# The language for content autogenerated by Sphinx. Refer to documentation

# for a list of supported languages.

#language = None

# There are two options for replacing |today|: either, you set today to some

# non-false value, then it is used:

#today = ''

# Else, today_fmt is used as the format for a strftime call.

#today_fmt = '%B %d, %Y'

# List of patterns, relative to source directory, that match files and

# directories to ignore when looking for source files.

exclude_patterns = ['_build']

# The reST default role (used for this markup: `text`) to use for all documents.

#default_role = None

# If true, '()' will be appended to :func: etc. cross-reference text.

#add_function_parentheses = True

# If true, the current module name will be prepended to all description

# unit titles (such as .. function::).

#add_module_names = True

# If true, sectionauthor and moduleauthor directives will be shown in the

# output. They are ignored by default.

#show_authors = False

# The name of the Pygments (syntax highlighting) style to use.

pygments_style = 'sphinx'

highlight_language = 'none'

# A list of ignored prefixes for module index sorting.

#modindex_common_prefix = []

    with open(filename) as f:

        pre, post = re.split(split_re, f.read())

    with open(filename, 'w') as f:

        f.write(pre +

                ''.join(format_f(years, name) for years, name in l) +

                post)

def main():

    repo_entries = [

        (year, contributor_data.name_fixes.get(name) or contributor_data.name_fixes.get(name.rsplit('<', 1)[0].strip()) or name)

        for year, name in

        (line.strip().split(' ', 1)

         for line in os.popen("""hg log -r '::.' -T '{date(date,"%Y")} {author}\n'""").readlines())

        ]

    insert_entries(

        filename='kallithea/templates/about.html',

        all_entries=repo_entries + contributor_data.other_about + contributor_data.other,

        no_entries=contributor_data.no_about,

        domain_extra=contributor_data.domain_extra,

        split_re=r'(?:  <li>Copyright &copy; [^\n]*</li>\n)*',

        normalize_name=lambda name: name.split('<', 1)[0].strip(),

        format_f=lambda years, name: '  <li>Copyright &copy; %s, %s</li>\n' % (nice_years(years, '&ndash;', ', '), name),

        )

    insert_entries(

        filename='CONTRIBUTORS',

        all_entries=repo_entries + contributor_data.other_contributors + contributor_data.other,

        no_entries=contributor_data.total_ignore,

        domain_extra=contributor_data.domain_extra,

        split_re=r'(?:    [^\n]*\n)*',

        normalize_name=lambda name: name,

        format_f=lambda years, name: ('    %s%s%s\n' % (name, ' ' if years else '', nice_years(years))),

        )

    insert_entries(

        filename='kallithea/templates/base/base.html',

        all_entries=repo_entries,

        no_entries=contributor_data.total_ignore,

        domain_extra={},

        split_re=r'(?<=&copy;) .* (?=by various authors)',

        normalize_name=lambda name: '',

        format_f=lambda years, name: ' ' + nice_years(years, '–', ', ') + ' ',

        )

if __name__ == '__main__':

    main()

# To list new contributors since last tagging:

# { hg log -r '::tagged()' -T '    {author}\n    {author}\n'; hg log -r '::.' -T '    {author}\n' | sort | uniq; } | sort | uniq -u