Show More
@@ -1,4 +1,61 b'' | |||||
1 | notify extension - No help text available |
|
1 | notify extension - hook extension to email notifications on commits/pushes | |
|
2 | ||||
|
3 | Subscriptions can be managed through hgrc. Default mode is to print | |||
|
4 | messages to stdout, for testing and configuring. | |||
|
5 | ||||
|
6 | To use, configure notify extension and enable in hgrc like this: | |||
|
7 | ||||
|
8 | [extensions] | |||
|
9 | hgext.notify = | |||
|
10 | ||||
|
11 | [hooks] | |||
|
12 | # one email for each incoming changeset | |||
|
13 | incoming.notify = python:hgext.notify.hook | |||
|
14 | # batch emails when many changesets incoming at one time | |||
|
15 | changegroup.notify = python:hgext.notify.hook | |||
|
16 | ||||
|
17 | [notify] | |||
|
18 | # config items go in here | |||
|
19 | ||||
|
20 | config items: | |||
|
21 | ||||
|
22 | REQUIRED: | |||
|
23 | config = /path/to/file # file containing subscriptions | |||
|
24 | ||||
|
25 | OPTIONAL: | |||
|
26 | test = True # print messages to stdout for testing | |||
|
27 | strip = 3 # number of slashes to strip for url paths | |||
|
28 | domain = example.com # domain to use if committer missing domain | |||
|
29 | style = ... # style file to use when formatting email | |||
|
30 | template = ... # template to use when formatting email | |||
|
31 | incoming = ... # template to use when run as incoming hook | |||
|
32 | changegroup = ... # template when run as changegroup hook | |||
|
33 | maxdiff = 300 # max lines of diffs to include (0=none, -1=all) | |||
|
34 | maxsubject = 67 # truncate subject line longer than this | |||
|
35 | diffstat = True # add a diffstat before the diff content | |||
|
36 | sources = serve # notify if source of incoming changes in this list | |||
|
37 | # (serve == ssh or http, push, pull, bundle) | |||
|
38 | [email] | |||
|
39 | from = user@host.com # email address to send as if none given | |||
|
40 | [web] | |||
|
41 | baseurl = http://hgserver/... # root of hg web site for browsing commits | |||
|
42 | ||||
|
43 | notify config file has same format as regular hgrc. it has two | |||
|
44 | sections so you can express subscriptions in whatever way is handier | |||
|
45 | for you. | |||
|
46 | ||||
|
47 | [usersubs] | |||
|
48 | # key is subscriber email, value is ","-separated list of glob patterns | |||
|
49 | user@host = pattern | |||
|
50 | ||||
|
51 | [reposubs] | |||
|
52 | # key is glob pattern, value is ","-separated list of subscriber emails | |||
|
53 | pattern = user@host | |||
|
54 | ||||
|
55 | glob patterns are matched against path to repo root. | |||
|
56 | ||||
|
57 | if you like, you can put notify config file in repo that users can | |||
|
58 | push changes to, they can manage their own subscriptions. | |||
2 |
|
59 | |||
3 | no commands defined |
|
60 | no commands defined | |
4 | % commit |
|
61 | % commit |
General Comments 0
You need to be logged in to leave comments.
Login now