Changeset - 4d1aa80e5d0a
Parent rev.
Child rev.
[Not reviewed]
Merge default
0 18 0
Thomas De Schampheleire - 6 years ago 2020-06-07 21:56:15
thomas.de_schampheleire@nokia.com
merge stable
17 files changed with 317 insertions and 273 deletions:
.hgtags
1
development.ini
14
13
docs/overview.rst
36
docs/theme/nature/layout.html
1
1
kallithea/bin/kallithea_cli_config.py
1
kallithea/lib/auth_modules/auth_crowd.py
8
24
kallithea/lib/inifile.py
1
kallithea/lib/paster_commands/template.ini.mako
222
221
kallithea/lib/vcs/backends/git/changeset.py
2
2
kallithea/model/db.py
1
kallithea/templates/admin/gists/edit.html
1
1
kallithea/templates/compare/compare_diff.html
1
1
kallithea/tests/functional/test_admin_gists.py
8
1
kallithea/tests/functional/test_feed.py
12
4
scripts/generate-ini.py
1
1
scripts/validate-commits
7
1
setup.py
1
2
0 comments (0 inline, 0 general)
.hgtags
➞
Show inline comments
 
c097458480a5972dd75d5695b61e855fd0ab371e rhodecode-0.0.0.7.0
 
8bdec09436cb7e4a764bd2ba50b84060e30eb34f rhodecode-0.0.0.7.1
 
1a18994cdc3bdd156ee93c7c0fb8d94a88f1f640 rhodecode-0.0.0.7.2
 
a3a7c3e03b76ee264a828cb1087970bb98bbffcd rhodecode-0.0.0.7.3
 
58b46f9194c347641bfc9a26697ef413a4761971 rhodecode-0.0.0.7.4
 
710e7a75bb6b8346cee3bd0ddda67592e4790268 rhodecode-0.0.0.7.5
 
ca80f8c0056211dad33483a50b913593516d7a6c rhodecode-0.0.0.7.6
 
0cf49c29c846fefeb4e1a222e4b1850e9e3eaa62 rhodecode-0.0.0.7.7
 
702c7e565c56a49c89414e81f28571c8e5b67408 rhodecode-0.0.0.7.8
 
c12f4d19c95065f313eefcd45eac9ef507f5fa55 rhodecode-0.0.0.7.9
 
558eb7c5028f24a90b5466ed16be13b213ba1fc2 rhodecode-0.0.0.8.0
 
a9814a642e11092b243ca01721254a04633a0ffc rhodecode-0.0.0.8.1
 
ccbe729908844884aea89d00fb14a6cb92e10c06 rhodecode-0.0.0.8.2
 
ca41d544dbdfd2f81bd0304168492a26276aadb6 rhodecode-0.0.0.8.3
 
2fa16ec5822da0c6fade3dd1ed9b6c0655e5dbbf rhodecode-0.0.0.8.4
 
16ba57d8fe2317c49dbd422afd07ab497687aa02 rhodecode-0.0.0.8.5
 
53128b6b9a4ddb6ee9554cbb83a082a6d1316b42 rhodecode-0.0.1.0.0rc4
 
afd98d1f817e6a6b52172735c22160239e615a6b rhodecode-0.0.1.0.0
 
bee56f209c40a6880f2f633b02227b5ee1f8ff5a rhodecode-0.0.1.0.1
 
d85b0948e53925ebbbc49e9f7967013a04f866e9 rhodecode-0.0.1.0.2
 
d9c8dddb96af521e346f05b88d515c536eef3d17 rhodecode-0.0.1.1.0
 
344f748517814ed0408a49e392dc625f4cc37fdc rhodecode-0.0.1.1.1
 
6c01c12eafb8cc72d4c4cbd121400fad755b2862 rhodecode-0.0.1.1.2
 
4fa80e0484ef5c33feaa9c39fc66916f410ba353 rhodecode-0.0.1.1.3
 
cb77867d69d3c5931712aac486c980a42ee90745 rhodecode-0.0.1.1.5
 
cb77867d69d3c5931712aac486c980a42ee90745 rhodecode-0.0.1.1.5
 
008bdfdd95c8bd31ae6d89f76c75c1f49cbcd0bc rhodecode-0.0.1.1.5
 
c5af1d3c861fb36b156224e75c2f55a97f54657d rhodecode-0.0.1.1.6
 
7327a0d1584cf28d33e738048af1f6809d499451 rhodecode-0.0.1.1.7
 
bd102f45950f779995a1beae42b6eb099cdd27b3 rhodecode-0.0.1.1.7
 
c8974135732aa0ceb841cee6df66e29f089b4963 rhodecode-0.0.1.1.8
 
c252049af24cd98eef5f4143fa3abbff3c912e29 rhodecode-0.0.1.2.0
 
0b8fba8ab90b01f811a50e6e7384989cced21d38 rhodecode-0.0.1.2.1
 
22273bec00ba2fd860c60a9277d3d7229e288e18 rhodecode-0.0.1.2.2
 
1ff606a7858dbd8a5f70b3da5cc89524bd0d84f9 rhodecode-0.0.1.2.3
 
a7a282a902b207ce34e830d643c79b7ab52e3b35 rhodecode-0.0.1.2.4
 
b6b611e7722e754abebaae6e265cbb4c823d344d rhodecode-0.0.1.2.5
 
dbc82e3362a25d2aece42060089824c4342efd17 rhodecode-0.0.1.3.0
 
79a95f338fd0115b2cdb77118f39e17d22ff505c rhodecode-0.0.1.3.1
 
9ab21c5ddb84935bea5c743b4e147ed5a398b30c rhodecode-0.0.1.3.2
 
934906f028b582a254e0028ba25e5d20dd32b9cd rhodecode-0.0.1.3.3
 
af21362474e3ab5aa0e2fbb1c872356f2c16c4f3 rhodecode-0.0.1.3.4
 
0e2792e04bd316fe64335cbe6a476031ac60b29b rhodecode-0.0.1.3.5
 
edfff9f37916389144d3a3644d0a7d7adfd79b11 rhodecode-0.0.1.3.6
 
9ae95fdeca184f2404205645f06c6597b74ef2db rhodecode-0.0.1.4.0
 
909143a4dde53c46d4f24abb426ec870471c7de1 rhodecode-0.0.1.4.1
 
d998cc84cf726798486a438763053f0e1dc1b646 rhodecode-0.0.1.4.2
 
3f5d40b9dd99ccb009ea2211ee2d4b594c634946 rhodecode-0.0.1.4.3
 
3148c08cf86f1849917e2d50f7ab7766c1550b0a rhodecode-0.0.1.4.4
 
a5f0bc867edc88be23eb808693e5393a97d4c54a rhodecode-0.0.1.5.0
 
3259dc7caea48687eab018ee646ae6ad7e7ef377 rhodecode-0.0.1.5.1
 
efe23d6c178c11d575a0214181276a3452776e48 rhodecode-0.0.1.5.2
 
1a498b11f1540f5b94b6f6009298f5dc3eaad9e9 rhodecode-0.0.1.5.3
 
3447862ad8c9ceba85857774c526e39fde3a2281 rhodecode-0.0.1.5.4
 
c15d7b336af58df9f1bbc8f8957464e7ea618d4c rhodecode-0.0.1.6.0rc1
 
78b53ee0d247f90d51b028307ff5717851b6c265 rhodecode-0.0.1.6.0
 
351ad34d56321349ff5bd38f537bd768b8efef2e rhodecode-0.0.1.7.0
 
1f71ef689d2a3c9978cea6591a1f4e9107a5ca83 rhodecode-0.0.1.7.1
 
cc48c1541c7e2e84114bf92a0f9cd4b8b1341545 0.0
 
d17e88a1a88a29f6fac948c94498129e405a40d3 0.1
 
ad0ce803b40cb17fc3988373052943e041030b02 0.2
 
c6e32714336345403adf76abb6ebf9b8116fcdc7 0.2.1
 
14f488a5dc4ca6647bc6acf12534fd137e968aa8 0.2.2
 
9b3e9e242f5c97cc0c7657e5ac93dce7de61ca16 0.3
 
9bf8eb837e785b6856ccfac264e977ce3ebe1535 0.3.1
 
a84d40e9481fcea4dafadee86b03f0dd401527d6 0.3.2
 
64ea7ea0923618a0c117acebb816a6f0d162bfdb 0.3.3
 
cf635c823ea059cc3a1581b82d8672e46b682384 0.3.4
 
4cca4cc6a0a97f4c4763317184cd41aca4297630 0.3.5
 
082c9b8f0f17bd34740eb90c69bdc4c80d4b5b31 0.3.6
 
a18445b85d407294da0b7f1d8be3bedef5ffdea6 0.3.7
 
8db761c407685e7b08b800c947890035b0d67025 0.4.0rc1
 
60f726162fd6c515bd819feb423be73cad01d7d3 0.4.0rc2
 
19086c5de05f4984d7a90cd31624c45dd893f6bb 0.4.0
 
da65398a62fff50f3d241796cbf17acdea2092ef 0.4.1
 
bfa0b0a814644f0af3f492d17a9ed169cc3b89fe 0.5.0
 
d01a8e92936dbd62c76505432f60efba432e9397 0.5.1
 
aa0a637fa6f635a5e024fa56b19ed2a2dacca857 0.5.2
 
9f5ca9088067618d79129d224c35c818bd2d2f12 0.6.0
 
a22edac2be58eaf68d1940d4dfeb88fadbabb43a 0.6.1
development.ini
➞
Show inline comments
 
###################################################################################
 
###################################################################################
 
## Kallithea config file generated with kallithea-config                         ##
 
## Kallithea config file generated with kallithea-cli                            ##
 
##                                                                               ##
 
## The %(here)s variable will be replaced with the parent directory of this file ##
 
## The %(here)s variable will generally be replaced with the parent directory of ##
 
## this file. Other use of % must be escaped as %% .                             ##
 
###################################################################################
 
###################################################################################
 

			




	
	
	
		
 
[DEFAULT]

			




	
	
	
		
 

			




	
	
	
		
 
################################################################################

			




	
	
	
		
 
## Email settings                                                             ##

			




	
	
	
		
 
##                                                                            ##

			




	
	
	
		
 
## Refer to the documentation ("Email settings") for more details.            ##

			




	
	
	
		
 
##                                                                            ##

			




	
	
	
		
 
## It is recommended to use a valid sender address that passes access         ##

			




	
	
	
		
 
## validation and spam filtering in mail servers.                             ##

			




	
	
	
		
 
################################################################################

			




	
	
	
		
 

			




	
	
	
		
 
## 'From' header for application emails. You can optionally add a name.

			




	
	
	
		
 
## Default:

			




	
	
	
		
 
#app_email_from = Kallithea

			




	
	
	
		
 
## Examples:

			




	
	
	
		
 
#app_email_from = Kallithea <kallithea-noreply@example.com>

			




	
	
	
		
 
#app_email_from = kallithea-noreply@example.com

			




	
	
	
		
 

			




	
	
	
		
 
## Subject prefix for application emails.

			




	
	
	
		
 
## A space between this prefix and the real subject is automatically added.

			




	
	
	
		
 
## Default:

			




	
	
	
		
 
#email_prefix =

			




	
	
	
		
 
## Example:

			




	
	
	
		
 
#email_prefix = [Kallithea]

			




	
	
	
		
 

			




	
	
	
		
 
## Recipients for error emails and fallback recipients of application mails.

			




	
	
	
		
 
## Multiple addresses can be specified, comma-separated.

			




	
	
	
		
 
## Only addresses are allowed, do not add any name part.

			




	
	
	
		
 
## Default:

			




	
	
	
		
 
#email_to =

			




	
	
	
		
 
## Examples:

			




	
	
	
		
 
#email_to = admin@example.com

			




	
	
	
		
 
#email_to = admin@example.com,another_admin@example.com

			




	
	
	
		
 
email_to =

			




	
	
	
		
 

			




	
	
	
		
 
## 'From' header for error emails. You can optionally add a name.

			




	
	
	
		
 
## Default: (none)

			




	
	
	
		
 
## Examples:

			




	
	
	
		
 
#error_email_from = Kallithea Errors <kallithea-noreply@example.com>

			




	
	
	
		
 
#error_email_from = kallithea_errors@example.com

			




	
	
	
		
 
error_email_from =

			




	
	
	
		
 

			




	
	
	
		
 
## SMTP server settings

			




	
	
	
		
 
## If specifying credentials, make sure to use secure connections.

			




	
	
	
		
 
## Default: Send unencrypted unauthenticated mails to the specified smtp_server.

			




	
	
	
		
 
## For "SSL", use smtp_use_ssl = true and smtp_port = 465.

			




	
	
	
		
 
## For "STARTTLS", use smtp_use_tls = true and smtp_port = 587.

			




	
	
	
		
 
smtp_server =

			




	
	
	
		
 
smtp_username =

			




	
	
	
		
 
smtp_password =

			




	
	
	
		
 
smtp_port =

			




	
	
	
		
 
smtp_use_ssl = false

			




	
	
	
		
 
smtp_use_tls = false

			




	
	
	
		
 

			




	
	
	
		
 
## Entry point for 'gearbox serve'

			




	
	
	
		
 
[server:main]

			




	
	
	
		
 
#host = 127.0.0.1

			




	
	
	
		
 
host = 0.0.0.0

			




	
	
	
		
 
port = 5000

			




	
	
	
		
 

			




	
	
	
		
 
## WAITRESS ##

			




	
	
	
		
 
use = egg:waitress#main

			




	
	
	
		
 
## number of worker threads

			




	
	
	
		
 
threads = 1

			




	
	
	
		
 
## MAX BODY SIZE 100GB

			




	
	
	
		
 
max_request_body_size = 107374182400

			




	
	
	
		
 
## use poll instead of select, fixes fd limits, may not work on old

			




	
	
	
		
 
## windows systems.

			




	
	
	
		
 
#asyncore_use_poll = True

			




	
	
	
		
 

			




	
	
	
		
 
## middleware for hosting the WSGI application under a URL prefix

			




	
	
	
		
 
#[filter:proxy-prefix]

			




	
	
	
		
 
#use = egg:PasteDeploy#prefix

			




	
	
	
		
 
#prefix = /<your-prefix>

			




	
	
	
		
 

			




	
	
	
		
 
[app:main]

			




	
	
	
		
 
use = egg:kallithea

			




	
	
	
		
 
## enable proxy prefix middleware

			




	
	
	
		
 
#filter-with = proxy-prefix

			




	
	
	
		
 

			




	
	
	
		
 
full_stack = true

			




	
	
	
		
 
static_files = true

			




	
	
	
		
 

			




	
	
	
		
 
## Internationalization (see setup documentation for details)

			




	
	
	
		
 
## By default, the languages requested by the browser are used if available, with English as default.

			




	
	
	
		
 
## Set i18n.enabled=false to disable automatic language choice.

			




	
	
	
		
 
#i18n.enabled = true

			




	
	
	
		
 
## To Force a language, set i18n.enabled=false and specify the language in i18n.lang.

			




	
	
	
		
 
## Valid values are the names of subdirectories in kallithea/i18n with a LC_MESSAGES/kallithea.mo

			




	
	
	
		
 
#i18n.lang = en

			




	
	
	
		
 

			




	
	
	
		
 
cache_dir = %(here)s/data

			




	
	
	
		
 
index_dir = %(here)s/data/index

			




	
	
	
		
 

			




	
	
	
		
 
## uncomment and set this path to use archive download cache

			




	
	
	
		
 
archive_cache_dir = %(here)s/tarballcache

			




	
	
	
		
 

			




	
	
	
		
 
## change this to unique ID for security

			




	
	
	
		
 
#app_instance_uuid = VERY-SECRET

			




	
	
	
		
 
app_instance_uuid = development-not-secret

			




	
	
	
		
 

			




	
	
	
		
 
## cut off limit for large diffs (size in bytes)

			




	
	
	
		
 
cut_off_limit = 256000

			




	
	
	
		
 

			




	
	
	
		
 
## force https in Kallithea, fixes https redirects, assumes it's always https

			




	
	
	
		
 
force_https = false

			




	
	
	
		
 

			




	
	
	
		
 
## use Strict-Transport-Security headers

			




	
	
	
		
 
use_htsts = false

			




	
	
	
		
 

			




	
	
	
		
 
## number of commits stats will parse on each iteration

			




	
	
	
		
 
commit_parse_limit = 25

			




	
	
	
		
 

			




	
	
	
		
 
## Path to Python executable to be used for git hooks.

			




	
	
	
		
 
## This value will be written inside the git hook scripts as the text

			




	
	
	
		
 
## after '#!' (shebang). When empty or not defined, the value of

			




	
	
	
		
 
## 'sys.executable' at the time of installation of the git hooks is

			




	
	
	
		
 
## used, which is correct in many cases but for example not when using uwsgi.

			




	
	
	
		
 
## If you change this setting, you should reinstall the Git hooks via

			




	
	
	
		
 
## Admin > Settings > Remap and Rescan.

			




	
	
	
		
 
#git_hook_interpreter = /srv/kallithea/venv/bin/python3

			




	
	
	
		
 

			




	
	
	
		
 
## path to git executable

			




	
	
	
		
 
git_path = git

			




	
	
	
		
 

			




	
	
	
		
 
## git rev filter option, --all is the default filter, if you need to

			




	
	
	
		
 
## hide all refs in changelog switch this to --branches --tags

			




	
	
	
		
 
#git_rev_filter = --branches --tags

			




	
	
	
		
 

			




	
	
	
		
 
## RSS feed options

			




	
	
	
		
 
rss_cut_off_limit = 256000

			




	
	
	
		
 
rss_items_per_page = 10

			




	
	
	
		
 
rss_include_diff = false

			




	
	
	
		
 

			




	
	
	
		
 
## options for showing and identifying changesets

			




	
	
	
		
 
show_sha_length = 12

			




	
	
	
		
 
show_revision_number = false

			




	
	
	
		
 

			




	
	
	
		
 
## Canonical URL to use when creating full URLs in UI and texts.

			




	
	
	
		
 
## Useful when the site is available under different names or protocols.

			




	
	
	
		
 
## Defaults to what is provided in the WSGI environment.

			




	
	
	
		
 
#canonical_url = https://kallithea.example.com/repos

			




	
	
	
		
 

			




	
	
	
		
 
## gist URL alias, used to create nicer urls for gist. This should be an

			




	
	
	
		
 
## url that does rewrites to _admin/gists/<gistid>.

			




	
	
	
		
 
## example: http://gist.example.com/{gistid}. Empty means use the internal

			




	
	
	
		
 
## Kallithea url, ie. http[s]://kallithea.example.com/_admin/gists/<gistid>

			




	
	
	
		
 
gist_alias_url =

			




	
	
	
		
 

			




	
	
	
		
 
## default encoding used to convert from and to unicode

			




	
	
	
		
 
## can be also a comma separated list of encoding in case of mixed encodings

			




	
	
	
		
 
default_encoding = utf-8

			




	
	
	
		
 

			




	
	
	
		
 
## Set Mercurial encoding, similar to setting HGENCODING before launching Kallithea

			




	
	
	
		
 
hgencoding = utf-8

			




	
	
	
		
 

			




	
	
	
		
 
## issue tracker for Kallithea (leave blank to disable, absent for default)

			




	
	
	
		
 
#bugtracker = https://bitbucket.org/conservancy/kallithea/issues

			




	
	
	
		
 

			




	
	
	
		
 
## issue tracking mapping for commit messages, comments, PR descriptions, ...

			




	
	
	
		
 
## Refer to the documentation ("Integration with issue trackers") for more details.

			




	
	
	
		
 

			




	
	
	
		
 
## regular expression to match issue references

			




	
	
	
		
 
## This pattern may/should contain parenthesized groups, that can

			




	
	
	
		
 
## be referred to in issue_server_link or issue_sub using Python backreferences

			




	
	
	
		
 
## (e.g. \1, \2, ...). You can also create named groups with '(?P<groupname>)'.

			




	
	
	
		
 
## To require mandatory whitespace before the issue pattern, use:

			




	
	
	
		
 
## (?:^|(?<=\s)) before the actual pattern, and for mandatory whitespace

			




	
	
	
		
 
## behind the issue pattern, use (?:$|(?=\s)) after the actual pattern.

			




	
	
	
		
 

			




	
	
	
		
 
issue_pat = #(\d+)

			




	
	
	
		
 

			




	
	
	
		
 
## server url to the issue

			




	
	
	
		
 
## This pattern may/should contain backreferences to parenthesized groups in issue_pat.

			




	
	
	
		
 
## A backreference can be \1, \2, ... or \g<groupname> if you specified a named group

			




	
	
	
		
 
## called 'groupname' in issue_pat.

			




	
	
	
		
 
## The special token {repo} is replaced with the full repository name

			




	
	
	
		
 
## including repository groups, while {repo_name} is replaced with just

			




	
	
	
		
 
## the name of the repository.

			




	
	
	
		
 

			




	
	
	
		
 
issue_server_link = https://issues.example.com/{repo}/issue/\1

			




	
	
	
		
 

			




	
	
	
		
 
## substitution pattern to use as the link text

			




	
	
	
		
 
## If issue_sub is empty, the text matched by issue_pat is retained verbatim

			




	
	
	
		
 
## for the link text. Otherwise, the link text is that of issue_sub, with any

			




	
	
	
		
 
## backreferences to groups in issue_pat replaced.

			




	
	
	
		
 

			




	
	
	
		
 
issue_sub =

			




	
	
	
		
 

			




	
	
	
		
 
## issue_pat, issue_server_link and issue_sub can have suffixes to specify

			




	
	
	
		
 
## multiple patterns, to other issues server, wiki or others

			




	
	
	
		
 
## below an example how to create a wiki pattern

			




	
	
	
		
 
## wiki-some-id -> https://wiki.example.com/some-id

			




	
	
	
		
 

			




	
	
	
		
 
#issue_pat_wiki = wiki-(\S+)

			




	
	
	
		
 
#issue_server_link_wiki = https://wiki.example.com/\1

			




	
	
	
		
 
#issue_sub_wiki = WIKI-\1

			




	
	
	
		
 

			




	
	
	
		
 
## alternative return HTTP header for failed authentication. Default HTTP

			




	
	
	
		
 
## response is 401 HTTPUnauthorized. Currently Mercurial clients have trouble with

			




	
	
	
		
 
## handling that. Set this variable to 403 to return HTTPForbidden

			




	
	
	
		
 
auth_ret_code =

			




	
	
	
		
 

			




	
	
	
		
 
## allows to change the repository location in settings page

			




	
	
	
		
 
allow_repo_location_change = True

			




	
	
	
		
 

			




	
	
	
		
 
## allows to setup custom hooks in settings page

			




	
	
	
		
 
allow_custom_hooks_settings = True

			




	
	
	
		
 

			




	
	
	
		
 
## extra extensions for indexing, space separated and without the leading '.'.

			




	
	
	
		
 
#index.extensions =

			




	
	
	
		
 
#    gemfile

			




	
	
	
		
 
#    lock

			




	
	
	
		
 

			




	
	
	
		
 
## extra filenames for indexing, space separated

			




	
	
	
		
 
#index.filenames =

			




	
	
	
		
 
#    .dockerignore

			




	
	
	
		
 
#    .editorconfig

			




	
	
	
		
 
#    INSTALL

			




	
	
	
		
 
#    CHANGELOG

			




	
	
	
		
 

			




	
	
	
		
 
####################################

			




	
	
	
		
 
###           SSH CONFIG        ####

			




	
	
	
		
 
##            SSH CONFIG          ##

			




	
	
	
		
 
####################################

			




	
	
	
		
 

			




	
	
	
		
 
## SSH is disabled by default, until an Administrator decides to enable it.

			




	
	
	
		
 
ssh_enabled = false

			




	
	
	
		
 

			




	
	
	
		
 
## File where users' SSH keys will be stored *if* ssh_enabled is true.

			




	
	
	
		
 
#ssh_authorized_keys = /home/kallithea/.ssh/authorized_keys

			




	
	
	
		
 

			




	
	
	
		
 
## Path to be used in ssh_authorized_keys file to invoke kallithea-cli with ssh-serve.

			




	
	
	
		
 
#kallithea_cli_path = /srv/kallithea/venv/bin/kallithea-cli

			




	
	
	
		
 

			




	
	
	
		
 
## Locale to be used in the ssh-serve command.

			




	
	
	
		
 
## This is needed because an SSH client may try to use its own locale

			




	
	
	
		
 
## settings, which may not be available on the server.

			




	
	
	
		
 
## See `locale -a` for valid values on this system.

			




	
	
	
		
 
#ssh_locale = C.UTF-8

			




	
	
	
		
 

			




	
	
	
		
 
####################################

			




	
	
	
		
 
###        CELERY CONFIG        ####

			




	
	
	
		
 
##         CELERY CONFIG          ##

			




	
	
	
		
 
####################################

			




	
	
	
		
 

			




	
	
	
		
 
## Note: Celery doesn't support Windows.

			




	
	
	
		
 
use_celery = false

			




	
	
	
		
 

			




	
	
	
		
 
## Celery config settings from https://docs.celeryproject.org/en/4.4.0/userguide/configuration.html prefixed with 'celery.'.

			




	
	
	
		
 

			




	
	
	
		
 
## Example: use the message queue on the local virtual host 'kallitheavhost' as the RabbitMQ user 'kallithea':

			




	
	
	
		
 
celery.broker_url = amqp://kallithea:thepassword@localhost:5672/kallitheavhost

			




	
	
	
		
 

			




	
	
	
		
 
celery.result.backend = db+sqlite:///celery-results.db

			




	
	
	
		
 

			




	
	
	
		
 
#celery.amqp.task.result.expires = 18000

			




	
	
	
		
 

			




	
	
	
		
 
celery.worker_concurrency = 2

			




	
	
	
		
 
celery.worker_max_tasks_per_child = 1

			




	
	
	
		
 

			




	
	
	
		
 
## If true, tasks will never be sent to the queue, but executed locally instead.

			




	
	
	
		
 
celery.task_always_eager = false

			




	
	
	
		
 

			




	
	
	
		
 
####################################

			




	
	
	
		
 
###         BEAKER CACHE        ####

			




	
	
	
		
 
##          BEAKER CACHE          ##

			




	
	
	
		
 
####################################

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.data_dir = %(here)s/data/cache/data

			




	
	
	
		
 
beaker.cache.lock_dir = %(here)s/data/cache/lock

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.regions = long_term,long_term_file

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.long_term.type = memory

			




	
	
	
		
 
beaker.cache.long_term.expire = 36000

			




	
	
	
		
 
beaker.cache.long_term.key_length = 256

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.long_term_file.type = file

			




	
	
	
		
 
beaker.cache.long_term_file.expire = 604800

			




	
	
	
		
 
beaker.cache.long_term_file.key_length = 256

			




	
	
	
		
 

			




	
	
	
		
 
####################################

			




	
	
	
		
 
###       BEAKER SESSION        ####

			




	
	
	
		
 
##        BEAKER SESSION          ##

			




	
	
	
		
 
####################################

			




	
	
	
		
 

			




	
	
	
		
 
## Name of session cookie. Should be unique for a given host and path, even when running

			




	
	
	
		
 
## on different ports. Otherwise, cookie sessions will be shared and messed up.

			




	
	
	
		
 
session.key = kallithea

			




	
	
	
		
 
## Sessions should always only be accessible by the browser, not directly by JavaScript.

			




	
	
	
		
 
session.httponly = true

			




	
	
	
		
 
## Session lifetime. 2592000 seconds is 30 days.

			




	
	
	
		
 
session.timeout = 2592000

			




	
	
	
		
 

			




	
	
	
		
 
## Server secret used with HMAC to ensure integrity of cookies.

			




	
	
	
		
 
#session.secret = VERY-SECRET

			




	
	
	
		
 
session.secret = development-not-secret

			




	
	
	
		
 
## Further, encrypt the data with AES.

			




	
	
	
		
 
#session.encrypt_key = <key_for_encryption>

			




	
	
	
		
 
#session.validate_key = <validation_key>

			




	
	
	
		
 

			




	
	
	
		
 
## Type of storage used for the session, current types are

			




	
	
	
		
 
## dbm, file, memcached, database, and memory.

			




	
	
	
		
 

			




	
	
	
		
 
## File system storage of session data. (default)

			




	
	
	
		
 
#session.type = file

			




	
	
	
		
 

			




	
	
	
		
 
## Cookie only, store all session data inside the cookie. Requires secure secrets.

			




	
	
	
		
 
#session.type = cookie

			




	
	
	
		
 

			




	
	
	
		
 
## Database storage of session data.

			




	
	
	
		
 
#session.type = ext:database

			




	
	
	
		
 
#session.sa.url = postgresql://postgres:qwe@localhost/kallithea

			




	
	
	
		
 
#session.table_name = db_session

			




	
	
	
		
 

			




	
	
	
		
 
####################################

			




	
	
	
		
 
###       ERROR HANDLING        ####

			




	
	
	
		
 
##        ERROR HANDLING          ##

			




	
	
	
		
 
####################################

			




	
	
	
		
 

			




	
	
	
		
 
## Show a nice error page for application HTTP errors and exceptions (default true)

			




	
	
	
		
 
#errorpage.enabled = true

			




	
	
	
		
 

			




	
	
	
		
 
## Enable Backlash client-side interactive debugger (default false)

			




	
	
	
		
 
## WARNING: *THIS MUST BE false IN PRODUCTION ENVIRONMENTS!!!*

			




	
	
	
		
 
## This debug mode will allow all visitors to execute malicious code.

			




	
	
	
		
 
#debug = false

			




	
	
	
		
 
debug = true

			




	
	
	
		
 

			




	
	
	
		
 
## Enable Backlash server-side error reporting (unless debug mode handles it client-side) (default true)

			




	
	
	
		
 
#trace_errors.enable = true

			




	
	
	
		
 
## Errors will be reported by mail if trace_errors.error_email is set.

			




	
	
	
		
 

			




	
	
	
		
 
## Propagate email settings to ErrorReporter of TurboGears2

			




	
	
	
		
 
## You do not normally need to change these lines

			




	
	
	
		
 
get trace_errors.smtp_server = smtp_server

			




	
	
	
		
 
get trace_errors.smtp_port = smtp_port

			




	
	
	
		
 
get trace_errors.from_address = error_email_from

			




	
	
	
		
 
get trace_errors.error_email = email_to

			




	
	
	
		
 
get trace_errors.smtp_username = smtp_username

			




	
	
	
		
 
get trace_errors.smtp_password = smtp_password

			




	
	
	
		
 
get trace_errors.smtp_use_tls = smtp_use_tls

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
##################################

			




	
	
	
		
 
###       LOGVIEW CONFIG       ###

			




	
	
	
		
 
##        LOGVIEW CONFIG        ##

			




	
	
	
		
 
##################################

			




	
	
	
		
 

			




	
	
	
		
 
logview.sqlalchemy = #faa

			




	
	
	
		
 
logview.pylons.templating = #bfb

			




	
	
	
		
 
logview.pylons.util = #eee

			




	
	
	
		
 

			




	
	
	
		
 
#########################################################

			




	
	
	
		
 
### DB CONFIGS - EACH DB WILL HAVE IT'S OWN CONFIG    ###

			




	
	
	
		
 
#########################################################

			




	
	
	
		
 
#########################

			




	
	
	
		
 
##      DB CONFIG      ##

			




	
	
	
		
 
#########################

			




	
	
	
		
 

			




	
	
	
		
 
## SQLITE [default]

			




	
	
	
		
 
sqlalchemy.url = sqlite:///%(here)s/kallithea.db?timeout=60

			




	
	
	
		
 

			




	
	
	
		
 
## see sqlalchemy docs for other backends

			




	
	
	
		
 

			




	
	
	
		
 
sqlalchemy.pool_recycle = 3600

			




	
	
	
		
 

			




	
	
	
		
 
################################

			




	
	
	
		
 
### ALEMBIC CONFIGURATION   ####

			




	
	
	
		
 
##   ALEMBIC CONFIGURATION    ##

			




	
	
	
		
 
################################

			




	
	
	
		
 

			




	
	
	
		
 
[alembic]

			




	
	
	
		
 
script_location = kallithea:alembic

			




	
	
	
		
 

			




	
	
	
		
 
################################

			




	
	
	
		
 
### LOGGING CONFIGURATION   ####

			




	
	
	
		
 
##   LOGGING CONFIGURATION    ##

			




	
	
	
		
 
################################

			




	
	
	
		
 

			




	
	
	
		
 
[loggers]

			




	
	
	
		
 
keys = root, routes, kallithea, sqlalchemy, tg, gearbox, beaker, templates, whoosh_indexer, werkzeug, backlash

			




	
	
	
		
 

			




	
	
	
		
 
[handlers]

			




	
	
	
		
 
keys = console, console_color, console_color_sql, null

			




	
	
	
		
 

			




	
	
	
		
 
[formatters]

			




	
	
	
		
 
keys = generic, color_formatter, color_formatter_sql

			




	
	
	
		
 

			




	
	
	
		
 
#############

			




	
	
	
		
 
## LOGGERS ##

			




	
	
	
		
 
#############

			




	
	
	
		
 

			




	
	
	
		
 
[logger_root]

			




	
	
	
		
 
level = NOTSET

			




	
	
	
		
 
#handlers = console

			




	
	
	
		
 
## For coloring based on log level:

			




	
	
	
		
 
handlers = console_color

			




	
	
	
		
 

			




	
	
	
		
 
[logger_routes]

			




	
	
	
		
 
#level = WARN

			




	
	
	
		
 
level = DEBUG

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = routes.middleware

			




	
	
	
		
 
## "level = DEBUG" logs the route matched and routing variables.

			




	
	
	
		
 

			




	
	
	
		
 
[logger_beaker]

			




	
	
	
		
 
#level = WARN

			




	
	
	
		
 
level = DEBUG

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = beaker.container

			




	
	
	
		
 

			




	
	
	
		
 
[logger_templates]

			




	
	
	
		
 
#level = WARN

			




	
	
	
		
 
level = INFO

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = pylons.templating

			




	
	
	
		
 

			




	
	
	
		
 
[logger_kallithea]

			




	
	
	
		
 
#level = WARN

			




	
	
	
		
 
level = DEBUG

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = kallithea

			




	
	
	
		
 

			




	
	
	
		
 
[logger_tg]

			




	
	
	
		
 
#level = WARN

			




	
	
	
		
 
level = DEBUG

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = tg

			




	
	
	
		
 

			




	
	
	
		
 
[logger_gearbox]

			




	
	
	
		
 
#level = WARN

			




	
	
	
		
 
level = DEBUG

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = gearbox

			




	
	
	
		
 

			




	
	
	
		
 
[logger_sqlalchemy]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = sqlalchemy.engine

			




	
	
	
		
 
## For coloring based on log level and pretty printing of SQL:

			




	
	
	
		
 
#level = INFO

			




	
	
	
		
 
#handlers = console_color_sql

			




	
	
	
		
 
#propagate = 0

			




	
	
	
		
 

			




	
	
	
		
 
[logger_whoosh_indexer]

			




	
	
	
		
 
#level = WARN

			




	
	
	
		
 
level = DEBUG

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = whoosh_indexer

			




	
	
	
		
 

			




	
	
	
		
 
[logger_werkzeug]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = werkzeug

			




	
	
	
		
 

			




	
	
	
		
 
[logger_backlash]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = backlash

			




	
	
	
		
 

			




	
	
	
		
 
##############

			




	
	
	
		
 
## HANDLERS ##

			




	
	
	
		
 
##############

			




	
	
	
		
 

			




	
	
	
		
 
[handler_console]

			




	
	
	
		
 
class = StreamHandler

			




	
	
	
		
 
args = (sys.stderr,)

			




	
	
	
		
 
formatter = generic

			




	
	
	
		
 

			




	
	
	
		
 
[handler_console_color]

			




	
	
	
		
 
## ANSI color coding based on log level

			




	
	
	
		
 
class = StreamHandler

			




	
	
	
		
 
args = (sys.stderr,)

			




	
	
	
		
 
formatter = color_formatter

			




	
	
	
		
 

			




	
	
	
		
 
[handler_console_color_sql]

			




	
	
	
		
 
## ANSI color coding and pretty printing of SQL statements

			




	
	
	
		
 
class = StreamHandler

			




	
	
	
		
 
args = (sys.stderr,)

			




	
	
	
		
 
formatter = color_formatter_sql

			




	
	
	
		
 

			




	
	
	
		
 
[handler_null]

			




	
	
	
		
 
class = NullHandler

			




	
	
	
		
 
args = ()

			




	
	
	
		
 

			




	
	
	
		
 
################

			




	
	
	
		
 
## FORMATTERS ##

			




	
	
	
		
 
################

			




	
	
	
		
 

			




	
	
	
		
 
[formatter_generic]

			




	
	
	
		
 
format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s

			




	
	
	
		
 
datefmt = %Y-%m-%d %H:%M:%S

			




	
	
	
		
 

			




	
	
	
		
 
[formatter_color_formatter]

			




	
	
	
		
 
class = kallithea.lib.colored_formatter.ColorFormatter

			




	
	
	
		
 
format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s

			




	
	
	
		
 
datefmt = %Y-%m-%d %H:%M:%S

			




	
	
	
		
 

			




	
	
	
		
 
[formatter_color_formatter_sql]

			




	
	
	
		
 
class = kallithea.lib.colored_formatter.ColorFormatterSql

			




	
	
	
		
 
format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s

			




	
	
	
		
 
datefmt = %Y-%m-%d %H:%M:%S

			




	
	
	
		
 

			




	
	
	
		
 
#################

			




	
	
	
		
 
## SSH LOGGING ##

			




	
	
	
		
 
#################

			




	
	
	
		
 

			




	
	
	
		
 
## The default loggers use 'handler_console' that uses StreamHandler with

			




	
	
	
		
 
## destination 'sys.stderr'. In the context of the SSH server process, these log

			




	
	
	
		
 
## messages would be sent to the client, which is normally not what you want.

			




	
	
	
		
 
## By default, when running ssh-serve, just use NullHandler and disable logging

			




	
	
	
		
 
## completely. For other logging options, see:

			




	
	
	
		
 
## https://docs.python.org/2/library/logging.handlers.html

			




	
	
	
		
 

			




	
	
	
		
 
[ssh_serve:logger_root]

			




	
	
	
		
 
level = CRITICAL

			




	
	
	
		
 
handlers = null

			




	
	
	
		
 

			




	
	
	
		
 
## Note: If logging is configured with other handlers, they might need similar

			




	
	
	
		
 
## muting for ssh-serve too.

			




        

    


    
    

    

        

                

                    docs/overview.rst
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
.. _overview:

			




	
	
	
		
 

			




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

			




	
	
	
		
 
Installation overview

			




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

			




	
	
	
		
 

			




	
	
	
		
 
Some overview and some details that can help understanding the options when

			




	
	
	
		
 
installing Kallithea.

			




	
	
	
		
 

			




	
	
	
		
 
1. **Prepare environment and external dependencies.**

			




	
	
	
		
 
    Kallithea needs:

			




	
	
	
		
 

			




	
	
	
		
 
    * A filesystem where the Mercurial and Git repositories can be stored.

			




	
	
	
		
 
    * A database where meta data can be stored.

			




	
	
	
		
 
    * A Python environment where the Kallithea application and its dependencies

			




	
	
	
		
 
      can be installed.

			




	
	
	
		
 
    * A web server that can host the Kallithea web application using the WSGI

			




	
	
	
		
 
      API.

			




	
	
	
		
 

			




	
	
	
		
 
2. **Install Kallithea software.**

			




	
	
	
		
 
    This makes the ``kallithea-cli`` command line tool available.

			




	
	
	
		
 

			




	
	
	
		
 
3. **Create low level configuration file.**

			




	
	
	
		
 
    Use ``kallithea-cli config-create`` to create a ``.ini`` file with database

			




	
	
	
		
 
    connection info, mail server information, some web server configuration,

			




	
	
	
		
 
    etc.

			




	
	
	
		
 

			




	
	
	
		
 
4. **Populate the database.**

			




	
	
	
		
 
    Use ``kallithea-cli db-create`` with the ``.ini`` file to create the

			




	
	
	
		
 
    database schema and insert the most basic information: the location of the

			




	
	
	
		
 
    repository store and an initial local admin user.

			




	
	
	
		
 

			




	
	
	
		
 
5. **Configure the web server.**

			




	
	
	
		
 
    The web server must invoke the WSGI entrypoint for the Kallithea software

			




	
	
	
		
 
    using the ``.ini`` file (and thus the database). This makes the web

			




	
	
	
		
 
    application available so the local admin user can log in and tweak the

			




	
	
	
		
 
    configuration further.

			




	
	
	
		
 

			




	
	
	
		
 
6. **Configure users.**

			




	
	
	
		
 
    The initial admin user can create additional local users, or configure how

			




	
	
	
		
 
    users can be created and authenticated from other user directories.

			




	
	
	
		
 

			




	
	
	
		
 
See the subsequent sections, the separate OS-specific instructions, and

			




	
	
	
		
 
:ref:`setup` for details on these steps.

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
Python environment

			




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

			




	
	
	
		
 

			




	
	
	
		
 
**Kallithea** is written entirely in Python_ and requires Python version

			




	
	
	
		
 
3.6 or higher.

			




	
	
	
		
 

			




	
	
	
		
 
Given a Python installation, there are different ways of providing the

			




	
	
	
		
 
environment for running Python applications. Each of them pretty much

			




	
	
	
		
 
corresponds to a ``site-packages`` directory somewhere where packages can be

			




	
	
	
		
 
installed.

			




	
	
	
		
 

			




	
	
	
		
 
Kallithea itself can be run from source or be installed, but even when running

			




	
	
	
		
 
from source, there are some dependencies that must be installed in the Python

			




	
	
	
		
 
environment used for running Kallithea.

			




	
	
	
		
 

			




	
	
	
		
 
- Packages *could* be installed in Python's ``site-packages`` directory ... but

			




	
	
	
		
 
  that would require running pip_ as root and it would be hard to uninstall or

			




	
	
	
		
 
  upgrade and is probably not a good idea unless using a package manager.

			




	
	
	
		
 

			




	
	
	
		
 
- Packages could also be installed in ``~/.local`` ... but that is probably

			




	
	
	
		
 
  only a good idea if using a dedicated user per application or instance.

			




	
	
	
		
 

			




	
	
	
		
 
- Finally, it can be installed in a virtualenv. That is a very lightweight

			




	
	
	
		
 
  "container" where each Kallithea instance can get its own dedicated and

			




	
	
	
		
 
  self-contained virtual environment.

			




	
	
	
		
 

			




	
	
	
		
 
We recommend using virtualenv for installing Kallithea.

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
Locale environment

			




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

			




	
	
	
		
 

			




	
	
	
		
 
In order to ensure a correct functioning of Kallithea with respect to non-ASCII

			




	
	
	
		
 
characters in user names, file paths, commit messages, etc., it is very

			




	
	
	
		
 
important that Kallithea is run with a correct `locale` configuration.

			




	
	
	
		
 

			




	
	
	
		
 
On Unix, environment variables like ``LANG`` or ``LC_ALL`` can specify a language (like

			




	
	
	
		
 
``en_US``) and encoding (like ``UTF-8``) to use for code points outside the ASCII

			




	
	
	
		
 
range. The flexibility of supporting multiple encodings of Unicode has the flip

			




	
	
	
		
 
side of having to specify which encoding to use - especially for Mercurial.

			




	
	
	
		
 

			




	
	
	
		
 
It depends on the OS distribution and system configuration which locales are

			




	
	
	
		
 
available. For example, some Docker containers based on Debian default to only

			




	
	
	
		
 
supporting the ``C`` language, while other Linux environments have ``en_US`` but not

			




	
	
	
		
 
``C``. The ``locale -a`` command will show which values are available on the

			




	
	
	
		
 
current system. Regardless of the actual language, you should normally choose a

			




	
	
	
		
 
locale that has the ``UTF-8`` encoding (note that spellings ``utf8``, ``utf-8``,

			




	
	
	
		
 
``UTF8``, ``UTF-8`` are all referring to the same thing)

			




	
	
	
		
 

			




	
	
	
		
 
For technical reasons, the locale configuration **must** be provided in the

			




	
	
	
		
 
environment in which Kallithea runs - it cannot be specified in the ``.ini`` file.

			




	
	
	
		
 
How to practically do this depends on the web server that is used and the way it

			




	
	
	
		
 
is started. For example, gearbox is often started by a normal user, either

			




	
	
	
		
 
manually or via a script. In this case, the required locale environment

			




	
	
	
		
 
variables can be provided directly in that user's environment or in the script.

			




	
	
	
		
 
However, web servers like Apache are often started at boot via an init script or

			




	
	
	
		
 
service file. Modifying the environment for this case would thus require

			




	
	
	
		
 
root/administrator privileges. Moreover, that environment would dictate the

			




	
	
	
		
 
settings for all web services running under that web server, Kallithea being

			




	
	
	
		
 
just one of them. Specifically in the case of Apache with ``mod_wsgi``, the

			




	
	
	
		
 
locale can be set for a specific service in its ``WSGIDaemonProcess`` directive,

			




	
	
	
		
 
using the ``lang`` parameter.

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
Installation methods

			




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

			




	
	
	
		
 

			




	
	
	
		
 
Kallithea must be installed on a server. Kallithea is installed in a Python

			




	
	
	
		
 
environment so it can use packages that are installed there and make itself

			




	
	
	
		
 
available for other packages.

			




	
	
	
		
 

			




	
	
	
		
 
Two different cases will pretty much cover the options for how it can be

			




	
	
	
		
 
installed.

			




	
	
	
		
 

			




	
	
	
		
 
- The Kallithea source repository can be cloned and used -- it is kept stable and

			




	
	
	
		
 
  can be used in production. The Kallithea maintainers use the development

			




	
	
	
		
 
  branch in production. The advantage of installation from source and regularly

			




	
	
	
		
 
  updating it is that you take advantage of the most recent improvements. Using

			




	
	
	
		
 
  it directly from a DVCS also means that it is easy to track local customizations.

			




	
	
	
		
 

			




	
	
	
		
 
  Running ``pip install -e .`` in the source will use pip to install the

			




	
	
	
		
 
  necessary dependencies in the Python environment and create a

			




	
	
	
		
 
  ``.../site-packages/Kallithea.egg-link`` file there that points at the Kallithea

			




	
	
	
		
 
  source.

			




	
	
	
		
 

			




	
	
	
		
 
- Kallithea can also be installed from ready-made packages using a package manager.

			




	
	
	
		
 
  The official released versions are available on PyPI_ and can be downloaded and

			




	
	
	
		
 
  installed with all dependencies using ``pip install kallithea``.

			




	
	
	
		
 

			




	
	
	
		
 
  With this method, Kallithea is installed in the Python environment as any

			




	
	
	
		
 
  other package, usually as a ``.../site-packages/Kallithea-X-py3.8.egg/``

			




	
	
	
		
 
  directory with Python files and everything else that is needed.

			




	
	
	
		
 

			




	
	
	
		
 
  (``pip install kallithea`` from a source tree will do pretty much the same

			




	
	
	
		
 
  but build the Kallithea package itself locally instead of downloading it.)

			




	
	
	
		
 

			




	
	
	
		
 
.. note::

			




	
	
	
		
 
   Kallithea includes front-end code that needs to be processed first.

			




	
	
	
		
 
   The tool npm_ is used to download external dependencies and orchestrate the

			




	
	
	
		
 
   processing. The ``npm`` binary must thus be available.

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
Web server

			




	
	
	
		
 
----------

			




	
	
	
		
 

			




	
	
	
		
 
Kallithea is (primarily) a WSGI_ application that must be run from a web

			




	
	
	
		
 
server that serves WSGI applications over HTTP.

			




	
	
	
		
 

			




	
	
	
		
 
Kallithea itself is not serving HTTP (or HTTPS); that is the web server's

			




	
	
	
		
 
responsibility. Kallithea does however need to know its own user facing URL

			




	
	
	
		
 
(protocol, address, port and path) for each HTTP request. Kallithea will

			




	
	
	
		
 
usually use its own HTML/cookie based authentication but can also be configured

			




	
	
	
		
 
to use web server authentication.

			




	
	
	
		
 

			




	
	
	
		
 
There are several web server options:

			




	
	
	
		
 

			




	
	
	
		
 
- Kallithea uses the Gearbox_ tool as command line interface. Gearbox provides

			




	
	
	
		
 
  ``gearbox serve`` as a convenient way to launch a Python WSGI / web server

			




	
	
	
		
 
  from the command line. That is perfect for development and evaluation.

			




	
	
	
		
 
  Actual use in production might have different requirements and need extra

			




	
	
	
		
 
  work to make it manageable as a scalable system service.

			




	
	
	
		
 

			




	
	
	
		
 
  Gearbox comes with its own built-in web server but Kallithea defaults to use

			




	
	
	
		
 
  Waitress_. Gunicorn_ is also an option. These web servers have different

			




	
	
	
		
 
  limited feature sets.

			




	
	
	
		
 

			




	
	
	
		
 
  The web server used by ``gearbox`` is configured in the ``.ini`` file passed

			




	
	
	
		
 
  to it. The entry point for the WSGI application is configured

			




	
	
	
		
 
  in ``setup.py`` as ``kallithea.config.middleware:make_app``.

			




	
	
	
		
 

			




	
	
	
		
 
- `Apache httpd`_ can serve WSGI applications directly using mod_wsgi_ and a

			




	
	
	
		
 
  simple Python file with the necessary configuration. This is a good option if

			




	
	
	
		
 
  Apache is an option.

			




	
	
	
		
 

			




	
	
	
		
 
- uWSGI_ is also a full web server with built-in WSGI module.

			




	
	
	
		
 

			




	
	
	
		
 
- IIS_ can also server WSGI applications directly using isapi-wsgi_.

			




	
	
	
		
 

			




	
	
	
		
 
- A `reverse HTTP proxy <https://en.wikipedia.org/wiki/Reverse_proxy>`_

			




	
	
	
		
 
  can be put in front of another web server which has WSGI support.

			




	
	
	
		
 
  Such a layered setup can be complex but might in some cases be the right

			




	
	
	
		
 
  option, for example to standardize on one internet-facing web server, to add

			




	
	
	
		
 
  encryption or special authentication or for other security reasons, to

			




	
	
	
		
 
  provide caching of static files, or to provide load balancing or fail-over.

			




	
	
	
		
 
  Nginx_, Varnish_ and HAProxy_ are often used for this purpose, often in front

			




	
	
	
		
 
  of a ``gearbox serve`` that somehow is wrapped as a service.

			




	
	
	
		
 

			




	
	
	
		
 
The best option depends on what you are familiar with and the requirements for

			




	
	
	
		
 
performance and stability. Also, keep in mind that Kallithea mainly is serving

			




	
	
	
		
 
dynamically generated pages from a relatively slow Python process. Kallithea is

			




	
	
	
		
 
also often used inside organizations with a limited amount of users and thus no

			




	
	
	
		
 
continuous hammering from the internet.

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
.. _Python: http://www.python.org/

			




	
	
	
		
 
.. _Gunicorn: http://gunicorn.org/

			




	
	
	
		
 
.. _Waitress: http://waitress.readthedocs.org/en/latest/

			




	
	
	
		
 
.. _Gearbox: http://turbogears.readthedocs.io/en/latest/turbogears/gearbox.html

			




	
	
	
		
 
.. _PyPI: https://pypi.python.org/pypi

			




	
	
	
		
 
.. _Apache httpd: http://httpd.apache.org/

			




	
	
	
		
 
.. _mod_wsgi: https://code.google.com/p/modwsgi/

			




	
	
	
		
 
.. _isapi-wsgi: https://github.com/hexdump42/isapi-wsgi

			




	
	
	
		
 
.. _uWSGI: https://uwsgi-docs.readthedocs.org/en/latest/

			




	
	
	
		
 
.. _nginx: http://nginx.org/en/

			




	
	
	
		
 
.. _iis: http://en.wikipedia.org/wiki/Internet_Information_Services

			




	
	
	
		
 
.. _pip: http://en.wikipedia.org/wiki/Pip_%28package_manager%29

			




	
	
	
		
 
.. _WSGI: http://en.wikipedia.org/wiki/Web_Server_Gateway_Interface

			




	
	
	
		
 
.. _HAProxy: http://www.haproxy.org/

			




	
	
	
		
 
.. _Varnish: https://www.varnish-cache.org/

			




	
	
	
		
 
.. _npm: https://www.npmjs.com/

			




        

    


    
    

    

        

                

                    docs/theme/nature/layout.html
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
{% extends "basic/layout.html" %}

			




	
	
	
		
 

			




	
	
	
		
 
{% block sidebarlogo %}

			




	
	
	
		
 
<div style="text-align:center;margin:30px 0;">

			




	
	
	
		
 
  <img src="{{pathto('_static/kallithea-logo.svg',1)}}" width="200px"/>

			




	
	
	
		
 
</div>

			




	
	
	
		
 
<h3>Support Kallithea development</h3>

			




	
	
	
		
 
<div style="text-align:center">

			




	
	
	
		
 
<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="_top">

			




	
	
	
		
 
<input type="hidden" name="cmd" value="_s-xclick">

			




	
	
	
		
 
<input type="hidden" name="hosted_button_id" value="EYXFS3SQPHYUL">

			




	
	
	
		
 
<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal &ndash; The safer, easier way to pay online!">

			




	
	
	
		
 
<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">

			




	
	
	
		
 
</form>

			




	
	
	
		
 
    <div style="padding:5px">

			




	
	
	
		
 
     <a href="https://flattr.com/thing/922714/Donate-to-Software-Freedom-Conservancy" target="_blank">

			




	
	
	
		
 
     <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" border="0" /></a>

			




	
	
	
		
 
    </div>

			




	
	
	
		
 
</div>

			




	
	
	
		
 
{% endblock %}}

			




	
	
	
		
 
{% endblock %}

			




        

    


    
    

    

        

                

                    kallithea/bin/kallithea_cli_config.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



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

			




	
	
	
		
 
import sys

			




	
	
	
		
 
import uuid

			




	
	
	
		
 
from collections import defaultdict

			




	
	
	
		
 

			




	
	
	
		
 
import click

			




	
	
	
		
 
import mako.exceptions

			




	
	
	
		
 

			




	
	
	
		
 
import kallithea.bin.kallithea_cli_base as cli_base

			




	
	
	
		
 
import kallithea.lib.locale

			




	
	
	
		
 
from kallithea.lib import inifile

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
def show_defaults(ctx, param, value):

			




	
	
	
		
 
    # Following construct is taken from the Click documentation:

			




	
	
	
		
 
    # https://click.palletsprojects.com/en/7.x/options/#callbacks-and-eager-options

			




	
	
	
		
 
    # "The resilient_parsing flag is applied to the context if Click wants to

			




	
	
	
		
 
    # parse the command line without any destructive behavior that would change

			




	
	
	
		
 
    # the execution flow. In this case, because we would exit the program, we

			




	
	
	
		
 
    # instead do nothing."

			




	
	
	
		
 
    if not value or ctx.resilient_parsing:

			




	
	
	
		
 
        return

			




	
	
	
		
 

			




	
	
	
		
 
    for key, value in inifile.default_variables.items():

			




	
	
	
		
 
        click.echo('%s=%s' % (key, value))

			




	
	
	
		
 

			




	
	
	
		
 
    ctx.exit()

			




	
	
	
		
 

			




	
	
	
		
 
@cli_base.register_command()

			




	
	
	
		
 
@click.option('--show-defaults', callback=show_defaults,

			




	
	
	
		
 
              is_flag=True, expose_value=False, is_eager=True,

			




	
	
	
		
 
              help='Show the default values that can be overridden')

			




	
	
	
		
 
@click.argument('config_file', type=click.Path(dir_okay=False, writable=True), required=True)

			




	
	
	
		
 
@click.argument('key_value_pairs', nargs=-1)

			




	
	
	
		
 
def config_create(config_file, key_value_pairs):

			




	
	
	
		
 
    """Create a new configuration file.

			




	
	
	
		
 

			




	
	
	
		
 
    This command creates a default configuration file, possibly adding/updating

			




	
	
	
		
 
    settings you specify.

			




	
	
	
		
 

			




	
	
	
		
 
    The primary high level configuration keys and their default values are

			




	
	
	
		
 
    shown with --show-defaults . Custom values for these keys can be specified

			




	
	
	
		
 
    on the command line as key=value arguments.

			




	
	
	
		
 

			




	
	
	
		
 
    Additional key=value arguments will be patched/inserted in the [app:main]

			




	
	
	
		
 
    section ... until another section name specifies where any following values

			




	
	
	
		
 
    should go.

			




	
	
	
		
 
    """

			




	
	
	
		
 

			




	
	
	
		
 
    mako_variable_values = {

			




	
	
	
		
 
        'version': kallithea.__version__,

			




	
	
	
		
 
        'git_hook_interpreter': sys.executable,

			




	
	
	
		
 
        'user_home_path': os.path.expanduser('~'),

			




	
	
	
		
 
        'kallithea_cli_path': cli_base.kallithea_cli_path,

			




	
	
	
		
 
        'ssh_locale': kallithea.lib.locale.get_current_locale(),

			




	
	
	
		
 
    }

			




	
	
	
		
 
    ini_settings = defaultdict(dict)

			




	
	
	
		
 

			




	
	
	
		
 
    section_name = None

			




	
	
	
		
 
    for parameter in key_value_pairs:

			




	
	
	
		
 
        parts = parameter.split('=', 1)

			




	
	
	
		
 
        if len(parts) == 1 and parameter.startswith('[') and parameter.endswith(']'):

			




	
	
	
		
 
            section_name = parameter

			




	
	
	
		
 
        elif len(parts) == 2:

			




	
	
	
		
 
            key, value = parts

			




	
	
	
		
 
            if section_name is None and key in inifile.default_variables:

			




	
	
	
		
 
                mako_variable_values[key] = value

			




	
	
	
		
 
            else:

			




	
	
	
		
 
                if section_name is None:

			




	
	
	
		
 
                    section_name = '[app:main]'

			




	
	
	
		
 
                ini_settings[section_name][key] = value

			




	
	
	
		
 
        else:

			




	
	
	
		
 
            raise ValueError("Invalid name=value parameter %r" % parameter)

			




	
	
	
		
 

			




	
	
	
		
 
    # use default that cannot be replaced

			




	
	
	
		
 
    mako_variable_values.update({

			




	
	
	
		
 
        'uuid': lambda: uuid.uuid4().hex,

			




	
	
	
		
 
    })

			




	
	
	
		
 

			




	
	
	
		
 
    click.echo('Creating config file using:')

			




	
	
	
		
 
    for key, value in inifile.default_variables.items():

			




	
	
	
		
 
        if isinstance(value, str):

			




	
	
	
		
 
            options = inifile.variable_options.get(key)

			




	
	
	
		
 
            if options:

			




	
	
	
		
 
                click.echo('  %s=%s  (options: %s)' % (key, mako_variable_values.get(key, value), ', '.join(options)))

			




	
	
	
		
 
            else:

			




	
	
	
		
 
                click.echo('  %s=%s' % (key, mako_variable_values.get(key, value)))

			




	
	
	
		
 

			




	
	
	
		
 
    try:

			




	
	
	
		
 
        config_file_abs = os.path.abspath(config_file)

			




	
	
	
		
 
        inifile.create(config_file_abs, mako_variable_values, ini_settings)

			




	
	
	
		
 
        click.echo('Wrote new config file in %s' % config_file_abs)

			




	
	
	
		
 
        click.echo("Don't forget to build the front-end using 'kallithea-cli front-end-build'.")

			




	
	
	
		
 

			




	
	
	
		
 
    except Exception:

			




	
	
	
		
 
        click.echo(mako.exceptions.text_error_template().render())

			




        

    


    
    

    

        

                

                    kallithea/lib/auth_modules/auth_crowd.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
# -*- 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/>.

			




	
	
	
		
 
"""

			




	
	
	
		
 
kallithea.lib.auth_modules.auth_crowd

			




	
	
	
		
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

			




	
	
	
		
 

			




	
	
	
		
 
Kallithea authentication plugin for Atlassian CROWD

			




	
	
	
		
 

			




	
	
	
		
 
This file was forked by the Kallithea project in July 2014.

			




	
	
	
		
 
Original author and date, and relevant copyright and licensing information is below:

			




	
	
	
		
 
:created_on: Created on Nov 17, 2012

			




	
	
	
		
 
:author: marcink

			




	
	
	
		
 
:copyright: (c) 2013 RhodeCode GmbH, and others.

			




	
	
	
		
 
:license: GPLv3, see LICENSE.md for more details.

			




	
	
	
		
 
"""

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
import base64

			




	
	
	
		
 
import logging

			




	
	
	
		
 
import urllib.parse

			




	
	
	
		
 
import urllib.request

			




	
	
	
		
 

			




	
	
	
		
 
from kallithea.lib import auth_modules, ext_json

			




	
	
	
		
 
from kallithea.lib.compat import hybrid_property

			




	
	
	
		
 
from kallithea.lib.utils2 import ascii_bytes, ascii_str, safe_bytes

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
log = logging.getLogger(__name__)

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class CrowdServer(object):

			




	
	
	
		
 
    def __init__(self, *args, **kwargs):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Create a new CrowdServer object that points to IP/Address 'host',

			




	
	
	
		
 
        on the given port, and using the given method (https/http). user and

			




	
	
	
		
 
        passwd can be set here or with set_credentials. If unspecified,

			




	
	
	
		
 
        "version" defaults to "latest".

			




	
	
	
		
 

			




	
	
	
		
 
        example::

			




	
	
	
		
 

			




	
	
	
		
 
            cserver = CrowdServer(host="127.0.0.1",

			




	
	
	
		
 
                                  port="8095",

			




	
	
	
		
 
                                  user="some_app",

			




	
	
	
		
 
                                  passwd="some_passwd",

			




	
	
	
		
 
                                  version="1")

			




	
	
	
		
 
        """

			




	
	
	
		
 
        if "port" not in kwargs:

			




	
	
	
		
 
            kwargs["port"] = "8095"

			




	
	
	
		
 
        self._logger = kwargs.get("logger", logging.getLogger(__name__))

			




	
	
	
		
 
        self._uri = "%s://%s:%s/crowd" % (kwargs.get("method", "http"),

			




	
	
	
		
 
                                    kwargs.get("host", "127.0.0.1"),

			




	
	
	
		
 
                                    kwargs.get("port", "8095"))

			




	
	
	
		
 
        self.set_credentials(kwargs.get("user", ""),

			




	
	
	
		
 
                             kwargs.get("passwd", ""))

			




	
	
	
		
 
        self._version = kwargs.get("version", "latest")

			




	
	
	
		
 
        self._url_list = None

			




	
	
	
		
 
        self._appname = "crowd"

			




	
	
	
		
 

			




	
	
	
		
 
    def set_credentials(self, user, passwd):

			




	
	
	
		
 
        self.user = user

			




	
	
	
		
 
        self.passwd = passwd

			




	
	
	
		
 
        self._make_opener()

			




	
	
	
		
 

			




	
	
	
		
 
    def _make_opener(self):

			




	
	
	
		
 
        mgr = urllib.request.HTTPPasswordMgrWithDefaultRealm()

			




	
	
	
		
 
        mgr.add_password(None, self._uri, self.user, self.passwd)

			




	
	
	
		
 
        handler = urllib.request.HTTPBasicAuthHandler(mgr)

			




	
	
	
		
 
        self.opener = urllib.request.build_opener(handler)

			




	
	
	
		
 

			




	
	
	
		
 
    def _request(self, url, body=None, headers=None,

			




	
	
	
		
 
                 method=None, noformat=False,

			




	
	
	
		
 
                 empty_response_ok=False):

			




	
	
	
		
 
    def _request(self, url, body=None):

			




	
	
	
		
 
        _headers = {"Content-type": "application/json",

			




	
	
	
		
 
                    "Accept": "application/json"}

			




	
	
	
		
 
        if self.user and self.passwd:

			




	
	
	
		
 
            authstring = ascii_str(base64.b64encode(safe_bytes("%s:%s" % (self.user, self.passwd))))

			




	
	
	
		
 
            _headers["Authorization"] = "Basic %s" % authstring

			




	
	
	
		
 
        if headers:

			




	
	
	
		
 
            _headers.update(headers)

			




	
	
	
		
 
        log.debug("Sent to crowd at %s:\nHeaders: %s\nBody:\n%s", url, _headers, body)

			




	
	
	
		
 
        req = urllib.request.Request(url, body, _headers)

			




	
	
	
		
 
        if method:

			




	
	
	
		
 
            req.get_method = lambda: method

			




	
	
	
		
 

			




	
	
	
		
 
        global msg

			




	
	
	
		
 
        msg = ""

			




	
	
	
		
 
        msg = None

			




	
	
	
		
 
        try:

			




	
	
	
		
 
            rdoc = self.opener.open(req)

			




	
	
	
		
 
            msg = "".join(rdoc.readlines())

			




	
	
	
		
 
            if not msg and empty_response_ok:

			




	
	
	
		
 
                rval = {}

			




	
	
	
		
 
                rval["status"] = True

			




	
	
	
		
 
                rval["error"] = "Response body was empty"

			




	
	
	
		
 
            elif not noformat:

			




	
	
	
		
 
                rval = ext_json.loads(msg)

			




	
	
	
		
 
                rval["status"] = True

			




	
	
	
		
 
            else:

			




	
	
	
		
 
                rval = "".join(rdoc.readlines())

			




	
	
	
		
 
            msg = rdoc.read()

			




	
	
	
		
 
            rval = ext_json.loads(msg)

			




	
	
	
		
 
            rval["status"] = True

			




	
	
	
		
 
        except Exception as e:

			




	
	
	
		
 
            if not noformat:

			




	
	
	
		
 
                rval = {"status": False,

			




	
	
	
		
 
                        "body": body,

			




	
	
	
		
 
                        "error": str(e) + "\n" + msg}

			




	
	
	
		
 
            else:

			




	
	
	
		
 
                rval = None

			




	
	
	
		
 
            rval = {"status": False,

			




	
	
	
		
 
                    "body": body,

			




	
	
	
		
 
                    "error": "%s\n%r" % (e, msg)}

			




	
	
	
		
 
        return rval

			




	
	
	
		
 

			




	
	
	
		
 
    def user_auth(self, username, password):

			




	
	
	
		
 
        """Authenticate a user against crowd. Returns brief information about

			




	
	
	
		
 
        the user."""

			




	
	
	
		
 
        url = ("%s/rest/usermanagement/%s/authentication?username=%s"

			




	
	
	
		
 
               % (self._uri, self._version, urllib.parse.quote(username)))

			




	
	
	
		
 
        body = ascii_bytes(ext_json.dumps({"value": password}))

			




	
	
	
		
 
        return self._request(url, body)

			




	
	
	
		
 

			




	
	
	
		
 
    def user_groups(self, username):

			




	
	
	
		
 
        """Retrieve a list of groups to which this user belongs."""

			




	
	
	
		
 
        url = ("%s/rest/usermanagement/%s/user/group/nested?username=%s"

			




	
	
	
		
 
               % (self._uri, self._version, urllib.parse.quote(username)))

			




	
	
	
		
 
        return self._request(url)

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class KallitheaAuthPlugin(auth_modules.KallitheaExternalAuthPlugin):

			




	
	
	
		
 
    def __init__(self):

			




	
	
	
		
 
        self._protocol_values = ["http", "https"]

			




	
	
	
		
 

			




	
	
	
		
 
    @hybrid_property

			




	
	
	
		
 
    def name(self):

			




	
	
	
		
 
        return "crowd"

			




	
	
	
		
 

			




	
	
	
		
 
    def settings(self):

			




	
	
	
		
 
        settings = [

			




	
	
	
		
 
            {

			




	
	
	
		
 
                "name": "method",

			




	
	
	
		
 
                "validator": self.validators.OneOf(self._protocol_values),

			




	
	
	
		
 
                "type": "select",

			




	
	
	
		
 
                "values": self._protocol_values,

			




	
	
	
		
 
                "description": "The protocol used to connect to the Atlassian CROWD server.",

			




	
	
	
		
 
                "formname": "Protocol"

			




	
	
	
		
 
            },

			




	
	
	
		
 
            {

			




	
	
	
		
 
                "name": "host",

			




	
	
	
		
 
                "validator": self.validators.UnicodeString(strip=True),

			




	
	
	
		
 
                "type": "string",

			




	
	
	
		
 
                "description": "The FQDN or IP of the Atlassian CROWD Server",

			




	
	
	
		
 
                "default": "127.0.0.1",

			




	
	
	
		
 
                "formname": "Host"

			




	
	
	
		
 
            },

			




	
	
	
		
 
            {

			




	
	
	
		
 
                "name": "port",

			




	
	
	
		
 
                "validator": self.validators.Number(strip=True),

			




	
	
	
		
 
                "type": "int",

			




	
	
	
		
 
                "description": "The Port in use by the Atlassian CROWD Server",

			




	
	
	
		
 
                "default": 8095,

			




	
	
	
		
 
                "formname": "Port"

			




	
	
	
		
 
            },

			




	
	
	
		
 
            {

			




	
	
	
		
 
                "name": "app_name",

			




	
	
	
		
 
                "validator": self.validators.UnicodeString(strip=True),

			




	
	
	
		
 
                "type": "string",

			




	
	
	
		
 
                "description": "The Application Name to authenticate to CROWD",

			




	
	
	
		
 
                "default": "",

			




	
	
	
		
 
                "formname": "Application Name"

			




	
	
	
		
 
            },

			




	
	
	
		
 
            {

			




	
	
	
		
 
                "name": "app_password",

			




	
	
	
		
 
                "validator": self.validators.UnicodeString(strip=True),

			




	
	
	
		
 
                "type": "string",

			




	
	
	
		
 
                "description": "The password to authenticate to CROWD",

			




	
	
	
		
 
                "default": "",

			




	
	
	
		
 
                "formname": "Application Password"

			




	
	
	
		
 
            },

			




	
	
	
		
 
            {

			




	
	
	
		
 
                "name": "admin_groups",

			




	
	
	
		
 
                "validator": self.validators.UnicodeString(strip=True),

			




	
	
	
		
 
                "type": "string",

			




	
	
	
		
 
                "description": "A comma separated list of group names that identify users as Kallithea Administrators",

			




	
	
	
		
 
                "formname": "Admin Groups"

			




	
	
	
		
 
            }

			




	
	
	
		
 
        ]

			




	
	
	
		
 
        return settings

			




	
	
	
		
 

			




	
	
	
		
 
    def use_fake_password(self):

			




	
	
	
		
 
        return True

			




	
	
	
		
 

			




	
	
	
		
 
    def auth(self, userobj, username, password, settings, **kwargs):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Given a user object (which may be null), username, a plaintext password,

			




	
	
	
		
 
        and a settings object (containing all the keys needed as listed in settings()),

			




	
	
	
		
 
        authenticate this user's login attempt.

			




	
	
	
		
 

			




	
	
	
		
 
        Return None on failure. On success, return a dictionary of the form:

			




	
	
	
		
 

			




	
	
	
		
 
            see: KallitheaAuthPluginBase.auth_func_attrs

			




	
	
	
		
 
        This is later validated for correctness

			




	
	
	
		
 
        """

			




	
	
	
		
 
        if not username or not password:

			




	
	
	
		
 
            log.debug('Empty username or password skipping...')

			




	
	
	
		
 
            return None

			




	
	
	
		
 

			




	
	
	
		
 
        log.debug("Crowd settings: %s", settings)

			




	
	
	
		
 
        server = CrowdServer(**settings)

			




	
	
	
		
 
        server.set_credentials(settings["app_name"], settings["app_password"])

			




	
	
	
		
 
        crowd_user = server.user_auth(username, password)

			




	
	
	
		
 
        log.debug("Crowd returned: %s", crowd_user)

			




	
	
	
		
 
        if not crowd_user["status"]:

			




	
	
	
		
 
            log.error('Crowd authentication as %s returned no status', username)

			




	
	
	
		
 
            return None

			




	
	
	
		
 

			




	
	
	
		
 
        if not crowd_user.get('active'):

			




	
	
	
		
 
            log.error('Crowd authentication as %s returned in-active user', username)

			




	
	
	
		
 
            return None

			




	
	
	
		
 

			




	
	
	
		
 
        res = server.user_groups(crowd_user["name"])

			




	
	
	
		
 
        log.debug("Crowd groups: %s", res)

			




	
	
	
		
 
        crowd_user["groups"] = [x["name"] for x in res["groups"]]

			




	
	
	
		
 

			




	
	
	
		
 
        # old attrs fetched from Kallithea database

			




	
	
	
		
 
        admin = getattr(userobj, 'admin', False)

			




	
	
	
		
 
        email = getattr(userobj, 'email', '')

			




	
	
	
		
 
        firstname = getattr(userobj, 'firstname', '')

			




	
	
	
		
 
        lastname = getattr(userobj, 'lastname', '')

			




	
	
	
		
 

			




	
	
	
		
 
        user_data = {

			




	
	
	
		
 
            'username': crowd_user["name"] or username,

			




	
	
	
		
 
            'firstname': crowd_user["first-name"] or firstname,

			




	
	
	
		
 
            'lastname': crowd_user["last-name"] or lastname,

			




	
	
	
		
 
            'groups': crowd_user["groups"],

			




	
	
	
		
 
            'email': crowd_user["email"] or email,

			




	
	
	
		
 
            'admin': admin,

			




	
	
	
		
 
            'extern_name': crowd_user["name"],

			




	
	
	
		
 
        }

			




	
	
	
		
 

			




	
	
	
		
 
        # set an admin if we're in admin_groups of crowd

			




	
	
	
		
 
        for group in settings["admin_groups"].split(","):

			




	
	
	
		
 
            if group in user_data["groups"]:

			




	
	
	
		
 
                user_data["admin"] = True

			




	
	
	
		
 
        log.debug("Final crowd user object: %s", user_data)

			




	
	
	
		
 
        log.info('user %s authenticated correctly', user_data['username'])

			




	
	
	
		
 
        return user_data

			




	
	
	
		
 

			




	
	
	
		
 
    def get_managed_fields(self):

			




	
	
	
		
 
        return ['username', 'firstname', 'lastname', 'email', 'password']

			




        

    


    
    

    

        

                

                    kallithea/lib/inifile.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
# -*- 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/>.

			




	
	
	
		
 

			




	
	
	
		
 
"""

			




	
	
	
		
 
kallithea.lib.inifile

			




	
	
	
		
 
~~~~~~~~~~~~~~~~~~~~~

			




	
	
	
		
 

			




	
	
	
		
 
Handling of .ini files, mainly creating them from Mako templates and adding

			




	
	
	
		
 
other custom values.

			




	
	
	
		
 
"""

			




	
	
	
		
 

			




	
	
	
		
 
import logging

			




	
	
	
		
 
import os

			




	
	
	
		
 
import re

			




	
	
	
		
 

			




	
	
	
		
 
import mako.template

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
log = logging.getLogger(__name__)

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
template_file = os.path.join(

			




	
	
	
		
 
    os.path.dirname(os.path.dirname(os.path.dirname(__file__))),

			




	
	
	
		
 
    'kallithea/lib/paster_commands/template.ini.mako')

			




	
	
	
		
 

			




	
	
	
		
 
default_variables = {

			




	
	
	
		
 
    'database_engine': 'sqlite',

			




	
	
	
		
 
    'http_server': 'waitress',

			




	
	
	
		
 
    'host': '127.0.0.1',

			




	
	
	
		
 
    'port': '5000',

			




	
	
	
		
 
    'uuid': lambda: 'VERY-SECRET',

			




	
	
	
		
 
    'version': '',

			




	
	
	
		
 
}

			




	
	
	
		
 

			




	
	
	
		
 
variable_options = {

			




	
	
	
		
 
    'database_engine': ['sqlite', 'postgres', 'mysql'],

			




	
	
	
		
 
    'http_server': ['waitress', 'gearbox', 'gevent', 'gunicorn', 'uwsgi'],

			




	
	
	
		
 
}

			




	
	
	
		
 

			




	
	
	
		
 
def expand(template, mako_variable_values, settings):

			




	
	
	
		
 
    """Expand mako template and tweak it.

			




	
	
	
		
 
    Not entirely stable for random templates as input, but good enough for our

			




	
	
	
		
 
    single template.

			




	
	
	
		
 

			




	
	
	
		
 
    >>> template = '''

			




	
	
	
		
 
    ... [first-section]

			




	
	
	
		
 
    ...

			




	
	
	
		
 
    ... variable=${mako_variable}

			




	
	
	
		
 
    ... variable2  =\tvalue after tab

			




	
	
	
		
 
    ... ## This section had some whitespace and stuff

			




	
	
	
		
 
    ...

			




	
	
	
		
 
    ...

			




	
	
	
		
 
    ... # ${mako_function()}

			




	
	
	
		
 
    ... [second-section]

			




	
	
	
		
 
    ... %if conditional_options == 'option-a':

			




	
	
	
		
 
    ... # option a was chosen

			




	
	
	
		
 
    ... %elif conditional_options == 'option-b':

			




	
	
	
		
 
    ... some_variable = "never mind - option-b will not be used anyway ..."

			




	
	
	
		
 
    ... %endif

			




	
	
	
		
 
    ...

			




	
	
	
		
 
    ... [comment-section]

			




	
	
	
		
 
    ... #variable3 = 3.0

			




	
	
	
		
 
    ... #variable4 = 4.0

			




	
	
	
		
 
    ... #variable5 = 5.0

			




	
	
	
		
 
    ... variable5 = 5.1

			




	
	
	
		
 
    ... #variable6 = 6.0

			




	
	
	
		
 
    ... #variable6 = 6.1

			




	
	
	
		
 
    ... #variable7 = 7.0

			




	
	
	
		
 
    ... variable7 = 7.1

			




	
	
	
		
 
    ... variable8 = 8.0

			




	
	
	
		
 
    ... '''

			




	
	
	
		
 
    >>> mako_variable_values = {'mako_variable': 'VALUE', 'mako_function': (lambda: 'FUNCTION RESULT'),

			




	
	
	
		
 
    ...                         'conditional_options': 'option-a', 'http_server': 'nc'}

			




	
	
	
		
 
    >>> settings = { # only partially used

			




	
	
	
		
 
    ...     '[first-section]': {'variable2': 'VAL2', 'first_extra': 'EXTRA', 'spacey': ' '},

			




	
	
	
		
 
    ...     '[comment-section]': {'variable3': '3.0', 'variable4': '4.1', 'variable5': '5.2', 'variable6': '6.2', 'variable7': '7.0', 'variable8': None, 'variable9': None},

			




	
	
	
		
 
    ...     '[third-section]': {'third_extra': ' 3'},

			




	
	
	
		
 
    ...     '[fourth-section]': {'fourth_extra': '4', 'fourth': '"four"'},

			




	
	
	
		
 
    ... }

			




	
	
	
		
 
    >>> print(expand(template, mako_variable_values, settings))

			




	
	
	
		
 
    ERROR: http_server is 'nc' - it should be one of 'waitress', 'gearbox', 'gevent', 'gunicorn', 'uwsgi'

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    [first-section]

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    variable=VALUE

			




	
	
	
		
 
    #variable2  =    value after tab

			




	
	
	
		
 
    variable2 = VAL2

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    first_extra = EXTRA

			




	
	
	
		
 
    spacey =

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    # FUNCTION RESULT

			




	
	
	
		
 
    [second-section]

			




	
	
	
		
 
    # option a was chosen

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    [comment-section]

			




	
	
	
		
 
    variable3 = 3.0

			




	
	
	
		
 
    #variable4 = 4.0

			




	
	
	
		
 
    variable4 = 4.1

			




	
	
	
		
 
    #variable5 = 5.0

			




	
	
	
		
 
    #variable5 = 5.1

			




	
	
	
		
 
    variable5 = 5.2

			




	
	
	
		
 
    #variable6 = 6.0

			




	
	
	
		
 
    #variable6 = 6.1

			




	
	
	
		
 
    variable6 = 6.2

			




	
	
	
		
 
    variable7 = 7.0

			




	
	
	
		
 
    #variable7 = 7.1

			




	
	
	
		
 
    #variable8 = 8.0

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    variable8 = None

			




	
	
	
		
 
    variable9 = None

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    [fourth-section]

			




	
	
	
		
 
    fourth = "four"

			




	
	
	
		
 
    fourth_extra = 4

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    [third-section]

			




	
	
	
		
 
    third_extra =  3

			




	
	
	
		
 
    <BLANKLINE>

			




	
	
	
		
 
    """

			




	
	
	
		
 
    mako_variables = dict(default_variables)

			




	
	
	
		
 
    mako_variables.update(mako_variable_values or {})

			




	
	
	
		
 
    settings = dict((k, dict(v)) for k, v in settings.items()) # deep copy before mutating

			




	
	
	
		
 

			




	
	
	
		
 
    for key, value in mako_variables.items():

			




	
	
	
		
 
        if key in variable_options:

			




	
	
	
		
 
            if value not in variable_options[key]:

			




	
	
	
		
 
                print('ERROR: %s is %r - it should be one of %s' %

			




	
	
	
		
 
                      (key, value, ', '.join(repr(x) for x in variable_options[key])))

			




	
	
	
		
 

			




	
	
	
		
 
    ini_lines = mako.template.Template(template).render(**mako_variables)

			




	
	
	
		
 

			




	
	
	
		
 
    def process_section(m):

			




	
	
	
		
 
        """process a ini section, replacing values as necessary"""

			




	
	
	
		
 
        sectionname, lines = m.groups()

			




	
	
	
		
 
        if sectionname in settings:

			




	
	
	
		
 
            section_settings = settings.pop(sectionname)

			




	
	
	
		
 
            add_after_key_value = {}  # map key to value it should be added after

			




	
	
	
		
 

			




	
	
	
		
 
            # 1st pass:

			




	
	
	
		
 
            # comment out lines with keys that have new values

			




	
	
	
		
 
            # find best line for keeping or un-commenting (because it has the right value) or adding after (because it is the last with other value)

			




	
	
	
		
 
            def comment_out(m):

			




	
	
	
		
 
                """process a section line if in section_settings and comment out and track in add_after_key_value"""

			




	
	
	
		
 
                line = m.group(0)

			




	
	
	
		
 
                comment, key, line_value = m.groups()

			




	
	
	
		
 
                if key not in section_settings:

			




	
	
	
		
 
                    return line

			




	
	
	
		
 
                new_value = section_settings[key]

			




	
	
	
		
 
                if line_value == new_value or add_after_key_value.get(key) != new_value:

			




	
	
	
		
 
                    add_after_key_value[key] = line_value

			




	
	
	
		
 
                if comment:

			




	
	
	
		
 
                    return line

			




	
	
	
		
 
                return '#' + line

			




	
	
	
		
 

			




	
	
	
		
 
            lines = re.sub(r'^(#)?([^#\n\s]*)[ \t]*=[ \t]*(.*)$', comment_out, lines, flags=re.MULTILINE)

			




	
	
	
		
 

			




	
	
	
		
 
            # 2nd pass:

			




	
	
	
		
 
            # find the best comment line and un-comment or add after

			




	
	
	
		
 
            def add_after_comment(m):

			




	
	
	
		
 
                """process a section comment line and add new value"""

			




	
	
	
		
 
                line = m.group(0)

			




	
	
	
		
 
                key, line_value = m.groups()

			




	
	
	
		
 
                if key not in section_settings:

			




	
	
	
		
 
                    return line

			




	
	
	
		
 
                if line_value != add_after_key_value.get(key):

			




	
	
	
		
 
                    return line

			




	
	
	
		
 
                new_value = section_settings[key]

			




	
	
	
		
 
                if new_value == line_value:

			




	
	
	
		
 
                    line = line.lstrip('#')

			




	
	
	
		
 
                else:

			




	
	
	
		
 
                    line += '\n%s = %s' % (key, new_value)

			




	
	
	
		
 
                section_settings.pop(key)

			




	
	
	
		
 
                return line

			




	
	
	
		
 

			




	
	
	
		
 
            lines = re.sub(r'^#([^#\n\s]*)[ \t]*=[ \t]*(.*)$', add_after_comment, lines, flags=re.MULTILINE)

			




	
	
	
		
 

			




	
	
	
		
 
            # 3rd pass:

			




	
	
	
		
 
            # settings that haven't been consumed yet at is appended to section

			




	
	
	
		
 
            if section_settings:

			




	
	
	
		
 
                lines += '\n' + ''.join('%s = %s\n' % (key, value) for key, value in sorted(section_settings.items()))

			




	
	
	
		
 

			




	
	
	
		
 
        return sectionname + '\n' + re.sub('[ \t]+\n', '\n', lines)

			




	
	
	
		
 

			




	
	
	
		
 
    # process sections until comments before next section or end

			




	
	
	
		
 
    ini_lines = re.sub(r'''^

			




	
	
	
		
 
        (\[.*\])\n

			




	
	
	
		
 
        # after the section name, a number of chunks with:

			




	
	
	
		
 
        (

			




	
	
	
		
 
            (?:

			




	
	
	
		
 
                # a number of comments or empty lines

			




	
	
	
		
 
                (?:[#].*\n|\n)*

			




	
	
	
		
 
                # one or more non-empty non-comments non-section-start lines

			




	
	
	
		
 
                (?:[^\n#[].*\n)+

			




	
	
	
		
 
                # a number of comments - not empty lines

			




	
	
	
		
 
                (?:[#].*\n)*

			




	
	
	
		
 
            )*

			




	
	
	
		
 
        )

			




	
	
	
		
 
        ''',

			




	
	
	
		
 
        process_section, ini_lines, flags=re.MULTILINE | re.VERBOSE) \

			




	
	
	
		
 
        + \

			




	
	
	
		
 
        ''.join(

			




	
	
	
		
 
            '\n' + sectionname + '\n' + ''.join('%s = %s\n' % (key, value) for key, value in sorted(section_settings.items()))

			




	
	
	
		
 
            for sectionname, section_settings in sorted(settings.items())

			




	
	
	
		
 
            if section_settings)

			




	
	
	
		
 

			




	
	
	
		
 
    return ini_lines

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
def create(dest_file, mako_variable_values, settings):

			




	
	
	
		
 
    """Create an ini file at dest_file"""

			




	
	
	
		
 
    with open(template_file, 'rb') as f:

			




	
	
	
		
 
        template = f.read().decode('utf-8')

			




	
	
	
		
 

			




	
	
	
		
 
    ini_lines = expand(template, mako_variable_values, settings)

			




	
	
	
		
 

			




	
	
	
		
 
    with open(dest_file, 'wb') as f:

			




	
	
	
		
 
        f.write(ini_lines.encode('utf-8'))

			




        

    


    
    

    

        

                

                    kallithea/lib/paster_commands/template.ini.mako
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



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

			




	
	
	
		
 
<%text>###################################################################################</%text>

			




	
	
	
		
 
<%text>###################################################################################</%text>

			




	
	
	
		
 
<%text>## Kallithea config file generated with kallithea-config                         ##</%text>

			




	
	
	
		
 
<%text>##                                                                               ##</%text>

			




	
	
	
		
 
<%text>## The %(here)s variable will be replaced with the parent directory of this file ##</%text>

			




	
	
	
		
 
<%text>###################################################################################</%text>

			




	
	
	
		
 
<%text>###################################################################################</%text>

			




	
	
	
		
 
<%text>##</%text>#################################################################################

			




	
	
	
		
 
<%text>##</%text>#################################################################################

			




	
	
	
		
 
<%text>##</%text> Kallithea config file generated with kallithea-cli ${'%-27s' % version       }##

			




	
	
	
		
 
<%text>##</%text>                                                                               ##

			




	
	
	
		
 
<%text>##</%text> The %(here)s variable will generally be replaced with the parent directory of ##

			




	
	
	
		
 
<%text>##</%text> this file. Other use of % must be escaped as %% .                             ##

			




	
	
	
		
 
<%text>##</%text>#################################################################################

			




	
	
	
		
 
<%text>##</%text>#################################################################################

			




	
	
	
		
 

			




	
	
	
		
 
[DEFAULT]

			




	
	
	
		
 

			




	
	
	
		
 
<%text>################################################################################</%text>

			




	
	
	
		
 
<%text>## Email settings                                                             ##</%text>

			




	
	
	
		
 
<%text>##                                                                            ##</%text>

			




	
	
	
		
 
<%text>## Refer to the documentation ("Email settings") for more details.            ##</%text>

			




	
	
	
		
 
<%text>##                                                                            ##</%text>

			




	
	
	
		
 
<%text>## It is recommended to use a valid sender address that passes access         ##</%text>

			




	
	
	
		
 
<%text>## validation and spam filtering in mail servers.                             ##</%text>

			




	
	
	
		
 
<%text>################################################################################</%text>

			




	
	
	
		
 
<%text>##</%text>##############################################################################

			




	
	
	
		
 
<%text>##</%text> Email settings                                                             ##

			




	
	
	
		
 
<%text>##</%text>                                                                            ##

			




	
	
	
		
 
<%text>##</%text> Refer to the documentation ("Email settings") for more details.            ##

			




	
	
	
		
 
<%text>##</%text>                                                                            ##

			




	
	
	
		
 
<%text>##</%text> It is recommended to use a valid sender address that passes access         ##

			




	
	
	
		
 
<%text>##</%text> validation and spam filtering in mail servers.                             ##

			




	
	
	
		
 
<%text>##</%text>##############################################################################

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## 'From' header for application emails. You can optionally add a name.</%text>

			




	
	
	
		
 
<%text>## Default:</%text>

			




	
	
	
		
 
<%text>##</%text> 'From' header for application emails. You can optionally add a name.

			




	
	
	
		
 
<%text>##</%text> Default:

			




	
	
	
		
 
#app_email_from = Kallithea

			




	
	
	
		
 
<%text>## Examples:</%text>

			




	
	
	
		
 
<%text>##</%text> Examples:

			




	
	
	
		
 
#app_email_from = Kallithea <kallithea-noreply@example.com>

			




	
	
	
		
 
#app_email_from = kallithea-noreply@example.com

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Subject prefix for application emails.</%text>

			




	
	
	
		
 
<%text>## A space between this prefix and the real subject is automatically added.</%text>

			




	
	
	
		
 
<%text>## Default:</%text>

			




	
	
	
		
 
<%text>##</%text> Subject prefix for application emails.

			




	
	
	
		
 
<%text>##</%text> A space between this prefix and the real subject is automatically added.

			




	
	
	
		
 
<%text>##</%text> Default:

			




	
	
	
		
 
#email_prefix =

			




	
	
	
		
 
<%text>## Example:</%text>

			




	
	
	
		
 
<%text>##</%text> Example:

			




	
	
	
		
 
#email_prefix = [Kallithea]

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Recipients for error emails and fallback recipients of application mails.</%text>

			




	
	
	
		
 
<%text>## Multiple addresses can be specified, comma-separated.</%text>

			




	
	
	
		
 
<%text>## Only addresses are allowed, do not add any name part.</%text>

			




	
	
	
		
 
<%text>## Default:</%text>

			




	
	
	
		
 
<%text>##</%text> Recipients for error emails and fallback recipients of application mails.

			




	
	
	
		
 
<%text>##</%text> Multiple addresses can be specified, comma-separated.

			




	
	
	
		
 
<%text>##</%text> Only addresses are allowed, do not add any name part.

			




	
	
	
		
 
<%text>##</%text> Default:

			




	
	
	
		
 
#email_to =

			




	
	
	
		
 
<%text>## Examples:</%text>

			




	
	
	
		
 
<%text>##</%text> Examples:

			




	
	
	
		
 
#email_to = admin@example.com

			




	
	
	
		
 
#email_to = admin@example.com,another_admin@example.com

			




	
	
	
		
 
email_to =

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## 'From' header for error emails. You can optionally add a name.</%text>

			




	
	
	
		
 
<%text>## Default: (none)</%text>

			




	
	
	
		
 
<%text>## Examples:</%text>

			




	
	
	
		
 
<%text>##</%text> 'From' header for error emails. You can optionally add a name.

			




	
	
	
		
 
<%text>##</%text> Default: (none)

			




	
	
	
		
 
<%text>##</%text> Examples:

			




	
	
	
		
 
#error_email_from = Kallithea Errors <kallithea-noreply@example.com>

			




	
	
	
		
 
#error_email_from = kallithea_errors@example.com

			




	
	
	
		
 
error_email_from =

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## SMTP server settings</%text>

			




	
	
	
		
 
<%text>## If specifying credentials, make sure to use secure connections.</%text>

			




	
	
	
		
 
<%text>## Default: Send unencrypted unauthenticated mails to the specified smtp_server.</%text>

			




	
	
	
		
 
<%text>## For "SSL", use smtp_use_ssl = true and smtp_port = 465.</%text>

			




	
	
	
		
 
<%text>## For "STARTTLS", use smtp_use_tls = true and smtp_port = 587.</%text>

			




	
	
	
		
 
<%text>##</%text> SMTP server settings

			




	
	
	
		
 
<%text>##</%text> If specifying credentials, make sure to use secure connections.

			




	
	
	
		
 
<%text>##</%text> Default: Send unencrypted unauthenticated mails to the specified smtp_server.

			




	
	
	
		
 
<%text>##</%text> For "SSL", use smtp_use_ssl = true and smtp_port = 465.

			




	
	
	
		
 
<%text>##</%text> For "STARTTLS", use smtp_use_tls = true and smtp_port = 587.

			




	
	
	
		
 
smtp_server =

			




	
	
	
		
 
smtp_username =

			




	
	
	
		
 
smtp_password =

			




	
	
	
		
 
smtp_port =

			




	
	
	
		
 
smtp_use_ssl = false

			




	
	
	
		
 
smtp_use_tls = false

			




	
	
	
		
 

			




	
	
	
		
 
%if http_server != 'uwsgi':

			




	
	
	
		
 
<%text>## Entry point for 'gearbox serve'</%text>

			




	
	
	
		
 
<%text>##</%text> Entry point for 'gearbox serve'

			




	
	
	
		
 
[server:main]

			




	
	
	
		
 
host = ${host}

			




	
	
	
		
 
port = ${port}

			




	
	
	
		
 

			




	
	
	
		
 
%if http_server == 'gearbox':

			




	
	
	
		
 
<%text>## Gearbox default web server ##</%text>

			




	
	
	
		
 
<%text>##</%text> Gearbox default web server ##

			




	
	
	
		
 
use = egg:gearbox#wsgiref

			




	
	
	
		
 
<%text>## nr of worker threads to spawn</%text>

			




	
	
	
		
 
<%text>##</%text> nr of worker threads to spawn

			




	
	
	
		
 
threadpool_workers = 1

			




	
	
	
		
 
<%text>## max request before thread respawn</%text>

			




	
	
	
		
 
<%text>##</%text> max request before thread respawn

			




	
	
	
		
 
threadpool_max_requests = 100

			




	
	
	
		
 
<%text>## option to use threads of process</%text>

			




	
	
	
		
 
<%text>##</%text> option to use threads of process

			




	
	
	
		
 
use_threadpool = true

			




	
	
	
		
 

			




	
	
	
		
 
%elif http_server == 'gevent':

			




	
	
	
		
 
<%text>## Gearbox gevent web server ##</%text>

			




	
	
	
		
 
<%text>##</%text> Gearbox gevent web server ##

			




	
	
	
		
 
use = egg:gearbox#gevent

			




	
	
	
		
 

			




	
	
	
		
 
%elif http_server == 'waitress':

			




	
	
	
		
 
<%text>## WAITRESS ##</%text>

			




	
	
	
		
 
<%text>##</%text> WAITRESS ##

			




	
	
	
		
 
use = egg:waitress#main

			




	
	
	
		
 
<%text>## number of worker threads</%text>

			




	
	
	
		
 
<%text>##</%text> number of worker threads

			




	
	
	
		
 
threads = 1

			




	
	
	
		
 
<%text>## MAX BODY SIZE 100GB</%text>

			




	
	
	
		
 
<%text>##</%text> MAX BODY SIZE 100GB

			




	
	
	
		
 
max_request_body_size = 107374182400

			




	
	
	
		
 
<%text>## use poll instead of select, fixes fd limits, may not work on old</%text>

			




	
	
	
		
 
<%text>## windows systems.</%text>

			




	
	
	
		
 
<%text>##</%text> use poll instead of select, fixes fd limits, may not work on old

			




	
	
	
		
 
<%text>##</%text> windows systems.

			




	
	
	
		
 
#asyncore_use_poll = True

			




	
	
	
		
 

			




	
	
	
		
 
%elif http_server == 'gunicorn':

			




	
	
	
		
 
<%text>## GUNICORN ##</%text>

			




	
	
	
		
 
<%text>##</%text> GUNICORN ##

			




	
	
	
		
 
use = egg:gunicorn#main

			




	
	
	
		
 
<%text>## number of process workers. You must set `instance_id = *` when this option</%text>

			




	
	
	
		
 
<%text>## is set to more than one worker</%text>

			




	
	
	
		
 
<%text>##</%text> number of process workers. You must set `instance_id = *` when this option

			




	
	
	
		
 
<%text>##</%text> is set to more than one worker

			




	
	
	
		
 
workers = 4

			




	
	
	
		
 
<%text>## process name</%text>

			




	
	
	
		
 
<%text>##</%text> process name

			




	
	
	
		
 
proc_name = kallithea

			




	
	
	
		
 
<%text>## type of worker class, one of sync, eventlet, gevent, tornado</%text>

			




	
	
	
		
 
<%text>## recommended for bigger setup is using of of other than sync one</%text>

			




	
	
	
		
 
<%text>##</%text> type of worker class, one of sync, eventlet, gevent, tornado

			




	
	
	
		
 
<%text>##</%text> recommended for bigger setup is using of of other than sync one

			




	
	
	
		
 
worker_class = sync

			




	
	
	
		
 
max_requests = 1000

			




	
	
	
		
 
<%text>## amount of time a worker can handle request before it gets killed and</%text>

			




	
	
	
		
 
<%text>## restarted</%text>

			




	
	
	
		
 
<%text>##</%text> amount of time a worker can handle request before it gets killed and

			




	
	
	
		
 
<%text>##</%text> restarted

			




	
	
	
		
 
timeout = 3600

			




	
	
	
		
 

			




	
	
	
		
 
%endif

			




	
	
	
		
 
%else:

			




	
	
	
		
 
<%text>## UWSGI ##</%text>

			




	
	
	
		
 
<%text>##</%text> UWSGI ##

			




	
	
	
		
 
[uwsgi]

			




	
	
	
		
 
<%text>## Note: this section is parsed by the uWSGI .ini parser when run as:</%text>

			




	
	
	
		
 
<%text>## uwsgi --venv /srv/kallithea/venv --ini-paste-logged my.ini</%text>

			




	
	
	
		
 
<%text>## Note: in uWSGI 2.0.18 or older, pastescript needs to be installed to</%text>

			




	
	
	
		
 
<%text>## get correct application logging. In later versions this is not necessary.</%text>

			




	
	
	
		
 
<%text>## pip install pastescript</%text>

			




	
	
	
		
 
<%text>##</%text> Note: this section is parsed by the uWSGI .ini parser when run as:

			




	
	
	
		
 
<%text>##</%text> uwsgi --venv /srv/kallithea/venv --ini-paste-logged my.ini

			




	
	
	
		
 
<%text>##</%text> Note: in uWSGI 2.0.18 or older, pastescript needs to be installed to

			




	
	
	
		
 
<%text>##</%text> get correct application logging. In later versions this is not necessary.

			




	
	
	
		
 
<%text>##</%text> pip install pastescript

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## HTTP Basics:</%text>

			




	
	
	
		
 
<%text>##</%text> HTTP Basics:

			




	
	
	
		
 
http-socket = ${host}:${port}

			




	
	
	
		
 
buffer-size = 65535                    ; Mercurial will use huge GET headers for discovery

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Scaling:</%text>

			




	
	
	
		
 
<%text>##</%text> Scaling:

			




	
	
	
		
 
master = true                          ; Use separate master and worker processes

			




	
	
	
		
 
auto-procname = true                   ; Name worker processes accordingly

			




	
	
	
		
 
lazy = true                            ; App *must* be loaded in workers - db connections can't be shared

			




	
	
	
		
 
workers = 4                            ; On demand scaling up to this many worker processes

			




	
	
	
		
 
cheaper = 1                            ; Initial and on demand scaling down to this many worker processes

			




	
	
	
		
 
max-requests = 1000                    ; Graceful reload of worker processes to avoid leaks

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Tweak defaults:</%text>

			




	
	
	
		
 
<%text>##</%text> Tweak defaults:

			




	
	
	
		
 
strict = true                          ; Fail on unknown config directives

			




	
	
	
		
 
enable-threads = true                  ; Enable Python threads (not threaded workers)

			




	
	
	
		
 
vacuum = true                          ; Delete sockets during shutdown

			




	
	
	
		
 
single-interpreter = true

			




	
	
	
		
 
die-on-term = true                     ; Shutdown when receiving SIGTERM (default is respawn)

			




	
	
	
		
 
need-app = true                        ; Exit early if no app can be loaded.

			




	
	
	
		
 
reload-on-exception = true             ; Don't assume that the application worker can process more requests after a severe error

			




	
	
	
		
 

			




	
	
	
		
 
%endif

			




	
	
	
		
 
<%text>## middleware for hosting the WSGI application under a URL prefix</%text>

			




	
	
	
		
 
<%text>##</%text> middleware for hosting the WSGI application under a URL prefix

			




	
	
	
		
 
#[filter:proxy-prefix]

			




	
	
	
		
 
#use = egg:PasteDeploy#prefix

			




	
	
	
		
 
#prefix = /<your-prefix>

			




	
	
	
		
 

			




	
	
	
		
 
[app:main]

			




	
	
	
		
 
use = egg:kallithea

			




	
	
	
		
 
<%text>## enable proxy prefix middleware</%text>

			




	
	
	
		
 
<%text>##</%text> enable proxy prefix middleware

			




	
	
	
		
 
#filter-with = proxy-prefix

			




	
	
	
		
 

			




	
	
	
		
 
full_stack = true

			




	
	
	
		
 
static_files = true

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Internationalization (see setup documentation for details)</%text>

			




	
	
	
		
 
<%text>## By default, the languages requested by the browser are used if available, with English as default.</%text>

			




	
	
	
		
 
<%text>## Set i18n.enabled=false to disable automatic language choice.</%text>

			




	
	
	
		
 
<%text>##</%text> Internationalization (see setup documentation for details)

			




	
	
	
		
 
<%text>##</%text> By default, the languages requested by the browser are used if available, with English as default.

			




	
	
	
		
 
<%text>##</%text> Set i18n.enabled=false to disable automatic language choice.

			




	
	
	
		
 
#i18n.enabled = true

			




	
	
	
		
 
<%text>## To Force a language, set i18n.enabled=false and specify the language in i18n.lang.</%text>

			




	
	
	
		
 
<%text>## Valid values are the names of subdirectories in kallithea/i18n with a LC_MESSAGES/kallithea.mo</%text>

			




	
	
	
		
 
<%text>##</%text> To Force a language, set i18n.enabled=false and specify the language in i18n.lang.

			




	
	
	
		
 
<%text>##</%text> Valid values are the names of subdirectories in kallithea/i18n with a LC_MESSAGES/kallithea.mo

			




	
	
	
		
 
#i18n.lang = en

			




	
	
	
		
 

			




	
	
	
		
 
cache_dir = %(here)s/data

			




	
	
	
		
 
index_dir = %(here)s/data/index

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## uncomment and set this path to use archive download cache</%text>

			




	
	
	
		
 
<%text>##</%text> uncomment and set this path to use archive download cache

			




	
	
	
		
 
archive_cache_dir = %(here)s/tarballcache

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## change this to unique ID for security</%text>

			




	
	
	
		
 
<%text>##</%text> change this to unique ID for security

			




	
	
	
		
 
app_instance_uuid = ${uuid()}

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## cut off limit for large diffs (size in bytes)</%text>

			




	
	
	
		
 
<%text>##</%text> cut off limit for large diffs (size in bytes)

			




	
	
	
		
 
cut_off_limit = 256000

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## force https in Kallithea, fixes https redirects, assumes it's always https</%text>

			




	
	
	
		
 
<%text>##</%text> force https in Kallithea, fixes https redirects, assumes it's always https

			




	
	
	
		
 
force_https = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## use Strict-Transport-Security headers</%text>

			




	
	
	
		
 
<%text>##</%text> use Strict-Transport-Security headers

			




	
	
	
		
 
use_htsts = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## number of commits stats will parse on each iteration</%text>

			




	
	
	
		
 
<%text>##</%text> number of commits stats will parse on each iteration

			




	
	
	
		
 
commit_parse_limit = 25

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Path to Python executable to be used for git hooks.</%text>

			




	
	
	
		
 
<%text>## This value will be written inside the git hook scripts as the text</%text>

			




	
	
	
		
 
<%text>## after '#!' (shebang). When empty or not defined, the value of</%text>

			




	
	
	
		
 
<%text>## 'sys.executable' at the time of installation of the git hooks is</%text>

			




	
	
	
		
 
<%text>## used, which is correct in many cases but for example not when using uwsgi.</%text>

			




	
	
	
		
 
<%text>## If you change this setting, you should reinstall the Git hooks via</%text>

			




	
	
	
		
 
<%text>## Admin > Settings > Remap and Rescan.</%text>

			




	
	
	
		
 
<%text>##</%text> Path to Python executable to be used for git hooks.

			




	
	
	
		
 
<%text>##</%text> This value will be written inside the git hook scripts as the text

			




	
	
	
		
 
<%text>##</%text> after '#!' (shebang). When empty or not defined, the value of

			




	
	
	
		
 
<%text>##</%text> 'sys.executable' at the time of installation of the git hooks is

			




	
	
	
		
 
<%text>##</%text> used, which is correct in many cases but for example not when using uwsgi.

			




	
	
	
		
 
<%text>##</%text> If you change this setting, you should reinstall the Git hooks via

			




	
	
	
		
 
<%text>##</%text> Admin > Settings > Remap and Rescan.

			




	
	
	
		
 
#git_hook_interpreter = /srv/kallithea/venv/bin/python3

			




	
	
	
		
 
%if git_hook_interpreter:

			




	
	
	
		
 
git_hook_interpreter = ${git_hook_interpreter}

			




	
	
	
		
 
%endif

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## path to git executable</%text>

			




	
	
	
		
 
<%text>##</%text> path to git executable

			




	
	
	
		
 
git_path = git

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## git rev filter option, --all is the default filter, if you need to</%text>

			




	
	
	
		
 
<%text>## hide all refs in changelog switch this to --branches --tags</%text>

			




	
	
	
		
 
<%text>##</%text> git rev filter option, --all is the default filter, if you need to

			




	
	
	
		
 
<%text>##</%text> hide all refs in changelog switch this to --branches --tags

			




	
	
	
		
 
#git_rev_filter = --branches --tags

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## RSS feed options</%text>

			




	
	
	
		
 
<%text>##</%text> RSS feed options

			




	
	
	
		
 
rss_cut_off_limit = 256000

			




	
	
	
		
 
rss_items_per_page = 10

			




	
	
	
		
 
rss_include_diff = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## options for showing and identifying changesets</%text>

			




	
	
	
		
 
<%text>##</%text> options for showing and identifying changesets

			




	
	
	
		
 
show_sha_length = 12

			




	
	
	
		
 
show_revision_number = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Canonical URL to use when creating full URLs in UI and texts.</%text>

			




	
	
	
		
 
<%text>## Useful when the site is available under different names or protocols.</%text>

			




	
	
	
		
 
<%text>## Defaults to what is provided in the WSGI environment.</%text>

			




	
	
	
		
 
<%text>##</%text> Canonical URL to use when creating full URLs in UI and texts.

			




	
	
	
		
 
<%text>##</%text> Useful when the site is available under different names or protocols.

			




	
	
	
		
 
<%text>##</%text> Defaults to what is provided in the WSGI environment.

			




	
	
	
		
 
#canonical_url = https://kallithea.example.com/repos

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## gist URL alias, used to create nicer urls for gist. This should be an</%text>

			




	
	
	
		
 
<%text>## url that does rewrites to _admin/gists/<gistid>.</%text>

			




	
	
	
		
 
<%text>## example: http://gist.example.com/{gistid}. Empty means use the internal</%text>

			




	
	
	
		
 
<%text>## Kallithea url, ie. http[s]://kallithea.example.com/_admin/gists/<gistid></%text>

			




	
	
	
		
 
<%text>##</%text> gist URL alias, used to create nicer urls for gist. This should be an

			




	
	
	
		
 
<%text>##</%text> url that does rewrites to _admin/gists/<gistid>.

			




	
	
	
		
 
<%text>##</%text> example: http://gist.example.com/{gistid}. Empty means use the internal

			




	
	
	
		
 
<%text>##</%text> Kallithea url, ie. http[s]://kallithea.example.com/_admin/gists/<gistid>

			




	
	
	
		
 
gist_alias_url =

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## default encoding used to convert from and to unicode</%text>

			




	
	
	
		
 
<%text>## can be also a comma separated list of encoding in case of mixed encodings</%text>

			




	
	
	
		
 
<%text>##</%text> default encoding used to convert from and to unicode

			




	
	
	
		
 
<%text>##</%text> can be also a comma separated list of encoding in case of mixed encodings

			




	
	
	
		
 
default_encoding = utf-8

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Set Mercurial encoding, similar to setting HGENCODING before launching Kallithea</%text>

			




	
	
	
		
 
<%text>##</%text> Set Mercurial encoding, similar to setting HGENCODING before launching Kallithea

			




	
	
	
		
 
hgencoding = utf-8

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## issue tracker for Kallithea (leave blank to disable, absent for default)</%text>

			




	
	
	
		
 
<%text>##</%text> issue tracker for Kallithea (leave blank to disable, absent for default)

			




	
	
	
		
 
#bugtracker = https://bitbucket.org/conservancy/kallithea/issues

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## issue tracking mapping for commit messages, comments, PR descriptions, ...</%text>

			




	
	
	
		
 
<%text>## Refer to the documentation ("Integration with issue trackers") for more details.</%text>

			




	
	
	
		
 
<%text>##</%text> issue tracking mapping for commit messages, comments, PR descriptions, ...

			




	
	
	
		
 
<%text>##</%text> Refer to the documentation ("Integration with issue trackers") for more details.

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## regular expression to match issue references</%text>

			




	
	
	
		
 
<%text>## This pattern may/should contain parenthesized groups, that can</%text>

			




	
	
	
		
 
<%text>## be referred to in issue_server_link or issue_sub using Python backreferences</%text>

			




	
	
	
		
 
<%text>## (e.g. \1, \2, ...). You can also create named groups with '(?P<groupname>)'.</%text>

			




	
	
	
		
 
<%text>## To require mandatory whitespace before the issue pattern, use:</%text>

			




	
	
	
		
 
<%text>## (?:^|(?<=\s)) before the actual pattern, and for mandatory whitespace</%text>

			




	
	
	
		
 
<%text>## behind the issue pattern, use (?:$|(?=\s)) after the actual pattern.</%text>

			




	
	
	
		
 
<%text>##</%text> regular expression to match issue references

			




	
	
	
		
 
<%text>##</%text> This pattern may/should contain parenthesized groups, that can

			




	
	
	
		
 
<%text>##</%text> be referred to in issue_server_link or issue_sub using Python backreferences

			




	
	
	
		
 
<%text>##</%text> (e.g. \1, \2, ...). You can also create named groups with '(?P<groupname>)'.

			




	
	
	
		
 
<%text>##</%text> To require mandatory whitespace before the issue pattern, use:

			




	
	
	
		
 
<%text>##</%text> (?:^|(?<=\s)) before the actual pattern, and for mandatory whitespace

			




	
	
	
		
 
<%text>##</%text> behind the issue pattern, use (?:$|(?=\s)) after the actual pattern.

			




	
	
	
		
 

			




	
	
	
		
 
issue_pat = #(\d+)

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## server url to the issue</%text>

			




	
	
	
		
 
<%text>## This pattern may/should contain backreferences to parenthesized groups in issue_pat.</%text>

			




	
	
	
		
 
<%text>## A backreference can be \1, \2, ... or \g<groupname> if you specified a named group</%text>

			




	
	
	
		
 
<%text>## called 'groupname' in issue_pat.</%text>

			




	
	
	
		
 
<%text>## The special token {repo} is replaced with the full repository name</%text>

			




	
	
	
		
 
<%text>## including repository groups, while {repo_name} is replaced with just</%text>

			




	
	
	
		
 
<%text>## the name of the repository.</%text>

			




	
	
	
		
 
<%text>##</%text> server url to the issue

			




	
	
	
		
 
<%text>##</%text> This pattern may/should contain backreferences to parenthesized groups in issue_pat.

			




	
	
	
		
 
<%text>##</%text> A backreference can be \1, \2, ... or \g<groupname> if you specified a named group

			




	
	
	
		
 
<%text>##</%text> called 'groupname' in issue_pat.

			




	
	
	
		
 
<%text>##</%text> The special token {repo} is replaced with the full repository name

			




	
	
	
		
 
<%text>##</%text> including repository groups, while {repo_name} is replaced with just

			




	
	
	
		
 
<%text>##</%text> the name of the repository.

			




	
	
	
		
 

			




	
	
	
		
 
issue_server_link = https://issues.example.com/{repo}/issue/\1

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## substitution pattern to use as the link text</%text>

			




	
	
	
		
 
<%text>## If issue_sub is empty, the text matched by issue_pat is retained verbatim</%text>

			




	
	
	
		
 
<%text>## for the link text. Otherwise, the link text is that of issue_sub, with any</%text>

			




	
	
	
		
 
<%text>## backreferences to groups in issue_pat replaced.</%text>

			




	
	
	
		
 
<%text>##</%text> substitution pattern to use as the link text

			




	
	
	
		
 
<%text>##</%text> If issue_sub is empty, the text matched by issue_pat is retained verbatim

			




	
	
	
		
 
<%text>##</%text> for the link text. Otherwise, the link text is that of issue_sub, with any

			




	
	
	
		
 
<%text>##</%text> backreferences to groups in issue_pat replaced.

			




	
	
	
		
 

			




	
	
	
		
 
issue_sub =

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## issue_pat, issue_server_link and issue_sub can have suffixes to specify</%text>

			




	
	
	
		
 
<%text>## multiple patterns, to other issues server, wiki or others</%text>

			




	
	
	
		
 
<%text>## below an example how to create a wiki pattern</%text>

			




	
	
	
		
 
<%text>## wiki-some-id -> https://wiki.example.com/some-id</%text>

			




	
	
	
		
 
<%text>##</%text> issue_pat, issue_server_link and issue_sub can have suffixes to specify

			




	
	
	
		
 
<%text>##</%text> multiple patterns, to other issues server, wiki or others

			




	
	
	
		
 
<%text>##</%text> below an example how to create a wiki pattern

			




	
	
	
		
 
<%text>##</%text> wiki-some-id -> https://wiki.example.com/some-id

			




	
	
	
		
 

			




	
	
	
		
 
#issue_pat_wiki = wiki-(\S+)

			




	
	
	
		
 
#issue_server_link_wiki = https://wiki.example.com/\1

			




	
	
	
		
 
#issue_sub_wiki = WIKI-\1

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## alternative return HTTP header for failed authentication. Default HTTP</%text>

			




	
	
	
		
 
<%text>## response is 401 HTTPUnauthorized. Currently Mercurial clients have trouble with</%text>

			




	
	
	
		
 
<%text>## handling that. Set this variable to 403 to return HTTPForbidden</%text>

			




	
	
	
		
 
<%text>##</%text> alternative return HTTP header for failed authentication. Default HTTP

			




	
	
	
		
 
<%text>##</%text> response is 401 HTTPUnauthorized. Currently Mercurial clients have trouble with

			




	
	
	
		
 
<%text>##</%text> handling that. Set this variable to 403 to return HTTPForbidden

			




	
	
	
		
 
auth_ret_code =

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## allows to change the repository location in settings page</%text>

			




	
	
	
		
 
<%text>##</%text> allows to change the repository location in settings page

			




	
	
	
		
 
allow_repo_location_change = True

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## allows to setup custom hooks in settings page</%text>

			




	
	
	
		
 
<%text>##</%text> allows to setup custom hooks in settings page

			




	
	
	
		
 
allow_custom_hooks_settings = True

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## extra extensions for indexing, space separated and without the leading '.'.</%text>

			




	
	
	
		
 
<%text>##</%text> extra extensions for indexing, space separated and without the leading '.'.

			




	
	
	
		
 
#index.extensions =

			




	
	
	
		
 
#    gemfile

			




	
	
	
		
 
#    lock

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## extra filenames for indexing, space separated</%text>

			




	
	
	
		
 
<%text>##</%text> extra filenames for indexing, space separated

			




	
	
	
		
 
#index.filenames =

			




	
	
	
		
 
#    .dockerignore

			




	
	
	
		
 
#    .editorconfig

			




	
	
	
		
 
#    INSTALL

			




	
	
	
		
 
#    CHANGELOG

			




	
	
	
		
 

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>###           SSH CONFIG        ####</%text>

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 
<%text>##</%text>            SSH CONFIG          ##

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## SSH is disabled by default, until an Administrator decides to enable it.</%text>

			




	
	
	
		
 
<%text>##</%text> SSH is disabled by default, until an Administrator decides to enable it.

			




	
	
	
		
 
ssh_enabled = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## File where users' SSH keys will be stored *if* ssh_enabled is true.</%text>

			




	
	
	
		
 
<%text>##</%text> File where users' SSH keys will be stored *if* ssh_enabled is true.

			




	
	
	
		
 
#ssh_authorized_keys = /home/kallithea/.ssh/authorized_keys

			




	
	
	
		
 
%if user_home_path:

			




	
	
	
		
 
ssh_authorized_keys = ${user_home_path}/.ssh/authorized_keys

			




	
	
	
		
 
%endif

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Path to be used in ssh_authorized_keys file to invoke kallithea-cli with ssh-serve.</%text>

			




	
	
	
		
 
<%text>##</%text> Path to be used in ssh_authorized_keys file to invoke kallithea-cli with ssh-serve.

			




	
	
	
		
 
#kallithea_cli_path = /srv/kallithea/venv/bin/kallithea-cli

			




	
	
	
		
 
%if kallithea_cli_path:

			




	
	
	
		
 
kallithea_cli_path = ${kallithea_cli_path}

			




	
	
	
		
 
%endif

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Locale to be used in the ssh-serve command.</%text>

			




	
	
	
		
 
<%text>## This is needed because an SSH client may try to use its own locale</%text>

			




	
	
	
		
 
<%text>## settings, which may not be available on the server.</%text>

			




	
	
	
		
 
<%text>## See `locale -a` for valid values on this system.</%text>

			




	
	
	
		
 
<%text>##</%text> Locale to be used in the ssh-serve command.

			




	
	
	
		
 
<%text>##</%text> This is needed because an SSH client may try to use its own locale

			




	
	
	
		
 
<%text>##</%text> settings, which may not be available on the server.

			




	
	
	
		
 
<%text>##</%text> See `locale -a` for valid values on this system.

			




	
	
	
		
 
#ssh_locale = C.UTF-8

			




	
	
	
		
 
%if ssh_locale:

			




	
	
	
		
 
ssh_locale = ${ssh_locale}

			




	
	
	
		
 
%endif

			




	
	
	
		
 

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>###        CELERY CONFIG        ####</%text>

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 
<%text>##</%text>         CELERY CONFIG          ##

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Note: Celery doesn't support Windows.</%text>

			




	
	
	
		
 
<%text>##</%text> Note: Celery doesn't support Windows.

			




	
	
	
		
 
use_celery = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Celery config settings from https://docs.celeryproject.org/en/4.4.0/userguide/configuration.html prefixed with 'celery.'.</%text>

			




	
	
	
		
 
<%text>##</%text> Celery config settings from https://docs.celeryproject.org/en/4.4.0/userguide/configuration.html prefixed with 'celery.'.

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Example: use the message queue on the local virtual host 'kallitheavhost' as the RabbitMQ user 'kallithea':</%text>

			




	
	
	
		
 
<%text>##</%text> Example: use the message queue on the local virtual host 'kallitheavhost' as the RabbitMQ user 'kallithea':

			




	
	
	
		
 
celery.broker_url = amqp://kallithea:thepassword@localhost:5672/kallitheavhost

			




	
	
	
		
 

			




	
	
	
		
 
celery.result.backend = db+sqlite:///celery-results.db

			




	
	
	
		
 

			




	
	
	
		
 
#celery.amqp.task.result.expires = 18000

			




	
	
	
		
 

			




	
	
	
		
 
celery.worker_concurrency = 2

			




	
	
	
		
 
celery.worker_max_tasks_per_child = 1

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## If true, tasks will never be sent to the queue, but executed locally instead.</%text>

			




	
	
	
		
 
<%text>##</%text> If true, tasks will never be sent to the queue, but executed locally instead.

			




	
	
	
		
 
celery.task_always_eager = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>###         BEAKER CACHE        ####</%text>

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 
<%text>##</%text>          BEAKER CACHE          ##

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.data_dir = %(here)s/data/cache/data

			




	
	
	
		
 
beaker.cache.lock_dir = %(here)s/data/cache/lock

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.regions = long_term,long_term_file

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.long_term.type = memory

			




	
	
	
		
 
beaker.cache.long_term.expire = 36000

			




	
	
	
		
 
beaker.cache.long_term.key_length = 256

			




	
	
	
		
 

			




	
	
	
		
 
beaker.cache.long_term_file.type = file

			




	
	
	
		
 
beaker.cache.long_term_file.expire = 604800

			




	
	
	
		
 
beaker.cache.long_term_file.key_length = 256

			




	
	
	
		
 

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>###       BEAKER SESSION        ####</%text>

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 
<%text>##</%text>        BEAKER SESSION          ##

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Name of session cookie. Should be unique for a given host and path, even when running</%text>

			




	
	
	
		
 
<%text>## on different ports. Otherwise, cookie sessions will be shared and messed up.</%text>

			




	
	
	
		
 
<%text>##</%text> Name of session cookie. Should be unique for a given host and path, even when running

			




	
	
	
		
 
<%text>##</%text> on different ports. Otherwise, cookie sessions will be shared and messed up.

			




	
	
	
		
 
session.key = kallithea

			




	
	
	
		
 
<%text>## Sessions should always only be accessible by the browser, not directly by JavaScript.</%text>

			




	
	
	
		
 
<%text>##</%text> Sessions should always only be accessible by the browser, not directly by JavaScript.

			




	
	
	
		
 
session.httponly = true

			




	
	
	
		
 
<%text>## Session lifetime. 2592000 seconds is 30 days.</%text>

			




	
	
	
		
 
<%text>##</%text> Session lifetime. 2592000 seconds is 30 days.

			




	
	
	
		
 
session.timeout = 2592000

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Server secret used with HMAC to ensure integrity of cookies.</%text>

			




	
	
	
		
 
<%text>##</%text> Server secret used with HMAC to ensure integrity of cookies.

			




	
	
	
		
 
session.secret = ${uuid()}

			




	
	
	
		
 
<%text>## Further, encrypt the data with AES.</%text>

			




	
	
	
		
 
<%text>##</%text> Further, encrypt the data with AES.

			




	
	
	
		
 
#session.encrypt_key = <key_for_encryption>

			




	
	
	
		
 
#session.validate_key = <validation_key>

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Type of storage used for the session, current types are</%text>

			




	
	
	
		
 
<%text>## dbm, file, memcached, database, and memory.</%text>

			




	
	
	
		
 
<%text>##</%text> Type of storage used for the session, current types are

			




	
	
	
		
 
<%text>##</%text> dbm, file, memcached, database, and memory.

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## File system storage of session data. (default)</%text>

			




	
	
	
		
 
<%text>##</%text> File system storage of session data. (default)

			




	
	
	
		
 
#session.type = file

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Cookie only, store all session data inside the cookie. Requires secure secrets.</%text>

			




	
	
	
		
 
<%text>##</%text> Cookie only, store all session data inside the cookie. Requires secure secrets.

			




	
	
	
		
 
#session.type = cookie

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Database storage of session data.</%text>

			




	
	
	
		
 
<%text>##</%text> Database storage of session data.

			




	
	
	
		
 
#session.type = ext:database

			




	
	
	
		
 
#session.sa.url = postgresql://postgres:qwe@localhost/kallithea

			




	
	
	
		
 
#session.table_name = db_session

			




	
	
	
		
 

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>###       ERROR HANDLING        ####</%text>

			




	
	
	
		
 
<%text>####################################</%text>

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 
<%text>##</%text>        ERROR HANDLING          ##

			




	
	
	
		
 
<%text>##</%text>##################################

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Show a nice error page for application HTTP errors and exceptions (default true)</%text>

			




	
	
	
		
 
<%text>##</%text> Show a nice error page for application HTTP errors and exceptions (default true)

			




	
	
	
		
 
#errorpage.enabled = true

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Enable Backlash client-side interactive debugger (default false)</%text>

			




	
	
	
		
 
<%text>## WARNING: *THIS MUST BE false IN PRODUCTION ENVIRONMENTS!!!*</%text>

			




	
	
	
		
 
<%text>## This debug mode will allow all visitors to execute malicious code.</%text>

			




	
	
	
		
 
<%text>##</%text> Enable Backlash client-side interactive debugger (default false)

			




	
	
	
		
 
<%text>##</%text> WARNING: *THIS MUST BE false IN PRODUCTION ENVIRONMENTS!!!*

			




	
	
	
		
 
<%text>##</%text> This debug mode will allow all visitors to execute malicious code.

			




	
	
	
		
 
#debug = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Enable Backlash server-side error reporting (unless debug mode handles it client-side) (default true)</%text>

			




	
	
	
		
 
<%text>##</%text> Enable Backlash server-side error reporting (unless debug mode handles it client-side) (default true)

			




	
	
	
		
 
#trace_errors.enable = true

			




	
	
	
		
 
<%text>## Errors will be reported by mail if trace_errors.error_email is set.</%text>

			




	
	
	
		
 
<%text>##</%text> Errors will be reported by mail if trace_errors.error_email is set.

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Propagate email settings to ErrorReporter of TurboGears2</%text>

			




	
	
	
		
 
<%text>## You do not normally need to change these lines</%text>

			




	
	
	
		
 
<%text>##</%text> Propagate email settings to ErrorReporter of TurboGears2

			




	
	
	
		
 
<%text>##</%text> You do not normally need to change these lines

			




	
	
	
		
 
get trace_errors.smtp_server = smtp_server

			




	
	
	
		
 
get trace_errors.smtp_port = smtp_port

			




	
	
	
		
 
get trace_errors.from_address = error_email_from

			




	
	
	
		
 
get trace_errors.error_email = email_to

			




	
	
	
		
 
get trace_errors.smtp_username = smtp_username

			




	
	
	
		
 
get trace_errors.smtp_password = smtp_password

			




	
	
	
		
 
get trace_errors.smtp_use_tls = smtp_use_tls

			




	
	
	
		
 

			




	
	
	
		
 
%if error_aggregation_service == 'sentry':

			




	
	
	
		
 
<%text>################</%text>

			




	
	
	
		
 
<%text>### [sentry] ###</%text>

			




	
	
	
		
 
<%text>################</%text>

			




	
	
	
		
 
<%text>##</%text>##############

			




	
	
	
		
 
<%text>##</%text>  [sentry]  ##

			




	
	
	
		
 
<%text>##</%text>##############

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## sentry is a alternative open source error aggregator</%text>

			




	
	
	
		
 
<%text>## you must install python packages `sentry` and `raven` to enable</%text>

			




	
	
	
		
 
<%text>##</%text> sentry is a alternative open source error aggregator

			




	
	
	
		
 
<%text>##</%text> you must install python packages `sentry` and `raven` to enable

			




	
	
	
		
 

			




	
	
	
		
 
sentry.dsn = YOUR_DNS

			




	
	
	
		
 
sentry.servers =

			




	
	
	
		
 
sentry.name =

			




	
	
	
		
 
sentry.key =

			




	
	
	
		
 
sentry.public_key =

			




	
	
	
		
 
sentry.secret_key =

			




	
	
	
		
 
sentry.project =

			




	
	
	
		
 
sentry.site =

			




	
	
	
		
 
sentry.include_paths =

			




	
	
	
		
 
sentry.exclude_paths =

			




	
	
	
		
 

			




	
	
	
		
 
%endif

			




	
	
	
		
 

			




	
	
	
		
 
<%text>##################################</%text>

			




	
	
	
		
 
<%text>###       LOGVIEW CONFIG       ###</%text>

			




	
	
	
		
 
<%text>##################################</%text>

			




	
	
	
		
 
<%text>##</%text>################################

			




	
	
	
		
 
<%text>##</%text>        LOGVIEW CONFIG        ##

			




	
	
	
		
 
<%text>##</%text>################################

			




	
	
	
		
 

			




	
	
	
		
 
logview.sqlalchemy = #faa

			




	
	
	
		
 
logview.pylons.templating = #bfb

			




	
	
	
		
 
logview.pylons.util = #eee

			




	
	
	
		
 

			




	
	
	
		
 
<%text>#########################################################</%text>

			




	
	
	
		
 
<%text>### DB CONFIGS - EACH DB WILL HAVE IT'S OWN CONFIG    ###</%text>

			




	
	
	
		
 
<%text>#########################################################</%text>

			




	
	
	
		
 
<%text>##</%text>#######################

			




	
	
	
		
 
<%text>##</%text>      DB CONFIG      ##

			




	
	
	
		
 
<%text>##</%text>#######################

			




	
	
	
		
 

			




	
	
	
		
 
%if database_engine == 'sqlite':

			




	
	
	
		
 
<%text>## SQLITE [default]</%text>

			




	
	
	
		
 
<%text>##</%text> SQLITE [default]

			




	
	
	
		
 
sqlalchemy.url = sqlite:///%(here)s/kallithea.db?timeout=60

			




	
	
	
		
 

			




	
	
	
		
 
%elif database_engine == 'postgres':

			




	
	
	
		
 
<%text>## POSTGRESQL</%text>

			




	
	
	
		
 
<%text>##</%text> POSTGRESQL

			




	
	
	
		
 
sqlalchemy.url = postgresql://user:pass@localhost/kallithea

			




	
	
	
		
 

			




	
	
	
		
 
%elif database_engine == 'mysql':

			




	
	
	
		
 
<%text>## MySQL</%text>

			




	
	
	
		
 
<%text>##</%text> MySQL

			




	
	
	
		
 
sqlalchemy.url = mysql://user:pass@localhost/kallithea?charset=utf8

			




	
	
	
		
 

			




	
	
	
		
 
%endif

			




	
	
	
		
 
<%text>## see sqlalchemy docs for other backends</%text>

			




	
	
	
		
 
<%text>##</%text> see sqlalchemy docs for other backends

			




	
	
	
		
 

			




	
	
	
		
 
sqlalchemy.pool_recycle = 3600

			




	
	
	
		
 

			




	
	
	
		
 
<%text>################################</%text>

			




	
	
	
		
 
<%text>### ALEMBIC CONFIGURATION   ####</%text>

			




	
	
	
		
 
<%text>################################</%text>

			




	
	
	
		
 
<%text>##</%text>##############################

			




	
	
	
		
 
<%text>##</%text>   ALEMBIC CONFIGURATION    ##

			




	
	
	
		
 
<%text>##</%text>##############################

			




	
	
	
		
 

			




	
	
	
		
 
[alembic]

			




	
	
	
		
 
script_location = kallithea:alembic

			




	
	
	
		
 

			




	
	
	
		
 
<%text>################################</%text>

			




	
	
	
		
 
<%text>### LOGGING CONFIGURATION   ####</%text>

			




	
	
	
		
 
<%text>################################</%text>

			




	
	
	
		
 
<%text>##</%text>##############################

			




	
	
	
		
 
<%text>##</%text>   LOGGING CONFIGURATION    ##

			




	
	
	
		
 
<%text>##</%text>##############################

			




	
	
	
		
 

			




	
	
	
		
 
[loggers]

			




	
	
	
		
 
keys = root, routes, kallithea, sqlalchemy, tg, gearbox, beaker, templates, whoosh_indexer, werkzeug, backlash

			




	
	
	
		
 

			




	
	
	
		
 
[handlers]

			




	
	
	
		
 
keys = console, console_color, console_color_sql, null

			




	
	
	
		
 

			




	
	
	
		
 
[formatters]

			




	
	
	
		
 
keys = generic, color_formatter, color_formatter_sql

			




	
	
	
		
 

			




	
	
	
		
 
<%text>#############</%text>

			




	
	
	
		
 
<%text>## LOGGERS ##</%text>

			




	
	
	
		
 
<%text>#############</%text>

			




	
	
	
		
 
<%text>##</%text>###########

			




	
	
	
		
 
<%text>##</%text> LOGGERS ##

			




	
	
	
		
 
<%text>##</%text>###########

			




	
	
	
		
 

			




	
	
	
		
 
[logger_root]

			




	
	
	
		
 
level = NOTSET

			




	
	
	
		
 
handlers = console

			




	
	
	
		
 
<%text>## For coloring based on log level:</%text>

			




	
	
	
		
 
<%text>##</%text> For coloring based on log level:

			




	
	
	
		
 
#handlers = console_color

			




	
	
	
		
 

			




	
	
	
		
 
[logger_routes]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = routes.middleware

			




	
	
	
		
 
<%text>## "level = DEBUG" logs the route matched and routing variables.</%text>

			




	
	
	
		
 
<%text>##</%text> "level = DEBUG" logs the route matched and routing variables.

			




	
	
	
		
 

			




	
	
	
		
 
[logger_beaker]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = beaker.container

			




	
	
	
		
 

			




	
	
	
		
 
[logger_templates]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = pylons.templating

			




	
	
	
		
 

			




	
	
	
		
 
[logger_kallithea]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = kallithea

			




	
	
	
		
 

			




	
	
	
		
 
[logger_tg]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = tg

			




	
	
	
		
 

			




	
	
	
		
 
[logger_gearbox]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = gearbox

			




	
	
	
		
 

			




	
	
	
		
 
[logger_sqlalchemy]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = sqlalchemy.engine

			




	
	
	
		
 
<%text>## For coloring based on log level and pretty printing of SQL:</%text>

			




	
	
	
		
 
<%text>##</%text> For coloring based on log level and pretty printing of SQL:

			




	
	
	
		
 
#level = INFO

			




	
	
	
		
 
#handlers = console_color_sql

			




	
	
	
		
 
#propagate = 0

			




	
	
	
		
 

			




	
	
	
		
 
[logger_whoosh_indexer]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = whoosh_indexer

			




	
	
	
		
 

			




	
	
	
		
 
[logger_werkzeug]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = werkzeug

			




	
	
	
		
 

			




	
	
	
		
 
[logger_backlash]

			




	
	
	
		
 
level = WARN

			




	
	
	
		
 
handlers =

			




	
	
	
		
 
qualname = backlash

			




	
	
	
		
 

			




	
	
	
		
 
<%text>##############</%text>

			




	
	
	
		
 
<%text>## HANDLERS ##</%text>

			




	
	
	
		
 
<%text>##############</%text>

			




	
	
	
		
 
<%text>##</%text>############

			




	
	
	
		
 
<%text>##</%text> HANDLERS ##

			




	
	
	
		
 
<%text>##</%text>############

			




	
	
	
		
 

			




	
	
	
		
 
[handler_console]

			




	
	
	
		
 
class = StreamHandler

			




	
	
	
		
 
args = (sys.stderr,)

			




	
	
	
		
 
formatter = generic

			




	
	
	
		
 

			




	
	
	
		
 
[handler_console_color]

			




	
	
	
		
 
<%text>## ANSI color coding based on log level</%text>

			




	
	
	
		
 
<%text>##</%text> ANSI color coding based on log level

			




	
	
	
		
 
class = StreamHandler

			




	
	
	
		
 
args = (sys.stderr,)

			




	
	
	
		
 
formatter = color_formatter

			




	
	
	
		
 

			




	
	
	
		
 
[handler_console_color_sql]

			




	
	
	
		
 
<%text>## ANSI color coding and pretty printing of SQL statements</%text>

			




	
	
	
		
 
<%text>##</%text> ANSI color coding and pretty printing of SQL statements

			




	
	
	
		
 
class = StreamHandler

			




	
	
	
		
 
args = (sys.stderr,)

			




	
	
	
		
 
formatter = color_formatter_sql

			




	
	
	
		
 

			




	
	
	
		
 
[handler_null]

			




	
	
	
		
 
class = NullHandler

			




	
	
	
		
 
args = ()

			




	
	
	
		
 

			




	
	
	
		
 
<%text>################</%text>

			




	
	
	
		
 
<%text>## FORMATTERS ##</%text>

			




	
	
	
		
 
<%text>################</%text>

			




	
	
	
		
 
<%text>##</%text>##############

			




	
	
	
		
 
<%text>##</%text> FORMATTERS ##

			




	
	
	
		
 
<%text>##</%text>##############

			




	
	
	
		
 

			




	
	
	
		
 
[formatter_generic]

			




	
	
	
		
 
format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s

			




	
	
	
		
 
datefmt = %Y-%m-%d %H:%M:%S

			




	
	
	
		
 

			




	
	
	
		
 
[formatter_color_formatter]

			




	
	
	
		
 
class = kallithea.lib.colored_formatter.ColorFormatter

			




	
	
	
		
 
format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s

			




	
	
	
		
 
datefmt = %Y-%m-%d %H:%M:%S

			




	
	
	
		
 

			




	
	
	
		
 
[formatter_color_formatter_sql]

			




	
	
	
		
 
class = kallithea.lib.colored_formatter.ColorFormatterSql

			




	
	
	
		
 
format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s

			




	
	
	
		
 
datefmt = %Y-%m-%d %H:%M:%S

			




	
	
	
		
 

			




	
	
	
		
 
<%text>#################</%text>

			




	
	
	
		
 
<%text>## SSH LOGGING ##</%text>

			




	
	
	
		
 
<%text>#################</%text>

			




	
	
	
		
 
<%text>##</%text>###############

			




	
	
	
		
 
<%text>##</%text> SSH LOGGING ##

			




	
	
	
		
 
<%text>##</%text>###############

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## The default loggers use 'handler_console' that uses StreamHandler with</%text>

			




	
	
	
		
 
<%text>## destination 'sys.stderr'. In the context of the SSH server process, these log</%text>

			




	
	
	
		
 
<%text>## messages would be sent to the client, which is normally not what you want.</%text>

			




	
	
	
		
 
<%text>## By default, when running ssh-serve, just use NullHandler and disable logging</%text>

			




	
	
	
		
 
<%text>## completely. For other logging options, see:</%text>

			




	
	
	
		
 
<%text>## https://docs.python.org/2/library/logging.handlers.html</%text>

			




	
	
	
		
 
<%text>##</%text> The default loggers use 'handler_console' that uses StreamHandler with

			




	
	
	
		
 
<%text>##</%text> destination 'sys.stderr'. In the context of the SSH server process, these log

			




	
	
	
		
 
<%text>##</%text> messages would be sent to the client, which is normally not what you want.

			




	
	
	
		
 
<%text>##</%text> By default, when running ssh-serve, just use NullHandler and disable logging

			




	
	
	
		
 
<%text>##</%text> completely. For other logging options, see:

			




	
	
	
		
 
<%text>##</%text> https://docs.python.org/2/library/logging.handlers.html

			




	
	
	
		
 

			




	
	
	
		
 
[ssh_serve:logger_root]

			




	
	
	
		
 
level = CRITICAL

			




	
	
	
		
 
handlers = null

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Note: If logging is configured with other handlers, they might need similar</%text>

			




	
	
	
		
 
<%text>## muting for ssh-serve too.</%text>

			




	
	
	
		
 
<%text>##</%text> Note: If logging is configured with other handlers, they might need similar

			




	
	
	
		
 
<%text>##</%text> muting for ssh-serve too.

			




        

    


    
    

    

        

                

                    kallithea/lib/vcs/backends/git/changeset.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
		
 
@@ -42,387 +42,387 @@ class GitChangeset(BaseChangeset):

			




	
	
	
		
 

			




	
	
	
		
 
        self.nodes = {}

			




	
	
	
		
 
        self._paths = {}

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def bookmarks(self):

			




	
	
	
		
 
        return ()

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def message(self):

			




	
	
	
		
 
        return safe_str(self._commit.message)

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def committer(self):

			




	
	
	
		
 
        return safe_str(getattr(self._commit, self._committer_property))

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def author(self):

			




	
	
	
		
 
        return safe_str(getattr(self._commit, self._author_property))

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def date(self):

			




	
	
	
		
 
        return date_fromtimestamp(getattr(self._commit, self._date_property),

			




	
	
	
		
 
                                  getattr(self._commit, self._date_tz_property))

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def _timestamp(self):

			




	
	
	
		
 
        return getattr(self._commit, self._date_property)

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def status(self):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns modified, added, removed, deleted files for current changeset

			




	
	
	
		
 
        """

			




	
	
	
		
 
        return self.changed, self.added, self.removed

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def tags(self):

			




	
	
	
		
 
        _tags = []

			




	
	
	
		
 
        for tname, tsha in self.repository.tags.items():

			




	
	
	
		
 
            if tsha == self.raw_id:

			




	
	
	
		
 
                _tags.append(tname)

			




	
	
	
		
 
        return _tags

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def branch(self):

			




	
	
	
		
 
        # Note: This function will return one branch name for the changeset -

			




	
	
	
		
 
        # that might not make sense in Git where branches() is a better match

			




	
	
	
		
 
        # for the basic model

			




	
	
	
		
 
        heads = self.repository._heads(reverse=False)

			




	
	
	
		
 
        ref = heads.get(self._commit.id)

			




	
	
	
		
 
        if ref:

			




	
	
	
		
 
            return safe_str(ref)

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def branches(self):

			




	
	
	
		
 
        heads = self.repository._heads(reverse=True)

			




	
	
	
		
 
        return [safe_str(b) for b in heads if heads[b] == self._commit.id] # FIXME: Inefficient ... and returning None!

			




	
	
	
		
 

			




	
	
	
		
 
    def _get_id_for_path(self, path):

			




	
	
	
		
 
        # FIXME: Please, spare a couple of minutes and make those codes cleaner;

			




	
	
	
		
 
        if path not in self._paths:

			




	
	
	
		
 
            path = path.strip('/')

			




	
	
	
		
 
            # set root tree

			




	
	
	
		
 
            tree = self.repository._repo[self._tree_id]

			




	
	
	
		
 
            if path == '':

			




	
	
	
		
 
                self._paths[''] = tree.id

			




	
	
	
		
 
                return tree.id

			




	
	
	
		
 
            splitted = path.split('/')

			




	
	
	
		
 
            dirs, name = splitted[:-1], splitted[-1]

			




	
	
	
		
 
            curdir = ''

			




	
	
	
		
 

			




	
	
	
		
 
            # initially extract things from root dir

			




	
	
	
		
 
            for item, stat, id in tree.items():

			




	
	
	
		
 
                name = safe_str(item)

			




	
	
	
		
 
                if curdir:

			




	
	
	
		
 
                    name = '/'.join((curdir, name))

			




	
	
	
		
 
                self._paths[name] = id

			




	
	
	
		
 
                self._stat_modes[name] = stat

			




	
	
	
		
 

			




	
	
	
		
 
            for dir in dirs:

			




	
	
	
		
 
                if curdir:

			




	
	
	
		
 
                    curdir = '/'.join((curdir, dir))

			




	
	
	
		
 
                else:

			




	
	
	
		
 
                    curdir = dir

			




	
	
	
		
 
                dir_id = None

			




	
	
	
		
 
                for item, stat, id in tree.items():

			




	
	
	
		
 
                    name = safe_str(item)

			




	
	
	
		
 
                    if dir == name:

			




	
	
	
		
 
                        dir_id = id

			




	
	
	
		
 
                if dir_id:

			




	
	
	
		
 
                    # Update tree

			




	
	
	
		
 
                    tree = self.repository._repo[dir_id]

			




	
	
	
		
 
                    if not isinstance(tree, objects.Tree):

			




	
	
	
		
 
                        raise ChangesetError('%s is not a directory' % curdir)

			




	
	
	
		
 
                else:

			




	
	
	
		
 
                    raise ChangesetError('%s have not been found' % curdir)

			




	
	
	
		
 

			




	
	
	
		
 
                # cache all items from the given traversed tree

			




	
	
	
		
 
                for item, stat, id in tree.items():

			




	
	
	
		
 
                    name = safe_str(item)

			




	
	
	
		
 
                    if curdir:

			




	
	
	
		
 
                        name = '/'.join((curdir, name))

			




	
	
	
		
 
                    self._paths[name] = id

			




	
	
	
		
 
                    self._stat_modes[name] = stat

			




	
	
	
		
 
            if path not in self._paths:

			




	
	
	
		
 
                raise NodeDoesNotExistError("There is no file nor directory "

			




	
	
	
		
 
                    "at the given path '%s' at revision %s"

			




	
	
	
		
 
                    % (path, self.short_id))

			




	
	
	
		
 
        return self._paths[path]

			




	
	
	
		
 

			




	
	
	
		
 
    def _get_kind(self, path):

			




	
	
	
		
 
        obj = self.repository._repo[self._get_id_for_path(path)]

			




	
	
	
		
 
        if isinstance(obj, objects.Blob):

			




	
	
	
		
 
            return NodeKind.FILE

			




	
	
	
		
 
        elif isinstance(obj, objects.Tree):

			




	
	
	
		
 
            return NodeKind.DIR

			




	
	
	
		
 

			




	
	
	
		
 
    def _get_filectx(self, path):

			




	
	
	
		
 
        path = path.rstrip('/')

			




	
	
	
		
 
        if self._get_kind(path) != NodeKind.FILE:

			




	
	
	
		
 
            raise ChangesetError("File does not exist for revision %s at "

			




	
	
	
		
 
                " '%s'" % (self.raw_id, path))

			




	
	
	
		
 
        return path

			




	
	
	
		
 

			




	
	
	
		
 
    def _get_file_nodes(self):

			




	
	
	
		
 
        return chain(*(t[2] for t in self.walk()))

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def parents(self):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns list of parents changesets.

			




	
	
	
		
 
        """

			




	
	
	
		
 
        return [self.repository.get_changeset(ascii_str(parent_id))

			




	
	
	
		
 
                for parent_id in self._commit.parents]

			




	
	
	
		
 

			




	
	
	
		
 
    @LazyProperty

			




	
	
	
		
 
    def children(self):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns list of children changesets.

			




	
	
	
		
 
        """

			




	
	
	
		
 
        rev_filter = settings.GIT_REV_FILTER

			




	
	
	
		
 
        so = self.repository.run_git_command(

			




	
	
	
		
 
            ['rev-list', rev_filter, '--children']

			




	
	
	
		
 
        )

			




	
	
	
		
 
        return [

			




	
	
	
		
 
            self.repository.get_changeset(cs)

			




	
	
	
		
 
            for parts in (l.split(' ') for l in so.splitlines())

			




	
	
	
		
 
            if parts[0] == self.raw_id

			




	
	
	
		
 
            for cs in parts[1:]

			




	
	
	
		
 
        ]

			




	
	
	
		
 

			




	
	
	
		
 
    def next(self, branch=None):

			




	
	
	
		
 
        if branch and self.branch != branch:

			




	
	
	
		
 
            raise VCSError('Branch option used on changeset not belonging '

			




	
	
	
		
 
                           'to that branch')

			




	
	
	
		
 

			




	
	
	
		
 
        cs = self

			




	
	
	
		
 
        while True:

			




	
	
	
		
 
            try:

			




	
	
	
		
 
                next_ = cs.revision + 1

			




	
	
	
		
 
                next_rev = cs.repository.revisions[next_]

			




	
	
	
		
 
            except IndexError:

			




	
	
	
		
 
                raise ChangesetDoesNotExistError

			




	
	
	
		
 
            cs = cs.repository.get_changeset(next_rev)

			




	
	
	
		
 

			




	
	
	
		
 
            if not branch or branch == cs.branch:

			




	
	
	
		
 
                return cs

			




	
	
	
		
 

			




	
	
	
		
 
    def prev(self, branch=None):

			




	
	
	
		
 
        if branch and self.branch != branch:

			




	
	
	
		
 
            raise VCSError('Branch option used on changeset not belonging '

			




	
	
	
		
 
                           'to that branch')

			




	
	
	
		
 

			




	
	
	
		
 
        cs = self

			




	
	
	
		
 
        while True:

			




	
	
	
		
 
            try:

			




	
	
	
		
 
                prev_ = cs.revision - 1

			




	
	
	
		
 
                if prev_ < 0:

			




	
	
	
		
 
                    raise IndexError

			




	
	
	
		
 
                prev_rev = cs.repository.revisions[prev_]

			




	
	
	
		
 
            except IndexError:

			




	
	
	
		
 
                raise ChangesetDoesNotExistError

			




	
	
	
		
 
            cs = cs.repository.get_changeset(prev_rev)

			




	
	
	
		
 

			




	
	
	
		
 
            if not branch or branch == cs.branch:

			




	
	
	
		
 
                return cs

			




	
	
	
		
 

			




	
	
	
		
 
    def diff(self, ignore_whitespace=True, context=3):

			




	
	
	
		
 
        # Only used to feed diffstat

			




	
	
	
		
 
        rev1 = self.parents[0] if self.parents else self.repository.EMPTY_CHANGESET

			




	
	
	
		
 
        rev2 = self

			




	
	
	
		
 
        return b''.join(self.repository.get_diff(rev1, rev2,

			




	
	
	
		
 
        return self.repository.get_diff(rev1, rev2,

			




	
	
	
		
 
                                    ignore_whitespace=ignore_whitespace,

			




	
	
	
		
 
                                    context=context))

			




	
	
	
		
 
                                    context=context)

			




	
	
	
		
 

			




	
	
	
		
 
    def get_file_mode(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns stat mode of the file at the given ``path``.

			




	
	
	
		
 
        """

			




	
	
	
		
 
        # ensure path is traversed

			




	
	
	
		
 
        self._get_id_for_path(path)

			




	
	
	
		
 
        return self._stat_modes[path]

			




	
	
	
		
 

			




	
	
	
		
 
    def get_file_content(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns content of the file at given ``path``.

			




	
	
	
		
 
        """

			




	
	
	
		
 
        id = self._get_id_for_path(path)

			




	
	
	
		
 
        blob = self.repository._repo[id]

			




	
	
	
		
 
        return blob.as_pretty_string()

			




	
	
	
		
 

			




	
	
	
		
 
    def get_file_size(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns size of the file at given ``path``.

			




	
	
	
		
 
        """

			




	
	
	
		
 
        id = self._get_id_for_path(path)

			




	
	
	
		
 
        blob = self.repository._repo[id]

			




	
	
	
		
 
        return blob.raw_length()

			




	
	
	
		
 

			




	
	
	
		
 
    def get_file_changeset(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns last commit of the file at the given ``path``.

			




	
	
	
		
 
        """

			




	
	
	
		
 
        return self.get_file_history(path, limit=1)[0]

			




	
	
	
		
 

			




	
	
	
		
 
    def get_file_history(self, path, limit=None):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns history of file as reversed list of ``Changeset`` objects for

			




	
	
	
		
 
        which file at given ``path`` has been modified.

			




	
	
	
		
 

			




	
	
	
		
 
        TODO: This function now uses os underlying 'git' and 'grep' commands

			




	
	
	
		
 
        which is generally not good. Should be replaced with algorithm

			




	
	
	
		
 
        iterating commits.

			




	
	
	
		
 
        """

			




	
	
	
		
 
        self._get_filectx(path)

			




	
	
	
		
 

			




	
	
	
		
 
        if limit is not None:

			




	
	
	
		
 
            cmd = ['log', '-n', str(safe_int(limit, 0)),

			




	
	
	
		
 
                   '--pretty=format:%H', '-s', self.raw_id, '--', path]

			




	
	
	
		
 

			




	
	
	
		
 
        else:

			




	
	
	
		
 
            cmd = ['log',

			




	
	
	
		
 
                   '--pretty=format:%H', '-s', self.raw_id, '--', path]

			




	
	
	
		
 
        so = self.repository.run_git_command(cmd)

			




	
	
	
		
 
        ids = re.findall(r'[0-9a-fA-F]{40}', so)

			




	
	
	
		
 
        return [self.repository.get_changeset(sha) for sha in ids]

			




	
	
	
		
 

			




	
	
	
		
 
    def get_file_history_2(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns history of file as reversed list of ``Changeset`` objects for

			




	
	
	
		
 
        which file at given ``path`` has been modified.

			




	
	
	
		
 

			




	
	
	
		
 
        """

			




	
	
	
		
 
        self._get_filectx(path)

			




	
	
	
		
 
        from dulwich.walk import Walker

			




	
	
	
		
 
        include = [self.raw_id]

			




	
	
	
		
 
        walker = Walker(self.repository._repo.object_store, include,

			




	
	
	
		
 
                        paths=[path], max_entries=1)

			




	
	
	
		
 
        return [self.repository.get_changeset(ascii_str(x.commit.id.decode))

			




	
	
	
		
 
                for x in walker]

			




	
	
	
		
 

			




	
	
	
		
 
    def get_file_annotate(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns a generator of four element tuples with

			




	
	
	
		
 
            lineno, sha, changeset lazy loader and line

			




	
	
	
		
 
        """

			




	
	
	
		
 
        # TODO: This function now uses os underlying 'git' command which is

			




	
	
	
		
 
        # generally not good. Should be replaced with algorithm iterating

			




	
	
	
		
 
        # commits.

			




	
	
	
		
 
        cmd = ['blame', '-l', '--root', '-r', self.raw_id, '--', path]

			




	
	
	
		
 
        # -l     ==> outputs long shas (and we need all 40 characters)

			




	
	
	
		
 
        # --root ==> doesn't put '^' character for boundaries

			




	
	
	
		
 
        # -r sha ==> blames for the given revision

			




	
	
	
		
 
        so = self.repository.run_git_command(cmd)

			




	
	
	
		
 

			




	
	
	
		
 
        for i, blame_line in enumerate(so.split('\n')[:-1]):

			




	
	
	
		
 
            sha, line = re.split(r' ', blame_line, 1)

			




	
	
	
		
 
            yield (i + 1, sha, lambda sha=sha: self.repository.get_changeset(sha), line)

			




	
	
	
		
 

			




	
	
	
		
 
    def fill_archive(self, stream=None, kind='tgz', prefix=None,

			




	
	
	
		
 
                     subrepos=False):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Fills up given stream.

			




	
	
	
		
 

			




	
	
	
		
 
        :param stream: file like object.

			




	
	
	
		
 
        :param kind: one of following: ``zip``, ``tgz`` or ``tbz2``.

			




	
	
	
		
 
            Default: ``tgz``.

			




	
	
	
		
 
        :param prefix: name of root directory in archive.

			




	
	
	
		
 
            Default is repository name and changeset's raw_id joined with dash

			




	
	
	
		
 
            (``repo-tip.<KIND>``).

			




	
	
	
		
 
        :param subrepos: include subrepos in this archive.

			




	
	
	
		
 

			




	
	
	
		
 
        :raise ImproperArchiveTypeError: If given kind is wrong.

			




	
	
	
		
 
        :raise VcsError: If given stream is None

			




	
	
	
		
 
        """

			




	
	
	
		
 
        allowed_kinds = settings.ARCHIVE_SPECS

			




	
	
	
		
 
        if kind not in allowed_kinds:

			




	
	
	
		
 
            raise ImproperArchiveTypeError('Archive kind not supported use one'

			




	
	
	
		
 
                'of %s' % ' '.join(allowed_kinds))

			




	
	
	
		
 

			




	
	
	
		
 
        if stream is None:

			




	
	
	
		
 
            raise VCSError('You need to pass in a valid stream for filling'

			




	
	
	
		
 
                           ' with archival data')

			




	
	
	
		
 

			




	
	
	
		
 
        if prefix is None:

			




	
	
	
		
 
            prefix = '%s-%s' % (self.repository.name, self.short_id)

			




	
	
	
		
 
        elif prefix.startswith('/'):

			




	
	
	
		
 
            raise VCSError("Prefix cannot start with leading slash")

			




	
	
	
		
 
        elif prefix.strip() == '':

			




	
	
	
		
 
            raise VCSError("Prefix cannot be empty")

			




	
	
	
		
 

			




	
	
	
		
 
        if kind == 'zip':

			




	
	
	
		
 
            frmt = 'zip'

			




	
	
	
		
 
        else:

			




	
	
	
		
 
            frmt = 'tar'

			




	
	
	
		
 
        _git_path = settings.GIT_EXECUTABLE_PATH

			




	
	
	
		
 
        cmd = '%s archive --format=%s --prefix=%s/ %s' % (_git_path,

			




	
	
	
		
 
                                                frmt, prefix, self.raw_id)

			




	
	
	
		
 
        if kind == 'tgz':

			




	
	
	
		
 
            cmd += ' | gzip -9'

			




	
	
	
		
 
        elif kind == 'tbz2':

			




	
	
	
		
 
            cmd += ' | bzip2 -9'

			




	
	
	
		
 

			




	
	
	
		
 
        if stream is None:

			




	
	
	
		
 
            raise VCSError('You need to pass in a valid stream for filling'

			




	
	
	
		
 
                           ' with archival data')

			




	
	
	
		
 
        popen = Popen(cmd, stdout=PIPE, stderr=PIPE, shell=True,

			




	
	
	
		
 
                      cwd=self.repository.path)

			




	
	
	
		
 

			




	
	
	
		
 
        buffer_size = 1024 * 8

			




	
	
	
		
 
        chunk = popen.stdout.read(buffer_size)

			




	
	
	
		
 
        while chunk:

			




	
	
	
		
 
            stream.write(chunk)

			




	
	
	
		
 
            chunk = popen.stdout.read(buffer_size)

			




	
	
	
		
 
        # Make sure all descriptors would be read

			




	
	
	
		
 
        popen.communicate()

			




	
	
	
		
 

			




	
	
	
		
 
    def get_nodes(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns combined ``DirNode`` and ``FileNode`` objects list representing

			




	
	
	
		
 
        state of changeset at the given ``path``. If node at the given ``path``

			




	
	
	
		
 
        is not instance of ``DirNode``, ChangesetError would be raised.

			




	
	
	
		
 
        """

			




	
	
	
		
 

			




	
	
	
		
 
        if self._get_kind(path) != NodeKind.DIR:

			




	
	
	
		
 
            raise ChangesetError("Directory does not exist for revision %s at "

			




	
	
	
		
 
                " '%s'" % (self.revision, path))

			




	
	
	
		
 
        path = path.rstrip('/')

			




	
	
	
		
 
        id = self._get_id_for_path(path)

			




	
	
	
		
 
        tree = self.repository._repo[id]

			




	
	
	
		
 
        dirnodes = []

			




	
	
	
		
 
        filenodes = []

			




	
	
	
		
 
        als = self.repository.alias

			




	
	
	
		
 
        for name, stat, id in tree.items():

			




	
	
	
		
 
            obj_path = safe_str(name)

			




	
	
	
		
 
            if path != '':

			




	
	
	
		
 
                obj_path = '/'.join((path, obj_path))

			




	
	
	
		
 
            if objects.S_ISGITLINK(stat):

			




	
	
	
		
 
                root_tree = self.repository._repo[self._tree_id]

			




	
	
	
		
 
                cf = ConfigFile.from_file(BytesIO(self.repository._repo.get_object(root_tree[b'.gitmodules'][1]).data))

			




	
	
	
		
 
                url = ascii_str(cf.get(('submodule', obj_path), 'url'))

			




	
	
	
		
 
                dirnodes.append(SubModuleNode(obj_path, url=url, changeset=ascii_str(id),

			




	
	
	
		
 
                                              alias=als))

			




	
	
	
		
 
                continue

			




	
	
	
		
 

			




	
	
	
		
 
            obj = self.repository._repo.get_object(id)

			




	
	
	
		
 
            if obj_path not in self._stat_modes:

			




	
	
	
		
 
                self._stat_modes[obj_path] = stat

			




	
	
	
		
 
            if isinstance(obj, objects.Tree):

			




	
	
	
		
 
                dirnodes.append(DirNode(obj_path, changeset=self))

			




	
	
	
		
 
            elif isinstance(obj, objects.Blob):

			




	
	
	
		
 
                filenodes.append(FileNode(obj_path, changeset=self, mode=stat))

			




	
	
	
		
 
            else:

			




	
	
	
		
 
                raise ChangesetError("Requested object should be Tree "

			




	
	
	
		
 
                                     "or Blob, is %r" % type(obj))

			




	
	
	
		
 
        nodes = dirnodes + filenodes

			




	
	
	
		
 
        for node in nodes:

			




	
	
	
		
 
            if node.path not in self.nodes:

			




	
	
	
		
 
                self.nodes[node.path] = node

			




	
	
	
		
 
        nodes.sort()

			




	
	
	
		
 
        return nodes

			




	
	
	
		
 

			




	
	
	
		
 
    def get_node(self, path):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Returns ``Node`` object from the given ``path``. If there is no node at

			




	
	
	
		
 
        the given ``path``, ``ChangesetError`` would be raised.

			




        

    


    
    

    

        

                

                    kallithea/model/db.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
		
 
@@ -2106,218 +2106,217 @@ class PullRequest(Base, BaseDbModel):

			




	
	
	
		
 

			




	
	
	
		
 
        return q

			




	
	
	
		
 

			




	
	
	
		
 
    def get_reviewer_users(self):

			




	
	
	
		
 
        """Like .reviewers, but actually returning the users"""

			




	
	
	
		
 
        return User.query() \

			




	
	
	
		
 
            .join(PullRequestReviewer) \

			




	
	
	
		
 
            .filter(PullRequestReviewer.pull_request == self) \

			




	
	
	
		
 
            .order_by(PullRequestReviewer.pull_request_reviewers_id) \

			




	
	
	
		
 
            .all()

			




	
	
	
		
 

			




	
	
	
		
 
    def is_closed(self):

			




	
	
	
		
 
        return self.status == self.STATUS_CLOSED

			




	
	
	
		
 

			




	
	
	
		
 
    def user_review_status(self, user_id):

			




	
	
	
		
 
        """Return the user's latest status votes on PR"""

			




	
	
	
		
 
        # note: no filtering on repo - that would be redundant

			




	
	
	
		
 
        status = ChangesetStatus.query() \

			




	
	
	
		
 
            .filter(ChangesetStatus.pull_request == self) \

			




	
	
	
		
 
            .filter(ChangesetStatus.user_id == user_id) \

			




	
	
	
		
 
            .order_by(ChangesetStatus.version) \

			




	
	
	
		
 
            .first()

			




	
	
	
		
 
        return str(status.status) if status else ''

			




	
	
	
		
 

			




	
	
	
		
 
    @classmethod

			




	
	
	
		
 
    def make_nice_id(cls, pull_request_id):

			




	
	
	
		
 
        '''Return pull request id nicely formatted for displaying'''

			




	
	
	
		
 
        return '#%s' % pull_request_id

			




	
	
	
		
 

			




	
	
	
		
 
    def nice_id(self):

			




	
	
	
		
 
        '''Return the id of this pull request, nicely formatted for displaying'''

			




	
	
	
		
 
        return self.make_nice_id(self.pull_request_id)

			




	
	
	
		
 

			




	
	
	
		
 
    def get_api_data(self):

			




	
	
	
		
 
        return self.__json__()

			




	
	
	
		
 

			




	
	
	
		
 
    def __json__(self):

			




	
	
	
		
 
        clone_uri_tmpl = kallithea.CONFIG.get('clone_uri_tmpl') or Repository.DEFAULT_CLONE_URI

			




	
	
	
		
 
        return dict(

			




	
	
	
		
 
            pull_request_id=self.pull_request_id,

			




	
	
	
		
 
            url=self.url(),

			




	
	
	
		
 
            reviewers=self.reviewers,

			




	
	
	
		
 
            revisions=self.revisions,

			




	
	
	
		
 
            owner=self.owner.username,

			




	
	
	
		
 
            title=self.title,

			




	
	
	
		
 
            description=self.description,

			




	
	
	
		
 
            org_repo_url=self.org_repo.clone_url(clone_uri_tmpl=clone_uri_tmpl),

			




	
	
	
		
 
            org_ref_parts=self.org_ref_parts,

			




	
	
	
		
 
            other_ref_parts=self.other_ref_parts,

			




	
	
	
		
 
            status=self.status,

			




	
	
	
		
 
            comments=self.comments,

			




	
	
	
		
 
            statuses=self.statuses,

			




	
	
	
		
 
        )

			




	
	
	
		
 

			




	
	
	
		
 
    def url(self, **kwargs):

			




	
	
	
		
 
        canonical = kwargs.pop('canonical', None)

			




	
	
	
		
 
        import kallithea.lib.helpers as h

			




	
	
	
		
 
        b = self.org_ref_parts[1]

			




	
	
	
		
 
        if b != self.other_ref_parts[1]:

			




	
	
	
		
 
            s = '/_/' + b

			




	
	
	
		
 
        else:

			




	
	
	
		
 
            s = '/_/' + self.title

			




	
	
	
		
 
        kwargs['extra'] = urlreadable(s)

			




	
	
	
		
 
        if canonical:

			




	
	
	
		
 
            return h.canonical_url('pullrequest_show', repo_name=self.other_repo.repo_name,

			




	
	
	
		
 
                                   pull_request_id=self.pull_request_id, **kwargs)

			




	
	
	
		
 
        return h.url('pullrequest_show', repo_name=self.other_repo.repo_name,

			




	
	
	
		
 
                     pull_request_id=self.pull_request_id, **kwargs)

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class PullRequestReviewer(Base, BaseDbModel):

			




	
	
	
		
 
    __tablename__ = 'pull_request_reviewers'

			




	
	
	
		
 
    __table_args__ = (

			




	
	
	
		
 
        Index('pull_request_reviewers_user_id_idx', 'user_id'),

			




	
	
	
		
 
        _table_args_default_dict,

			




	
	
	
		
 
    )

			




	
	
	
		
 

			




	
	
	
		
 
    def __init__(self, user=None, pull_request=None):

			




	
	
	
		
 
        self.user = user

			




	
	
	
		
 
        self.pull_request = pull_request

			




	
	
	
		
 

			




	
	
	
		
 
    pull_request_reviewers_id = Column('pull_requests_reviewers_id', Integer(), primary_key=True)

			




	
	
	
		
 
    pull_request_id = Column(Integer(), ForeignKey('pull_requests.pull_request_id'), nullable=False)

			




	
	
	
		
 
    user_id = Column(Integer(), ForeignKey('users.user_id'), nullable=False)

			




	
	
	
		
 

			




	
	
	
		
 
    user = relationship('User')

			




	
	
	
		
 
    pull_request = relationship('PullRequest')

			




	
	
	
		
 

			




	
	
	
		
 
    def __json__(self):

			




	
	
	
		
 
        return dict(

			




	
	
	
		
 
            username=self.user.username if self.user else None,

			




	
	
	
		
 
        )

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class Notification(object):

			




	
	
	
		
 
    __tablename__ = 'notifications'

			




	
	
	
		
 

			




	
	
	
		
 
class UserNotification(object):

			




	
	
	
		
 
    __tablename__ = 'user_to_notification'

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class Gist(Base, BaseDbModel):

			




	
	
	
		
 
    __tablename__ = 'gists'

			




	
	
	
		
 
    __table_args__ = (

			




	
	
	
		
 
        Index('g_gist_access_id_idx', 'gist_access_id'),

			




	
	
	
		
 
        Index('g_created_on_idx', 'created_on'),

			




	
	
	
		
 
        _table_args_default_dict,

			




	
	
	
		
 
    )

			




	
	
	
		
 

			




	
	
	
		
 
    GIST_PUBLIC = 'public'

			




	
	
	
		
 
    GIST_PRIVATE = 'private'

			




	
	
	
		
 
    DEFAULT_FILENAME = 'gistfile1.txt'

			




	
	
	
		
 

			




	
	
	
		
 
    gist_id = Column(Integer(), primary_key=True)

			




	
	
	
		
 
    gist_access_id = Column(Unicode(250), nullable=False)

			




	
	
	
		
 
    gist_description = Column(UnicodeText(), nullable=False)

			




	
	
	
		
 
    owner_id = Column('user_id', Integer(), ForeignKey('users.user_id'), nullable=False)

			




	
	
	
		
 
    gist_expires = Column(Float(53), nullable=False)

			




	
	
	
		
 
    gist_type = Column(Unicode(128), nullable=False)

			




	
	
	
		
 
    created_on = Column(DateTime(timezone=False), nullable=False, default=datetime.datetime.now)

			




	
	
	
		
 
    modified_at = Column(DateTime(timezone=False), nullable=False, default=datetime.datetime.now)

			




	
	
	
		
 

			




	
	
	
		
 
    owner = relationship('User')

			




	
	
	
		
 

			




	
	
	
		
 
    @hybrid_property

			




	
	
	
		
 
    def is_expired(self):

			




	
	
	
		
 
        return (self.gist_expires != -1) & (time.time() > self.gist_expires)

			




	
	
	
		
 

			




	
	
	
		
 
    def __repr__(self):

			




	
	
	
		
 
        return "<%s %s %s>" % (

			




	
	
	
		
 
            self.__class__.__name__,

			




	
	
	
		
 
            self.gist_type, self.gist_access_id)

			




	
	
	
		
 

			




	
	
	
		
 
    @classmethod

			




	
	
	
		
 
    def guess_instance(cls, value):

			




	
	
	
		
 
        return super(Gist, cls).guess_instance(value, Gist.get_by_access_id)

			




	
	
	
		
 

			




	
	
	
		
 
    @classmethod

			




	
	
	
		
 
    def get_or_404(cls, id_):

			




	
	
	
		
 
        res = cls.query().filter(cls.gist_access_id == id_).scalar()

			




	
	
	
		
 
        if res is None:

			




	
	
	
		
 
            raise HTTPNotFound

			




	
	
	
		
 
        return res

			




	
	
	
		
 

			




	
	
	
		
 
    @classmethod

			




	
	
	
		
 
    def get_by_access_id(cls, gist_access_id):

			




	
	
	
		
 
        return cls.query().filter(cls.gist_access_id == gist_access_id).scalar()

			




	
	
	
		
 

			




	
	
	
		
 
    def gist_url(self):

			




	
	
	
		
 
        alias_url = kallithea.CONFIG.get('gist_alias_url')

			




	
	
	
		
 
        if alias_url:

			




	
	
	
		
 
            return alias_url.replace('{gistid}', self.gist_access_id)

			




	
	
	
		
 

			




	
	
	
		
 
        import kallithea.lib.helpers as h

			




	
	
	
		
 
        return h.canonical_url('gist', gist_id=self.gist_access_id)

			




	
	
	
		
 

			




	
	
	
		
 
    def get_api_data(self):

			




	
	
	
		
 
        """

			




	
	
	
		
 
        Common function for generating gist related data for API

			




	
	
	
		
 
        """

			




	
	
	
		
 
        gist = self

			




	
	
	
		
 
        data = dict(

			




	
	
	
		
 
            gist_id=gist.gist_id,

			




	
	
	
		
 
            type=gist.gist_type,

			




	
	
	
		
 
            access_id=gist.gist_access_id,

			




	
	
	
		
 
            description=gist.gist_description,

			




	
	
	
		
 
            url=gist.gist_url(),

			




	
	
	
		
 
            expires=gist.gist_expires,

			




	
	
	
		
 
            created_on=gist.created_on,

			




	
	
	
		
 
        )

			




	
	
	
		
 
        return data

			




	
	
	
		
 

			




	
	
	
		
 
    def __json__(self):

			




	
	
	
		
 
        data = dict(

			




	
	
	
		
 
        )

			




	
	
	
		
 
        data.update(self.get_api_data())

			




	
	
	
		
 
        return data

			




	
	
	
		
 

			




	
	
	
		
 
    ## SCM functions

			




	
	
	
		
 

			




	
	
	
		
 
    @property

			




	
	
	
		
 
    def scm_instance(self):

			




	
	
	
		
 
        from kallithea.lib.vcs import get_repo

			




	
	
	
		
 
        from kallithea.model.gist import GIST_STORE_LOC

			




	
	
	
		
 
        gist_base_path = os.path.join(kallithea.CONFIG['base_path'], GIST_STORE_LOC)

			




	
	
	
		
 
        return get_repo(os.path.join(gist_base_path, self.gist_access_id))

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class UserSshKeys(Base, BaseDbModel):

			




	
	
	
		
 
    __tablename__ = 'user_ssh_keys'

			




	
	
	
		
 
    __table_args__ = (

			




	
	
	
		
 
        Index('usk_fingerprint_idx', 'fingerprint'),

			




	
	
	
		
 
        UniqueConstraint('fingerprint'),

			




	
	
	
		
 
        _table_args_default_dict

			




	
	
	
		
 
    )

			




	
	
	
		
 
    __mapper_args__ = {}

			




	
	
	
		
 

			




	
	
	
		
 
    user_ssh_key_id = Column(Integer(), primary_key=True)

			




	
	
	
		
 
    user_id = Column(Integer(), ForeignKey('users.user_id'), nullable=False)

			




	
	
	
		
 
    _public_key = Column('public_key', UnicodeText(), nullable=False)

			




	
	
	
		
 
    description = Column(UnicodeText(), nullable=False)

			




	
	
	
		
 
    fingerprint = Column(String(255), nullable=False, unique=True)

			




	
	
	
		
 
    created_on = Column(DateTime(timezone=False), nullable=False, default=datetime.datetime.now)

			




	
	
	
		
 
    last_seen = Column(DateTime(timezone=False), nullable=True)

			




	
	
	
		
 

			




	
	
	
		
 
    user = relationship('User')

			




	
	
	
		
 

			




	
	
	
		
 
    @property

			




	
	
	
		
 
    def public_key(self):

			




	
	
	
		
 
        return self._public_key

			




	
	
	
		
 

			




	
	
	
		
 
    @public_key.setter

			




	
	
	
		
 
    def public_key(self, full_key):

			




	
	
	
		
 
        # the full public key is too long to be suitable as database key - instead,

			




	
	
	
		
 
        # use fingerprints similar to 'ssh-keygen -E sha256 -lf ~/.ssh/id_rsa.pub'

			




	
	
	
		
 
        self._public_key = full_key

			




	
	
	
		
 
        enc_key = safe_bytes(full_key.split(" ")[1])

			




	
	
	
		
 
        self.fingerprint = base64.b64encode(hashlib.sha256(base64.b64decode(enc_key)).digest()).replace(b'\n', b'').rstrip(b'=').decode()

			




        

    


    
    

    

        

                

                    kallithea/templates/admin/gists/edit.html
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



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

			




	
	
	
		
 
<%inherit file="/base/base.html"/>

			




	
	
	
		
 

			




	
	
	
		
 
<%block name="title">

			




	
	
	
		
 
    ${_('Edit Gist')} &middot; ${c.gist.gist_access_id}

			




	
	
	
		
 
</%block>

			




	
	
	
		
 

			




	
	
	
		
 
<%block name="js_extra">

			




	
	
	
		
 
  <script src="${h.url('/codemirror/lib/codemirror.js')}"></script>

			




	
	
	
		
 
  <script src="${h.url('/js/codemirror_loadmode.js')}"></script>

			




	
	
	
		
 
  <script src="${h.url('/codemirror/mode/meta.js')}"></script>

			




	
	
	
		
 
</%block>

			




	
	
	
		
 
<%block name="css_extra">

			




	
	
	
		
 
  <link rel="stylesheet" type="text/css" href="${h.url('/codemirror/lib/codemirror.css')}"/>

			




	
	
	
		
 
</%block>

			




	
	
	
		
 

			




	
	
	
		
 
<%def name="breadcrumbs_links()">

			




	
	
	
		
 
    ${_('Edit Gist')} &middot; ${c.gist.gist_access_id}

			




	
	
	
		
 
</%def>

			




	
	
	
		
 

			




	
	
	
		
 
<%block name="header_menu">

			




	
	
	
		
 
    ${self.menu('gists')}

			




	
	
	
		
 
</%block>

			




	
	
	
		
 

			




	
	
	
		
 
<%def name="main()">

			




	
	
	
		
 
<div class="panel panel-primary">

			




	
	
	
		
 
    <div class="panel-heading clearfix">

			




	
	
	
		
 
        ${self.breadcrumbs()}

			




	
	
	
		
 
    </div>

			




	
	
	
		
 

			




	
	
	
		
 
    <div class="panel-body">

			




	
	
	
		
 
        <div id="edit_error" style="display: none" class="flash_msg">

			




	
	
	
		
 
            <div class="alert alert-dismissable alert-warning">

			




	
	
	
		
 
              <button type="button" class="close" data-dismiss="alert" aria-hidden="true"><i class="icon-cancel-circled"></i></button>

			




	
	
	
		
 
              ${(h.HTML(_('Gist was updated since you started editing. Copy your changes and click %(here)s to reload new version.'))

			




	
	
	
		
 
                             % {'here': h.link_to(_('here'),h.url('edit_gist', gist_id=c.gist.gist_access_id))})}

			




	
	
	
		
 
            </div>

			




	
	
	
		
 
            <script>'use strict';

			




	
	
	
		
 
            if (typeof jQuery != 'undefined') {

			




	
	
	
		
 
                $(".alert").alert();

			




	
	
	
		
 
            }

			




	
	
	
		
 
            </script>

			




	
	
	
		
 
        </div>

			




	
	
	
		
 

			




	
	
	
		
 
        <div id="files_data">

			




	
	
	
		
 
          ${h.form(h.url('edit_gist', gist_id=c.gist.gist_access_id), method='post', id='eform')}

			




	
	
	
		
 
            <div>

			




	
	
	
		
 
                <input type="hidden" value="${c.file_changeset.raw_id}" name="parent_hash">

			




	
	
	
		
 
                <textarea class="form-control"

			




	
	
	
		
 
                          id="description" name="description"

			




	
	
	
		
 
                          placeholder="${_('Gist description ...')}">${c.gist.gist_description}</textarea>

			




	
	
	
		
 
                <div>

			




	
	
	
		
 
                    <label>

			




	
	
	
		
 
                        ${_('Gist lifetime')}

			




	
	
	
		
 
                        ${h.select('lifetime', '0', c.lifetime_options)}

			




	
	
	
		
 
                    </label>

			




	
	
	
		
 
                    <span class="text-muted">

			




	
	
	
		
 
                     %if c.gist.gist_expires == -1:

			




	
	
	
		
 
                      ${_('Expires')}: ${_('Never')}

			




	
	
	
		
 
                     %else:

			




	
	
	
		
 
                      ${_('Expires')}: ${h.age(h.time_to_datetime(c.gist.gist_expires))}

			




	
	
	
		
 
                     %endif

			




	
	
	
		
 
                   </span>

			




	
	
	
		
 
                </div>

			




	
	
	
		
 
            </div>

			




	
	
	
		
 

			




	
	
	
		
 
            % for cnt, file in enumerate(c.files):

			




	
	
	
		
 
                <div id="body" class="panel panel-default form-inline">

			




	
	
	
		
 
                    <div class="panel-heading">

			




	
	
	
		
 
                        <input type="hidden" value="${file.path}" name="org_files">

			




	
	
	
		
 
                        <input class="form-control" id="filename_${h.FID('f',file.path)}" name="files" size="30" type="text" value="${file.path}">

			




	
	
	
		
 
                        <select class="form-control" id="mimetype_${h.FID('f',file.path)}" name="mimetypes"></select>

			




	
	
	
		
 
                    </div>

			




	
	
	
		
 
                    <div class="panel-body no-padding">

			




	
	
	
		
 
                        <div id="editor_container">

			




	
	
	
		
 
                            <textarea id="editor_${h.FID('f',file.path)}" name="contents" style="display:none">${safe_str(file.content)}</textarea>

			




	
	
	
		
 
                            <textarea id="editor_${h.FID('f',file.path)}" name="contents" style="display:none">${h.safe_str(file.content)}</textarea>

			




	
	
	
		
 
                        </div>

			




	
	
	
		
 
                    </div>

			




	
	
	
		
 
                </div>

			




	
	
	
		
 

			




	
	
	
		
 
                ## dynamic edit box.

			




	
	
	
		
 
                <script>'use strict';

			




	
	
	
		
 
                    $(document).ready(function(){

			




	
	
	
		
 
                        var myCodeMirror = initCodeMirror(${h.js('editor_' + h.FID('f',file.path))}, ${h.jshtml(request.script_name)}, '');

			




	
	
	
		
 

			




	
	
	
		
 
                        //inject new modes

			




	
	
	
		
 
                        var $mimetype_select = $(${h.js('#mimetype_' + h.FID('f',file.path))});

			




	
	
	
		
 
                        $mimetype_select.each(function(){

			




	
	
	
		
 
                            var modes_select = this;

			




	
	
	
		
 
                            var index = 1;

			




	
	
	
		
 
                            for(var i=0;i<CodeMirror.modeInfo.length;i++) {

			




	
	
	
		
 
                                var m = CodeMirror.modeInfo[i];

			




	
	
	
		
 
                                var opt = new Option(m.name, m.mime);

			




	
	
	
		
 
                                $(opt).attr('mode', m.mode);

			




	
	
	
		
 
                                if (m.mime == 'text/plain') {

			




	
	
	
		
 
                                    // default plain text

			




	
	
	
		
 
                                    $(opt).prop('selected', true);

			




	
	
	
		
 
                                    modes_select.options[0] = opt;

			




	
	
	
		
 
                                } else {

			




	
	
	
		
 
                                    modes_select.options[index++] = opt;

			




	
	
	
		
 
                                }

			




	
	
	
		
 
                            }

			




	
	
	
		
 
                        });

			




	
	
	
		
 

			




	
	
	
		
 
                        var $filename_input = $(${h.js('#filename_' + h.FID('f',file.path))});

			




	
	
	
		
 
                        // on select change set new mode

			




	
	
	
		
 
                        $mimetype_select.change(function(e){

			




	
	
	
		
 
                            var selected = e.currentTarget;

			




	
	
	
		
 
                            var node = selected.options[selected.selectedIndex];

			




	
	
	
		
 
                            var detected_mode = CodeMirror.findModeByMIME(node.value);

			




	
	
	
		
 
                            setCodeMirrorMode(myCodeMirror, detected_mode);

			




	
	
	
		
 

			




	
	
	
		
 
                            var proposed_ext = CodeMirror.findExtensionByMode(detected_mode);

			




	
	
	
		
 
                            var file_data = CodeMirror.getFilenameAndExt($filename_input.val());

			




	
	
	
		
 
                            var filename = file_data['filename'] || 'filename1';

			




	
	
	
		
 
                            $filename_input.val(filename + '.' + proposed_ext);

			




	
	
	
		
 
                        });

			




	
	
	
		
 

			




	
	
	
		
 
                        // on type the new filename set mode

			




	
	
	
		
 
                        $filename_input.keyup(function(){

			




	
	
	
		
 
                            var file_data = CodeMirror.getFilenameAndExt(this.value);

			




	
	
	
		
 
                            if(file_data['ext'] != null){

			




	
	
	
		
 
                                var detected_mode = CodeMirror.findModeByExtension(file_data['ext']) || CodeMirror.findModeByMIME('text/plain');

			




	
	
	
		
 

			




	
	
	
		
 
                                if (detected_mode){

			




	
	
	
		
 
                                    setCodeMirrorMode(myCodeMirror, detected_mode);

			




	
	
	
		
 
                                    $mimetype_select.val(detected_mode.mime);

			




	
	
	
		
 
                                }

			




	
	
	
		
 
                            }

			




	
	
	
		
 
                        });

			




	
	
	
		
 

			




	
	
	
		
 
                        // set mode on page load

			




	
	
	
		
 
                        var detected_mode = CodeMirror.findModeByExtension(${h.js(file.extension)});

			




	
	
	
		
 

			




	
	
	
		
 
                        if (detected_mode){

			




	
	
	
		
 
                            setCodeMirrorMode(myCodeMirror, detected_mode);

			




	
	
	
		
 
                            $mimetype_select.val(detected_mode.mime);

			




	
	
	
		
 
                        }

			




	
	
	
		
 
                    });

			




	
	
	
		
 
                </script>

			




	
	
	
		
 

			




	
	
	
		
 
            %endfor

			




	
	
	
		
 

			




	
	
	
		
 
            <div>

			




	
	
	
		
 
            ${h.submit('update',_('Update Gist'),class_="btn btn-success")}

			




	
	
	
		
 
            <a class="btn btn-default" href="${h.url('gist', gist_id=c.gist.gist_access_id)}">${_('Cancel')}</a>

			




	
	
	
		
 
            </div>

			




	
	
	
		
 
          ${h.end_form()}

			




	
	
	
		
 
          <script>'use strict';

			




	
	
	
		
 
              $('#update').on('click', function(e){

			




	
	
	
		
 
                  e.preventDefault();

			




	
	
	
		
 

			




	
	
	
		
 
                  // check for newer version.

			




	
	
	
		
 
                  $.ajax({

			




	
	
	
		
 
                    url: ${h.js(h.url('edit_gist_check_revision', gist_id=c.gist.gist_access_id))},

			




	
	
	
		
 
                    data: {'revision': ${h.js(c.file_changeset.raw_id)}, '_session_csrf_secret_token': _session_csrf_secret_token},

			




	
	
	
		
 
                    dataType: 'json',

			




	
	
	
		
 
                    type: 'POST',

			




	
	
	
		
 
                    success: function(data) {

			




	
	
	
		
 
                      if(data.success == false){

			




	
	
	
		
 
                          $('#edit_error').show();

			




	
	
	
		
 
                      }

			




	
	
	
		
 
                      else{

			




	
	
	
		
 
                        $('#eform').submit();

			




	
	
	
		
 
                      }

			




	
	
	
		
 
                    }

			




	
	
	
		
 
                  });

			




	
	
	
		
 
              });

			




	
	
	
		
 
          </script>

			




	
	
	
		
 
        </div>

			




	
	
	
		
 
    </div>

			




	
	
	
		
 

			




	
	
	
		
 
</div>

			




	
	
	
		
 
</%def>

			




        

    


    
    

    

        

                

                    kallithea/templates/compare/compare_diff.html
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



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

			




	
	
	
		
 
<%inherit file="/base/base.html"/>

			




	
	
	
		
 

			




	
	
	
		
 
<%block name="title">

			




	
	
	
		
 
    %if c.compare_home:

			




	
	
	
		
 
        ${_('%s Compare') % c.repo_name}

			




	
	
	
		
 
    %else:

			




	
	
	
		
 
        ${_('%s Compare') % c.repo_name} - ${'%s@%s' % (c.a_repo.repo_name, c.a_ref_name)} &gt; ${'%s@%s' % (c.cs_repo.repo_name, c.cs_ref_name)}

			




	
	
	
		
 
    %endif

			




	
	
	
		
 
</%block>

			




	
	
	
		
 

			




	
	
	
		
 
<%def name="breadcrumbs_links()">

			




	
	
	
		
 
  ${_('Compare Revisions')}

			




	
	
	
		
 
</%def>

			




	
	
	
		
 

			




	
	
	
		
 
<%block name="header_menu">

			




	
	
	
		
 
    ${self.menu('repositories')}

			




	
	
	
		
 
</%block>

			




	
	
	
		
 

			




	
	
	
		
 
<%def name="main()">

			




	
	
	
		
 
${self.repo_context_bar('changelog')}

			




	
	
	
		
 
<div class="panel panel-primary">

			




	
	
	
		
 
    <div class="panel-heading clearfix">

			




	
	
	
		
 
        ${self.breadcrumbs()}

			




	
	
	
		
 
    </div>

			




	
	
	
		
 
    <div class="panel-body">

			




	
	
	
		
 
      <div class="panel panel-default">

			




	
	
	
		
 
        <div id="body" class="panel-heading">

			




	
	
	
		
 
            <div class="compare-revision-selector">

			




	
	
	
		
 
                ## divs are "inline-block" and cannot have whitespace between them.

			




	
	
	
		
 
                <span>

			




	
	
	
		
 
                    ${h.hidden('compare_org')}

			




	
	
	
		
 
                </span><span>

			




	
	
	
		
 
                    <i class="icon-right"></i>

			




	
	
	
		
 
                </span><span>

			




	
	
	
		
 
                    ${h.hidden('compare_other')}

			




	
	
	
		
 
                </span><span>

			




	
	
	
		
 
                    %if not c.compare_home:

			




	
	
	
		
 
                        <a class="btn btn-default btn-sm" href="${c.swap_url}"><i class="icon-arrows-cw"></i>${_('Swap')}</a>

			




	
	
	
		
 
                    %endif

			




	
	
	
		
 
                    <button type="button" id="compare_revs" class="btn btn-default btn-sm"><i class="icon-git-compare"></i>${_('Compare Revisions')}</button>

			




	
	
	
		
 
                </span>

			




	
	
	
		
 
            </div>

			




	
	
	
		
 
        </div>

			




	
	
	
		
 

			




	
	
	
		
 
    %if c.compare_home:

			




	
	
	
		
 
        <div id="changeset_compare_view_content" class="panel-body">

			




	
	
	
		
 
         <h4 class="text-muted">${_('Compare revisions, branches, bookmarks, or tags.')}</h4>

			




	
	
	
		
 
        </div>

			




	
	
	
		
 
    %else:

			




	
	
	
		
 
        <div id="changeset_compare_view_content" class="panel-body">

			




	
	
	
		
 
                ##CS

			




	
	
	
		
 
                <h5>${ungettext('Showing %s commit','Showing %s commits', len(c.cs_ranges)) % len(c.cs_ranges)}</h5>

			




	
	
	
		
 
                <%include file="compare_cs.html" />

			




	
	
	
		
 

			




	
	
	
		
 
                ## FILES

			




	
	
	
		
 
                <h5>

			




	
	
	
		
 
                % if c.limited_diff:

			




	
	
	
		
 
                    ${ungettext('%s file changed', '%s files changed', len(c.file_diff_data)) % len(c.file_diff_data)}:

			




	
	
	
		
 
                % else:

			




	
	
	
		
 
                    ${ungettext('%s file changed with %s insertions and %s deletions','%s files changed with %s insertions and %s deletions', len(c.file_diff_data)) % (len(c.file_diff_data),c.lines_added,c.lines_deleted)}:

			




	
	
	
		
 
                %endif

			




	
	
	
		
 

			




	
	
	
		
 
                ${c.ignorews_url(request.GET)}

			




	
	
	
		
 
                ${c.context_url(request.GET)}

			




	
	
	
		
 
                </h5>

			




	
	
	
		
 
                <div class="cs_files">

			




	
	
	
		
 
                  %if not c.file_diff_data:

			




	
	
	
		
 
                     <span class="text-muted">${_('No files')}</span>

			




	
	
	
		
 
                  %endif

			




	
	
	
		
 
                  %for fid, url_fid, op, a_path, path, diff, stats in c.file_diff_data:

			




	
	
	
		
 
                    <div class="cs_${op} clearfix">

			




	
	
	
		
 
                      <span class="node">

			




	
	
	
		
 
                          <i class="icon-diff-${op}"></i>

			




	
	
	
		
 
                          ${h.link_to(path, '#%s' % fid)}

			




	
	
	
		
 
                      </span>

			




	
	
	
		
 
                      <div class="changes">${h.fancy_file_stats(stats)}</div>

			




	
	
	
		
 
                    </div>

			




	
	
	
		
 
                  %endfor

			




	
	
	
		
 
                  %if c.limited_diff:

			




	
	
	
		
 
                    <h5>${_('Changeset was too big and was cut off...')} <a href="${h.url.current(fulldiff=1, **request.GET.mixed())}">${_('Show full diff anyway')}</a></h5>

			




	
	
	
		
 
                  %endif

			




	
	
	
		
 
                </div>

			




	
	
	
		
 
        </div>

			




	
	
	
		
 
    %endif

			




	
	
	
		
 
      </div>

			




	
	
	
		
 
    %endif

			




	
	
	
		
 

			




	
	
	
		
 
    %if not c.compare_home:

			




	
	
	
		
 
        ## diff block

			




	
	
	
		
 
        <%namespace name="diff_block" file="/changeset/diff_block.html"/>

			




	
	
	
		
 
        ${diff_block.diff_block_js()}

			




	
	
	
		
 
        ${diff_block.diff_block(c.a_repo.repo_name, c.a_ref_type, c.a_ref_name, c.a_rev,

			




	
	
	
		
 
                                c.cs_repo.repo_name, c.cs_ref_type, c.cs_ref_name, c.cs_rev, c.file_diff_data)}

			




	
	
	
		
 
        % if c.limited_diff:

			




	
	
	
		
 
          <h4>${_('Changeset was too big and was cut off...')} <a href="${h.url.current(fulldiff=1, **request.GET.mixed())}">${_('Show full diff')}</a></h4>

			




	
	
	
		
 
        % endif

			




	
	
	
		
 
    %endif

			




	
	
	
		
 
    </div>

			




	
	
	
		
 

			




	
	
	
		
 
</div>

			




	
	
	
		
 
    <script>'use strict';

			




	
	
	
		
 

			




	
	
	
		
 
   $(document).ready(function(){

			




	
	
	
		
 
    var cache = {};

			




	
	
	
		
 

			




	
	
	
		
 
    function make_revision_dropdown(css_selector, repo_name, ref_name, cache_key) {

			




	
	
	
		
 
      $(css_selector).select2({

			




	
	
	
		
 
        placeholder: '{0}@{1}'.format(repo_name, ref_name || ${h.jshtml(_('Select changeset'))}),

			




	
	
	
		
 
        formatSelection: function(obj){

			




	
	
	
		
 
            return '{0}@{1}'.format(repo_name, obj.text).html_escape();

			




	
	
	
		
 
        },

			




	
	
	
		
 
        dropdownAutoWidth: true,

			




	
	
	
		
 
        maxResults: 50,

			




	
	
	
		
 
        query: function(query){

			




	
	
	
		
 
          var key = cache_key;

			




	
	
	
		
 
          var cached = cache[key] ;

			




	
	
	
		
 
          if(cached) {

			




	
	
	
		
 
            var data = {results: []};

			




	
	
	
		
 
            var queryLower = query.term.toLowerCase();

			




	
	
	
		
 
            //filter results

			




	
	
	
		
 
            $.each(cached.results, function(){

			




	
	
	
		
 
                var section = this.text;

			




	
	
	
		
 
                var children = [];

			




	
	
	
		
 
                $.each(this.children, function(){

			




	
	
	
		
 
                    if(children.length < 50 ?

			




	
	
	
		
 
                       ((queryLower.length == 0) || (this.text.toLowerCase().indexOf(queryLower) >= 0)) :

			




	
	
	
		
 
                       ((queryLower.length != 0) && (this.text.toLowerCase().indexOf(queryLower) == 0))) {

			




	
	
	
		
 
                        children.push(this);

			




	
	
	
		
 
                    }

			




	
	
	
		
 
                });

			




	
	
	
		
 
                children = branchSort(children, undefined, query)

			




	
	
	
		
 
                data.results.push({'text': section, 'children': children});

			




	
	
	
		
 
            });

			




	
	
	
		
 
            //push the typed in changeset

			




	
	
	
		
 
            data.results.push({'text':_TM['Specify changeset'],

			




	
	
	
		
 
                               'children': [{'id': query.term, 'text': query.term, 'type': 'rev'}]});

			




	
	
	
		
 
            query.callback(data);

			




	
	
	
		
 
          }else{

			




	
	
	
		
 
              $.ajax({

			




	
	
	
		
 
                url: pyroutes.url('repo_refs_data', {'repo_name': repo_name}),

			




	
	
	
		
 
                data: {},

			




	
	
	
		
 
                dataType: 'json',

			




	
	
	
		
 
                type: 'GET',

			




	
	
	
		
 
                success: function(data) {

			




	
	
	
		
 
                  cache[key] = data;

			




	
	
	
		
 
                  query.callback(data);

			




	
	
	
		
 
                }

			




	
	
	
		
 
              });

			




	
	
	
		
 
          }

			




	
	
	
		
 
        }

			




	
	
	
		
 
    });

			




	
	
	
		
 
    }

			




	
	
	
		
 

			




	
	
	
		
 
    make_revision_dropdown("#compare_org",   ${h.js(c.a_repo.repo_name)},  ${h.js(c.a_ref_name)},  'cache');

			




	
	
	
		
 
    make_revision_dropdown("#compare_other", ${h.js(c.cs_repo.repo_name)}, ${h.js(c.cs_ref_name)}, 'cache2');

			




	
	
	
		
 

			




	
	
	
		
 
    function values_changed() {

			




	
	
	
		
 
        var values = $('#compare_org').select2('data') && $('#compare_other').select2('data');

			




	
	
	
		
 
        if (values) {

			




	
	
	
		
 
             $('#compare_revs').removeClass("disabled");

			




	
	
	
		
 
             // TODO: the swap button ... if any

			




	
	
	
		
 
        } else {

			




	
	
	
		
 
             $('#compare_revs').addClass("disabled");

			




	
	
	
		
 
             // TODO: the swap button ... if any

			




	
	
	
		
 
        }

			




	
	
	
		
 
    }

			




	
	
	
		
 
    values_changed();

			




	
	
	
		
 
    $('#compare_org').change(values_changed);

			




	
	
	
		
 
    $('#compare_other').change(values_changed);

			




	
	
	
		
 
    $('#compare_revs').on('click', function(){

			




	
	
	
		
 
        var org = $('#compare_org').select2('data');

			




	
	
	
		
 
        var other = $('#compare_other').select2('data');

			




	
	
	
		
 
        if (!org || !other) {

			




	
	
	
		
 
            return;

			




	
	
	
		
 
        }

			




	
	
	
		
 

			




	
	
	
		
 
        var compare_url = ${h.js(h.url('compare_url',repo_name=c.repo_name,org_ref_type='__other_ref_type__',org_ref_name='__org__',other_ref_type='__org_ref_type__',other_ref_name='__other__', other_repo=c.cs_repo.repo_name))};

			




	
	
	
		
 
        var u = compare_url.replace('__other_ref_type__',org.type)

			




	
	
	
		
 
                           .replace('__org__',org.text)

			




	
	
	
		
 
                           .replace('__org_ref_type__',other.type)

			




	
	
	
		
 
                           .replace('__other__',other.text);

			




	
	
	
		
 
        window.location = u;

			




	
	
	
		
 
    });

			




	
	
	
		
 
   });

			




	
	
	
		
 
    </script>

			




	
	
	
		
 
</%def>

			




        

    


    
    

    

        

                

                    kallithea/tests/functional/test_admin_gists.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
from kallithea.model.db import Gist, User

			




	
	
	
		
 
from kallithea.model.gist import GistModel

			




	
	
	
		
 
from kallithea.model.meta import Session

			




	
	
	
		
 
from kallithea.tests import base

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
def _create_gist(f_name, content='some gist', lifetime=-1,

			




	
	
	
		
 
                 description='gist-desc', gist_type='public',

			




	
	
	
		
 
                 owner=base.TEST_USER_ADMIN_LOGIN):

			




	
	
	
		
 
    gist_mapping = {

			




	
	
	
		
 
        f_name: {'content': content}

			




	
	
	
		
 
    }

			




	
	
	
		
 
    owner = User.get_by_username(owner)

			




	
	
	
		
 
    gist = GistModel().create(description, owner=owner, ip_addr=base.IP_ADDR,

			




	
	
	
		
 
                       gist_mapping=gist_mapping, gist_type=gist_type,

			




	
	
	
		
 
                       lifetime=lifetime)

			




	
	
	
		
 
    Session().commit()

			




	
	
	
		
 
    return gist

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class TestGistsController(base.TestController):

			




	
	
	
		
 

			




	
	
	
		
 
    def teardown_method(self, method):

			




	
	
	
		
 
        for g in Gist.query():

			




	
	
	
		
 
            GistModel().delete(g)

			




	
	
	
		
 
        Session().commit()

			




	
	
	
		
 

			




	
	
	
		
 
    def test_index(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.get(base.url('gists'))

			




	
	
	
		
 
        # Test response...

			




	
	
	
		
 
        response.mustcontain('There are no gists yet')

			




	
	
	
		
 

			




	
	
	
		
 
        g1 = _create_gist('gist1').gist_access_id

			




	
	
	
		
 
        g2 = _create_gist('gist2', lifetime=1400).gist_access_id

			




	
	
	
		
 
        g3 = _create_gist('gist3', description='gist3-desc').gist_access_id

			




	
	
	
		
 
        g4 = _create_gist('gist4', gist_type='private').gist_access_id

			




	
	
	
		
 
        response = self.app.get(base.url('gists'))

			




	
	
	
		
 
        # Test response...

			




	
	
	
		
 
        response.mustcontain('gist: %s' % g1)

			




	
	
	
		
 
        response.mustcontain('gist: %s' % g2)

			




	
	
	
		
 
        response.mustcontain('Expires: in 23 hours')  # we don't care about the end

			




	
	
	
		
 
        response.mustcontain('gist: %s' % g3)

			




	
	
	
		
 
        response.mustcontain('gist3-desc')

			




	
	
	
		
 
        response.mustcontain(no=['gist: %s' % g4])

			




	
	
	
		
 

			




	
	
	
		
 
    def test_index_private_gists(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        gist = _create_gist('gist5', gist_type='private')

			




	
	
	
		
 
        response = self.app.get(base.url('gists', private=1))

			




	
	
	
		
 
        # Test response...

			




	
	
	
		
 

			




	
	
	
		
 
        # and privates

			




	
	
	
		
 
        response.mustcontain('gist: %s' % gist.gist_access_id)

			




	
	
	
		
 

			




	
	
	
		
 
    def test_create_missing_description(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.post(base.url('gists'),

			




	
	
	
		
 
                                 params={'lifetime': -1, '_session_csrf_secret_token': self.session_csrf_secret_token()},

			




	
	
	
		
 
                                 status=200)

			




	
	
	
		
 

			




	
	
	
		
 
        response.mustcontain('Missing value')

			




	
	
	
		
 

			




	
	
	
		
 
    def test_create(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.post(base.url('gists'),

			




	
	
	
		
 
                                 params={'lifetime': -1,

			




	
	
	
		
 
                                         'content': 'gist test',

			




	
	
	
		
 
                                         'filename': 'foo',

			




	
	
	
		
 
                                         'public': 'public',

			




	
	
	
		
 
                                         '_session_csrf_secret_token': self.session_csrf_secret_token()},

			




	
	
	
		
 
                                 status=302)

			




	
	
	
		
 
        response = response.follow()

			




	
	
	
		
 
        response.mustcontain('added file: foo')

			




	
	
	
		
 
        response.mustcontain('gist test')

			




	
	
	
		
 
        response.mustcontain('<div class="label label-success">Public Gist</div>')

			




	
	
	
		
 

			




	
	
	
		
 
    def test_create_with_path_with_dirs(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.post(base.url('gists'),

			




	
	
	
		
 
                                 params={'lifetime': -1,

			




	
	
	
		
 
                                         'content': 'gist test',

			




	
	
	
		
 
                                         'filename': '/home/foo',

			




	
	
	
		
 
                                         'public': 'public',

			




	
	
	
		
 
                                         '_session_csrf_secret_token': self.session_csrf_secret_token()},

			




	
	
	
		
 
                                 status=200)

			




	
	
	
		
 
        response.mustcontain('Filename cannot be inside a directory')

			




	
	
	
		
 

			




	
	
	
		
 
    def test_access_expired_gist(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        gist = _create_gist('never-see-me')

			




	
	
	
		
 
        gist.gist_expires = 0  # 1970

			




	
	
	
		
 
        Session().commit()

			




	
	
	
		
 

			




	
	
	
		
 
        response = self.app.get(base.url('gist', gist_id=gist.gist_access_id), status=404)

			




	
	
	
		
 

			




	
	
	
		
 
    def test_create_private(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.post(base.url('gists'),

			




	
	
	
		
 
                                 params={'lifetime': -1,

			




	
	
	
		
 
                                         'content': 'private gist test',

			




	
	
	
		
 
                                         'filename': 'private-foo',

			




	
	
	
		
 
                                         'private': 'private',

			




	
	
	
		
 
                                         '_session_csrf_secret_token': self.session_csrf_secret_token()},

			




	
	
	
		
 
                                 status=302)

			




	
	
	
		
 
        response = response.follow()

			




	
	
	
		
 
        response.mustcontain('added file: private-foo<')

			




	
	
	
		
 
        response.mustcontain('private gist test')

			




	
	
	
		
 
        response.mustcontain('<div class="label label-warning">Private Gist</div>')

			




	
	
	
		
 

			




	
	
	
		
 
    def test_create_with_description(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.post(base.url('gists'),

			




	
	
	
		
 
                                 params={'lifetime': -1,

			




	
	
	
		
 
                                         'content': 'gist test',

			




	
	
	
		
 
                                         'filename': 'foo-desc',

			




	
	
	
		
 
                                         'description': 'gist-desc',

			




	
	
	
		
 
                                         'public': 'public',

			




	
	
	
		
 
                                         '_session_csrf_secret_token': self.session_csrf_secret_token()},

			




	
	
	
		
 
                                 status=302)

			




	
	
	
		
 
        response = response.follow()

			




	
	
	
		
 
        response.mustcontain('added file: foo-desc')

			




	
	
	
		
 
        response.mustcontain('gist test')

			




	
	
	
		
 
        response.mustcontain('gist-desc')

			




	
	
	
		
 
        response.mustcontain('<div class="label label-success">Public Gist</div>')

			




	
	
	
		
 

			




	
	
	
		
 
    def test_new(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.get(base.url('new_gist'))

			




	
	
	
		
 

			




	
	
	
		
 
    def test_delete(self):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        gist = _create_gist('delete-me')

			




	
	
	
		
 
        response = self.app.post(base.url('gist_delete', gist_id=gist.gist_id),

			




	
	
	
		
 
            params={'_session_csrf_secret_token': self.session_csrf_secret_token()})

			




	
	
	
		
 

			




	
	
	
		
 
    def test_delete_normal_user_his_gist(self):

			




	
	
	
		
 
        self.log_user(base.TEST_USER_REGULAR_LOGIN, base.TEST_USER_REGULAR_PASS)

			




	
	
	
		
 
        gist = _create_gist('delete-me', owner=base.TEST_USER_REGULAR_LOGIN)

			




	
	
	
		
 
        response = self.app.post(base.url('gist_delete', gist_id=gist.gist_id),

			




	
	
	
		
 
            params={'_session_csrf_secret_token': self.session_csrf_secret_token()})

			




	
	
	
		
 

			




	
	
	
		
 
    def test_delete_normal_user_not_his_own_gist(self):

			




	
	
	
		
 
        self.log_user(base.TEST_USER_REGULAR_LOGIN, base.TEST_USER_REGULAR_PASS)

			




	
	
	
		
 
        gist = _create_gist('delete-me')

			




	
	
	
		
 
        response = self.app.post(base.url('gist_delete', gist_id=gist.gist_id), status=403,

			




	
	
	
		
 
            params={'_session_csrf_secret_token': self.session_csrf_secret_token()})

			




	
	
	
		
 

			




	
	
	
		
 
    def test_show(self):

			




	
	
	
		
 
        gist = _create_gist('gist-show-me')

			




	
	
	
		
 
        response = self.app.get(base.url('gist', gist_id=gist.gist_access_id))

			




	
	
	
		
 
        response.mustcontain('added file: gist-show-me<')

			




	
	
	
		
 
        response.mustcontain('%s - created' % base.TEST_USER_ADMIN_LOGIN)

			




	
	
	
		
 
        response.mustcontain('gist-desc')

			




	
	
	
		
 
        response.mustcontain('<div class="label label-success">Public Gist</div>')

			




	
	
	
		
 

			




	
	
	
		
 
    def test_show_as_raw(self):

			




	
	
	
		
 
        gist = _create_gist('gist-show-me', content='GIST CONTENT')

			




	
	
	
		
 
        response = self.app.get(base.url('formatted_gist',

			




	
	
	
		
 
                                    gist_id=gist.gist_access_id, format='raw'))

			




	
	
	
		
 
        assert response.body == b'GIST CONTENT'

			




	
	
	
		
 

			




	
	
	
		
 
    def test_show_as_raw_individual_file(self):

			




	
	
	
		
 
        gist = _create_gist('gist-show-me-raw', content='GIST BODY')

			




	
	
	
		
 
        response = self.app.get(base.url('formatted_gist_file',

			




	
	
	
		
 
                                    gist_id=gist.gist_access_id, format='raw',

			




	
	
	
		
 
                                    revision='tip', f_path='gist-show-me-raw'))

			




	
	
	
		
 
        assert response.body == b'GIST BODY'

			




	
	
	
		
 

			




	
	
	
		
 
    def test_edit(self):

			




	
	
	
		
 
        response = self.app.get(base.url('edit_gist', gist_id=1))

			




	
	
	
		
 
        gist = _create_gist('gist-edit')

			




	
	
	
		
 
        response = self.app.get(base.url('edit_gist', gist_id=gist.gist_access_id), status=302)

			




	
	
	
		
 
        assert 'login' in response.location

			




	
	
	
		
 

			




	
	
	
		
 
        self.log_user(base.TEST_USER_REGULAR_LOGIN, base.TEST_USER_REGULAR_PASS)

			




	
	
	
		
 
        response = self.app.get(base.url('edit_gist', gist_id=gist.gist_access_id))

			




	
	
	
		
 

			




	
	
	
		
 
        # FIXME actually test editing the gist

			




        

    


    
    

    

        

                

                    kallithea/tests/functional/test_feed.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
from kallithea.tests import base

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
class TestFeedController(base.TestController):

			




	
	
	
		
 

			




	
	
	
		
 
    def test_rss(self):

			




	
	
	
		
 
    @base.parametrize('repo', [

			




	
	
	
		
 
        base.HG_REPO,

			




	
	
	
		
 
        base.GIT_REPO,

			




	
	
	
		
 
    ])

			




	
	
	
		
 
    def test_rss(self, repo):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.get(base.url(controller='feed', action='rss',

			




	
	
	
		
 
                                    repo_name=base.HG_REPO))

			




	
	
	
		
 
                                    repo_name=repo))

			




	
	
	
		
 

			




	
	
	
		
 
        assert response.content_type == "application/rss+xml"

			




	
	
	
		
 
        assert """<rss version="2.0">""" in response

			




	
	
	
		
 

			




	
	
	
		
 
    def test_atom(self):

			




	
	
	
		
 
    @base.parametrize('repo', [

			




	
	
	
		
 
        base.HG_REPO,

			




	
	
	
		
 
        base.GIT_REPO,

			




	
	
	
		
 
    ])

			




	
	
	
		
 
    def test_atom(self, repo):

			




	
	
	
		
 
        self.log_user()

			




	
	
	
		
 
        response = self.app.get(base.url(controller='feed', action='atom',

			




	
	
	
		
 
                                    repo_name=base.HG_REPO))

			




	
	
	
		
 
                                    repo_name=repo))

			




	
	
	
		
 

			




	
	
	
		
 
        assert response.content_type == """application/atom+xml"""

			




	
	
	
		
 
        assert """<?xml version="1.0" encoding="utf-8"?>""" in response

			




	
	
	
		
 
        assert """<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-us">""" in response

			




        

    


    
    

    

        

                

                    scripts/generate-ini.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
#!/usr/bin/env python3

			




	
	
	
		
 
"""

			




	
	
	
		
 
Based on kallithea/lib/paster_commands/template.ini.mako, generate development.ini

			




	
	
	
		
 
"""

			




	
	
	
		
 

			




	
	
	
		
 
import re

			




	
	
	
		
 

			




	
	
	
		
 
from kallithea.lib import inifile

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
# files to be generated from the mako template

			




	
	
	
		
 
ini_files = [

			




	
	
	
		
 
    ('development.ini',

			




	
	
	
		
 
        {

			




	
	
	
		
 
            '[server:main]': {

			




	
	
	
		
 
                'host': '0.0.0.0',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[app:main]': {

			




	
	
	
		
 
                'debug': 'true',

			




	
	
	
		
 
                'app_instance_uuid': 'development-not-secret',

			




	
	
	
		
 
                'session.secret': 'development-not-secret',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_root]': {

			




	
	
	
		
 
                'handlers': 'console_color',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_routes]': {

			




	
	
	
		
 
                'level': 'DEBUG',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_beaker]': {

			




	
	
	
		
 
                'level': 'DEBUG',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_templates]': {

			




	
	
	
		
 
                'level': 'INFO',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_kallithea]': {

			




	
	
	
		
 
                'level': 'DEBUG',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_tg]': {

			




	
	
	
		
 
                'level': 'DEBUG',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_gearbox]': {

			




	
	
	
		
 
                'level': 'DEBUG',

			




	
	
	
		
 
            },

			




	
	
	
		
 
            '[logger_whoosh_indexer]': {

			




	
	
	
		
 
                'level': 'DEBUG',

			




	
	
	
		
 
            },

			




	
	
	
		
 
        },

			




	
	
	
		
 
    ),

			




	
	
	
		
 
]

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
def main():

			




	
	
	
		
 
    # make sure all mako lines starting with '#' (the '##' comments) are marked up as <text>

			




	
	
	
		
 
    makofile = inifile.template_file

			




	
	
	
		
 
    print('reading:', makofile)

			




	
	
	
		
 
    mako_org = open(makofile).read()

			




	
	
	
		
 
    mako_no_text_markup = re.sub(r'</?%text>', '', mako_org)

			




	
	
	
		
 
    mako_marked_up = re.sub(r'\n(##.*)', r'\n<%text>\1</%text>', mako_no_text_markup, flags=re.MULTILINE)

			




	
	
	
		
 
    mako_marked_up = re.sub(r'\n##(.*)', r'\n<%text>##</%text>\1', mako_no_text_markup, flags=re.MULTILINE)

			




	
	
	
		
 
    if mako_marked_up != mako_org:

			




	
	
	
		
 
        print('writing:', makofile)

			




	
	
	
		
 
        open(makofile, 'w').write(mako_marked_up)

			




	
	
	
		
 

			




	
	
	
		
 
    lines = re.findall(r'\n(# [^ ].*)', mako_marked_up)

			




	
	
	
		
 
    if lines:

			




	
	
	
		
 
        print('ERROR: the template .ini file convention is to use "## Foo Bar" for text comments and "#foo = bar" for disabled settings')

			




	
	
	
		
 
        for line in lines:

			




	
	
	
		
 
            print(line)

			




	
	
	
		
 
        raise SystemExit(1)

			




	
	
	
		
 

			




	
	
	
		
 
    # create ini files

			




	
	
	
		
 
    for fn, settings in ini_files:

			




	
	
	
		
 
        print('updating:', fn)

			




	
	
	
		
 
        inifile.create(fn, None, settings)

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
if __name__ == '__main__':

			




	
	
	
		
 
    main()

			




        

    


    
    

    

        

                

                    scripts/validate-commits
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
#!/bin/bash

			




	
	
	
		
 
# Validate the specified commits against test suite and other checks.

			




	
	
	
		
 

			




	
	
	
		
 
if [ -n "$VIRTUAL_ENV" ]; then

			




	
	
	
		
 
    echo "Please run this script from outside a virtualenv."

			




	
	
	
		
 
    exit 1

			




	
	
	
		
 
fi

			




	
	
	
		
 

			




	
	
	
		
 
if ! hg update --check -q .; then

			




	
	
	
		
 
    echo "Working dir is not clean, please commit/revert changes first."

			




	
	
	
		
 
    exit 1

			




	
	
	
		
 
fi

			




	
	
	
		
 

			




	
	
	
		
 
revset=$1

			




	
	
	
		
 
if [ -z "$revset" ]; then

			




	
	
	
		
 
    echo "Warning: no revisions specified, checking draft changes up to the current one."

			




	
	
	
		
 
    revset='draft() and ancestors(.)'

			




	
	
	
		
 
fi

			




	
	
	
		
 

			




	
	
	
		
 
venv=$(mktemp -d kallithea-validatecommits-env-XXXXXX)

			




	
	
	
		
 
resultfile=$(mktemp kallithea-validatecommits-result-XXXXXX)

			




	
	
	
		
 
echo > "$resultfile"

			




	
	
	
		
 

			




	
	
	
		
 
cleanup()

			




	
	
	
		
 
{

			




	
	
	
		
 
    rm -rf /tmp/kallithea-test*

			




	
	
	
		
 
    rm -rf "$venv"

			




	
	
	
		
 
}

			




	
	
	
		
 
finish()

			




	
	
	
		
 
{

			




	
	
	
		
 
    cleanup

			




	
	
	
		
 
    # print (possibly intermediate) results

			




	
	
	
		
 
    cat "$resultfile"

			




	
	
	
		
 
    rm "$resultfile"

			




	
	
	
		
 
}

			




	
	
	
		
 
trap finish EXIT

			




	
	
	
		
 

			




	
	
	
		
 
for rev in $(hg log -r "$1" -T '{node}\n'); do

			




	
	
	
		
 
for rev in $(hg log -r "$revset" -T '{node}\n'); do

			




	
	
	
		
 
    hg log -r "$rev"

			




	
	
	
		
 
    hg update "$rev"

			




	
	
	
		
 

			




	
	
	
		
 
    cleanup

			




	
	
	
		
 
    python3 -m venv "$venv"

			




	
	
	
		
 
    source "$venv/bin/activate"

			




	
	
	
		
 
    pip install --upgrade pip setuptools

			




	
	
	
		
 
    pip install -e . -r dev_requirements.txt python-ldap python-pam

			




	
	
	
		
 

			




	
	
	
		
 
    # run-all-cleanup

			




	
	
	
		
 
    if ! scripts/run-all-cleanup ; then

			




	
	
	
		
 
        echo "run-all-cleanup encountered errors!"

			




	
	
	
		
 
        result="NOK"

			




	
	
	
		
 
    else

			




	
	
	
		
 
        if ! hg update --check -q .; then

			




	
	
	
		
 
            echo "run-all-cleanup did not give clean results!"

			




	
	
	
		
 
            result="NOK"

			




	
	
	
		
 
            hg diff

			




	
	
	
		
 
            hg revert -a

			




	
	
	
		
 
        else

			




	
	
	
		
 
            result=" OK"

			




	
	
	
		
 
        fi

			




	
	
	
		
 
    fi

			




	
	
	
		
 
    echo "$result: $rev (run-all-cleanup)" >> "$resultfile"

			




	
	
	
		
 

			




	
	
	
		
 
    # pytest

			




	
	
	
		
 
    if py.test; then

			




	
	
	
		
 
        result=" OK"

			




	
	
	
		
 
    else

			




	
	
	
		
 
        result="NOK"

			




	
	
	
		
 
    fi

			




	
	
	
		
 
    echo "$result: $rev (pytest)" >> "$resultfile"

			




	
	
	
		
 

			




	
	
	
		
 
    deactivate

			




	
	
	
		
 
    echo

			




	
	
	
		
 
done

			




        

    


    
    

    

        

                

                    setup.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
	
		
 
#!/usr/bin/env python3

			




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

			




	
	
	
		
 
import os

			




	
	
	
		
 
import platform

			




	
	
	
		
 
import sys

			




	
	
	
		
 

			




	
	
	
		
 
import setuptools

			




	
	
	
		
 
# monkey patch setuptools to use distutils owner/group functionality

			




	
	
	
		
 
from setuptools.command import sdist

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
if sys.version_info < (3, 6):

			




	
	
	
		
 
    raise Exception('Kallithea requires Python 3.6 or later')

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
here = os.path.abspath(os.path.dirname(__file__))

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
def _get_meta_var(name, data, callback_handler=None):

			




	
	
	
		
 
    import re

			




	
	
	
		
 
    matches = re.compile(r'(?:%s)\s*=\s*(.*)' % name).search(data)

			




	
	
	
		
 
    if matches:

			




	
	
	
		
 
        s = eval(matches.groups()[0])

			




	
	
	
		
 
        if callable(callback_handler):

			




	
	
	
		
 
            return callback_handler(s)

			




	
	
	
		
 
        return s

			




	
	
	
		
 

			




	
	
	
		
 
_meta = open(os.path.join(here, 'kallithea', '__init__.py'), 'r')

			




	
	
	
		
 
_metadata = _meta.read()

			




	
	
	
		
 
_meta.close()

			




	
	
	
		
 

			




	
	
	
		
 
def callback(V):

			




	
	
	
		
 
    return '.'.join(map(str, V[:3])) + '.'.join(V[3:])

			




	
	
	
		
 
__version__ = _get_meta_var('VERSION', _metadata, callback)

			




	
	
	
		
 
__license__ = _get_meta_var('__license__', _metadata)

			




	
	
	
		
 
__author__ = _get_meta_var('__author__', _metadata)

			




	
	
	
		
 
__url__ = _get_meta_var('__url__', _metadata)

			




	
	
	
		
 
# defines current platform

			




	
	
	
		
 
__platform__ = platform.system()

			




	
	
	
		
 

			




	
	
	
		
 
is_windows = __platform__ in ['Windows']

			




	
	
	
		
 

			




	
	
	
		
 
requirements = [

			




	
	
	
		
 
    "alembic >= 1.0.10, < 1.5",

			




	
	
	
		
 
    "gearbox >= 0.1.0, < 1",

			




	
	
	
		
 
    "waitress >= 0.8.8, < 1.5",

			




	
	
	
		
 
    "WebOb >= 1.8, < 1.9",

			




	
	
	
		
 
    "backlash >= 0.1.2, < 1",

			




	
	
	
		
 
    "TurboGears2 >= 2.4, < 2.5",

			




	
	
	
		
 
    "tgext.routes >= 0.2.0, < 1",

			




	
	
	
		
 
    "Beaker >= 1.10.1, < 2",

			




	
	
	
		
 
    "WebHelpers2 >= 2.0, < 2.1",

			




	
	
	
		
 
    "FormEncode >= 1.3.1, < 1.4",

			




	
	
	
		
 
    "SQLAlchemy >= 1.2.9, < 1.4",

			




	
	
	
		
 
    "Mako >= 0.9.1, < 1.2",

			




	
	
	
		
 
    "Pygments >= 2.2.0, < 2.6",

			




	
	
	
		
 
    "Whoosh >= 2.7.1, < 2.8",

			




	
	
	
		
 
    "celery >= 4.3, < 4.5",

			




	
	
	
		
 
    "celery >= 4.3, < 4.5, != 4.4.4", # 4.4.4 is broken due to unexpressed dependency on 'future', see https://github.com/celery/celery/pull/6146

			




	
	
	
		
 
    "Babel >= 1.3, < 2.9",

			




	
	
	
		
 
    "python-dateutil >= 2.1.0, < 2.9",

			




	
	
	
		
 
    "Markdown >= 2.2.1, < 3.2",

			




	
	
	
		
 
    "docutils >= 0.11, < 0.17",

			




	
	
	
		
 
    "URLObject >= 2.3.4, < 2.5",

			




	
	
	
		
 
    "Routes >= 2.0, < 2.5",

			




	
	
	
		
 
    "dulwich >= 0.19.0, < 0.20",

			




	
	
	
		
 
    "mercurial >= 5.2, < 5.5",

			




	
	
	
		
 
    "decorator >= 4.2.1, < 4.5",

			




	
	
	
		
 
    "Paste >= 2.0.3, < 3.4",

			




	
	
	
		
 
    "bleach >= 3.0, < 3.1.4",

			




	
	
	
		
 
    "Click >= 7.0, < 8",

			




	
	
	
		
 
    "ipaddr >= 2.2.0, < 2.3",

			




	
	
	
		
 
    "paginate >= 0.5, < 0.6",

			




	
	
	
		
 
    "paginate_sqlalchemy >= 0.3.0, < 0.4",

			




	
	
	
		
 
    "bcrypt >= 3.1.0, < 3.2",

			




	
	
	
		
 
    "pip >= 20.0, < 999",

			




	
	
	
		
 
]

			




	
	
	
		
 

			




	
	
	
		
 
dependency_links = [

			




	
	
	
		
 
]

			




	
	
	
		
 

			




	
	
	
		
 
classifiers = [

			




	
	
	
		
 
    'Development Status :: 4 - Beta',

			




	
	
	
		
 
    'Environment :: Web Environment',

			




	
	
	
		
 
    'Framework :: Pylons',

			




	
	
	
		
 
    'Intended Audience :: Developers',

			




	
	
	
		
 
    'License :: OSI Approved :: GNU General Public License (GPL)',

			




	
	
	
		
 
    'Operating System :: OS Independent',

			




	
	
	
		
 
    'Programming Language :: Python :: 3.6',

			




	
	
	
		
 
    'Programming Language :: Python :: 3.7',

			




	
	
	
		
 
    'Programming Language :: Python :: 3.8',

			




	
	
	
		
 
    'Topic :: Software Development :: Version Control',

			




	
	
	
		
 
]

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
# additional files from project that goes somewhere in the filesystem

			




	
	
	
		
 
# relative to sys.prefix

			




	
	
	
		
 
data_files = []

			




	
	
	
		
 

			




	
	
	
		
 
description = ('Kallithea is a fast and powerful management tool '

			




	
	
	
		
 
               'for Mercurial and Git with a built in push/pull server, '

			




	
	
	
		
 
               'full text search and code-review.')

			




	
	
	
		
 

			




	
	
	
		
 
keywords = ' '.join([

			




	
	
	
		
 
    'kallithea', 'mercurial', 'git', 'code review',

			




	
	
	
		
 
    'repo groups', 'ldap', 'repository management', 'hgweb replacement',

			




	
	
	
		
 
    'hgwebdir', 'gitweb replacement', 'serving hgweb',

			




	
	
	
		
 
])

			




	
	
	
		
 

			




	
	
	
		
 
# long description

			




	
	
	
		
 
README_FILE = 'README.rst'

			




	
	
	
		
 
try:

			




	
	
	
		
 
    long_description = open(README_FILE).read()

			




	
	
	
		
 
except IOError as err:

			




	
	
	
		
 
    sys.stderr.write(

			




	
	
	
		
 
        "[WARNING] Cannot find file specified as long_description (%s): %s\n"

			




	
	
	
		
 
        % (README_FILE, err)

			




	
	
	
		
 
    )

			




	
	
	
		
 
    long_description = description

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
sdist_org = sdist.sdist

			




	
	
	
		
 
class sdist_new(sdist_org):

			




	
	
	
		
 
    def initialize_options(self):

			




	
	
	
		
 
        sdist_org.initialize_options(self)

			




	
	
	
		
 
        self.owner = self.group = 'root'

			




	
	
	
		
 
sdist.sdist = sdist_new

			




	
	
	
		
 

			




	
	
	
		
 
packages = setuptools.find_packages(exclude=['ez_setup'])

			




	
	
	
		
 

			




	
	
	
		
 
setuptools.setup(

			




	
	
	
		
 
    name='Kallithea',

			




	
	
	
		
 
    version=__version__,

			




	
	
	
		
 
    description=description,

			




	
	
	
		
 
    long_description=long_description,

			




	
	
	
		
 
    keywords=keywords,

			




	
	
	
		
 
    license=__license__,

			




	
	
	
		
 
    author=__author__,

			




	
	
	
		
 
    author_email='kallithea@sfconservancy.org',

			




	
	
	
		
 
    dependency_links=dependency_links,

			




	
	
	
		
 
    url=__url__,

			




	
	
	
		
 
    install_requires=requirements,

			




	
	
	
		
 
    classifiers=classifiers,

			




	
	
	
		
 
    data_files=data_files,

			




	
	
	
		
 
    packages=packages,

			




	
	
	
		
 
    include_package_data=True,

			




	
	
	
		
 
    message_extractors={'kallithea': [

			




	
	
	
		
 
            ('**.py', 'python', None),

			




	
	
	
		
 
            ('templates/**.mako', 'mako', {'input_encoding': 'utf-8'}),

			




	
	
	
		
 
            ('templates/**.html', 'mako', {'input_encoding': 'utf-8'}),

			




	
	
	
		
 
            ('public/**', 'ignore', None)]},

			




	
	
	
		
 
    zip_safe=False,

			




	
	
	
		
 
    entry_points="""

			




	
	
	
		
 
    [console_scripts]

			




	
	
	
		
 
    kallithea-api =    kallithea.bin.kallithea_api:main

			




	
	
	
		
 
    kallithea-gist =   kallithea.bin.kallithea_gist:main

			




	
	
	
		
 
    kallithea-config = kallithea.bin.kallithea_config:main

			




	
	
	
		
 
    kallithea-cli =    kallithea.bin.kallithea_cli:cli

			




	
	
	
		
 

			




	
	
	
		
 
    [paste.app_factory]

			




	
	
	
		
 
    main = kallithea.config.middleware:make_app

			




	
	
	
		
 
    """,

			




	
	
	
		
 
)

			




        

    



    


    



    



      

      





    
    0 comments (0 inline, 0 general)
    





    


  

  







  


    




    








    
        Server instance: clio-32551
    
    
        This site is powered by
            Kallithea 0.7.0,
        which is
        © 2010–2025 by various authors & licensed under GPLv3.
            – Support