1 #
2 # Copyright (c) 2001 Bizar Software Pty Ltd (http://www.bizarsoftware.com.au/)
3 # This module is free software, and you may redistribute it and/or modify
4 # under the same terms as Python, so long as this copyright message and
5 # disclaimer are retained in their original form.
6 #
7 # IN NO EVENT SHALL BIZAR SOFTWARE PTY LTD BE LIABLE TO ANY PARTY FOR
8 # DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING
9 # OUT OF THE USE OF THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
10 # POSSIBILITY OF SUCH DAMAGE.
11 #
12 # BIZAR SOFTWARE PTY LTD SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
13 # BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
14 # FOR A PARTICULAR PURPOSE. THE CODE PROVIDED HEREUNDER IS ON AN "AS IS"
15 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
16 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
17 #
18 # $Id: instance_config.py,v 1.16 2002-05-21 06:05:54 richard Exp $
20 MAIL_DOMAIN=MAILHOST=HTTP_HOST=None
21 HTTP_PORT=0
23 try:
24 from localconfig import *
25 except ImportError:
26 localconfig = None
28 import os
30 # roundup home is this package's directory
31 INSTANCE_HOME=os.path.split(__file__)[0]
33 # The SMTP mail host that roundup will use to send mail
34 if not MAILHOST:
35 MAILHOST = 'localhost'
37 # The domain name used for email addresses.
38 if not MAIL_DOMAIN:
39 MAIL_DOMAIN = 'fill.me.in.'
41 # the next two are only used for the standalone HTTP server.
42 if not HTTP_HOST:
43 HTTP_HOST = ''
44 if not HTTP_PORT:
45 HTTP_PORT = 9080
47 # This is the directory that the database is going to be stored in
48 DATABASE = os.path.join(INSTANCE_HOME, 'db')
50 # This is the directory that the HTML templates reside in
51 TEMPLATES = os.path.join(INSTANCE_HOME, 'html')
53 # A descriptive name for your roundup instance
54 INSTANCE_NAME = 'Roundup issue tracker'
56 # The email address that mail to roundup should go to
57 ISSUE_TRACKER_EMAIL = 'issue_tracker@%s'%MAIL_DOMAIN
59 # The web address that the instance is viewable at
60 ISSUE_TRACKER_WEB = 'http://some.useful.url/'
62 # The email address that roundup will complain to if it runs into trouble
63 ADMIN_EMAIL = 'roundup-admin@%s'%MAIL_DOMAIN
65 # Somewhere for roundup to log stuff internally sent to stdout or stderr
66 LOG = os.path.join(INSTANCE_HOME, 'roundup.log')
68 # Where to place the web filtering HTML on the index page
69 FILTER_POSITION = 'bottom' # one of 'top', 'bottom', 'top and bottom'
71 # Deny or allow anonymous access to the web interface
72 ANONYMOUS_ACCESS = 'deny' # either 'deny' or 'allow'
74 # Deny or allow anonymous users to register through the web interface
75 ANONYMOUS_REGISTER = 'deny' # either 'deny' or 'allow'
77 # Deny or allow anonymous users to register through the mail interface
78 ANONYMOUS_REGISTER_MAIL = 'deny' # either 'deny' or 'allow'
80 # Send nosy messages to the author of the message
81 MESSAGES_TO_AUTHOR = 'no' # either 'yes' or 'no'
83 # Does the author of a message get placed on the nosy list automatically?
84 # If 'new' is used, then the author will only be added when a message
85 # creates a new issue. If 'yes', then the author will be added on followups
86 # too. If 'no', they're never added to the nosy.
87 ADD_AUTHOR_TO_NOSY = 'new' # one of 'yes', 'no', 'new'
89 # Do the recipients (To:, Cc:) of a message get placed on the nosy list?
90 # If 'new' is used, then the recipients will only be added when a message
91 # creates a new issue. If 'yes', then the recipients will be added on followups
92 # too. If 'no', they're never added to the nosy.
93 ADD_RECIPIENTS_TO_NOSY = 'new' # either 'yes', 'no', 'new'
95 # Where to place the email signature
96 EMAIL_SIGNATURE_POSITION = 'bottom' # one of 'top', 'bottom', 'none'
98 # Keep email citations
99 EMAIL_KEEP_QUOTED_TEXT = 'no' # either 'yes' or 'no'
101 # Preserve the email body as is
102 EMAIL_LEAVE_BODY_UNCHANGED = 'no' # either 'yes' or 'no'
104 # Default class to use in the mailgw if one isn't supplied in email
105 # subjects. To disable, comment out the variable below or leave it blank.
106 # Examples:
107 MAIL_DEFAULT_CLASS = 'issue' # use "issue" class by default
108 #MAIL_DEFAULT_CLASS = '' # disable (or just comment the var out)
110 # Define what index links are available in the header, and what their
111 # labels are. Each key is used to look up one of the index specifications
112 # below - so 'DEFAULT' will use 'DEFAULT_INDEX'.
113 # Where the FILTERSPEC has 'assignedto' with a value of None, it will be
114 # replaced by the id of the logged-in user.
115 HEADER_INDEX_LINKS = ['DEFAULT', 'UNASSIGNED', 'USER']
117 # list the classes that users are able to add nodes to
118 HEADER_ADD_LINKS = ['issue']
120 # Now the DEFAULT display specification. TODO: describe format
121 DEFAULT_INDEX = {
122 'LABEL': 'All Issues',
123 'CLASS': 'issue',
124 'SORT': ['-activity'],
125 'GROUP': ['priority'],
126 'FILTER': ['status'],
127 'COLUMNS': ['id','activity','title','creator','assignedto'],
128 'FILTERSPEC': {
129 'status': ['-1', '1', '2', '3', '4', '5', '6', '7'],
130 },
131 }
133 # The "unsassigned issues" index
134 UNASSIGNED_INDEX = {
135 'LABEL': 'Unassigned Issues',
136 'CLASS': 'issue',
137 'SORT': ['-activity'],
138 'GROUP': ['priority'],
139 'FILTER': ['status', 'assignedto'],
140 'COLUMNS': ['id','activity','title','creator','status'],
141 'FILTERSPEC': {
142 'status': ['-1', '1', '2', '3', '4', '5', '6', '7'],
143 'assignedto': ['-1'],
144 },
145 }
147 # The "my issues" index -- note that the user's id will replace the
148 # 'CURRENT USER' value of the "assignedto" filterspec
149 USER_INDEX = {
150 'LABEL': 'My Issues',
151 'CLASS': 'issue',
152 'SORT': ['-activity'],
153 'GROUP': ['priority'],
154 'FILTER': ['status', 'assignedto'],
155 'COLUMNS': ['id','activity','title','creator','status'],
156 'FILTERSPEC': {
157 'status': ['-1', '1', '2', '3', '4', '5', '6', '7'],
158 'assignedto': 'CURRENT USER',
159 },
160 }
163 #
164 # $Log: not supported by cvs2svn $
165 # Revision 1.15 2002/05/02 07:56:34 richard
166 # . added option to automatically add the authors and recipients of messages
167 # to the nosy lists with the options ADD_AUTHOR_TO_NOSY (default 'new') and
168 # ADD_RECIPIENTS_TO_NOSY (default 'new'). These settings emulate the current
169 # behaviour. Setting them to 'yes' will add the author/recipients to the nosy
170 # on messages that create issues and followup messages.
171 # . added missing documentation for a few of the config option values
172 #
173 # Revision 1.14 2002/04/23 15:46:49 rochecompaan
174 # . stripping of the email message body can now be controlled through
175 # the config variables EMAIL_KEEP_QUOTED_TEST and
176 # EMAIL_LEAVE_BODY_UNCHANGED.
177 #
178 # Revision 1.13 2002/03/14 23:59:24 richard
179 # . #517734 ] web header customisation is obscure
180 #
181 # Revision 1.12 2002/02/15 00:13:38 richard
182 # . #503204 ] mailgw needs a default class
183 # - partially done - the setting of additional properties can wait for a
184 # better configuration system.
185 #
186 # Revision 1.11 2002/02/14 23:46:02 richard
187 # . #516883 ] mail interface + ANONYMOUS_REGISTER
188 #
189 # Revision 1.10 2001/11/26 22:55:56 richard
190 # Feature:
191 # . Added INSTANCE_NAME to configuration - used in web and email to identify
192 # the instance.
193 # . Added EMAIL_SIGNATURE_POSITION to indicate where to place the roundup
194 # signature info in e-mails.
195 # . Some more flexibility in the mail gateway and more error handling.
196 # . Login now takes you to the page you back to the were denied access to.
197 #
198 # Fixed:
199 # . Lots of bugs, thanks Roché and others on the devel mailing list!
200 #
201 # Revision 1.9 2001/10/30 00:54:45 richard
202 # Features:
203 # . #467129 ] Lossage when username=e-mail-address
204 # . #473123 ] Change message generation for author
205 # . MailGW now moves 'resolved' to 'chatting' on receiving e-mail for an issue.
206 #
207 # Revision 1.8 2001/10/23 01:00:18 richard
208 # Re-enabled login and registration access after lopping them off via
209 # disabling access for anonymous users.
210 # Major re-org of the htmltemplate code, cleaning it up significantly. Fixed
211 # a couple of bugs while I was there. Probably introduced a couple, but
212 # things seem to work OK at the moment.
213 #
214 # Revision 1.7 2001/10/22 03:25:01 richard
215 # Added configuration for:
216 # . anonymous user access and registration (deny/allow)
217 # . filter "widget" location on index page (top, bottom, both)
218 # Updated some documentation.
219 #
220 # Revision 1.6 2001/10/01 06:10:42 richard
221 # stop people setting up roundup with our addresses as default - need to
222 # handle this better in the init
223 #
224 # Revision 1.5 2001/08/07 00:24:43 richard
225 # stupid typo
226 #
227 # Revision 1.4 2001/08/07 00:15:51 richard
228 # Added the copyright/license notice to (nearly) all files at request of
229 # Bizar Software.
230 #
231 # Revision 1.3 2001/08/02 06:38:17 richard
232 # Roundupdb now appends "mailing list" information to its messages which
233 # include the e-mail address and web interface address. Templates may
234 # override this in their db classes to include specific information (support
235 # instructions, etc).
236 #
237 # Revision 1.2 2001/07/29 07:01:39 richard
238 # Added vim command to all source so that we don't get no steenkin' tabs :)
239 #
240 # Revision 1.1 2001/07/23 23:28:43 richard
241 # Adding the classic template
242 #
243 # Revision 1.1 2001/07/23 04:33:21 anthonybaxter
244 # split __init__.py into 2. dbinit and instance_config.
245 #
246 #
247 # vim: set filetype=python ts=4 sw=4 et si