pytype: introduce configuration for running pytype

Install pytype and dependencies on Python 3.8 with:
pip install --upgrade -r pytype_requirements.txt

Checks can then be run with:
pytype

docs: describe, visualize, and verify internal code structure and layering

Try to describe something that isn't entirely there yet.

deps.py will help track and minimize violations through checks and
visualization in deps.svg .

docs: when using venv with a clone, recommend using 'venv' as location

Avoid having the odd inconsistent location ../kallithea-venv to care about.

For good or bad, this might change how it is feasible to grep. I usually make
sure to only search tracked files:
grep Foo `hg mani`

ini: move archive_cache_dir to the data directory

Give less data locations to care about.

front-end: fix documentation regarding theme.less file

The documentation stated that a theme.less file can be placed in the
Kallithea root directory, but this is not true. The file is expected in
kallithea/front-end to take effect.

Update the documentation and .hgignore file.

front-end: use At.js for MentionsAutoComplete

We want to get rid of YUI, and select2 is not well suited for this purpose.
So use At.js, which is made just for this use case.

Original implementation was modified by Mads Kiilerich.

front-end: Use DataTables from node_modules and stop bundling it

There is no minimized version in the npm package. For now, we just use the raw
one. We can minimize later.

front-end: Use select2 from node_modules and stop bundling it

select2 3.5.4 was added in 304e83e9bcde ... but the latest npm release in the 3
series is 3.5.1, so we use that one instead. We should probably upgrade to the
4 series.

The select2 images were not in the location the generated css pointed - now we
copy them from node_modules to the right location, next to the generated css.

Note: this will drop 190cb30841de "branches: fix performance of branch
selectors with many branches - only show the first 200 results" ... but it
should no longer be relevant now when we use server side filtering.

15e507047bae introduced select2-bootstrap.css - it is not clear what version
was used, but we use the latest 1.4.6 which also is very old.

front-end: Use jQuery and Flot from node_modules and stop bundling them

jquery.min.js 1.12.3 was introduced in 7a4dec17e837.

jquery.flot.js 0.8.3 was introduced in 322ce5147fe0.

front-end: Store temporary files in a tmp directory

Avoid mixing temporary files with source files or have them in the generated
output. But for now, keep them in the front-end directory where we need write
access for node_modules anyway.

front-end: Introduce 'front-end' directory with source files for building the front-end

The top level with package.json is not included when installing with pip, and
'kallithea-cli front-end-build' and npm would thus fail.

Instead, introduce 'kallithea/front-end/'. It is under 'kallithea/' and is thus
included when doing pip install, but it is just a source directory and not
under "public". Most of the "less" stuff should probably move there. And
probably also most things that now are checked in under "public", so a fully
populated public front-end directory can be built anywhere, without write
access to the Python installation directory.

hgignore: .pytest_cache

This directory is created by py.test and contains for example information about
latest failures.

cli: front-end-build: generate pygments.css dynamically

Rather than having pygments.css part of the Kallithea sources, generate it
on the fly via front-end-create

Idea comes from Dominik Ruf.

less: generate map files when building style.css with 'npm run less'

The map files allow web development tools ("Firebug" style) to show the .less
and .css source instead of the generated style.css . The generated style.css
will get a trailing comment with a reference to
kallithea/public/css/style.css.map . It will not have any impact on runtime.

less: load optional theme.less file to allow custom styles

Users can use this file to easily override the default style.
For example they can override the theme main color or the logo url.

less: don't distribute the generated style.css file - for now, it must be built with npm after installing Kallithea

Generated files should not be included in the repository. Especially not when
using GPL with the requirement of distributing corresponding source.

Also add the two commands to generate the css file to the docs.

Modified by Mads Kiilerich.

style: use npm less to generate kallithea stylesheet style.css from style.less

This is a minimal change to introduce less as framework to generate our
stylesheet. The input less file is currently the same as the original css
stylesheet, so that the delta between the input style.less and the output
style.css is zero.

To regenerate style.css from style.less, run:

npm --prefix kallithea/public/less install
npm --prefix kallithea/public/less run less

These changes are based on work by Dominik Ruf.

tests: move test data to top level 'data' folder - make grepping in kallithea/ easier

We like to have test.ini under kallithea/tests, but we don't want the temporary files there.

.hgignore: Add .eggs/ and tarballcache/

Setuptools >= 7.0 and .eggs is created and populated with eggs if setup.py has
setup_requires of packages that are not installed and setuptools has to
download them to satisfy the requirements. See
https://bitbucket.org/pypa/setuptools/pull-request/97/cache-eggs-required-for-building-in-eggs/diff#

tarballcache comes from test.ini : archive_cache_dir = %(here)s/tarballcache

i18n: don't include .mo files in the repo - build them on demand

(We do however keep the english .mo for now to preserve backwards
compatibility.)

docs: rework stuff

The existing docs were far from how we wanted it to be. There was so much to do
and it is not feasible to do that cleanup it in clean patches.

Instead, I took a sweep through the docs and changed what I thought could
benefit from a change: structure, examples, advices, language, markup, content,
etc.

created rhodecode-api binary script for working with api via cli
- created docs
- moved the backup script to bin folder