##// END OF EJS Templates
hgweb: raw file mimetype guessing configurable, off by default (BC) (issue2923)...
Matt Mackall -
r15004:d06b9c55 stable
parent child Browse files
Show More
@@ -1,1293 +1,1300
1 1 The Mercurial system uses a set of configuration files to control
2 2 aspects of its behavior.
3 3
4 4 The configuration files use a simple ini-file format. A configuration
5 5 file consists of sections, led by a ``[section]`` header and followed
6 6 by ``name = value`` entries::
7 7
8 8 [ui]
9 9 username = Firstname Lastname <firstname.lastname@example.net>
10 10 verbose = True
11 11
12 12 The above entries will be referred to as ``ui.username`` and
13 13 ``ui.verbose``, respectively. See the Syntax section below.
14 14
15 15 Files
16 16 -----
17 17
18 18 Mercurial reads configuration data from several files, if they exist.
19 19 These files do not exist by default and you will have to create the
20 20 appropriate configuration files yourself: global configuration like
21 21 the username setting is typically put into
22 22 ``%USERPROFILE%\mercurial.ini`` or ``$HOME/.hgrc`` and local
23 23 configuration is put into the per-repository ``<repo>/.hg/hgrc`` file.
24 24
25 25 The names of these files depend on the system on which Mercurial is
26 26 installed. ``*.rc`` files from a single directory are read in
27 27 alphabetical order, later ones overriding earlier ones. Where multiple
28 28 paths are given below, settings from earlier paths override later
29 29 ones.
30 30
31 31 | (Unix, Windows) ``<repo>/.hg/hgrc``
32 32
33 33 Per-repository configuration options that only apply in a
34 34 particular repository. This file is not version-controlled, and
35 35 will not get transferred during a "clone" operation. Options in
36 36 this file override options in all other configuration files. On
37 37 Unix, most of this file will be ignored if it doesn't belong to a
38 38 trusted user or to a trusted group. See the documentation for the
39 39 ``[trusted]`` section below for more details.
40 40
41 41 | (Unix) ``$HOME/.hgrc``
42 42 | (Windows) ``%USERPROFILE%\.hgrc``
43 43 | (Windows) ``%USERPROFILE%\Mercurial.ini``
44 44 | (Windows) ``%HOME%\.hgrc``
45 45 | (Windows) ``%HOME%\Mercurial.ini``
46 46
47 47 Per-user configuration file(s), for the user running Mercurial. On
48 48 Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these
49 49 files apply to all Mercurial commands executed by this user in any
50 50 directory. Options in these files override per-system and per-installation
51 51 options.
52 52
53 53 | (Unix) ``/etc/mercurial/hgrc``
54 54 | (Unix) ``/etc/mercurial/hgrc.d/*.rc``
55 55
56 56 Per-system configuration files, for the system on which Mercurial
57 57 is running. Options in these files apply to all Mercurial commands
58 58 executed by any user in any directory. Options in these files
59 59 override per-installation options.
60 60
61 61 | (Unix) ``<install-root>/etc/mercurial/hgrc``
62 62 | (Unix) ``<install-root>/etc/mercurial/hgrc.d/*.rc``
63 63
64 64 Per-installation configuration files, searched for in the
65 65 directory where Mercurial is installed. ``<install-root>`` is the
66 66 parent directory of the **hg** executable (or symlink) being run. For
67 67 example, if installed in ``/shared/tools/bin/hg``, Mercurial will look
68 68 in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply
69 69 to all Mercurial commands executed by any user in any directory.
70 70
71 71 | (Windows) ``<install-dir>\Mercurial.ini`` **or**
72 72 | (Windows) ``<install-dir>\hgrc.d\*.rc`` **or**
73 73 | (Windows) ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial``
74 74
75 75 Per-installation/system configuration files, for the system on
76 76 which Mercurial is running. Options in these files apply to all
77 77 Mercurial commands executed by any user in any directory. Registry
78 78 keys contain PATH-like strings, every part of which must reference
79 79 a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will
80 80 be read. Mercurial checks each of these locations in the specified
81 81 order until one or more configuration files are detected. If the
82 82 pywin32 extensions are not installed, Mercurial will only look for
83 83 site-wide configuration in ``C:\Mercurial\Mercurial.ini``.
84 84
85 85 Syntax
86 86 ------
87 87
88 88 A configuration file consists of sections, led by a ``[section]`` header
89 89 and followed by ``name = value`` entries (sometimes called
90 90 ``configuration keys``)::
91 91
92 92 [spam]
93 93 eggs=ham
94 94 green=
95 95 eggs
96 96
97 97 Each line contains one entry. If the lines that follow are indented,
98 98 they are treated as continuations of that entry. Leading whitespace is
99 99 removed from values. Empty lines are skipped. Lines beginning with
100 100 ``#`` or ``;`` are ignored and may be used to provide comments.
101 101
102 102 Configuration keys can be set multiple times, in which case Mercurial
103 103 will use the value that was configured last. As an example::
104 104
105 105 [spam]
106 106 eggs=large
107 107 ham=serrano
108 108 eggs=small
109 109
110 110 This would set the configuration key named ``eggs`` to ``small``.
111 111
112 112 It is also possible to define a section multiple times. A section can
113 113 be redefined on the same and/or on different configuration files. For
114 114 example::
115 115
116 116 [foo]
117 117 eggs=large
118 118 ham=serrano
119 119 eggs=small
120 120
121 121 [bar]
122 122 eggs=ham
123 123 green=
124 124 eggs
125 125
126 126 [foo]
127 127 ham=prosciutto
128 128 eggs=medium
129 129 bread=toasted
130 130
131 131 This would set the ``eggs``, ``ham``, and ``bread`` configuration keys
132 132 of the ``foo`` section to ``medium``, ``prosciutto``, and ``toasted``,
133 133 respectively. As you can see there only thing that matters is the last
134 134 value that was set for each of the configuration keys.
135 135
136 136 If a configuration key is set multiple times in different
137 137 configuration files the final value will depend on the order in which
138 138 the different configuration files are read, with settings from earlier
139 139 paths overriding later ones as described on the ``Files`` section
140 140 above.
141 141
142 142 A line of the form ``%include file`` will include ``file`` into the
143 143 current configuration file. The inclusion is recursive, which means
144 144 that included files can include other files. Filenames are relative to
145 145 the configuration file in which the ``%include`` directive is found.
146 146 Environment variables and ``~user`` constructs are expanded in
147 147 ``file``. This lets you do something like::
148 148
149 149 %include ~/.hgrc.d/$HOST.rc
150 150
151 151 to include a different configuration file on each computer you use.
152 152
153 153 A line with ``%unset name`` will remove ``name`` from the current
154 154 section, if it has been set previously.
155 155
156 156 The values are either free-form text strings, lists of text strings,
157 157 or Boolean values. Boolean values can be set to true using any of "1",
158 158 "yes", "true", or "on" and to false using "0", "no", "false", or "off"
159 159 (all case insensitive).
160 160
161 161 List values are separated by whitespace or comma, except when values are
162 162 placed in double quotation marks::
163 163
164 164 allow_read = "John Doe, PhD", brian, betty
165 165
166 166 Quotation marks can be escaped by prefixing them with a backslash. Only
167 167 quotation marks at the beginning of a word is counted as a quotation
168 168 (e.g., ``foo"bar baz`` is the list of ``foo"bar`` and ``baz``).
169 169
170 170 Sections
171 171 --------
172 172
173 173 This section describes the different sections that may appear in a
174 174 Mercurial configuration file, the purpose of each section, its possible
175 175 keys, and their possible values.
176 176
177 177 ``alias``
178 178 """""""""
179 179
180 180 Defines command aliases.
181 181 Aliases allow you to define your own commands in terms of other
182 182 commands (or aliases), optionally including arguments. Positional
183 183 arguments in the form of ``$1``, ``$2``, etc in the alias definition
184 184 are expanded by Mercurial before execution. Positional arguments not
185 185 already used by ``$N`` in the definition are put at the end of the
186 186 command to be executed.
187 187
188 188 Alias definitions consist of lines of the form::
189 189
190 190 <alias> = <command> [<argument>]...
191 191
192 192 For example, this definition::
193 193
194 194 latest = log --limit 5
195 195
196 196 creates a new command ``latest`` that shows only the five most recent
197 197 changesets. You can define subsequent aliases using earlier ones::
198 198
199 199 stable5 = latest -b stable
200 200
201 201 .. note:: It is possible to create aliases with the same names as
202 202 existing commands, which will then override the original
203 203 definitions. This is almost always a bad idea!
204 204
205 205 An alias can start with an exclamation point (``!``) to make it a
206 206 shell alias. A shell alias is executed with the shell and will let you
207 207 run arbitrary commands. As an example, ::
208 208
209 209 echo = !echo
210 210
211 211 will let you do ``hg echo foo`` to have ``foo`` printed in your
212 212 terminal. A better example might be::
213 213
214 214 purge = !$HG status --no-status --unknown -0 | xargs -0 rm
215 215
216 216 which will make ``hg purge`` delete all unknown files in the
217 217 repository in the same manner as the purge extension.
218 218
219 219 Shell aliases are executed in an environment where ``$HG`` expand to
220 220 the path of the Mercurial that was used to execute the alias. This is
221 221 useful when you want to call further Mercurial commands in a shell
222 222 alias, as was done above for the purge alias. In addition,
223 223 ``$HG_ARGS`` expand to the arguments given to Mercurial. In the ``hg
224 224 echo foo`` call above, ``$HG_ARGS`` would expand to ``echo foo``.
225 225
226 226 ``auth``
227 227 """"""""
228 228
229 229 Authentication credentials for HTTP authentication. This section
230 230 allows you to store usernames and passwords for use when logging
231 231 *into* HTTP servers. See the ``[web]`` configuration section if
232 232 you want to configure *who* can login to your HTTP server.
233 233
234 234 Each line has the following format::
235 235
236 236 <name>.<argument> = <value>
237 237
238 238 where ``<name>`` is used to group arguments into authentication
239 239 entries. Example::
240 240
241 241 foo.prefix = hg.intevation.org/mercurial
242 242 foo.username = foo
243 243 foo.password = bar
244 244 foo.schemes = http https
245 245
246 246 bar.prefix = secure.example.org
247 247 bar.key = path/to/file.key
248 248 bar.cert = path/to/file.cert
249 249 bar.schemes = https
250 250
251 251 Supported arguments:
252 252
253 253 ``prefix``
254 254 Either ``*`` or a URI prefix with or without the scheme part.
255 255 The authentication entry with the longest matching prefix is used
256 256 (where ``*`` matches everything and counts as a match of length
257 257 1). If the prefix doesn't include a scheme, the match is performed
258 258 against the URI with its scheme stripped as well, and the schemes
259 259 argument, q.v., is then subsequently consulted.
260 260
261 261 ``username``
262 262 Optional. Username to authenticate with. If not given, and the
263 263 remote site requires basic or digest authentication, the user will
264 264 be prompted for it. Environment variables are expanded in the
265 265 username letting you do ``foo.username = $USER``.
266 266
267 267 ``password``
268 268 Optional. Password to authenticate with. If not given, and the
269 269 remote site requires basic or digest authentication, the user
270 270 will be prompted for it.
271 271
272 272 ``key``
273 273 Optional. PEM encoded client certificate key file. Environment
274 274 variables are expanded in the filename.
275 275
276 276 ``cert``
277 277 Optional. PEM encoded client certificate chain file. Environment
278 278 variables are expanded in the filename.
279 279
280 280 ``schemes``
281 281 Optional. Space separated list of URI schemes to use this
282 282 authentication entry with. Only used if the prefix doesn't include
283 283 a scheme. Supported schemes are http and https. They will match
284 284 static-http and static-https respectively, as well.
285 285 Default: https.
286 286
287 287 If no suitable authentication entry is found, the user is prompted
288 288 for credentials as usual if required by the remote.
289 289
290 290
291 291 ``decode/encode``
292 292 """""""""""""""""
293 293
294 294 Filters for transforming files on checkout/checkin. This would
295 295 typically be used for newline processing or other
296 296 localization/canonicalization of files.
297 297
298 298 Filters consist of a filter pattern followed by a filter command.
299 299 Filter patterns are globs by default, rooted at the repository root.
300 300 For example, to match any file ending in ``.txt`` in the root
301 301 directory only, use the pattern ``*.txt``. To match any file ending
302 302 in ``.c`` anywhere in the repository, use the pattern ``**.c``.
303 303 For each file only the first matching filter applies.
304 304
305 305 The filter command can start with a specifier, either ``pipe:`` or
306 306 ``tempfile:``. If no specifier is given, ``pipe:`` is used by default.
307 307
308 308 A ``pipe:`` command must accept data on stdin and return the transformed
309 309 data on stdout.
310 310
311 311 Pipe example::
312 312
313 313 [encode]
314 314 # uncompress gzip files on checkin to improve delta compression
315 315 # note: not necessarily a good idea, just an example
316 316 *.gz = pipe: gunzip
317 317
318 318 [decode]
319 319 # recompress gzip files when writing them to the working dir (we
320 320 # can safely omit "pipe:", because it's the default)
321 321 *.gz = gzip
322 322
323 323 A ``tempfile:`` command is a template. The string ``INFILE`` is replaced
324 324 with the name of a temporary file that contains the data to be
325 325 filtered by the command. The string ``OUTFILE`` is replaced with the name
326 326 of an empty temporary file, where the filtered data must be written by
327 327 the command.
328 328
329 329 .. note:: The tempfile mechanism is recommended for Windows systems,
330 330 where the standard shell I/O redirection operators often have
331 331 strange effects and may corrupt the contents of your files.
332 332
333 333 This filter mechanism is used internally by the ``eol`` extension to
334 334 translate line ending characters between Windows (CRLF) and Unix (LF)
335 335 format. We suggest you use the ``eol`` extension for convenience.
336 336
337 337
338 338 ``defaults``
339 339 """"""""""""
340 340
341 341 (defaults are deprecated. Don't use them. Use aliases instead)
342 342
343 343 Use the ``[defaults]`` section to define command defaults, i.e. the
344 344 default options/arguments to pass to the specified commands.
345 345
346 346 The following example makes :hg:`log` run in verbose mode, and
347 347 :hg:`status` show only the modified files, by default::
348 348
349 349 [defaults]
350 350 log = -v
351 351 status = -m
352 352
353 353 The actual commands, instead of their aliases, must be used when
354 354 defining command defaults. The command defaults will also be applied
355 355 to the aliases of the commands defined.
356 356
357 357
358 358 ``diff``
359 359 """"""""
360 360
361 361 Settings used when displaying diffs. Everything except for ``unified`` is a
362 362 Boolean and defaults to False.
363 363
364 364 ``git``
365 365 Use git extended diff format.
366 366
367 367 ``nodates``
368 368 Don't include dates in diff headers.
369 369
370 370 ``showfunc``
371 371 Show which function each change is in.
372 372
373 373 ``ignorews``
374 374 Ignore white space when comparing lines.
375 375
376 376 ``ignorewsamount``
377 377 Ignore changes in the amount of white space.
378 378
379 379 ``ignoreblanklines``
380 380 Ignore changes whose lines are all blank.
381 381
382 382 ``unified``
383 383 Number of lines of context to show.
384 384
385 385 ``email``
386 386 """""""""
387 387
388 388 Settings for extensions that send email messages.
389 389
390 390 ``from``
391 391 Optional. Email address to use in "From" header and SMTP envelope
392 392 of outgoing messages.
393 393
394 394 ``to``
395 395 Optional. Comma-separated list of recipients' email addresses.
396 396
397 397 ``cc``
398 398 Optional. Comma-separated list of carbon copy recipients'
399 399 email addresses.
400 400
401 401 ``bcc``
402 402 Optional. Comma-separated list of blind carbon copy recipients'
403 403 email addresses.
404 404
405 405 ``method``
406 406 Optional. Method to use to send email messages. If value is ``smtp``
407 407 (default), use SMTP (see the ``[smtp]`` section for configuration).
408 408 Otherwise, use as name of program to run that acts like sendmail
409 409 (takes ``-f`` option for sender, list of recipients on command line,
410 410 message on stdin). Normally, setting this to ``sendmail`` or
411 411 ``/usr/sbin/sendmail`` is enough to use sendmail to send messages.
412 412
413 413 ``charsets``
414 414 Optional. Comma-separated list of character sets considered
415 415 convenient for recipients. Addresses, headers, and parts not
416 416 containing patches of outgoing messages will be encoded in the
417 417 first character set to which conversion from local encoding
418 418 (``$HGENCODING``, ``ui.fallbackencoding``) succeeds. If correct
419 419 conversion fails, the text in question is sent as is. Defaults to
420 420 empty (explicit) list.
421 421
422 422 Order of outgoing email character sets:
423 423
424 424 1. ``us-ascii``: always first, regardless of settings
425 425 2. ``email.charsets``: in order given by user
426 426 3. ``ui.fallbackencoding``: if not in email.charsets
427 427 4. ``$HGENCODING``: if not in email.charsets
428 428 5. ``utf-8``: always last, regardless of settings
429 429
430 430 Email example::
431 431
432 432 [email]
433 433 from = Joseph User <joe.user@example.com>
434 434 method = /usr/sbin/sendmail
435 435 # charsets for western Europeans
436 436 # us-ascii, utf-8 omitted, as they are tried first and last
437 437 charsets = iso-8859-1, iso-8859-15, windows-1252
438 438
439 439
440 440 ``extensions``
441 441 """"""""""""""
442 442
443 443 Mercurial has an extension mechanism for adding new features. To
444 444 enable an extension, create an entry for it in this section.
445 445
446 446 If you know that the extension is already in Python's search path,
447 447 you can give the name of the module, followed by ``=``, with nothing
448 448 after the ``=``.
449 449
450 450 Otherwise, give a name that you choose, followed by ``=``, followed by
451 451 the path to the ``.py`` file (including the file name extension) that
452 452 defines the extension.
453 453
454 454 To explicitly disable an extension that is enabled in an hgrc of
455 455 broader scope, prepend its path with ``!``, as in ``foo = !/ext/path``
456 456 or ``foo = !`` when path is not supplied.
457 457
458 458 Example for ``~/.hgrc``::
459 459
460 460 [extensions]
461 461 # (the mq extension will get loaded from Mercurial's path)
462 462 mq =
463 463 # (this extension will get loaded from the file specified)
464 464 myfeature = ~/.hgext/myfeature.py
465 465
466 466
467 467 ``hostfingerprints``
468 468 """"""""""""""""""""
469 469
470 470 Fingerprints of the certificates of known HTTPS servers.
471 471 A HTTPS connection to a server with a fingerprint configured here will
472 472 only succeed if the servers certificate matches the fingerprint.
473 473 This is very similar to how ssh known hosts works.
474 474 The fingerprint is the SHA-1 hash value of the DER encoded certificate.
475 475 The CA chain and web.cacerts is not used for servers with a fingerprint.
476 476
477 477 For example::
478 478
479 479 [hostfingerprints]
480 480 hg.intevation.org = 38:76:52:7c:87:26:9a:8f:4a:f8:d3:de:08:45:3b:ea:d6:4b:ee:cc
481 481
482 482 This feature is only supported when using Python 2.6 or later.
483 483
484 484
485 485 ``format``
486 486 """"""""""
487 487
488 488 ``usestore``
489 489 Enable or disable the "store" repository format which improves
490 490 compatibility with systems that fold case or otherwise mangle
491 491 filenames. Enabled by default. Disabling this option will allow
492 492 you to store longer filenames in some situations at the expense of
493 493 compatibility and ensures that the on-disk format of newly created
494 494 repositories will be compatible with Mercurial before version 0.9.4.
495 495
496 496 ``usefncache``
497 497 Enable or disable the "fncache" repository format which enhances
498 498 the "store" repository format (which has to be enabled to use
499 499 fncache) to allow longer filenames and avoids using Windows
500 500 reserved names, e.g. "nul". Enabled by default. Disabling this
501 501 option ensures that the on-disk format of newly created
502 502 repositories will be compatible with Mercurial before version 1.1.
503 503
504 504 ``dotencode``
505 505 Enable or disable the "dotencode" repository format which enhances
506 506 the "fncache" repository format (which has to be enabled to use
507 507 dotencode) to avoid issues with filenames starting with ._ on
508 508 Mac OS X and spaces on Windows. Enabled by default. Disabling this
509 509 option ensures that the on-disk format of newly created
510 510 repositories will be compatible with Mercurial before version 1.7.
511 511
512 512 ``merge-patterns``
513 513 """"""""""""""""""
514 514
515 515 This section specifies merge tools to associate with particular file
516 516 patterns. Tools matched here will take precedence over the default
517 517 merge tool. Patterns are globs by default, rooted at the repository
518 518 root.
519 519
520 520 Example::
521 521
522 522 [merge-patterns]
523 523 **.c = kdiff3
524 524 **.jpg = myimgmerge
525 525
526 526 ``merge-tools``
527 527 """""""""""""""
528 528
529 529 This section configures external merge tools to use for file-level
530 530 merges.
531 531
532 532 Example ``~/.hgrc``::
533 533
534 534 [merge-tools]
535 535 # Override stock tool location
536 536 kdiff3.executable = ~/bin/kdiff3
537 537 # Specify command line
538 538 kdiff3.args = $base $local $other -o $output
539 539 # Give higher priority
540 540 kdiff3.priority = 1
541 541
542 542 # Define new tool
543 543 myHtmlTool.args = -m $local $other $base $output
544 544 myHtmlTool.regkey = Software\FooSoftware\HtmlMerge
545 545 myHtmlTool.priority = 1
546 546
547 547 Supported arguments:
548 548
549 549 ``priority``
550 550 The priority in which to evaluate this tool.
551 551 Default: 0.
552 552
553 553 ``executable``
554 554 Either just the name of the executable or its pathname. On Windows,
555 555 the path can use environment variables with ${ProgramFiles} syntax.
556 556 Default: the tool name.
557 557
558 558 ``args``
559 559 The arguments to pass to the tool executable. You can refer to the
560 560 files being merged as well as the output file through these
561 561 variables: ``$base``, ``$local``, ``$other``, ``$output``.
562 562 Default: ``$local $base $other``
563 563
564 564 ``premerge``
565 565 Attempt to run internal non-interactive 3-way merge tool before
566 566 launching external tool. Options are ``true``, ``false``, or ``keep``
567 567 to leave markers in the file if the premerge fails.
568 568 Default: True
569 569
570 570 ``binary``
571 571 This tool can merge binary files. Defaults to False, unless tool
572 572 was selected by file pattern match.
573 573
574 574 ``symlink``
575 575 This tool can merge symlinks. Defaults to False, even if tool was
576 576 selected by file pattern match.
577 577
578 578 ``check``
579 579 A list of merge success-checking options:
580 580
581 581 ``changed``
582 582 Ask whether merge was successful when the merged file shows no changes.
583 583 ``conflicts``
584 584 Check whether there are conflicts even though the tool reported success.
585 585 ``prompt``
586 586 Always prompt for merge success, regardless of success reported by tool.
587 587
588 588 ``checkchanged``
589 589 True is equivalent to ``check = changed``.
590 590 Default: False
591 591
592 592 ``checkconflicts``
593 593 True is equivalent to ``check = conflicts``.
594 594 Default: False
595 595
596 596 ``fixeol``
597 597 Attempt to fix up EOL changes caused by the merge tool.
598 598 Default: False
599 599
600 600 ``gui``
601 601 This tool requires a graphical interface to run. Default: False
602 602
603 603 ``regkey``
604 604 Windows registry key which describes install location of this
605 605 tool. Mercurial will search for this key first under
606 606 ``HKEY_CURRENT_USER`` and then under ``HKEY_LOCAL_MACHINE``.
607 607 Default: None
608 608
609 609 ``regkeyalt``
610 610 An alternate Windows registry key to try if the first key is not
611 611 found. The alternate key uses the same ``regname`` and ``regappend``
612 612 semantics of the primary key. The most common use for this key
613 613 is to search for 32bit applications on 64bit operating systems.
614 614 Default: None
615 615
616 616 ``regname``
617 617 Name of value to read from specified registry key. Defaults to the
618 618 unnamed (default) value.
619 619
620 620 ``regappend``
621 621 String to append to the value read from the registry, typically
622 622 the executable name of the tool.
623 623 Default: None
624 624
625 625
626 626 ``hooks``
627 627 """""""""
628 628
629 629 Commands or Python functions that get automatically executed by
630 630 various actions such as starting or finishing a commit. Multiple
631 631 hooks can be run for the same action by appending a suffix to the
632 632 action. Overriding a site-wide hook can be done by changing its
633 633 value or setting it to an empty string.
634 634
635 635 Example ``.hg/hgrc``::
636 636
637 637 [hooks]
638 638 # update working directory after adding changesets
639 639 changegroup.update = hg update
640 640 # do not use the site-wide hook
641 641 incoming =
642 642 incoming.email = /my/email/hook
643 643 incoming.autobuild = /my/build/hook
644 644
645 645 Most hooks are run with environment variables set that give useful
646 646 additional information. For each hook below, the environment
647 647 variables it is passed are listed with names of the form ``$HG_foo``.
648 648
649 649 ``changegroup``
650 650 Run after a changegroup has been added via push, pull or unbundle.
651 651 ID of the first new changeset is in ``$HG_NODE``. URL from which
652 652 changes came is in ``$HG_URL``.
653 653
654 654 ``commit``
655 655 Run after a changeset has been created in the local repository. ID
656 656 of the newly created changeset is in ``$HG_NODE``. Parent changeset
657 657 IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.
658 658
659 659 ``incoming``
660 660 Run after a changeset has been pulled, pushed, or unbundled into
661 661 the local repository. The ID of the newly arrived changeset is in
662 662 ``$HG_NODE``. URL that was source of changes came is in ``$HG_URL``.
663 663
664 664 ``outgoing``
665 665 Run after sending changes from local repository to another. ID of
666 666 first changeset sent is in ``$HG_NODE``. Source of operation is in
667 667 ``$HG_SOURCE``; see "preoutgoing" hook for description.
668 668
669 669 ``post-<command>``
670 670 Run after successful invocations of the associated command. The
671 671 contents of the command line are passed as ``$HG_ARGS`` and the result
672 672 code in ``$HG_RESULT``. Parsed command line arguments are passed as
673 673 ``$HG_PATS`` and ``$HG_OPTS``. These contain string representations of
674 674 the python data internally passed to <command>. ``$HG_OPTS`` is a
675 675 dictionary of options (with unspecified options set to their defaults).
676 676 ``$HG_PATS`` is a list of arguments. Hook failure is ignored.
677 677
678 678 ``pre-<command>``
679 679 Run before executing the associated command. The contents of the
680 680 command line are passed as ``$HG_ARGS``. Parsed command line arguments
681 681 are passed as ``$HG_PATS`` and ``$HG_OPTS``. These contain string
682 682 representations of the data internally passed to <command>. ``$HG_OPTS``
683 683 is a dictionary of options (with unspecified options set to their
684 684 defaults). ``$HG_PATS`` is a list of arguments. If the hook returns
685 685 failure, the command doesn't execute and Mercurial returns the failure
686 686 code.
687 687
688 688 ``prechangegroup``
689 689 Run before a changegroup is added via push, pull or unbundle. Exit
690 690 status 0 allows the changegroup to proceed. Non-zero status will
691 691 cause the push, pull or unbundle to fail. URL from which changes
692 692 will come is in ``$HG_URL``.
693 693
694 694 ``precommit``
695 695 Run before starting a local commit. Exit status 0 allows the
696 696 commit to proceed. Non-zero status will cause the commit to fail.
697 697 Parent changeset IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.
698 698
699 699 ``prelistkeys``
700 700 Run before listing pushkeys (like bookmarks) in the
701 701 repository. Non-zero status will cause failure. The key namespace is
702 702 in ``$HG_NAMESPACE``.
703 703
704 704 ``preoutgoing``
705 705 Run before collecting changes to send from the local repository to
706 706 another. Non-zero status will cause failure. This lets you prevent
707 707 pull over HTTP or SSH. Also prevents against local pull, push
708 708 (outbound) or bundle commands, but not effective, since you can
709 709 just copy files instead then. Source of operation is in
710 710 ``$HG_SOURCE``. If "serve", operation is happening on behalf of remote
711 711 SSH or HTTP repository. If "push", "pull" or "bundle", operation
712 712 is happening on behalf of repository on same system.
713 713
714 714 ``prepushkey``
715 715 Run before a pushkey (like a bookmark) is added to the
716 716 repository. Non-zero status will cause the key to be rejected. The
717 717 key namespace is in ``$HG_NAMESPACE``, the key is in ``$HG_KEY``,
718 718 the old value (if any) is in ``$HG_OLD``, and the new value is in
719 719 ``$HG_NEW``.
720 720
721 721 ``pretag``
722 722 Run before creating a tag. Exit status 0 allows the tag to be
723 723 created. Non-zero status will cause the tag to fail. ID of
724 724 changeset to tag is in ``$HG_NODE``. Name of tag is in ``$HG_TAG``. Tag is
725 725 local if ``$HG_LOCAL=1``, in repository if ``$HG_LOCAL=0``.
726 726
727 727 ``pretxnchangegroup``
728 728 Run after a changegroup has been added via push, pull or unbundle,
729 729 but before the transaction has been committed. Changegroup is
730 730 visible to hook program. This lets you validate incoming changes
731 731 before accepting them. Passed the ID of the first new changeset in
732 732 ``$HG_NODE``. Exit status 0 allows the transaction to commit. Non-zero
733 733 status will cause the transaction to be rolled back and the push,
734 734 pull or unbundle will fail. URL that was source of changes is in
735 735 ``$HG_URL``.
736 736
737 737 ``pretxncommit``
738 738 Run after a changeset has been created but the transaction not yet
739 739 committed. Changeset is visible to hook program. This lets you
740 740 validate commit message and changes. Exit status 0 allows the
741 741 commit to proceed. Non-zero status will cause the transaction to
742 742 be rolled back. ID of changeset is in ``$HG_NODE``. Parent changeset
743 743 IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.
744 744
745 745 ``preupdate``
746 746 Run before updating the working directory. Exit status 0 allows
747 747 the update to proceed. Non-zero status will prevent the update.
748 748 Changeset ID of first new parent is in ``$HG_PARENT1``. If merge, ID
749 749 of second new parent is in ``$HG_PARENT2``.
750 750
751 751 ``listkeys``
752 752 Run after listing pushkeys (like bookmarks) in the repository. The
753 753 key namespace is in ``$HG_NAMESPACE``. ``$HG_VALUES`` is a
754 754 dictionary containing the keys and values.
755 755
756 756 ``pushkey``
757 757 Run after a pushkey (like a bookmark) is added to the
758 758 repository. The key namespace is in ``$HG_NAMESPACE``, the key is in
759 759 ``$HG_KEY``, the old value (if any) is in ``$HG_OLD``, and the new
760 760 value is in ``$HG_NEW``.
761 761
762 762 ``tag``
763 763 Run after a tag is created. ID of tagged changeset is in ``$HG_NODE``.
764 764 Name of tag is in ``$HG_TAG``. Tag is local if ``$HG_LOCAL=1``, in
765 765 repository if ``$HG_LOCAL=0``.
766 766
767 767 ``update``
768 768 Run after updating the working directory. Changeset ID of first
769 769 new parent is in ``$HG_PARENT1``. If merge, ID of second new parent is
770 770 in ``$HG_PARENT2``. If the update succeeded, ``$HG_ERROR=0``. If the
771 771 update failed (e.g. because conflicts not resolved), ``$HG_ERROR=1``.
772 772
773 773 .. note:: It is generally better to use standard hooks rather than the
774 774 generic pre- and post- command hooks as they are guaranteed to be
775 775 called in the appropriate contexts for influencing transactions.
776 776 Also, hooks like "commit" will be called in all contexts that
777 777 generate a commit (e.g. tag) and not just the commit command.
778 778
779 779 .. note:: Environment variables with empty values may not be passed to
780 780 hooks on platforms such as Windows. As an example, ``$HG_PARENT2``
781 781 will have an empty value under Unix-like platforms for non-merge
782 782 changesets, while it will not be available at all under Windows.
783 783
784 784 The syntax for Python hooks is as follows::
785 785
786 786 hookname = python:modulename.submodule.callable
787 787 hookname = python:/path/to/python/module.py:callable
788 788
789 789 Python hooks are run within the Mercurial process. Each hook is
790 790 called with at least three keyword arguments: a ui object (keyword
791 791 ``ui``), a repository object (keyword ``repo``), and a ``hooktype``
792 792 keyword that tells what kind of hook is used. Arguments listed as
793 793 environment variables above are passed as keyword arguments, with no
794 794 ``HG_`` prefix, and names in lower case.
795 795
796 796 If a Python hook returns a "true" value or raises an exception, this
797 797 is treated as a failure.
798 798
799 799
800 800 ``http_proxy``
801 801 """"""""""""""
802 802
803 803 Used to access web-based Mercurial repositories through a HTTP
804 804 proxy.
805 805
806 806 ``host``
807 807 Host name and (optional) port of the proxy server, for example
808 808 "myproxy:8000".
809 809
810 810 ``no``
811 811 Optional. Comma-separated list of host names that should bypass
812 812 the proxy.
813 813
814 814 ``passwd``
815 815 Optional. Password to authenticate with at the proxy server.
816 816
817 817 ``user``
818 818 Optional. User name to authenticate with at the proxy server.
819 819
820 820 ``always``
821 821 Optional. Always use the proxy, even for localhost and any entries
822 822 in ``http_proxy.no``. True or False. Default: False.
823 823
824 824 ``smtp``
825 825 """"""""
826 826
827 827 Configuration for extensions that need to send email messages.
828 828
829 829 ``host``
830 830 Host name of mail server, e.g. "mail.example.com".
831 831
832 832 ``port``
833 833 Optional. Port to connect to on mail server. Default: 25.
834 834
835 835 ``tls``
836 836 Optional. Method to enable TLS when connecting to mail server: starttls,
837 837 smtps or none. Default: none.
838 838
839 839 ``username``
840 840 Optional. User name for authenticating with the SMTP server.
841 841 Default: none.
842 842
843 843 ``password``
844 844 Optional. Password for authenticating with the SMTP server. If not
845 845 specified, interactive sessions will prompt the user for a
846 846 password; non-interactive sessions will fail. Default: none.
847 847
848 848 ``local_hostname``
849 849 Optional. It's the hostname that the sender can use to identify
850 850 itself to the MTA.
851 851
852 852
853 853 ``patch``
854 854 """""""""
855 855
856 856 Settings used when applying patches, for instance through the 'import'
857 857 command or with Mercurial Queues extension.
858 858
859 859 ``eol``
860 860 When set to 'strict' patch content and patched files end of lines
861 861 are preserved. When set to ``lf`` or ``crlf``, both files end of
862 862 lines are ignored when patching and the result line endings are
863 863 normalized to either LF (Unix) or CRLF (Windows). When set to
864 864 ``auto``, end of lines are again ignored while patching but line
865 865 endings in patched files are normalized to their original setting
866 866 on a per-file basis. If target file does not exist or has no end
867 867 of line, patch line endings are preserved.
868 868 Default: strict.
869 869
870 870
871 871 ``paths``
872 872 """""""""
873 873
874 874 Assigns symbolic names to repositories. The left side is the
875 875 symbolic name, and the right gives the directory or URL that is the
876 876 location of the repository. Default paths can be declared by setting
877 877 the following entries.
878 878
879 879 ``default``
880 880 Directory or URL to use when pulling if no source is specified.
881 881 Default is set to repository from which the current repository was
882 882 cloned.
883 883
884 884 ``default-push``
885 885 Optional. Directory or URL to use when pushing if no destination
886 886 is specified.
887 887
888 888
889 889 ``profiling``
890 890 """""""""""""
891 891
892 892 Specifies profiling format and file output. In this section
893 893 description, 'profiling data' stands for the raw data collected
894 894 during profiling, while 'profiling report' stands for a statistical
895 895 text report generated from the profiling data. The profiling is done
896 896 using lsprof.
897 897
898 898 ``format``
899 899 Profiling format.
900 900 Default: text.
901 901
902 902 ``text``
903 903 Generate a profiling report. When saving to a file, it should be
904 904 noted that only the report is saved, and the profiling data is
905 905 not kept.
906 906 ``kcachegrind``
907 907 Format profiling data for kcachegrind use: when saving to a
908 908 file, the generated file can directly be loaded into
909 909 kcachegrind.
910 910
911 911 ``output``
912 912 File path where profiling data or report should be saved. If the
913 913 file exists, it is replaced. Default: None, data is printed on
914 914 stderr
915 915
916 916 ``revsetalias``
917 917 """""""""""""""
918 918
919 919 Alias definitions for revsets. See :hg:`help revsets` for details.
920 920
921 921 ``server``
922 922 """"""""""
923 923
924 924 Controls generic server settings.
925 925
926 926 ``uncompressed``
927 927 Whether to allow clients to clone a repository using the
928 928 uncompressed streaming protocol. This transfers about 40% more
929 929 data than a regular clone, but uses less memory and CPU on both
930 930 server and client. Over a LAN (100 Mbps or better) or a very fast
931 931 WAN, an uncompressed streaming clone is a lot faster (~10x) than a
932 932 regular clone. Over most WAN connections (anything slower than
933 933 about 6 Mbps), uncompressed streaming is slower, because of the
934 934 extra data transfer overhead. This mode will also temporarily hold
935 935 the write lock while determining what data to transfer.
936 936 Default is True.
937 937
938 938 ``validate``
939 939 Whether to validate the completeness of pushed changesets by
940 940 checking that all new file revisions specified in manifests are
941 941 present. Default is False.
942 942
943 943 ``subpaths``
944 944 """"""""""""
945 945
946 946 Defines subrepositories source locations rewriting rules of the form::
947 947
948 948 <pattern> = <replacement>
949 949
950 950 Where ``pattern`` is a regular expression matching the source and
951 951 ``replacement`` is the replacement string used to rewrite it. Groups
952 952 can be matched in ``pattern`` and referenced in ``replacements``. For
953 953 instance::
954 954
955 955 http://server/(.*)-hg/ = http://hg.server/\1/
956 956
957 957 rewrites ``http://server/foo-hg/`` into ``http://hg.server/foo/``.
958 958
959 959 All patterns are applied in definition order.
960 960
961 961 ``trusted``
962 962 """""""""""
963 963
964 964 Mercurial will not use the settings in the
965 965 ``.hg/hgrc`` file from a repository if it doesn't belong to a trusted
966 966 user or to a trusted group, as various hgrc features allow arbitrary
967 967 commands to be run. This issue is often encountered when configuring
968 968 hooks or extensions for shared repositories or servers. However,
969 969 the web interface will use some safe settings from the ``[web]``
970 970 section.
971 971
972 972 This section specifies what users and groups are trusted. The
973 973 current user is always trusted. To trust everybody, list a user or a
974 974 group with name ``*``. These settings must be placed in an
975 975 *already-trusted file* to take effect, such as ``$HOME/.hgrc`` of the
976 976 user or service running Mercurial.
977 977
978 978 ``users``
979 979 Comma-separated list of trusted users.
980 980
981 981 ``groups``
982 982 Comma-separated list of trusted groups.
983 983
984 984
985 985 ``ui``
986 986 """"""
987 987
988 988 User interface controls.
989 989
990 990 ``archivemeta``
991 991 Whether to include the .hg_archival.txt file containing meta data
992 992 (hashes for the repository base and for tip) in archives created
993 993 by the :hg:`archive` command or downloaded via hgweb.
994 994 Default is True.
995 995
996 996 ``askusername``
997 997 Whether to prompt for a username when committing. If True, and
998 998 neither ``$HGUSER`` nor ``$EMAIL`` has been specified, then the user will
999 999 be prompted to enter a username. If no username is entered, the
1000 1000 default ``USER@HOST`` is used instead.
1001 1001 Default is False.
1002 1002
1003 1003 ``commitsubrepos``
1004 1004 Whether to commit modified subrepositories when committing the
1005 1005 parent repository. If False and one subrepository has uncommitted
1006 1006 changes, abort the commit.
1007 1007 Default is True.
1008 1008
1009 1009 ``debug``
1010 1010 Print debugging information. True or False. Default is False.
1011 1011
1012 1012 ``editor``
1013 1013 The editor to use during a commit. Default is ``$EDITOR`` or ``vi``.
1014 1014
1015 1015 ``fallbackencoding``
1016 1016 Encoding to try if it's not possible to decode the changelog using
1017 1017 UTF-8. Default is ISO-8859-1.
1018 1018
1019 1019 ``ignore``
1020 1020 A file to read per-user ignore patterns from. This file should be
1021 1021 in the same format as a repository-wide .hgignore file. This
1022 1022 option supports hook syntax, so if you want to specify multiple
1023 1023 ignore files, you can do so by setting something like
1024 1024 ``ignore.other = ~/.hgignore2``. For details of the ignore file
1025 1025 format, see the ``hgignore(5)`` man page.
1026 1026
1027 1027 ``interactive``
1028 1028 Allow to prompt the user. True or False. Default is True.
1029 1029
1030 1030 ``logtemplate``
1031 1031 Template string for commands that print changesets.
1032 1032
1033 1033 ``merge``
1034 1034 The conflict resolution program to use during a manual merge.
1035 1035 For more information on merge tools see :hg:`help merge-tools`.
1036 1036 For configuring merge tools see the ``[merge-tools]`` section.
1037 1037
1038 1038 ``portablefilenames``
1039 1039 Check for portable filenames. Can be ``warn``, ``ignore`` or ``abort``.
1040 1040 Default is ``warn``.
1041 1041 If set to ``warn`` (or ``true``), a warning message is printed on POSIX
1042 1042 platforms, if a file with a non-portable filename is added (e.g. a file
1043 1043 with a name that can't be created on Windows because it contains reserved
1044 1044 parts like ``AUX``, reserved characters like ``:``, or would cause a case
1045 1045 collision with an existing file).
1046 1046 If set to ``ignore`` (or ``false``), no warning is printed.
1047 1047 If set to ``abort``, the command is aborted.
1048 1048 On Windows, this configuration option is ignored and the command aborted.
1049 1049
1050 1050 ``quiet``
1051 1051 Reduce the amount of output printed. True or False. Default is False.
1052 1052
1053 1053 ``remotecmd``
1054 1054 remote command to use for clone/push/pull operations. Default is ``hg``.
1055 1055
1056 1056 ``report_untrusted``
1057 1057 Warn if a ``.hg/hgrc`` file is ignored due to not being owned by a
1058 1058 trusted user or group. True or False. Default is True.
1059 1059
1060 1060 ``slash``
1061 1061 Display paths using a slash (``/``) as the path separator. This
1062 1062 only makes a difference on systems where the default path
1063 1063 separator is not the slash character (e.g. Windows uses the
1064 1064 backslash character (``\``)).
1065 1065 Default is False.
1066 1066
1067 1067 ``ssh``
1068 1068 command to use for SSH connections. Default is ``ssh``.
1069 1069
1070 1070 ``strict``
1071 1071 Require exact command names, instead of allowing unambiguous
1072 1072 abbreviations. True or False. Default is False.
1073 1073
1074 1074 ``style``
1075 1075 Name of style to use for command output.
1076 1076
1077 1077 ``timeout``
1078 1078 The timeout used when a lock is held (in seconds), a negative value
1079 1079 means no timeout. Default is 600.
1080 1080
1081 1081 ``traceback``
1082 1082 Mercurial always prints a traceback when an unknown exception
1083 1083 occurs. Setting this to True will make Mercurial print a traceback
1084 1084 on all exceptions, even those recognized by Mercurial (such as
1085 1085 IOError or MemoryError). Default is False.
1086 1086
1087 1087 ``username``
1088 1088 The committer of a changeset created when running "commit".
1089 1089 Typically a person's name and email address, e.g. ``Fred Widget
1090 1090 <fred@example.com>``. Default is ``$EMAIL`` or ``username@hostname``. If
1091 1091 the username in hgrc is empty, it has to be specified manually or
1092 1092 in a different hgrc file (e.g. ``$HOME/.hgrc``, if the admin set
1093 1093 ``username =`` in the system hgrc). Environment variables in the
1094 1094 username are expanded.
1095 1095
1096 1096 ``verbose``
1097 1097 Increase the amount of output printed. True or False. Default is False.
1098 1098
1099 1099
1100 1100 ``web``
1101 1101 """""""
1102 1102
1103 1103 Web interface configuration. The settings in this section apply to
1104 1104 both the builtin webserver (started by :hg:`serve`) and the script you
1105 1105 run through a webserver (``hgweb.cgi`` and the derivatives for FastCGI
1106 1106 and WSGI).
1107 1107
1108 1108 The Mercurial webserver does no authentication (it does not prompt for
1109 1109 usernames and passwords to validate *who* users are), but it does do
1110 1110 authorization (it grants or denies access for *authenticated users*
1111 1111 based on settings in this section). You must either configure your
1112 1112 webserver to do authentication for you, or disable the authorization
1113 1113 checks.
1114 1114
1115 1115 For a quick setup in a trusted environment, e.g., a private LAN, where
1116 1116 you want it to accept pushes from anybody, you can use the following
1117 1117 command line::
1118 1118
1119 1119 $ hg --config web.allow_push=* --config web.push_ssl=False serve
1120 1120
1121 1121 Note that this will allow anybody to push anything to the server and
1122 1122 that this should not be used for public servers.
1123 1123
1124 1124 The full set of options is:
1125 1125
1126 1126 ``accesslog``
1127 1127 Where to output the access log. Default is stdout.
1128 1128
1129 1129 ``address``
1130 1130 Interface address to bind to. Default is all.
1131 1131
1132 1132 ``allow_archive``
1133 1133 List of archive format (bz2, gz, zip) allowed for downloading.
1134 1134 Default is empty.
1135 1135
1136 1136 ``allowbz2``
1137 1137 (DEPRECATED) Whether to allow .tar.bz2 downloading of repository
1138 1138 revisions.
1139 1139 Default is False.
1140 1140
1141 1141 ``allowgz``
1142 1142 (DEPRECATED) Whether to allow .tar.gz downloading of repository
1143 1143 revisions.
1144 1144 Default is False.
1145 1145
1146 1146 ``allowpull``
1147 1147 Whether to allow pulling from the repository. Default is True.
1148 1148
1149 1149 ``allow_push``
1150 1150 Whether to allow pushing to the repository. If empty or not set,
1151 1151 push is not allowed. If the special value ``*``, any remote user can
1152 1152 push, including unauthenticated users. Otherwise, the remote user
1153 1153 must have been authenticated, and the authenticated user name must
1154 1154 be present in this list. The contents of the allow_push list are
1155 1155 examined after the deny_push list.
1156 1156
1157 ``guessmime``
1158 Control MIME types for raw download of file content.
1159 Set to True to let hgweb guess the content type from the file
1160 extension. This will serve HTML files as ``text/html`` and might
1161 allow cross-site scripting attacks when serving untrusted
1162 repositories. Default is False.
1163
1157 1164 ``allow_read``
1158 1165 If the user has not already been denied repository access due to
1159 1166 the contents of deny_read, this list determines whether to grant
1160 1167 repository access to the user. If this list is not empty, and the
1161 1168 user is unauthenticated or not present in the list, then access is
1162 1169 denied for the user. If the list is empty or not set, then access
1163 1170 is permitted to all users by default. Setting allow_read to the
1164 1171 special value ``*`` is equivalent to it not being set (i.e. access
1165 1172 is permitted to all users). The contents of the allow_read list are
1166 1173 examined after the deny_read list.
1167 1174
1168 1175 ``allowzip``
1169 1176 (DEPRECATED) Whether to allow .zip downloading of repository
1170 1177 revisions. Default is False. This feature creates temporary files.
1171 1178
1172 1179 ``baseurl``
1173 1180 Base URL to use when publishing URLs in other locations, so
1174 1181 third-party tools like email notification hooks can construct
1175 1182 URLs. Example: ``http://hgserver/repos/``.
1176 1183
1177 1184 ``cacerts``
1178 1185 Path to file containing a list of PEM encoded certificate
1179 1186 authority certificates. Environment variables and ``~user``
1180 1187 constructs are expanded in the filename. If specified on the
1181 1188 client, then it will verify the identity of remote HTTPS servers
1182 1189 with these certificates. The form must be as follows::
1183 1190
1184 1191 -----BEGIN CERTIFICATE-----
1185 1192 ... (certificate in base64 PEM encoding) ...
1186 1193 -----END CERTIFICATE-----
1187 1194 -----BEGIN CERTIFICATE-----
1188 1195 ... (certificate in base64 PEM encoding) ...
1189 1196 -----END CERTIFICATE-----
1190 1197
1191 1198 This feature is only supported when using Python 2.6 or later. If you wish
1192 1199 to use it with earlier versions of Python, install the backported
1193 1200 version of the ssl library that is available from
1194 1201 ``http://pypi.python.org``.
1195 1202
1196 1203 You can use OpenSSL's CA certificate file if your platform has one.
1197 1204 On most Linux systems this will be ``/etc/ssl/certs/ca-certificates.crt``.
1198 1205 Otherwise you will have to generate this file manually.
1199 1206
1200 1207 To disable SSL verification temporarily, specify ``--insecure`` from
1201 1208 command line.
1202 1209
1203 1210 ``cache``
1204 1211 Whether to support caching in hgweb. Defaults to True.
1205 1212
1206 1213 ``contact``
1207 1214 Name or email address of the person in charge of the repository.
1208 1215 Defaults to ui.username or ``$EMAIL`` or "unknown" if unset or empty.
1209 1216
1210 1217 ``deny_push``
1211 1218 Whether to deny pushing to the repository. If empty or not set,
1212 1219 push is not denied. If the special value ``*``, all remote users are
1213 1220 denied push. Otherwise, unauthenticated users are all denied, and
1214 1221 any authenticated user name present in this list is also denied. The
1215 1222 contents of the deny_push list are examined before the allow_push list.
1216 1223
1217 1224 ``deny_read``
1218 1225 Whether to deny reading/viewing of the repository. If this list is
1219 1226 not empty, unauthenticated users are all denied, and any
1220 1227 authenticated user name present in this list is also denied access to
1221 1228 the repository. If set to the special value ``*``, all remote users
1222 1229 are denied access (rarely needed ;). If deny_read is empty or not set,
1223 1230 the determination of repository access depends on the presence and
1224 1231 content of the allow_read list (see description). If both
1225 1232 deny_read and allow_read are empty or not set, then access is
1226 1233 permitted to all users by default. If the repository is being
1227 1234 served via hgwebdir, denied users will not be able to see it in
1228 1235 the list of repositories. The contents of the deny_read list have
1229 1236 priority over (are examined before) the contents of the allow_read
1230 1237 list.
1231 1238
1232 1239 ``descend``
1233 1240 hgwebdir indexes will not descend into subdirectories. Only repositories
1234 1241 directly in the current path will be shown (other repositories are still
1235 1242 available from the index corresponding to their containing path).
1236 1243
1237 1244 ``description``
1238 1245 Textual description of the repository's purpose or contents.
1239 1246 Default is "unknown".
1240 1247
1241 1248 ``encoding``
1242 1249 Character encoding name. Default is the current locale charset.
1243 1250 Example: "UTF-8"
1244 1251
1245 1252 ``errorlog``
1246 1253 Where to output the error log. Default is stderr.
1247 1254
1248 1255 ``hidden``
1249 1256 Whether to hide the repository in the hgwebdir index.
1250 1257 Default is False.
1251 1258
1252 1259 ``ipv6``
1253 1260 Whether to use IPv6. Default is False.
1254 1261
1255 1262 ``logourl``
1256 1263 Base URL to use for logos. If unset, ``http://mercurial.selenic.com/``
1257 1264 will be used.
1258 1265
1259 1266 ``name``
1260 1267 Repository name to use in the web interface. Default is current
1261 1268 working directory.
1262 1269
1263 1270 ``maxchanges``
1264 1271 Maximum number of changes to list on the changelog. Default is 10.
1265 1272
1266 1273 ``maxfiles``
1267 1274 Maximum number of files to list per changeset. Default is 10.
1268 1275
1269 1276 ``port``
1270 1277 Port to listen on. Default is 8000.
1271 1278
1272 1279 ``prefix``
1273 1280 Prefix path to serve from. Default is '' (server root).
1274 1281
1275 1282 ``push_ssl``
1276 1283 Whether to require that inbound pushes be transported over SSL to
1277 1284 prevent password sniffing. Default is True.
1278 1285
1279 1286 ``staticurl``
1280 1287 Base URL to use for static files. If unset, static files (e.g. the
1281 1288 hgicon.png favicon) will be served by the CGI script itself. Use
1282 1289 this setting to serve them directly with the HTTP server.
1283 1290 Example: ``http://hgserver/static/``.
1284 1291
1285 1292 ``stripes``
1286 1293 How many lines a "zebra stripe" should span in multiline output.
1287 1294 Default is 1; set to 0 to disable.
1288 1295
1289 1296 ``style``
1290 1297 Which template map style to use.
1291 1298
1292 1299 ``templates``
1293 1300 Where to find the HTML templates. Default is install path.
@@ -1,838 +1,842
1 1 #
2 2 # Copyright 21 May 2005 - (c) 2005 Jake Edge <jake@edge2.net>
3 3 # Copyright 2005-2007 Matt Mackall <mpm@selenic.com>
4 4 #
5 5 # This software may be used and distributed according to the terms of the
6 6 # GNU General Public License version 2 or any later version.
7 7
8 8 import os, mimetypes, re, cgi, copy
9 9 import webutil
10 10 from mercurial import error, encoding, archival, templater, templatefilters
11 11 from mercurial.node import short, hex
12 12 from mercurial.util import binary
13 13 from common import paritygen, staticfile, get_contact, ErrorResponse
14 14 from common import HTTP_OK, HTTP_FORBIDDEN, HTTP_NOT_FOUND
15 15 from mercurial import graphmod
16 16 from mercurial import help as helpmod
17 17 from mercurial.i18n import _
18 18
19 19 # __all__ is populated with the allowed commands. Be sure to add to it if
20 20 # you're adding a new command, or the new command won't work.
21 21
22 22 __all__ = [
23 23 'log', 'rawfile', 'file', 'changelog', 'shortlog', 'changeset', 'rev',
24 24 'manifest', 'tags', 'bookmarks', 'branches', 'summary', 'filediff', 'diff',
25 25 'annotate', 'filelog', 'archive', 'static', 'graph', 'help',
26 26 ]
27 27
28 28 def log(web, req, tmpl):
29 29 if 'file' in req.form and req.form['file'][0]:
30 30 return filelog(web, req, tmpl)
31 31 else:
32 32 return changelog(web, req, tmpl)
33 33
34 34 def rawfile(web, req, tmpl):
35 guessmime = web.configbool('web', 'guessmime', False)
36
35 37 path = webutil.cleanpath(web.repo, req.form.get('file', [''])[0])
36 38 if not path:
37 39 content = manifest(web, req, tmpl)
38 40 req.respond(HTTP_OK, web.ctype)
39 41 return content
40 42
41 43 try:
42 44 fctx = webutil.filectx(web.repo, req)
43 45 except error.LookupError, inst:
44 46 try:
45 47 content = manifest(web, req, tmpl)
46 48 req.respond(HTTP_OK, web.ctype)
47 49 return content
48 50 except ErrorResponse:
49 51 raise inst
50 52
51 53 path = fctx.path()
52 54 text = fctx.data()
53 mt = mimetypes.guess_type(path)[0]
54 if mt is None:
55 mt = binary(text) and 'application/octet-stream' or 'text/plain'
55 mt = 'application/binary'
56 if guessmime:
57 mt = mimetypes.guess_type(path)[0]
58 if mt is None:
59 mt = binary(text) and 'application/binary' or 'text/plain'
56 60 if mt.startswith('text/'):
57 61 mt += '; charset="%s"' % encoding.encoding
58 62
59 63 req.respond(HTTP_OK, mt, path, len(text))
60 64 return [text]
61 65
62 66 def _filerevision(web, tmpl, fctx):
63 67 f = fctx.path()
64 68 text = fctx.data()
65 69 parity = paritygen(web.stripecount)
66 70
67 71 if binary(text):
68 72 mt = mimetypes.guess_type(f)[0] or 'application/octet-stream'
69 73 text = '(binary:%s)' % mt
70 74
71 75 def lines():
72 76 for lineno, t in enumerate(text.splitlines(True)):
73 77 yield {"line": t,
74 78 "lineid": "l%d" % (lineno + 1),
75 79 "linenumber": "% 6d" % (lineno + 1),
76 80 "parity": parity.next()}
77 81
78 82 return tmpl("filerevision",
79 83 file=f,
80 84 path=webutil.up(f),
81 85 text=lines(),
82 86 rev=fctx.rev(),
83 87 node=fctx.hex(),
84 88 author=fctx.user(),
85 89 date=fctx.date(),
86 90 desc=fctx.description(),
87 91 branch=webutil.nodebranchnodefault(fctx),
88 92 parent=webutil.parents(fctx),
89 93 child=webutil.children(fctx),
90 94 rename=webutil.renamelink(fctx),
91 95 permissions=fctx.manifest().flags(f))
92 96
93 97 def file(web, req, tmpl):
94 98 path = webutil.cleanpath(web.repo, req.form.get('file', [''])[0])
95 99 if not path:
96 100 return manifest(web, req, tmpl)
97 101 try:
98 102 return _filerevision(web, tmpl, webutil.filectx(web.repo, req))
99 103 except error.LookupError, inst:
100 104 try:
101 105 return manifest(web, req, tmpl)
102 106 except ErrorResponse:
103 107 raise inst
104 108
105 109 def _search(web, req, tmpl):
106 110
107 111 query = req.form['rev'][0]
108 112 revcount = web.maxchanges
109 113 if 'revcount' in req.form:
110 114 revcount = int(req.form.get('revcount', [revcount])[0])
111 115 revcount = max(revcount, 1)
112 116 tmpl.defaults['sessionvars']['revcount'] = revcount
113 117
114 118 lessvars = copy.copy(tmpl.defaults['sessionvars'])
115 119 lessvars['revcount'] = max(revcount / 2, 1)
116 120 lessvars['rev'] = query
117 121 morevars = copy.copy(tmpl.defaults['sessionvars'])
118 122 morevars['revcount'] = revcount * 2
119 123 morevars['rev'] = query
120 124
121 125 def changelist(**map):
122 126 count = 0
123 127 qw = query.lower().split()
124 128
125 129 def revgen():
126 130 for i in xrange(len(web.repo) - 1, 0, -100):
127 131 l = []
128 132 for j in xrange(max(0, i - 100), i + 1):
129 133 ctx = web.repo[j]
130 134 l.append(ctx)
131 135 l.reverse()
132 136 for e in l:
133 137 yield e
134 138
135 139 for ctx in revgen():
136 140 miss = 0
137 141 for q in qw:
138 142 if not (q in ctx.user().lower() or
139 143 q in ctx.description().lower() or
140 144 q in " ".join(ctx.files()).lower()):
141 145 miss = 1
142 146 break
143 147 if miss:
144 148 continue
145 149
146 150 count += 1
147 151 n = ctx.node()
148 152 showtags = webutil.showtag(web.repo, tmpl, 'changelogtag', n)
149 153 files = webutil.listfilediffs(tmpl, ctx.files(), n, web.maxfiles)
150 154
151 155 yield tmpl('searchentry',
152 156 parity=parity.next(),
153 157 author=ctx.user(),
154 158 parent=webutil.parents(ctx),
155 159 child=webutil.children(ctx),
156 160 changelogtag=showtags,
157 161 desc=ctx.description(),
158 162 date=ctx.date(),
159 163 files=files,
160 164 rev=ctx.rev(),
161 165 node=hex(n),
162 166 tags=webutil.nodetagsdict(web.repo, n),
163 167 bookmarks=webutil.nodebookmarksdict(web.repo, n),
164 168 inbranch=webutil.nodeinbranch(web.repo, ctx),
165 169 branches=webutil.nodebranchdict(web.repo, ctx))
166 170
167 171 if count >= revcount:
168 172 break
169 173
170 174 tip = web.repo['tip']
171 175 parity = paritygen(web.stripecount)
172 176
173 177 return tmpl('search', query=query, node=tip.hex(),
174 178 entries=changelist, archives=web.archivelist("tip"),
175 179 morevars=morevars, lessvars=lessvars)
176 180
177 181 def changelog(web, req, tmpl, shortlog=False):
178 182
179 183 if 'node' in req.form:
180 184 ctx = webutil.changectx(web.repo, req)
181 185 else:
182 186 if 'rev' in req.form:
183 187 hi = req.form['rev'][0]
184 188 else:
185 189 hi = len(web.repo) - 1
186 190 try:
187 191 ctx = web.repo[hi]
188 192 except error.RepoError:
189 193 return _search(web, req, tmpl) # XXX redirect to 404 page?
190 194
191 195 def changelist(limit=0, **map):
192 196 l = [] # build a list in forward order for efficiency
193 197 for i in xrange(start, end):
194 198 ctx = web.repo[i]
195 199 n = ctx.node()
196 200 showtags = webutil.showtag(web.repo, tmpl, 'changelogtag', n)
197 201 files = webutil.listfilediffs(tmpl, ctx.files(), n, web.maxfiles)
198 202
199 203 l.insert(0, {"parity": parity.next(),
200 204 "author": ctx.user(),
201 205 "parent": webutil.parents(ctx, i - 1),
202 206 "child": webutil.children(ctx, i + 1),
203 207 "changelogtag": showtags,
204 208 "desc": ctx.description(),
205 209 "date": ctx.date(),
206 210 "files": files,
207 211 "rev": i,
208 212 "node": hex(n),
209 213 "tags": webutil.nodetagsdict(web.repo, n),
210 214 "bookmarks": webutil.nodebookmarksdict(web.repo, n),
211 215 "inbranch": webutil.nodeinbranch(web.repo, ctx),
212 216 "branches": webutil.nodebranchdict(web.repo, ctx)
213 217 })
214 218
215 219 if limit > 0:
216 220 l = l[:limit]
217 221
218 222 for e in l:
219 223 yield e
220 224
221 225 revcount = shortlog and web.maxshortchanges or web.maxchanges
222 226 if 'revcount' in req.form:
223 227 revcount = int(req.form.get('revcount', [revcount])[0])
224 228 revcount = max(revcount, 1)
225 229 tmpl.defaults['sessionvars']['revcount'] = revcount
226 230
227 231 lessvars = copy.copy(tmpl.defaults['sessionvars'])
228 232 lessvars['revcount'] = max(revcount / 2, 1)
229 233 morevars = copy.copy(tmpl.defaults['sessionvars'])
230 234 morevars['revcount'] = revcount * 2
231 235
232 236 count = len(web.repo)
233 237 pos = ctx.rev()
234 238 start = max(0, pos - revcount + 1)
235 239 end = min(count, start + revcount)
236 240 pos = end - 1
237 241 parity = paritygen(web.stripecount, offset=start - end)
238 242
239 243 changenav = webutil.revnavgen(pos, revcount, count, web.repo.changectx)
240 244
241 245 return tmpl(shortlog and 'shortlog' or 'changelog', changenav=changenav,
242 246 node=ctx.hex(), rev=pos, changesets=count,
243 247 entries=lambda **x: changelist(limit=0,**x),
244 248 latestentry=lambda **x: changelist(limit=1,**x),
245 249 archives=web.archivelist("tip"), revcount=revcount,
246 250 morevars=morevars, lessvars=lessvars)
247 251
248 252 def shortlog(web, req, tmpl):
249 253 return changelog(web, req, tmpl, shortlog = True)
250 254
251 255 def changeset(web, req, tmpl):
252 256 ctx = webutil.changectx(web.repo, req)
253 257 showtags = webutil.showtag(web.repo, tmpl, 'changesettag', ctx.node())
254 258 showbookmarks = webutil.showbookmark(web.repo, tmpl, 'changesetbookmark',
255 259 ctx.node())
256 260 showbranch = webutil.nodebranchnodefault(ctx)
257 261
258 262 files = []
259 263 parity = paritygen(web.stripecount)
260 264 for f in ctx.files():
261 265 template = f in ctx and 'filenodelink' or 'filenolink'
262 266 files.append(tmpl(template,
263 267 node=ctx.hex(), file=f,
264 268 parity=parity.next()))
265 269
266 270 style = web.config('web', 'style', 'paper')
267 271 if 'style' in req.form:
268 272 style = req.form['style'][0]
269 273
270 274 parity = paritygen(web.stripecount)
271 275 diffs = webutil.diffs(web.repo, tmpl, ctx, None, parity, style)
272 276
273 277 parity = paritygen(web.stripecount)
274 278 diffstatgen = webutil.diffstatgen(ctx)
275 279 diffstat = webutil.diffstat(tmpl, ctx, diffstatgen, parity)
276 280
277 281 return tmpl('changeset',
278 282 diff=diffs,
279 283 rev=ctx.rev(),
280 284 node=ctx.hex(),
281 285 parent=webutil.parents(ctx),
282 286 child=webutil.children(ctx),
283 287 changesettag=showtags,
284 288 changesetbookmark=showbookmarks,
285 289 changesetbranch=showbranch,
286 290 author=ctx.user(),
287 291 desc=ctx.description(),
288 292 date=ctx.date(),
289 293 files=files,
290 294 diffsummary=lambda **x: webutil.diffsummary(diffstatgen),
291 295 diffstat=diffstat,
292 296 archives=web.archivelist(ctx.hex()),
293 297 tags=webutil.nodetagsdict(web.repo, ctx.node()),
294 298 bookmarks=webutil.nodebookmarksdict(web.repo, ctx.node()),
295 299 branch=webutil.nodebranchnodefault(ctx),
296 300 inbranch=webutil.nodeinbranch(web.repo, ctx),
297 301 branches=webutil.nodebranchdict(web.repo, ctx))
298 302
299 303 rev = changeset
300 304
301 305 def manifest(web, req, tmpl):
302 306 ctx = webutil.changectx(web.repo, req)
303 307 path = webutil.cleanpath(web.repo, req.form.get('file', [''])[0])
304 308 mf = ctx.manifest()
305 309 node = ctx.node()
306 310
307 311 files = {}
308 312 dirs = {}
309 313 parity = paritygen(web.stripecount)
310 314
311 315 if path and path[-1] != "/":
312 316 path += "/"
313 317 l = len(path)
314 318 abspath = "/" + path
315 319
316 320 for f, n in mf.iteritems():
317 321 if f[:l] != path:
318 322 continue
319 323 remain = f[l:]
320 324 elements = remain.split('/')
321 325 if len(elements) == 1:
322 326 files[remain] = f
323 327 else:
324 328 h = dirs # need to retain ref to dirs (root)
325 329 for elem in elements[0:-1]:
326 330 if elem not in h:
327 331 h[elem] = {}
328 332 h = h[elem]
329 333 if len(h) > 1:
330 334 break
331 335 h[None] = None # denotes files present
332 336
333 337 if mf and not files and not dirs:
334 338 raise ErrorResponse(HTTP_NOT_FOUND, 'path not found: ' + path)
335 339
336 340 def filelist(**map):
337 341 for f in sorted(files):
338 342 full = files[f]
339 343
340 344 fctx = ctx.filectx(full)
341 345 yield {"file": full,
342 346 "parity": parity.next(),
343 347 "basename": f,
344 348 "date": fctx.date(),
345 349 "size": fctx.size(),
346 350 "permissions": mf.flags(full)}
347 351
348 352 def dirlist(**map):
349 353 for d in sorted(dirs):
350 354
351 355 emptydirs = []
352 356 h = dirs[d]
353 357 while isinstance(h, dict) and len(h) == 1:
354 358 k, v = h.items()[0]
355 359 if v:
356 360 emptydirs.append(k)
357 361 h = v
358 362
359 363 path = "%s%s" % (abspath, d)
360 364 yield {"parity": parity.next(),
361 365 "path": path,
362 366 "emptydirs": "/".join(emptydirs),
363 367 "basename": d}
364 368
365 369 return tmpl("manifest",
366 370 rev=ctx.rev(),
367 371 node=hex(node),
368 372 path=abspath,
369 373 up=webutil.up(abspath),
370 374 upparity=parity.next(),
371 375 fentries=filelist,
372 376 dentries=dirlist,
373 377 archives=web.archivelist(hex(node)),
374 378 tags=webutil.nodetagsdict(web.repo, node),
375 379 bookmarks=webutil.nodebookmarksdict(web.repo, node),
376 380 inbranch=webutil.nodeinbranch(web.repo, ctx),
377 381 branches=webutil.nodebranchdict(web.repo, ctx))
378 382
379 383 def tags(web, req, tmpl):
380 384 i = web.repo.tagslist()
381 385 i.reverse()
382 386 parity = paritygen(web.stripecount)
383 387
384 388 def entries(notip=False, limit=0, **map):
385 389 count = 0
386 390 for k, n in i:
387 391 if notip and k == "tip":
388 392 continue
389 393 if limit > 0 and count >= limit:
390 394 continue
391 395 count = count + 1
392 396 yield {"parity": parity.next(),
393 397 "tag": k,
394 398 "date": web.repo[n].date(),
395 399 "node": hex(n)}
396 400
397 401 return tmpl("tags",
398 402 node=hex(web.repo.changelog.tip()),
399 403 entries=lambda **x: entries(False, 0, **x),
400 404 entriesnotip=lambda **x: entries(True, 0, **x),
401 405 latestentry=lambda **x: entries(True, 1, **x))
402 406
403 407 def bookmarks(web, req, tmpl):
404 408 i = web.repo._bookmarks.items()
405 409 parity = paritygen(web.stripecount)
406 410
407 411 def entries(limit=0, **map):
408 412 count = 0
409 413 for k, n in sorted(i):
410 414 if limit > 0 and count >= limit:
411 415 continue
412 416 count = count + 1
413 417 yield {"parity": parity.next(),
414 418 "bookmark": k,
415 419 "date": web.repo[n].date(),
416 420 "node": hex(n)}
417 421
418 422 return tmpl("bookmarks",
419 423 node=hex(web.repo.changelog.tip()),
420 424 entries=lambda **x: entries(0, **x),
421 425 latestentry=lambda **x: entries(1, **x))
422 426
423 427 def branches(web, req, tmpl):
424 428 tips = (web.repo[n] for t, n in web.repo.branchtags().iteritems())
425 429 heads = web.repo.heads()
426 430 parity = paritygen(web.stripecount)
427 431 sortkey = lambda ctx: ('close' not in ctx.extra(), ctx.rev())
428 432
429 433 def entries(limit, **map):
430 434 count = 0
431 435 for ctx in sorted(tips, key=sortkey, reverse=True):
432 436 if limit > 0 and count >= limit:
433 437 return
434 438 count += 1
435 439 if not web.repo.branchheads(ctx.branch()):
436 440 status = 'closed'
437 441 elif ctx.node() not in heads:
438 442 status = 'inactive'
439 443 else:
440 444 status = 'open'
441 445 yield {'parity': parity.next(),
442 446 'branch': ctx.branch(),
443 447 'status': status,
444 448 'node': ctx.hex(),
445 449 'date': ctx.date()}
446 450
447 451 return tmpl('branches', node=hex(web.repo.changelog.tip()),
448 452 entries=lambda **x: entries(0, **x),
449 453 latestentry=lambda **x: entries(1, **x))
450 454
451 455 def summary(web, req, tmpl):
452 456 i = web.repo.tagslist()
453 457 i.reverse()
454 458
455 459 def tagentries(**map):
456 460 parity = paritygen(web.stripecount)
457 461 count = 0
458 462 for k, n in i:
459 463 if k == "tip": # skip tip
460 464 continue
461 465
462 466 count += 1
463 467 if count > 10: # limit to 10 tags
464 468 break
465 469
466 470 yield tmpl("tagentry",
467 471 parity=parity.next(),
468 472 tag=k,
469 473 node=hex(n),
470 474 date=web.repo[n].date())
471 475
472 476 def bookmarks(**map):
473 477 parity = paritygen(web.stripecount)
474 478 b = web.repo._bookmarks.items()
475 479 for k, n in sorted(b)[:10]: # limit to 10 bookmarks
476 480 yield {'parity': parity.next(),
477 481 'bookmark': k,
478 482 'date': web.repo[n].date(),
479 483 'node': hex(n)}
480 484
481 485 def branches(**map):
482 486 parity = paritygen(web.stripecount)
483 487
484 488 b = web.repo.branchtags()
485 489 l = [(-web.repo.changelog.rev(n), n, t) for t, n in b.iteritems()]
486 490 for r, n, t in sorted(l):
487 491 yield {'parity': parity.next(),
488 492 'branch': t,
489 493 'node': hex(n),
490 494 'date': web.repo[n].date()}
491 495
492 496 def changelist(**map):
493 497 parity = paritygen(web.stripecount, offset=start - end)
494 498 l = [] # build a list in forward order for efficiency
495 499 for i in xrange(start, end):
496 500 ctx = web.repo[i]
497 501 n = ctx.node()
498 502 hn = hex(n)
499 503
500 504 l.insert(0, tmpl(
501 505 'shortlogentry',
502 506 parity=parity.next(),
503 507 author=ctx.user(),
504 508 desc=ctx.description(),
505 509 date=ctx.date(),
506 510 rev=i,
507 511 node=hn,
508 512 tags=webutil.nodetagsdict(web.repo, n),
509 513 bookmarks=webutil.nodebookmarksdict(web.repo, n),
510 514 inbranch=webutil.nodeinbranch(web.repo, ctx),
511 515 branches=webutil.nodebranchdict(web.repo, ctx)))
512 516
513 517 yield l
514 518
515 519 tip = web.repo['tip']
516 520 count = len(web.repo)
517 521 start = max(0, count - web.maxchanges)
518 522 end = min(count, start + web.maxchanges)
519 523
520 524 return tmpl("summary",
521 525 desc=web.config("web", "description", "unknown"),
522 526 owner=get_contact(web.config) or "unknown",
523 527 lastchange=tip.date(),
524 528 tags=tagentries,
525 529 bookmarks=bookmarks,
526 530 branches=branches,
527 531 shortlog=changelist,
528 532 node=tip.hex(),
529 533 archives=web.archivelist("tip"))
530 534
531 535 def filediff(web, req, tmpl):
532 536 fctx, ctx = None, None
533 537 try:
534 538 fctx = webutil.filectx(web.repo, req)
535 539 except LookupError:
536 540 ctx = webutil.changectx(web.repo, req)
537 541 path = webutil.cleanpath(web.repo, req.form['file'][0])
538 542 if path not in ctx.files():
539 543 raise
540 544
541 545 if fctx is not None:
542 546 n = fctx.node()
543 547 path = fctx.path()
544 548 else:
545 549 n = ctx.node()
546 550 # path already defined in except clause
547 551
548 552 parity = paritygen(web.stripecount)
549 553 style = web.config('web', 'style', 'paper')
550 554 if 'style' in req.form:
551 555 style = req.form['style'][0]
552 556
553 557 diffs = webutil.diffs(web.repo, tmpl, fctx or ctx, [path], parity, style)
554 558 rename = fctx and webutil.renamelink(fctx) or []
555 559 ctx = fctx and fctx or ctx
556 560 return tmpl("filediff",
557 561 file=path,
558 562 node=hex(n),
559 563 rev=ctx.rev(),
560 564 date=ctx.date(),
561 565 desc=ctx.description(),
562 566 author=ctx.user(),
563 567 rename=rename,
564 568 branch=webutil.nodebranchnodefault(ctx),
565 569 parent=webutil.parents(ctx),
566 570 child=webutil.children(ctx),
567 571 diff=diffs)
568 572
569 573 diff = filediff
570 574
571 575 def annotate(web, req, tmpl):
572 576 fctx = webutil.filectx(web.repo, req)
573 577 f = fctx.path()
574 578 parity = paritygen(web.stripecount)
575 579
576 580 def annotate(**map):
577 581 last = None
578 582 if binary(fctx.data()):
579 583 mt = (mimetypes.guess_type(fctx.path())[0]
580 584 or 'application/octet-stream')
581 585 lines = enumerate([((fctx.filectx(fctx.filerev()), 1),
582 586 '(binary:%s)' % mt)])
583 587 else:
584 588 lines = enumerate(fctx.annotate(follow=True, linenumber=True))
585 589 for lineno, ((f, targetline), l) in lines:
586 590 fnode = f.filenode()
587 591
588 592 if last != fnode:
589 593 last = fnode
590 594
591 595 yield {"parity": parity.next(),
592 596 "node": f.hex(),
593 597 "rev": f.rev(),
594 598 "author": f.user(),
595 599 "desc": f.description(),
596 600 "file": f.path(),
597 601 "targetline": targetline,
598 602 "line": l,
599 603 "lineid": "l%d" % (lineno + 1),
600 604 "linenumber": "% 6d" % (lineno + 1),
601 605 "revdate": f.date()}
602 606
603 607 return tmpl("fileannotate",
604 608 file=f,
605 609 annotate=annotate,
606 610 path=webutil.up(f),
607 611 rev=fctx.rev(),
608 612 node=fctx.hex(),
609 613 author=fctx.user(),
610 614 date=fctx.date(),
611 615 desc=fctx.description(),
612 616 rename=webutil.renamelink(fctx),
613 617 branch=webutil.nodebranchnodefault(fctx),
614 618 parent=webutil.parents(fctx),
615 619 child=webutil.children(fctx),
616 620 permissions=fctx.manifest().flags(f))
617 621
618 622 def filelog(web, req, tmpl):
619 623
620 624 try:
621 625 fctx = webutil.filectx(web.repo, req)
622 626 f = fctx.path()
623 627 fl = fctx.filelog()
624 628 except error.LookupError:
625 629 f = webutil.cleanpath(web.repo, req.form['file'][0])
626 630 fl = web.repo.file(f)
627 631 numrevs = len(fl)
628 632 if not numrevs: # file doesn't exist at all
629 633 raise
630 634 rev = webutil.changectx(web.repo, req).rev()
631 635 first = fl.linkrev(0)
632 636 if rev < first: # current rev is from before file existed
633 637 raise
634 638 frev = numrevs - 1
635 639 while fl.linkrev(frev) > rev:
636 640 frev -= 1
637 641 fctx = web.repo.filectx(f, fl.linkrev(frev))
638 642
639 643 revcount = web.maxshortchanges
640 644 if 'revcount' in req.form:
641 645 revcount = int(req.form.get('revcount', [revcount])[0])
642 646 revcount = max(revcount, 1)
643 647 tmpl.defaults['sessionvars']['revcount'] = revcount
644 648
645 649 lessvars = copy.copy(tmpl.defaults['sessionvars'])
646 650 lessvars['revcount'] = max(revcount / 2, 1)
647 651 morevars = copy.copy(tmpl.defaults['sessionvars'])
648 652 morevars['revcount'] = revcount * 2
649 653
650 654 count = fctx.filerev() + 1
651 655 start = max(0, fctx.filerev() - revcount + 1) # first rev on this page
652 656 end = min(count, start + revcount) # last rev on this page
653 657 parity = paritygen(web.stripecount, offset=start - end)
654 658
655 659 def entries(limit=0, **map):
656 660 l = []
657 661
658 662 repo = web.repo
659 663 for i in xrange(start, end):
660 664 iterfctx = fctx.filectx(i)
661 665
662 666 l.insert(0, {"parity": parity.next(),
663 667 "filerev": i,
664 668 "file": f,
665 669 "node": iterfctx.hex(),
666 670 "author": iterfctx.user(),
667 671 "date": iterfctx.date(),
668 672 "rename": webutil.renamelink(iterfctx),
669 673 "parent": webutil.parents(iterfctx),
670 674 "child": webutil.children(iterfctx),
671 675 "desc": iterfctx.description(),
672 676 "tags": webutil.nodetagsdict(repo, iterfctx.node()),
673 677 "bookmarks": webutil.nodebookmarksdict(
674 678 repo, iterfctx.node()),
675 679 "branch": webutil.nodebranchnodefault(iterfctx),
676 680 "inbranch": webutil.nodeinbranch(repo, iterfctx),
677 681 "branches": webutil.nodebranchdict(repo, iterfctx)})
678 682
679 683 if limit > 0:
680 684 l = l[:limit]
681 685
682 686 for e in l:
683 687 yield e
684 688
685 689 nodefunc = lambda x: fctx.filectx(fileid=x)
686 690 nav = webutil.revnavgen(end - 1, revcount, count, nodefunc)
687 691 return tmpl("filelog", file=f, node=fctx.hex(), nav=nav,
688 692 entries=lambda **x: entries(limit=0, **x),
689 693 latestentry=lambda **x: entries(limit=1, **x),
690 694 revcount=revcount, morevars=morevars, lessvars=lessvars)
691 695
692 696 def archive(web, req, tmpl):
693 697 type_ = req.form.get('type', [None])[0]
694 698 allowed = web.configlist("web", "allow_archive")
695 699 key = req.form['node'][0]
696 700
697 701 if type_ not in web.archives:
698 702 msg = 'Unsupported archive type: %s' % type_
699 703 raise ErrorResponse(HTTP_NOT_FOUND, msg)
700 704
701 705 if not ((type_ in allowed or
702 706 web.configbool("web", "allow" + type_, False))):
703 707 msg = 'Archive type not allowed: %s' % type_
704 708 raise ErrorResponse(HTTP_FORBIDDEN, msg)
705 709
706 710 reponame = re.sub(r"\W+", "-", os.path.basename(web.reponame))
707 711 cnode = web.repo.lookup(key)
708 712 arch_version = key
709 713 if cnode == key or key == 'tip':
710 714 arch_version = short(cnode)
711 715 name = "%s-%s" % (reponame, arch_version)
712 716 mimetype, artype, extension, encoding = web.archive_specs[type_]
713 717 headers = [
714 718 ('Content-Type', mimetype),
715 719 ('Content-Disposition', 'attachment; filename=%s%s' % (name, extension))
716 720 ]
717 721 if encoding:
718 722 headers.append(('Content-Encoding', encoding))
719 723 req.header(headers)
720 724 req.respond(HTTP_OK)
721 725 archival.archive(web.repo, req, cnode, artype, prefix=name)
722 726 return []
723 727
724 728
725 729 def static(web, req, tmpl):
726 730 fname = req.form['file'][0]
727 731 # a repo owner may set web.static in .hg/hgrc to get any file
728 732 # readable by the user running the CGI script
729 733 static = web.config("web", "static", None, untrusted=False)
730 734 if not static:
731 735 tp = web.templatepath or templater.templatepath()
732 736 if isinstance(tp, str):
733 737 tp = [tp]
734 738 static = [os.path.join(p, 'static') for p in tp]
735 739 return [staticfile(static, fname, req)]
736 740
737 741 def graph(web, req, tmpl):
738 742
739 743 rev = webutil.changectx(web.repo, req).rev()
740 744 bg_height = 39
741 745 revcount = web.maxshortchanges
742 746 if 'revcount' in req.form:
743 747 revcount = int(req.form.get('revcount', [revcount])[0])
744 748 revcount = max(revcount, 1)
745 749 tmpl.defaults['sessionvars']['revcount'] = revcount
746 750
747 751 lessvars = copy.copy(tmpl.defaults['sessionvars'])
748 752 lessvars['revcount'] = max(revcount / 2, 1)
749 753 morevars = copy.copy(tmpl.defaults['sessionvars'])
750 754 morevars['revcount'] = revcount * 2
751 755
752 756 max_rev = len(web.repo) - 1
753 757 revcount = min(max_rev, revcount)
754 758 revnode = web.repo.changelog.node(rev)
755 759 revnode_hex = hex(revnode)
756 760 uprev = min(max_rev, rev + revcount)
757 761 downrev = max(0, rev - revcount)
758 762 count = len(web.repo)
759 763 changenav = webutil.revnavgen(rev, revcount, count, web.repo.changectx)
760 764 startrev = rev
761 765 # if starting revision is less than 60 set it to uprev
762 766 if rev < web.maxshortchanges:
763 767 startrev = uprev
764 768
765 769 dag = graphmod.dagwalker(web.repo, range(startrev, downrev - 1, -1))
766 770 tree = list(graphmod.colored(dag))
767 771 canvasheight = (len(tree) + 1) * bg_height - 27
768 772 data = []
769 773 for (id, type, ctx, vtx, edges) in tree:
770 774 if type != graphmod.CHANGESET:
771 775 continue
772 776 node = str(ctx)
773 777 age = templatefilters.age(ctx.date())
774 778 desc = templatefilters.firstline(ctx.description())
775 779 desc = cgi.escape(templatefilters.nonempty(desc))
776 780 user = cgi.escape(templatefilters.person(ctx.user()))
777 781 branch = ctx.branch()
778 782 branch = branch, web.repo.branchtags().get(branch) == ctx.node()
779 783 data.append((node, vtx, edges, desc, user, age, branch, ctx.tags(),
780 784 ctx.bookmarks()))
781 785
782 786 return tmpl('graph', rev=rev, revcount=revcount, uprev=uprev,
783 787 lessvars=lessvars, morevars=morevars, downrev=downrev,
784 788 canvasheight=canvasheight, jsdata=data, bg_height=bg_height,
785 789 node=revnode_hex, changenav=changenav)
786 790
787 791 def _getdoc(e):
788 792 doc = e[0].__doc__
789 793 if doc:
790 794 doc = doc.split('\n')[0]
791 795 else:
792 796 doc = _('(no help text available)')
793 797 return doc
794 798
795 799 def help(web, req, tmpl):
796 800 from mercurial import commands # avoid cycle
797 801
798 802 topicname = req.form.get('node', [None])[0]
799 803 if not topicname:
800 804 def topics(**map):
801 805 for entries, summary, _ in helpmod.helptable:
802 806 entries = sorted(entries, key=len)
803 807 yield {'topic': entries[-1], 'summary': summary}
804 808
805 809 early, other = [], []
806 810 primary = lambda s: s.split('|')[0]
807 811 for c, e in commands.table.iteritems():
808 812 doc = _getdoc(e)
809 813 if 'DEPRECATED' in doc or c.startswith('debug'):
810 814 continue
811 815 cmd = primary(c)
812 816 if cmd.startswith('^'):
813 817 early.append((cmd[1:], doc))
814 818 else:
815 819 other.append((cmd, doc))
816 820
817 821 early.sort()
818 822 other.sort()
819 823
820 824 def earlycommands(**map):
821 825 for c, doc in early:
822 826 yield {'topic': c, 'summary': doc}
823 827
824 828 def othercommands(**map):
825 829 for c, doc in other:
826 830 yield {'topic': c, 'summary': doc}
827 831
828 832 return tmpl('helptopics', topics=topics, earlycommands=earlycommands,
829 833 othercommands=othercommands, title='Index')
830 834
831 835 u = webutil.wsgiui()
832 836 u.pushbuffer()
833 837 try:
834 838 commands.help_(u, topicname)
835 839 except error.UnknownCommand:
836 840 raise ErrorResponse(HTTP_NOT_FOUND)
837 841 doc = u.popbuffer()
838 842 return tmpl('help', topic=topicname, doc=doc)
@@ -1,35 +1,57
1 1 Test raw style of hgweb
2 2
3 3 $ hg init test
4 4 $ cd test
5 5 $ mkdir sub
6 6 $ cat >'sub/some "text".txt' <<ENDSOME
7 7 > This is just some random text
8 8 > that will go inside the file and take a few lines.
9 9 > It is very boring to read, but computers don't
10 10 > care about things like that.
11 11 > ENDSOME
12 12 $ hg add 'sub/some "text".txt'
13 13 warning: filename contains '"', which is reserved on Windows: 'sub/some "text".txt'
14 14 $ hg commit -d "1 0" -m "Just some text"
15 15
16 16 $ hg serve -p $HGPORT -A access.log -E error.log -d --pid-file=hg.pid
17 17
18 18 $ cat hg.pid >> $DAEMON_PIDS
19 19 $ ("$TESTDIR/get-with-headers.py" localhost:$HGPORT '/?f=a23bf1310f6e;file=sub/some%20%22text%22.txt;style=raw' content-type content-length content-disposition) >getoutput.txt &
20 20 $ sleep 5
21 21 $ kill `cat hg.pid`
22 22 $ sleep 1 # wait for server to scream and die
23 23 $ cat getoutput.txt
24 24 200 Script output follows
25 content-type: application/binary
26 content-length: 157
27 content-disposition: inline; filename="some \"text\".txt"
28
29 This is just some random text
30 that will go inside the file and take a few lines.
31 It is very boring to read, but computers don't
32 care about things like that.
33 $ cat access.log error.log
34 127.0.0.1 - - [*] "GET /?f=a23bf1310f6e;file=sub/some%20%22text%22.txt;style=raw HTTP/1.1" 200 - (glob)
35
36 $ rm access.log error.log
37 $ hg serve -p $HGPORT -A access.log -E error.log -d --pid-file=hg.pid \
38 > --config web.guessmime=True
39
40 $ cat hg.pid >> $DAEMON_PIDS
41 $ ("$TESTDIR/get-with-headers.py" localhost:$HGPORT '/?f=a23bf1310f6e;file=sub/some%20%22text%22.txt;style=raw' content-type content-length content-disposition) >getoutput.txt &
42 $ sleep 5
43 $ kill `cat hg.pid`
44 $ sleep 1 # wait for server to scream and die
45 $ cat getoutput.txt
46 200 Script output follows
25 47 content-type: text/plain; charset="ascii"
26 48 content-length: 157
27 49 content-disposition: inline; filename="some \"text\".txt"
28 50
29 51 This is just some random text
30 52 that will go inside the file and take a few lines.
31 53 It is very boring to read, but computers don't
32 54 care about things like that.
33 55 $ cat access.log error.log
34 56 127.0.0.1 - - [*] "GET /?f=a23bf1310f6e;file=sub/some%20%22text%22.txt;style=raw HTTP/1.1" 200 - (glob)
35 57
General Comments 0
You need to be logged in to leave comments. Login now