##// END OF EJS Templates
extensions: improve the consistency of synopses...
extensions: improve the consistency of synopses Trying as much as possible to consistently: - use a present tense predicate followed by a direct object - verb referring directly to the functionality provided (ie. not "add command that does this" but simple "do that") - keep simple and to the point, leaving details for the long help (width is tight, possibly even more so for translations) Thanks to timeless, Martin Geisler, Rafael Villar Burke, Dan Villiom Podlaski Christiansen and others for the helpful suggestions.

File last commit:

r8894:868670db default
r8894:868670db default
Show More
test-notify.out
219 lines | 5.5 KiB | text/plain | TextLexer
Cédric Duval
extensions: improve the consistency of synopses...
r8894 notify extension - send e-mail notifications for commits/pushes
Dirkjan Ochtman
tests: fix output for test-notify
r7132
Subscriptions can be managed through hgrc. Default mode is to print
messages to stdout, for testing and configuring.
To use, configure notify extension and enable in hgrc like this:
[extensions]
hgext.notify =
[hooks]
# one email for each incoming changeset
incoming.notify = python:hgext.notify.hook
# batch emails when many changesets incoming at one time
changegroup.notify = python:hgext.notify.hook
[notify]
# config items go in here
config items:
REQUIRED:
config = /path/to/file # file containing subscriptions
OPTIONAL:
test = True # print messages to stdout for testing
strip = 3 # number of slashes to strip for url paths
domain = example.com # domain to use if committer missing domain
style = ... # style file to use when formatting email
template = ... # template to use when formatting email
incoming = ... # template to use when run as incoming hook
changegroup = ... # template when run as changegroup hook
maxdiff = 300 # max lines of diffs to include (0=none, -1=all)
maxsubject = 67 # truncate subject line longer than this
diffstat = True # add a diffstat before the diff content
sources = serve # notify if source of incoming changes in this list
# (serve == ssh or http, push, pull, bundle)
[email]
from = user@host.com # email address to send as if none given
[web]
baseurl = http://hgserver/... # root of hg web site for browsing commits
notify config file has same format as regular hgrc. it has two
sections so you can express subscriptions in whatever way is handier
for you.
[usersubs]
# key is subscriber email, value is ","-separated list of glob patterns
user@host = pattern
[reposubs]
# key is glob pattern, value is ","-separated list of subscriber emails
pattern = user@host
Martin Geisler
expand "repo" to "repository" in help texts
r8027 glob patterns are matched against path to repository root.
Dirkjan Ochtman
tests: fix output for test-notify
r7132
Martin Geisler
notify, commands: word-wrap help strings
r8029 if you like, you can put notify config file in repository that users
can push changes to, they can manage their own subscriptions.
Benoit Boissinot
fix hg help <ext> for extension that do not define any command...
r4009
no commands defined
Matt Mackall
add test for the notify extension
r3740 % commit
adding a
% clone
Adrian Buehlmann
clone: print "updating working directory" status message...
r6338 updating working directory
Matt Mackall
add test for the notify extension
r3740 1 files updated, 0 files merged, 0 files removed, 0 files unresolved
% commit
Alexis S. L. Carvalho
notify: don't try to fix addresses if notify.domain is not set
r4094 % pull (minimal config)
pulling from ../a
searching for changes
adding changesets
adding manifests
adding file changes
added 1 changesets with 1 changes to 1 files
Christian Ebert
notify: mime-encode messages...
r7116 Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Mathieu Clabaut
Add sending date to notify message....
r4479 Date:
Alexis S. L. Carvalho
notify: don't try to fix addresses if notify.domain is not set
r4094 Subject: changeset in test-notify/b: b
From: test
X-Hg-Notification: changeset 0647d048b600
Message-Id:
To: baz, foo@bar
changeset 0647d048b600 in test-notify/b
details: test-notify/b?cmd=changeset;node=0647d048b600
Florent Guillaume
test-notify: make it pass on Mac OS X 10.5
r6359 description: b
Alexis S. L. Carvalho
notify: don't try to fix addresses if notify.domain is not set
r4094
diffs (6 lines):
diff -r cb9a9f314b8b -r 0647d048b600 a
--- a/a Thu Jan 01 00:00:00 1970 +0000
+++ b/a Thu Jan 01 00:00:01 1970 +0000
Matt Mackall
diff: don't show function name by default...
r5863 @@ -1,1 +1,2 @@
Alexis S. L. Carvalho
notify: don't try to fix addresses if notify.domain is not set
r4094 a
+a
(run 'hg update' to get a working copy)
Patrick Mezard
ui: make readsections() abort when configuration cannot be read.
r4517 % fail for config file is missing
rolling back last transaction
pull failed
Matt Mackall
add test for the notify extension
r3740 % pull
Alexis S. L. Carvalho
notify: don't try to fix addresses if notify.domain is not set
r4094 rolling back last transaction
Matt Mackall
add test for the notify extension
r3740 pulling from ../a
searching for changes
adding changesets
adding manifests
adding file changes
added 1 changesets with 1 changes to 1 files
Christian Ebert
notify: mime-encode messages...
r7116 Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Christian Ebert
notify: fix neglect of custom headers set via template...
r7673 X-Test: foo
Mathieu Clabaut
Add sending date to notify message....
r4479 Date:
Matt Mackall
add test for the notify extension
r3740 Subject: b
From: test@test.com
X-Hg-Notification: changeset 0647d048b600
Message-Id:
Alexis S. L. Carvalho
notify: don't try to fix addresses if notify.domain is not set
r4094 To: baz@test.com, foo@bar
Matt Mackall
add test for the notify extension
r3740
changeset 0647d048b600
description:
b
diffs (6 lines):
diff -r cb9a9f314b8b -r 0647d048b600 a
--- a/a Thu Jan 01 00:00:00 1970 +0000
+++ b/a Thu Jan 01 00:00:01 1970 +0000
Matt Mackall
diff: don't show function name by default...
r5863 @@ -1,1 +1,2 @@
Matt Mackall
add test for the notify extension
r3740 a
+a
(run 'hg update' to get a working copy)
Dirkjan Ochtman
tests: add some testing for patch.diffstat()
r7105 % pull
rolling back last transaction
pulling from ../a
searching for changes
adding changesets
adding manifests
adding file changes
added 1 changesets with 1 changes to 1 files
Christian Ebert
notify: mime-encode messages...
r7116 Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Christian Ebert
notify: fix neglect of custom headers set via template...
r7673 X-Test: foo
Dirkjan Ochtman
tests: add some testing for patch.diffstat()
r7105 Date:
Subject: b
From: test@test.com
X-Hg-Notification: changeset 0647d048b600
Message-Id:
To: baz@test.com, foo@bar
changeset 0647d048b600
description:
b
diffstat:
Alexander Solovyov
python implementation of diffstat...
r7547 a | 1 +
1 files changed, 1 insertions(+), 0 deletions(-)
Dirkjan Ochtman
tests: add some testing for patch.diffstat()
r7105
diffs (6 lines):
diff -r cb9a9f314b8b -r 0647d048b600 a
--- a/a Thu Jan 01 00:00:00 1970 +0000
+++ b/a Thu Jan 01 00:00:01 1970 +0000
@@ -1,1 +1,2 @@
a
+a
(run 'hg update' to get a working copy)
Patrick Mezard
diffstat: don't fail on merges...
r7664 % test merge
1 files updated, 0 files merged, 0 files removed, 0 files unresolved
created new head
0 files updated, 0 files merged, 0 files removed, 0 files unresolved
(branch merge, don't forget to commit)
pulling from ../a
searching for changes
adding changesets
adding manifests
adding file changes
added 2 changesets with 0 changes to 1 files
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Test: foo
Date:
Subject: adda2
From: test@test.com
X-Hg-Notification: changeset 0a184ce6067f
Message-Id:
To: baz@test.com, foo@bar
changeset 0a184ce6067f
description:
adda2
diffstat:
a | 1 +
1 files changed, 1 insertions(+), 0 deletions(-)
diffs (6 lines):
diff -r cb9a9f314b8b -r 0a184ce6067f a
--- a/a Thu Jan 01 00:00:00 1970 +0000
+++ b/a Thu Jan 01 00:00:02 1970 +0000
@@ -1,1 +1,2 @@
a
+a
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Test: foo
Date:
Subject: merge
From: test@test.com
X-Hg-Notification: changeset 22c88b85aa27
Message-Id:
To: baz@test.com, foo@bar
changeset 22c88b85aa27
description:
merge
(run 'hg update' to get a working copy)