syntax: glob

*.pyc

*.swp

*.sqlite

*.tox

*.egg-info

*.egg

*.mo

.eggs/

tarballcache/

syntax: regexp

^rcextensions

^build

^dist/

^docs/build/

^docs/_build/

^data$

^sql_dumps/

^\.settings$

^\.project$

^\.pydevproject$

^\.coverage$

^kallithea/front-end/node_modules$

^kallithea/front-end/package-lock\.json$

^kallithea/front-end/tmp$

^kallithea/public/css/style\.css(\.map)?$

^theme\.less$

^kallithea\.db$

^test\.db$

^Kallithea\.egg-info$

^my\.ini$

^fabfile.py

^\.idea$

^\.cache$

^\.pytest_cache$

/__pycache__$

Kallithea License

=================

Kallithea as a whole is copyrighted by various authors and is licensed under

the terms of the GNU General Public License, version 3 (GPLv3), which is a

license published by the Free Software Foundation,

Inc. [A copy of GPLv3](/COPYING) is included herein.

Some individual files have copyright notices and those who offer changes to

those files should update the copyright notices in those specific files if

they so chose.

However, the definitive list of copyright holders for this project is kept in

[the about page template](kallithea/templates/about.html) so that it is

displayed appropriately when Kallithea is installed.  This is the most

important place to update copyright notices.

Third-Party Code Incorporated in Kallithea

==========================================

Various third-party code under GPLv3-compatible licenses is included as part

of Kallithea.

Alembic

-------

Kallithea incorporates an [Alembic](http://alembic.zzzcomputing.com/en/latest/)

"migration environment" in `kallithea/alembic`, portions of which is:

Copyright © 2009-2016 by Michael Bayer.

Alembic is a trademark of Michael Bayer.

and licensed under the MIT-permissive license, which is

[included in this distribution](MIT-Permissive-License.txt).

Bootstrap

---------

[Bootstrap](http://getbootstrap.com/), which is:

Copyright © 2011-2016 Twitter, Inc.

and licensed under the MIT-permissive license, which is

Codemirror

----------

Kallithea incorporates parts of the Javascript system called

[Codemirror](http://codemirror.net/), version 4.7.0, which is primarily:

Copyright &copy; 2013-2014 by Marijn Haverbeke <marijnh@gmail.com>

and licensed under the MIT-permissive license, which is

[included in this distribution](MIT-Permissive-License.txt).

Additional files from upstream Codemirror are copyrighted by various authors

and licensed under other permissive licenses.  The sub-directories under

[.../public/codemirror](kallithea/public/codemirror) include the copyright and

license notice and information as they appeared in Codemirror's upstream

release.

jQuery

------

Kallithea incorporates the Javascript system called

[jQuery](http://jquery.org/), [herein](kallithea/public/js/jquery.min.js),

which can be found together with its Corresponding Source in

https://github.com/jquery/jquery at tag 1.12.3 (mirrored at

https://kallithea-scm.org/repos/mirror/jquery/files/1.12.3/ ).

It is Copyright 2013 jQuery Foundation and other contributors http://jquery.com/ and is under an

[MIT-permissive license](MIT-Permissive-License.txt).

DataTables

----------

Kallithea incorporates the Javascript system called

[DataTables](http://www.datatables.net/)

which can be found together with their Corresponding Source in

https://github.com/DataTables/DataTables at tag 1.10.13 (mirrored at

https://kallithea-scm.org/repos/mirror/DataTables/files/1.10.13/ ).

It is Copyright 2008-2015 SpryMedia Ltd. and is under an

[MIT-permissive license](MIT-Permissive-License.txt).

Mergely

-------

Kallithea incorporates some code from the Javascript system called

[Mergely](http://www.mergely.com/), version 3.3.9.

[Mergely's license](http://www.mergely.com/license.php), a

[copy of which is included in this repository](LICENSE-MERGELY.html),

is (GPL|LGPL|MPL).  Kallithea as GPLv3'd project chooses the GPL arm of that

tri-license.

Select2

-------

Kallithea incorporates parts of the Javascript system called

[Select2](http://ivaynberg.github.io/select2/), which is:

Copyright 2012 Igor Vaynberg (and probably others)

and is licensed [under the following license](https://github.com/ivaynberg/select2/blob/master/LICENSE):

> This software is licensed under the Apache License, Version 2.0 (the

> "Apache License") or the GNU General Public License version 2 (the "GPL

> License"). You may choose either license to govern your use of this

> software only upon the condition that you accept all of the terms of either

> the Apache License or the GPL License.

A [copy of the Apache License 2.0](Apache-License-2.0.txt) is also included

in this distribution.

Kallithea will take the Apache license fork of the dual license, since

Kallithea is GPLv3'd.

Select2-Bootstrap-CSS

---------------------

Kallithea incorporates some CSS from a system called

[Select2-bootstrap-css](https://github.com/t0m/select2-bootstrap-css), which

is:

Copyright © 2013 Tom Terrace (and likely others)

and licensed under the MIT-permissive license, which is

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

# This program is free software: you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation, either version 3 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program.  If not, see <http://www.gnu.org/licenses/>.

import click

import kallithea.bin.kallithea_cli_base as cli_base

import os

import subprocess

import json

import kallithea

@cli_base.register_command()

@click.option('--install-deps/--no-install-deps', default=True,

        help='Skip installation of dependencies, via "npm".')

@click.option('--generate/--no-generate', default=True,

        help='Skip generation of front-end files.')

def front_end_build(install_deps, generate):

    """Build the front-end.

    Install required dependencies for the front-end and generate the necessary

    files.  This step is complementary to any 'pip install' step which only

    covers Python dependencies.

    The installation of front-end dependencies happens via the tool 'npm' which

    is expected to be installed already.

    """

    front_end_dir = os.path.abspath(os.path.join(kallithea.__file__, '..', 'front-end'))

    public_dir = os.path.abspath(os.path.join(kallithea.__file__, '..', 'public'))

    if install_deps:

        click.echo("Running 'npm install' to install front-end dependencies from package.json")

        subprocess.check_call(['npm', 'install'], cwd=front_end_dir)

    if generate:

        tmp_dir = os.path.join(front_end_dir, 'tmp')

        if not os.path.isdir(tmp_dir):

            os.mkdir(tmp_dir)

        with open(os.path.join(tmp_dir, 'pygments.css'), 'w') as f:

            subprocess.check_call(['pygmentize',

                    '-S', 'default',

                    '-f', 'html',

                    '-a', '.code-highlight'],

                    stdout=f)

        lesscpath = os.path.join(front_end_dir, 'node_modules', '.bin', 'lessc')

        lesspath = os.path.join(public_dir, 'less', 'main.less')

        csspath = os.path.join(public_dir, 'css', 'style.css')

        subprocess.check_call([lesscpath, '--relative-urls', '--source-map',

                '--source-map-less-inline', lesspath, csspath],

                cwd=front_end_dir)

        click.echo("Generating LICENSES.txt")

        check_licensing_json_path = os.path.join(tmp_dir, 'licensing.json')

        licensing_txt_path = os.path.join(public_dir, 'LICENSES.txt')

        subprocess.check_call([

            os.path.join(front_end_dir, 'node_modules', '.bin', 'license-checker'),

            '--json',

            '--out', check_licensing_json_path,

            ], cwd=front_end_dir)

        with open(check_licensing_json_path) as jsonfile:

            rows = json.loads(jsonfile.read())

            with open(licensing_txt_path, 'w') as out:

                out.write("The Kallithea front-end was built using the following Node modules:\n\n")

                for name_version, values in sorted(rows.items()):

                    name, version = name_version.rsplit('@', 1)

                    line = "%s from https://www.npmjs.com/package/%s/v/%s\n  License: %s\n  Repository: %s\n" % (

                        name_version, name, version, values['licenses'], values.get('repository', '-'))

                    if values.get('copyright'):

                        line += "  Copyright: %s\n" % (values['copyright'])

                    out.write(line + '\n')