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/select2-spinner\.gif$

^kallithea/public/css/select2\.png$

^kallithea/public/css/select2x2\.png$

^kallithea/public/css/style\.css$

^kallithea/public/css/style\.css\.map$

^kallithea/public/js/bootstrap\.js$

^kallithea/public/js/dataTables\.bootstrap\.js$

^kallithea/public/js/jquery\.dataTables\.js$

^kallithea/public/js/jquery\.flot\.js$

^kallithea/public/js/jquery\.flot\.selection\.js$

^kallithea/public/js/jquery\.flot\.time\.js$

^kallithea/public/js/jquery\.min\.js$

^kallithea/public/js/select2\.js$

^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

---------

Kallithea uses the web framework called

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

Copyright © 2011-2016 Twitter, Inc.

and licensed under the MIT-permissive license, which is

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

It is not distributed with Kallithea, but will be downloaded

using the ''kallithea-cli front-end-build'' command.

Codemirror

----------

[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

jQuery

------

Kallithea uses the Javascript system called

[jQuery](http://jquery.org/).

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

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

It is not distributed with Kallithea, but will be downloaded

using the ''kallithea-cli front-end-build'' command.

DataTables

----------

Kallithea uses the Javascript system called

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

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

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

It is not distributed with Kallithea, but will be downloaded

using the ''kallithea-cli front-end-build'' command.

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 uses 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.

It is not distributed with Kallithea, but will be downloaded

using the ''kallithea-cli front-end-build'' command.

Select2-Bootstrap-CSS

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

Kallithea uses 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

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

It is not distributed with Kallithea, but will be downloaded

using the ''kallithea-cli front-end-build'' command.

History.js

----------

Kallithea incorporates some CSS from a system called History.js, which is

Copyright 2010-2011 Benjamin Arthur Lupton <contact@balupton.com>

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice,

   this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice,

   this list of conditions and the following disclaimer in the documentation

   and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE

LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF

SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN

CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

POSSIBILITY OF SUCH DAMAGE.

YUI

---

Kallithea incorporates parts of the Javascript system called

[YUI 2 — Yahoo! User Interface Library](http://yui.github.io/yui2/docs/yui_2.9.0_full/),

which is made available under the [BSD License](http://yuilibrary.com/license/):

Copyright © 2013 Yahoo! Inc. All rights reserved.

Redistribution and use of this software in source and binary forms, with or

without modification, are permitted provided that the following conditions are

met:

* Redistributions of source code must retain the above copyright notice, this

  list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice,

  this list of conditions and the following disclaimer in the documentation

  and/or other materials provided with the distribution.

* Neither the name of Yahoo! Inc. nor the names of YUI's contributors may be

  used to endorse or promote products derived from this software without

  specific prior written permission of Yahoo! Inc.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND

ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR

ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON

ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Kallithea includes a minified version of YUI 2.9. To build yui.2.9.js:

    git clone https://github.com/yui/builder

    git clone https://github.com/yui/yui2

    cd yui2/

    git checkout hudson-yui2-2800

    ln -sf JumpToPageDropDown.js src/paginator/js/JumpToPageDropdown.js # work around inconsistent casing

    rm -f tmp.js

    for m in yahoo event dom animation datasource autocomplete event-delegate; do

      rm -f build/$m/$m.js

      ( cd src/$m && ant build deploybuild ) && sed -e 's,@VERSION@,2.9.0,g' -e 's,@BUILD@,2800,g' build/$m/$m.js >> tmp.js

    done

    java -jar ../builder/componentbuild/lib/yuicompressor/yuicompressor-2.4.4.jar tmp.js -o yui.2.9.js

In compliance with GPLv3 the Corresponding Source for this Object Code is made

available on

[https://kallithea-scm.org/repos/mirror](https://kallithea-scm.org/repos/mirror).

YUI Flot

--------

Kallithea incorporates some CSS from a system called

[Flot](http://code.google.com/p/flot/), which is:

Copyright 2006 Google Inc.

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

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

in this distribution.

Flot

----

# -*- 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 shutil

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)

        click.echo("Building CSS styling based on Bootstrap")

        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("Preparing Bootstrap JS")

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'bootstrap', 'dist', 'js', 'bootstrap.js'), os.path.join(public_dir, 'js', 'bootstrap.js'))

        click.echo("Preparing jQuery JS with Flot")

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'jquery', 'dist', 'jquery.min.js'), os.path.join(public_dir, 'js', 'jquery.min.js'))

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'jquery.flot', 'jquery.flot.js'), os.path.join(public_dir, 'js', 'jquery.flot.js'))

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'jquery.flot', 'jquery.flot.selection.js'), os.path.join(public_dir, 'js', 'jquery.flot.selection.js'))

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'jquery.flot', 'jquery.flot.time.js'), os.path.join(public_dir, 'js', 'jquery.flot.time.js'))

        click.echo("Preparing DataTables JS")

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'datatables.net', 'js', 'jquery.dataTables.js'), os.path.join(public_dir, 'js', 'jquery.dataTables.js'))

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'datatables.net-bs', 'js', 'dataTables.bootstrap.js'), os.path.join(public_dir, 'js', 'dataTables.bootstrap.js'))

        click.echo("Preparing Select2 JS")

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'select2', 'select2.js'), os.path.join(public_dir, 'js', 'select2.js'))

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'select2', 'select2.png'), os.path.join(public_dir, 'css', 'select2.png'))

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'select2', 'select2x2.png'), os.path.join(public_dir, 'css', 'select2x2.png'))

        shutil.copy(os.path.join(front_end_dir, 'node_modules', 'select2', 'select2-spinner.gif'), os.path.join(public_dir, 'css', 'select2-spinner.gif'))

        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')

{

  "name": "kallithea",

  "private": true,

  "dependencies": {

    "bootstrap": "3.3.7",

    "datatables.net": "1.10.13",

    "datatables.net-bs": "1.10.13",

    "jquery": "1.12.3",

    "jquery.flot": "0.8.3",

    "select2": "3.5.1",

    "select2-bootstrap-css": "1.2.4"

  },

  "devDependencies": {

    "less": "~2.7",

    "less-plugin-clean-css": "~1.5",

    "license-checker": "24.1.0"

  }

}