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

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

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

----

Kallithea incorporates some parts of a Javascript system called

[Flot](http://www.flotcharts.org/), which is:

Copyright (c) 2007-2014 IOLA and Ole Laursen

Permission is hereby granted, free of charge, to any person

obtaining a copy of this software and associated documentation

files (the "Software"), to deal in the Software without

restriction, including without limitation the rights to use,

copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the

Software is furnished to do so, subject to the following

conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES

OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,

WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR

OTHER DEALINGS IN THE SOFTWARE.

Icon fonts

----------

Kallithea incorporates subsets of both

[Font Awesome](http://fontawesome.io) and

[GitHub Octicons](https://octicons.github.com) for icons. Font Awesome is:

Copyright (c) 2016, Dave Gandy

Octicons is:

Copyright (c) 2012-2014 GitHub

These two sets are distributed under [SIL OFL 1.1](http://scripts.sil.org/OFL)

and have been combined into one font called "kallithea."

EOF

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