code-513942bca8d2/share/man/man1/roundup-admin.10000644000000000000000000003051214727466072017244 0ustar 00000000000000.TH ROUNDUP-ADMIN 1 "24 January 2003" .SH NAME roundup-admin \- administrate roundup trackers .SH SYNOPSIS \fBroundup-admin\fP [\fIoptions\fP] \fI\fP \fI\fP .SH OPTIONS .TP \fB-i\fP \fIinstance home\fP Specify the issue tracker "home directory" to administer .TP \fB-u\fP \fIuser\fP[\fB:\fP\fIpassword\fP] The user and password to use for commands (partial implemention, see Security Notes below). .TP \fB-h\fP Print help text. .TP \fB-d\fP Print full designators (e.g. issue1) not just id numbers (1). .TP \fB-c\fP When outputting lists of data, comma-separate them. Same as \fB-S ","\fP. .TP \fB-S\fP \fIstring\fP When outputting lists of data, separate items with given string. .TP \fB-s\fP When outputting lists of data, space-separate them. Same as \fB-S " "\fP. .TP \fB-P pragma=value\fP Set a pragma on the command line. Multiple \fB-P\fP options can be specified to set multiple pragmas. .TP \fB-V\fP Be verbose when importing data. .TP \fB-v\fP Report Roundup and Python versions and quit. .PP Only one of \fB-s\fP, \fB-c\fP or \fB-S\fP can be specified. .SH COMMANDS If no command is provided on the command line, roundup-admin will enter an interactive mode. More details about these commands are available using the help command. A designator is a classname and a nodeid concatenated, eg. bug1, user10, .... Roundup-admin takes a number of commands: .TP \fBhelp\fP prints help (same as \fB-h\fP) .TP \fBhelp\fP \fI\fP Print command-specific help .TP \fBhelp all\fP Print available help for all commands. .TP \fBcommit\fP Commit changes made to the database during an interactive session. The changes made during an interactive session are not automatically written to the database - they must be committed using this command. One-off commands on the command-line are automatically committed if they are successful. See also rollback. .TP \fBcreate\fP \fIclassname property=value ...\fP This creates a new entry of the given class using the property name=value arguments provided on the command line after the "create" command. .TP \fBdisplay\fP \fIdesignator[,designator]*\fP This lists the properties and their associated values for the given node. The pragma \fBdisplay_header\fP can be used to add a header between designators that includes the active/retired status of the item. .TP \fBexport\fP \fI[[-]class[,class]] export_dir\fP Export the database to colon-separated-value files. To exclude the files (e.g. for the msg or file class), use the exporttables command. Optionally limit the export to just the named classes or exclude the named classes, if the 1st argument starts with '-'. This action exports the current data from the database into colon-separated-value files that are placed in the nominated destination directory. .TP \fBexporttables\fP \fI[[-]class[,class]] export_dir\fP Export the database to colon-separated-value files, excluding the files below $TRACKER_HOME/db/files/ (which can be archived separately). To include the files, use the export command. .TP \fBfilter\fP \fIclassname propname=value ...\fP Find the nodes of the given class with a given property value. Multiple values can be specified by separating them with commas. If property is a string, all values must match. I.E. it's an 'and' operation. If the property is a link/multilink any value matches. I.E. an 'or' operation. .TP \fBfind\fP \fIclassname propname=value ...\fP Find the nodes of the given class with a given link property value. .TP \fBgenconfig\fP \fI\fP Generate a new tracker config file (ini style) with default values in \fI\fP. Note that this does not preserve any settings from the current tracker. Use updateconfig for that. .TP \fBget\fP \fIproperty designator[,designator]*\fP Get the given property of one or more designator(s). Retrieves the property value of the nodes specified by the designators. .TP \fBhistory\fP \fIdesignator [skipquiet] [raw]\fP Lists the journal entries viewable by the user for the node identified by the designator. If skipquiet is added, journal entries for quiet properties are not shown. Without the raw option a more human readable output format is used. .TP \fBimport\fP \fIimport_dir\fP Import a database from the directory containing CSV files, two per class to import. The imported nodes will have the same nodeid as defined in the import file, thus replacing any existing content. The new nodes are added to the existing database - if you want to create a new database using the imported data, then create a new database (or, tediously, retire all the old data). See also export. .TP \fBimporttables\fP \fIimport_dir\fP Import a database from the directory containing CSV files, two per class to import. The imported nodes will have the same nodeid as defined in the import file, thus replacing any existing content. This only imports database tables. It does not import files/message content. It is used to import data exported by exporttables. See also exporttables. .TP \fBinitialise\fP \fI[adminpw]\fP Initialise a new Roundup tracker. The administrator details will be set at this step. .TP \fBinstall\fP \fI[template [backend [key=val[,key=val]]]]\fP Install a new roundup tracker. The command will prompt for the tracker home directory (if not supplied through TRACKER_HOME or the -i option). The template and backend may be specified on the command-line as arguments, in that order. Command line arguments following the backend allows you to pass initial values for config options. For example, passing "web_http_auth=no,rdbms_user=dinsdale" will override defaults for options http_auth in section [web] and user in section [rdbms]. Please be careful to not use spaces in this argument! (Enclose whole argument in quotes if you need spaces in option value). The initialise command must be called after this command in order to initialise the tracker's database. You may edit the tracker's initial database contents before running that command by editing the tracker's dbinit.py module init() function. See also initopts help. .TP \fBlist\fP \fIclassname [property]\fP Lists all instances of the given class. If the property is not specified, the "label" property is used. The label property is tried in order: the key, "name", "title" and then the first property, alphabetically. With \fB-c\fP, \fB-S\fP or \fB-s\fP print a list of item id's if no property specified. If property specified, print list of that property for every class instance. The pragma \fBshow_retired\fP can be used to print only retired items or to print retired and active items. The default is to print only active items. .TP \fBmigrate\fP Update a tracker's database to be compatible with the Roundup codebase. You should run the "migrate" command for your tracker once you've installed the latest codebase. Do this before you use the web, command-line or mail interface and before any users access the tracker. This command will respond with either "Tracker updated" (if you've not previously run it on an RDBMS backend) or "No migration action required" (if you have run it, or have used another interface to the tracker, or possibly because you are using anydbm). It's safe to run this even if it's not required, so just get into the habit. .TP \fBpack\fP \fIperiod | date\fP Remove journal entries older than a period of time specified or before a certain date. .TP \fBperftest\fP \fI[mode] [arguments]*\fP Run performance test. For example test the effect of changing password hashing parameters. .TP \fBpragma\fP \fIsetting=value\fP|\fBlist\fP Set internal settings to a value. E.G. pragma verbose=True pragma verbose=yes pragma verbose=on pragma verbose=1 will turn on verbose mode for roundup-admin. pragma list will show all settings and their current values. If verbose is enabled hidden settings and descriptions will be shown. .TP \fBreindex\fP \fI[classname|classname:#-#|designator]*\fP This will re-generate the search indexes for a tracker. You can specify a specific item (or items) (e.g. issue23), range(s) of items (e.g. issue:1-1000), class(es) (e.g. issue) or reindex all items in the database if no arguments are supplied. .TP \fBrestore\fP \fIdesignator[,designator]*\fP Restore the retired node specified by designator. The given nodes will become available for users again. .TP \fBretire\fP \fIdesignator[,designator]*\fP This action indicates that a particular node is not to be retrieved by the list or find commands, and its key value may be re-used. See also restore. .TP \fBrollback\fP Undo all changes that are pending commit to the database. The changes made during an interactive session are not automatically written to the database - they must be committed manually. This command undoes all those changes, so a commit immediately after would make no changes to the database. .TP \fBsecurity\fP \fI[Role name]\fP Display the Permissions available to one or all Roles. .TP \fBset\fP \fIitems property=value property=value ...\fP Set the given properties of one or more items(s). The items are specified as a class or as a comma-separated list of item designators (ie "designator[,designator,...]"). This command sets the properties to the values for all designators given. If the value is missing (ie. "property=") then the property is un-set. If the property is a multilink, you specify the linked ids for the multilink as comma-separated numbers (ie "1,2,3"). .TP \fBspecification\fP \fIclassname\fP Show the properties for a classname. .TP \fBtemplates\fP \fI[trace_search]]\fP Lists the names, location and description of all known templates. .TP \fBtable\fP \fIclassname [property[,property]*]\fP Lists all instances of the given class. If the properties are not specified, all properties are displayed. By default, the column widths are the width of the largest value. The pragma \fBshow_retired\fP can be used to print only retired items or to print retired and active items. The default is to print only active items. .TP \fBupdateconfig\fP \fI\fP This is used when updating software. It merges the \fBconfig.ini\fP from the tracker with new settings from the new software. The merged/updated config file is written to \fI\fP. .PP Commands may be abbreviated as long as the abbreviation matches only one command, e.g. l == li == lis == list. .SH READLINE SUPPORT You can edit the command line and interact with history in roundup-admin's interactive mode. On Linux like systems, GNU Readline is required. On Mac's libedit can be used as well. On Windows pyreadline3 is required. See: https://docs.python.org/3/library/readline.html for details on readline. Roundup-admin will save the history between roundup-admin sessions. The commands are saved to the \fB.roundup_admin_history\fP file in the user's home directory. You can set the pragma \fBhistory_length\fP on the roundup-admin command line to change the amount of available and stored history for the session. If you are using GNU readline, you can persistently change the history size by adding: \fBset history-size 100\fP to the init file \fB.roundup_admin_rlrc\fP located in the user's home directory. Mac users using libedit should be able to persistently save history and set the history size by adding \fBhistory size 100\fP. Users of pyreadline3 can use: \fBhistory_length(100)\fP. .SH SECURITY NOTES The \fB-u user\fP setting does not currently operate like a user logging in via the web. The user running roundup-admin must have read access to the tracker home directory. As a result the user has access to the files and the database info contained in config.ini. Using \fB-u user\fP sets the actor/user parameter in the journal. Changes that are made are attributed to that user. The password is ignored if provided. Any existing username has full access to the data just like the admin user. This is an area for further development so that roundup-admin could be used with sudo to provide secure command line access to a tracker. .SH ENVIRONMENT VARIABLES .TP \fBROUNDUP_LOGIN\fP Provides an alternate way to set the user. .SH FURTHER HELP roundup-admin -h roundup-admin help -- this help roundup-admin help -- command-specific help roundup-admin help all -- all available help .SH SEE ALSO roundup-demo(1), roundup-mailgw(1), roundup-server(1) .SH AUTHOR This manpage was written by Bastian Kleineidam for the Debian distribution of roundup. The main author of roundup is Richard Jones . code-513942bca8d2/share/man/man1/roundup-demo.10000644000000000000000000000704414727466072017104 0ustar 00000000000000.TH ROUNDUP-DEMO 1 "27 July 2004" .SH NAME roundup-demo \- create a roundup "demo" tracker and launch its web interface .SH SYNOPSIS \fBroundup_demo\fP [\fB\-h\fP] [\fB-b\fP \fIBIND_ADDRESS\fP] [\fB-b\fP {\fBanydbm\fP,\fBmysql\fP,\fBsqlite\fP,\fBpostgresql\fP}] [\fB-t\fb {\fBminimal\fP,\fBjinja2\fP,\fBclassic\fP,\fBresponsive\fP,\fBdevel\fP}] [\fB-p\fP \fIPORT\fP] [\fB-P\fP \fIURLPORT\fP] [\fB-V\fP] [\fIdirectory\fP] [\fIbackend\fP] [\fBnuke\fP] .SH OPTIONS .TP \fIdirectory\fP The home directory for the new demo tracker. (*) .TP \fIbackend\fP Choose backend database. Depricated, use \fB-b\fP. .TP \fBnuke\fP Create a fresh demo tracker (deleting the existing one if any). E.G. .EX roundup-demo -b sqlite -t classic ./mytracker nuke .EE will remove an existing tracker (if present) from the directory \fB./mytracker\fP. Then it will create and serve a new empty classic tracker using the sqlite backend. .TP \fB-h\fP, \fB--help\fP Show the help message and exit .TP \fB-B\fp \fIBIND_ADDRESS\fI, \fB--bind_address\fP \fIBIND_ADDRESS\fP Choose address for server to listen at. Use 0.0.0.0 to bind to all addreses. Default: 127.0.0.1. .TP \fB-b\fP {\fBanydbm\fP,\fBmysql\fP,\fBsqlite\fP,\fBpostgresql\fP}, \ \fB--backend_db\fP {\fBanydbm\fP,\fBmysql\fP,\fBsqlite\fP,\fBpostgresql\fP} Choose backend database. Default: sqlite. Available backends are subject to availability on your system. .TP \fB-t\fP \ {\fBminimal\fP,\fBjinja2\fP,\fBclassic\fP,\fBresponsive\fP,\fBdevel\fP}, \ \fP--template\fB \ {\fBminimal\fP,\fBjinja2\fP,\fBclassic\fP,\fBresponsive\fP,\fBdevel\fP} Use specified template when building tracker. (*) .TP \fB-h\fP \fIHOSTNAME\fP, \fB--hostname\fP \fIHOSTNAME\fP Set the hostname used in the URL. This does not make the server listen at the hostname. Use the hostname with \fB-B\fP to listen on that IP address. .TP \fB-p\fP \fIPORT\fP, \fB--port\fP \fIPORT\fP Listen at this port. Default: search for open port starting at 8917. .TP \fB-P\fP \fIURLPORT\fP, \fB--urlport\fP \fIURLPORT\fP When using docker this option passes the docker external port to the demo instance. If using \fBdocker ... -p 9090:8917 ...\fP this should be set to \fB-P 9090\fP. Default: as selected by \fB--port\fP. .TP \fB-V\fP, \fB--version\fP Show program's version number and exit .PP If items marked with (*) are missing, they will be asked for interactively when setting up the tracker. .SH DESCRIPTION This command creates a fresh demo tracker for you to experiment with. The email features of Roundup will be turned off (so the nosy feature won't send email). It does this by removing the \fBnosyreaction.py\fP module from the demo tracker's \fIdetectors\fP directory. If you wish to send email to promote the tracker to production, you will need to copy \fBnosyreaction.py\fP from the default tracker templates directory. The \fBtemplates\fP command from roundup-admin(1) can help you locate a replacement. If you wish, you may modify the demo tracker by editing its configuration files and HTML templates. See the \fIcustomisation\fP manual for information about how to do that. Once you've fiddled with the demo tracker, you may use it as a template for creating your real, live tracker. Simply run the \fIroundup-admin\fP command to install the tracker from inside the demo tracker home directory, and it will be listed as an available template for installation. No data will be copied over. .SH SEE ALSO roundup-admin(1), roundup-mailgw(1), roundup-server(1) .SH AUTHOR This manpage was written by Richard Jones and extensively modified by John Rouillard . code-513942bca8d2/share/man/man1/roundup-mailgw.10000644000000000000000000001524014727466072017435 0ustar 00000000000000.TH ROUNDUP-MAILGW 1 "27 October 2022" .SH NAME roundup-mailgw \- mail gateway for roundup .SH SYNOPSIS \fBroundup-mailgw\fP [\fI-h|--help] [\fI-v\fP] [\fI--version\fP] [\fI-c|--default-class\fP \fIdefault_class\fP] [\fI-S|--set-value\fP \fI[class.]field=value\fP] [\fI-O|--oauth-directory\fP \fIdirectory\fP] [\fI-T|--oauth-token-endpoint\fP \fIendpoint-url\fP] [\fIinstance_home\fP] [\fImail source [specification]\fP] .SH OPTIONS .TP \fB-v\fP \fB--version\fP Print version and exit. .TP \fB-c\fP \fB--default-class\fP \fIhyperdb class\fP specify the default tracker class - one of issue (the default), msg, file, user etc. Overrides the tracker's mailgw \fIdefault_class\fP setting. .TP \fB-S\fP \fB--set-value\fP \fI[class.]property\fP\fB=\fP\fIvalue\fP[\fB;\fP\fIproperty\fP\fB=\fP\fIvalue\fP] specify the values to set on the class specified as prefix using the same format as the Subject line property manipulations. If the class prefix is left out it defaults to \fImsg\fP. Can also be specified with \fB--set-value\fP (and abbreviated to \fB--set\fP). .TP \fB-O\fP \fB--oauth-directory\fP \fIdirectory\fP Only with OAuth authentication specify the directory containing additional OAuth credentials. .TP \fB-T\fP \fB--oauth-token-endpoint\fP \fIurl\fP Token endpoint URL of your cloud provider, only used with OAuth. .SH DESCRIPTION The roundup mail gateway may be called in one of four ways: .IP \(bu without arguments which will use the env var ROUNDUP_INSTANCE, .IP \(bu with an \fIinstance_home\fP as the only argument, .IP \(bu with both an \fIinstance_home\fP and a mail spool file, or .IP \(bu with both an instance home and a mail source type and its specification. .PP \fBPIPE\fP .br If there is no mail source specified, the mail gateway reads a single message from the standard input and submits the message to the roundup.mailgw module. \fBUNIX mailbox\fP .br In this case, the gateway reads all messages from the UNIX mail spool file and submits each in turn to the roundup.mailgw module. The file is emptied once all messages have been successfully handled. The file is specified as: \fBmailbox\fP \fI/path/to/mailbox\fP In all of the following mail source types, the username and password can be stored in a ~/.netrc file. If done so, only the server name needs to be specified on the command-line. The username and/or password will be prompted for if not supplied on the command-line or in ~/.netrc. \fBPOP\fP .br For the mail source "pop", the gateway reads all messages from the POP server specified and submits each in turn to the roundup.mailgw module. The server is specified as: \fBpop\fP \fIusername\fP\fB:\fP\fIpassword\fP\fB@\fP\fIserver\fP .br The username and password may be omitted: \fBpop\fP \fIusername\fP\fB@\fP\fIserver\fP \fBpop\fP \fIserver\fP .br are both valid. \fBPOPS\fP .br Connect to the POP server over ssl/tls. This supports the same notation as POP. \fBAPOP\fP .br Same as POP, but using Authenticated POP: \fBapop\fP \fIusername\fP\fB:\fP\fIpassword\fP\fB@\fP\fIserver\fP \fBIMAP\fP .br Connect to an IMAP server. This supports the same notation as that of POP mail. \fBimap\fP \fIusername\fP\fB:\fP\fIpassword\fP\fB@\fP\fIserver\fP .br It also allows you to specify a specific mailbox other than INBOX using this format: \fBimap\fP \fIusername\fP\fB:\fP\fIpassword\fP\fB@\fP\fIserver mailbox\fP \fBIMAPS\fP .br Connect to an IMAP server over ssl/tls. This supports the same notation as IMAP. \fBimaps\fP \fIusername\fP\fB:\fP\fIpassword\fP\fB@\fP\fIserver\fP [\fImailbox\fP] \fBIMAPS_CRAM\fP .br Connect to an IMAP server over ssl/tls using CRAM-MD5 authentication. This supports the same notation as IMAP. \fBimaps_cram\fP \fIusername\fP\fB:\fP\fIpassword\fP\fB@\fP\fIserver\fP [\fImailbox\fP] \fBIMAPS_OAUTH\fP .br Connect to an IMAP server over ssl/tls using OAUTH authentication. Note that this does not support a password in imaps URLs. Instead it uses only the user and server and a command-line option for the directory with the files \fBaccess_token\fP, \fBrefresh_token\fP, \fBclient_secret\fP, and \fBclient_id\fP. By default this directory is \fBoauth\fP in your tracker home directory. The access token is tried first and, if expired, the refresh token together with the client secret is used to retrieve a new access token. Note that both token files need to be \fIwriteable\fP, the access token is continuously replaced and some cloud providers may also renew the refresh token from time to time: \fBimaps_oauth\fP \fIusername\fP\fB@\fP\fIserver\fP [\fImailbox\fP] .br The refresh and access tokens (the latter can be left empty), the client id and the client secret need to be retrieved via cloud provider specific protocols or websites. .SH ENVIRONMENT VARIABLES \fBROUNDUP_INSTANCE\fP .br This can be used to set the instance directory. If it is set, the \fIinstance_home\fP argument is optional. .SH EXAMPLE If your msg class has a messsagetype property you can set up aliases to receive the different types of messages. Setting up an alias in your MTA Using: tracker: |/tools/roundup/bin/roundup-mailgw -S "msg.messagetype=reply - to all" /var/roundup/sysadmin (the lines are split for readability. In the alias file they will be on the same line). Replace /tools/roundup/bin/roundup-mailgw by your path to the roundup-mailgw. This creates the email alias "tracker". All messages sent to it have their messagetype property set to "reply - to all". The roundup tracker instance is located at /var/roundup/sysadmin. A comment alias would receive emails at tracker_comment with: tracker_comment: |/tools/roundup/bin/roundup-mailgw -S "msg.messagetype=to tech" /var/roundup/sysadmin which would be a technical message. These messages can trigger different workflows based on the messagetype. Both examples use the default class specified in the tracker's config.ini (usually the issue class). You can also set properties directly on the issue class. If your tracker's issue has a "private" property that limits who can view an issue and its messages: security: |/tools/roundup/bin/roundup-mailgw -S "issue.private=true" -S "issue.keyword+=security" /var/roundup/sysadmin would set the private property on a issue to restrict visiblity and mark the issue as a security topic using a keyword. Both examples use the default class specified in the tracker's config.ini (usually the issue class). .SH SEE ALSO roundup-admin(1), roundup-demo(1), roundup-server(1) .SH AUTHOR This manpage was written by Bastian Kleineidam for the Debian distribution of roundup. The main author of roundup is Richard Jones . Updates by John Rouillard and Ralf Schlatterbeck . code-513942bca8d2/share/man/man1/roundup-server.10000644000000000000000000001305514727466072017465 0ustar 00000000000000.TH ROUNDUP-SERVER 1 "27 July 2004" .SH NAME roundup-server \- start roundup web server .SH SYNOPSIS \fBroundup-server\fP [\fIoptions\fP] [\fBname=\fP\fItracker home\fP]* .SH OPTIONS .TP \fB-C\fP \fIfile\fP or \fB--config\fP \fIfile\fP Use options read from the configuration file (see below). .TP \fB-n\fP \fIhostname\fP Sets the host name or IP address to listen on. Default is localhost (127.0.0.1). Use 0.0.0.0 to listen on all interfaces on the system. .TP \fB-p\fP \fIport\fP Sets the port to listen on (default: 8080). .TP \fB-d\fP \fIPIDfile\fP Run the server in the background and write the server's PID to the file indicated by PIDfile. The -l (or -L) option \fBmust\fP be specified if -d is used. .TP \fB-D\fP Run the server in the foreground even if -d is used. .TP \fB-t\fP \fBfork|thread|debug|none\fP Control multi-process mode. \fBdebug\fP and \fBnone\fP are always available. If an invalid mode is specified the server starts in \fBnone\fP (also called single) mode. Default fork. .TP \fB-m\fP \fImax_children\fP Set the maximum number of child processes (servers). This value may need to be increased on a heavily loaded site. Default 40. .TP \fB-l\fP \fIfile\fP Sets a filename to log to (instead of stdout). This is required if the -d option is used. .TP \fB-P\fP If a reverse proxy is used in front of the roundup-server, the server will log the ip address of the proxy, not the client browser. Using -P logs the left most entry in the X-Forwarded-For http header as the IP address of the client. This address will be logged or resolved to a hostname (with \fB-N\fP) and a '+' character will be appended. \fB-P\fP should only be used when the roundup server is accessible only from trusted proxy hosts. See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For for details and warnings about using the X-Forwarded-For header. .TP \fB-L\fP Have the server log using the Python logger with key roundup.http. .TP \fB-i\fP \fIfile\fP Sets a filename to use as a template for generating the tracker index page. The variable "trackers" is available to the template and is a dict of all configured trackers. If you connect to the root of the server (without a tracker name), the default index page is shown. Using \fB-i\fP allows you to customize the index page. .TP \fB-I\fP \fIheader1[,header2,...]\fP Pass the header(s) and their values to the backend. This allow-list of header variables can be used by custom code in the tracker or with a tracker's \fBhttp_auth_header\fP configuration option to allows a front end server to authenticate a user and pass the user identity to roundup. .TP \fB-s\fP Enables use of SSL. In most cases, you will want to run a real web server (Apache, Nginx) as a proxy to roundup-server running without SSL. The real web server can filter/rate limit/firewall requests to roundup-server. .TP \fB-e\fP \fIfile\fP Sets a filename containing the PEM file to use for SSL. The PEM file must include both the private key and certificate with appropriate header/trailer markers: .EX -----BEGIN PRIVATE KEY----- -----END PRIVATE KEY----- .EE and .EX -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- .EE If no file is specified, a temporary self-signed certificate will be used. .TP \fB-N\fP Log client machine names instead of IP addresses (much slower). .TP \fB-V\fP \fIHTTPVER\fP By default roundup-server uses HTTP/1.1 to enable keepalives for faster response. HTTPVER can be set to \fBHTTP/1.0\fP to disable keepalives. .TP \fB-u\fP \fIUID\fP Runs the Roundup web server as this UID. .TP \fB-g\fP \fIGID\fP Runs the Roundup web server as this GID. .TP \fB-v\fP or \fB--version\fP Print version and exit. .TP \fB-h\fP or \fB--help\fP Print help and exit. .TP \fB--save-config\fP Create configuration file and exit. The old config.ini will be saved to config.bak. Note that this command doesn't attempt to load or verify an existing config.ini. Running this in a tracker home directory will move the existing config.ini to config.bak and replace it with the roundup-server's config.ini. This will make the tracker in the directory fail to start until the original config.ini is restored. .TP \fBname=\fP\fItracker home\fP Sets the tracker home(s) to use. The \fBname\fP variable is how the tracker is identified in the URL (it's the first part of the URL path). The \fItracker home\fP variable is the directory that was identified when you did "roundup-admin init". You may specify any number of these name=home pairs on the command-line. For convenience, you may edit the TRACKER_HOMES variable in the roundup-server file instead. Make sure the name part doesn't include any url-unsafe characters like spaces, as these confuse the cookie handling in browsers like IE. .PP If you connect to the root directory (I.E. you do not include the \fBname\fP component in the URL, the server will display an index page of trackers served by roundup-server if more than one tracker is defined. If only one tracker is defined it will redirect to the tracker. .SH EXAMPLES .TP .B roundup-server -p 9000 bugs=/var/tracker reqs=/home/roundup/group1 Start the server on port \fB9000\fP serving two trackers; one under \fB/bugs\fP and one under \fB/reqs\fP. .PP If you connect to the server at the root level (http://host:9000/) it will display a list of the available trackers. .SH CONFIGURATION FILE See the "admin_guide" in the Roundup "doc" directory. .SH SEE ALSO roundup-admin(1), roundup-demo(1), roundup-mailgw(1) .SH AUTHOR This manpage was written by Bastian Kleineidam for the Debian distribution of roundup. The main author of roundup is Richard Jones . code-513942bca8d2/share/roundup/templates/classic/TEMPLATE-INFO.txt0000644000000000000000000000053114727466072022607 0ustar 00000000000000Name: classic Description: This is a generic issue tracker that may be used to track bugs, feature requests, project issues or any number of other types of issues. Most users of Roundup will find that this template suits them, with perhaps a few customisations. Intended-For: All first-time Roundup users code-513942bca8d2/share/roundup/templates/classic/detectors/config.ini0000644000000000000000000000103714727466072024046 0ustar 00000000000000[statusauditor] # Options for statusauditor.py # # Option: chatting_requires_two_users # Assume an issue has a status of unread and was created by the # demo user. # If False, a new message on the issue sets status to chatting. # If True, a new message sets the status to chatting only if the # author of the new message is not demo. A message sent by demo # keeps the issue status at unread. As a result a user can open # a new message and add information without setting the status # to chatting. chatting_requires_two_users = False code-513942bca8d2/share/roundup/templates/classic/detectors/messagesummary.py0000644000000000000000000000075214727466072025517 0ustar 00000000000000from roundup.mailgw import parseContent def summarygenerator(db, cl, nodeid, newvalues): ''' If the message doesn't have a summary, make one for it. ''' if 'summary' in newvalues or 'content' not in newvalues: return summary, content = parseContent(newvalues['content'], config=db.config) newvalues['summary'] = summary def init(db): # fire before changes are made db.msg.audit('create', summarygenerator) # vim: set filetype=python ts=4 sw=4 et si code-513942bca8d2/share/roundup/templates/classic/detectors/nosyreaction.py0000644000000000000000000001246714727466072025200 0ustar 00000000000000# # Copyright (c) 2001 Bizar Software Pty Ltd (http://www.bizarsoftware.com.au/) # This module is free software, and you may redistribute it and/or modify # under the same terms as Python, so long as this copyright message and # disclaimer are retained in their original form. # # IN NO EVENT SHALL BIZAR SOFTWARE PTY LTD BE LIABLE TO ANY PARTY FOR # DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING # OUT OF THE USE OF THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # # BIZAR SOFTWARE PTY LTD SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, # BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS # FOR A PARTICULAR PURPOSE. THE CODE PROVIDED HEREUNDER IS ON AN "AS IS" # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE, # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. # from roundup import roundupdb, hyperdb def nosyreaction(db, cl, nodeid, oldvalues): ''' A standard detector is provided that watches for additions to the "messages" property. When a new message is added, the detector sends it to all the users on the "nosy" list for the issue that are not already on the "recipients" list of the message. Those users are then appended to the "recipients" property on the message, so multiple copies of a message are never sent to the same user. The journal recorded by the hyperdatabase on the "recipients" property then provides a log of when the message was sent to whom. ''' # send a copy of all new messages to the nosy list for msgid in determineNewMessages(cl, nodeid, oldvalues): try: cl.nosymessage(nodeid, msgid, oldvalues) except roundupdb.MessageSendError as message: raise roundupdb.DetectorError(message) def determineNewMessages(cl, nodeid, oldvalues): ''' Figure a list of the messages that are being added to the given node in this transaction. ''' messages = [] if oldvalues is None: # the action was a create, so use all the messages in the create messages = cl.get(nodeid, 'messages') elif 'messages' in oldvalues: # the action was a set (so adding new messages to an existing issue) m = {} for msgid in oldvalues['messages']: m[msgid] = 1 messages = [] # figure which of the messages now on the issue weren't there before for msgid in cl.get(nodeid, 'messages'): if msgid not in m: messages.append(msgid) return messages def updatenosy(db, cl, nodeid, newvalues): '''Update the nosy list for changes to the assignedto ''' # nodeid will be None if this is a new node current_nosy = set() if nodeid is None: ok = ('new', 'yes') else: ok = ('yes',) # old node, get the current values from the node if they haven't # changed if 'nosy' not in newvalues: nosy = cl.get(nodeid, 'nosy') for value in nosy: current_nosy.add(value) # if the nosy list changed in this transaction, init from the new value if 'nosy' in newvalues: nosy = newvalues.get('nosy', []) for value in nosy: if not db.hasnode('user', value): continue current_nosy.add(value) new_nosy = set(current_nosy) # add assignedto(s) to the nosy list if 'assignedto' in newvalues and newvalues['assignedto'] is not None: propdef = cl.getprops() if isinstance(propdef['assignedto'], hyperdb.Link): assignedto_ids = [newvalues['assignedto']] elif isinstance(propdef['assignedto'], hyperdb.Multilink): assignedto_ids = newvalues['assignedto'] for assignedto_id in assignedto_ids: new_nosy.add(assignedto_id) # see if there's any new messages - if so, possibly add the author and # recipient to the nosy if 'messages' in newvalues: if nodeid is None: ok = ('new', 'yes') messages = newvalues['messages'] else: ok = ('yes',) # figure which of the messages now on the issue weren't oldmessages = cl.get(nodeid, 'messages') messages = [] for msgid in newvalues['messages']: if msgid not in oldmessages: messages.append(msgid) # configs for nosy modifications add_author = getattr(db.config, 'ADD_AUTHOR_TO_NOSY', 'new') add_recips = getattr(db.config, 'ADD_RECIPIENTS_TO_NOSY', 'new') # now for each new message: msg = db.msg for msgid in messages: if add_author in ok: authid = msg.get(msgid, 'author') new_nosy.add(authid) # add on the recipients of the message if add_recips in ok: for recipient in msg.get(msgid, 'recipients'): new_nosy.add(recipient) if current_nosy != new_nosy: # that's it, save off the new nosy list newvalues['nosy'] = list(new_nosy) def init(db): db.issue.react('create', nosyreaction) db.issue.react('set', nosyreaction) db.issue.audit('create', updatenosy) db.issue.audit('set', updatenosy) # vim: set filetype=python ts=4 sw=4 et si code-513942bca8d2/share/roundup/templates/classic/detectors/statusauditor.py0000644000000000000000000001130614727466072025365 0ustar 00000000000000# Copyright (c) 2002 ekit.com Inc (http://www.ekit-inc.com/) # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE # SOFTWARE. # from roundup.configuration import BooleanOption, InvalidOptionError def chatty(db, cl, nodeid, newvalues): ''' If the issue is currently 'resolved', 'done-cbb' or None, then set it to 'chatting'. If issue is 'unread' and chatting_requires_two_users is true, set state to 'chatting' if the person adding the new message is not the same as the person who created the issue. This allows somebody to submit multiple emails describing the problem without changing it to 'chatting'. 'chatting' should indicate at least two people are 'chatting'. ''' # If set to true, change state from 'unread' to 'chatting' only # if the author of the update is not the person who created the # first message (and thus the issue). If false (default ini file # setting) set 'chatting' when the second message is received. try: chatting_requires_two_users = BooleanOption(None, "detector::Statusauditor", "CHATTING_REQUIRES_TWO_USERS").str2value( db.config.detectors[ 'STATUSAUDITOR_CHATTING_REQUIRES_TWO_USERS' ] ) except InvalidOptionError: chatting_requires_two_users = False # NOTE if this is hit, detectors/config.ini needs to be updated with: # [statusauditor] # chatting_requires_two_users = yes # to enable or no to disable (same as default) # don't fire if there's no new message (ie. chat) if 'messages' not in newvalues: return if newvalues['messages'] == cl.get(nodeid, 'messages'): return # get the chatting state ID try: chatting_id = db.status.lookup('chatting') except KeyError: # no chatting state, ignore all this stuff return # get the current value current_status = cl.get(nodeid, 'status') # see if there's an explicit change in this transaction if 'status' in newvalues: # yep, skip return # determine the id of 'unread', 'resolved' and 'chatting' fromstates = [] for state in 'unread resolved done-cbb'.split(): try: fromstates.append(db.status.lookup(state)) except KeyError: pass unread = fromstates[0] # grab the 'unread' state which is first # ok, there's no explicit change, so check if we are in a state that # should be changed. First see if we should set 'chatting' based on # who opened the issue. if current_status == unread and chatting_requires_two_users: # find creator of issue and compare to currentuser making # update. If the creator is same as initial author don't # change to 'chatting'. issue_creator = cl.get(nodeid, 'creator') if issue_creator == db.getuid(): # person is chatting with themselves, don't set 'chatting' return # Current author is not the initiator of the issue so # we are 'chatting'. if current_status in fromstates + [None]: # yep, we're now chatting newvalues['status'] = chatting_id def presetunread(db, cl, nodeid, newvalues): ''' Make sure the status is set on new issues ''' if 'status' in newvalues and newvalues['status']: return # get the unread state ID try: unread_id = db.status.lookup('unread') except KeyError: # no unread state, ignore all this stuff return # ok, do it newvalues['status'] = unread_id def init(db): # fire before changes are made db.issue.audit('set', chatty) db.issue.audit('create', presetunread) # vim: set filetype=python ts=4 sw=4 et si code-513942bca8d2/share/roundup/templates/classic/detectors/userauditor.py0000644000000000000000000001047714727466072025030 0ustar 00000000000000# Copyright (c) 2003 Richard Jones (richard@mechanicalcat.net) # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE # SOFTWARE. # import re # regular expression thanks to: http://www.regular-expressions.info/email.html # this is the "99.99% solution for syntax only". email_regexp = (r"[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*", r"(localhost|(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9]))") email_rfc = re.compile('^' + email_regexp[0] + '@' + email_regexp[1] + '$', re.IGNORECASE) email_local = re.compile('^' + email_regexp[0] + '$', re.IGNORECASE) valid_username = re.compile('^[a-z0-9_@!%.+-]+$', re.IGNORECASE) def valid_address(address): ''' If we see an @-symbol in the address then check against the full RFC syntax. Otherwise it is a local-only address so only check the local part of the RFC syntax. ''' if '@' in address: return email_rfc.match(address) else: return email_local.match(address) def get_addresses(user): ''' iterate over all known addresses in a newvalues dict this takes of the address/alterate_addresses handling ''' if 'address' in user: yield user['address'] if user.get('alternate_addresses', None): for address in user['alternate_addresses'].split('\n'): yield address def audit_user_fields(db, cl, nodeid, newvalues): ''' Make sure user properties are valid. - email address is syntactically valid - email address is unique - roles specified exist - timezone is valid - username matches A-z0-9_-.@!+% (email symbols) ''' if 'username' in newvalues: if not valid_username.match(newvalues['username']): raise ValueError("Username/Login Name must consist only of the letters a-z (any case), digits 0-9 and the symbols: @._-!+%") for address in get_addresses(newvalues): if not valid_address(address): raise ValueError('Email address syntax is invalid "%s"'%address) check_main = db.user.stringFind(address=address) # make sure none of the alts are owned by anyone other than us (x!=nodeid) check_alts = [x for x in db.user.filter(None, {'alternate_addresses' : address}) if x != nodeid] if check_main or check_alts: raise ValueError('Email address %s already in use' % address) newroles = newvalues.get('roles') if newroles: for rolename in [r.lower().strip() for r in newroles.split(',')]: if rolename and rolename not in db.security.role: raise ValueError('Role "%s" does not exist'%rolename) tz = newvalues.get('timezone', None) if tz: # if they set a new timezone validate the timezone by attempting to # use it before we store it to the db. import roundup.date import datetime try: TZ = roundup.date.get_timezone(tz) dt = datetime.datetime.now() local = TZ.localize(dt).utctimetuple() except IOError: raise ValueError('Timezone "%s" does not exist' % tz) except ValueError: raise ValueError('Timezone "%s" exceeds valid range [-23...23]' % tz) def init(db): # fire before changes are made db.user.audit('set', audit_user_fields) db.user.audit('create', audit_user_fields) # vim: sts=4 sw=4 et si code-513942bca8d2/share/roundup/templates/classic/extensions/README.txt0000644000000000000000000000020114727466072023771 0ustar 00000000000000This directory is for tracker extensions: - CGI Actions - Templating functions See the customisation doc for more information. code-513942bca8d2/share/roundup/templates/classic/html/_generic.404.html0000644000000000000000000000067414727466072024025 0ustar 00000000000000 Item Not Found Item Not Found There is no with id code-513942bca8d2/share/roundup/templates/classic/html/_generic.calendar.html0000644000000000000000000000146314727466072025264 0ustar 00000000000000 code-513942bca8d2/share/roundup/templates/classic/html/_generic.collision.html0000644000000000000000000000136714727466072025511 0ustar 00000000000000 <span tal:replace="python:context._classname.capitalize()" i18n:name="class" /> Edit Collision - <span i18n:name="tracker" tal:replace="config/TRACKER_NAME" /> Edit Collision code-513942bca8d2/share/roundup/templates/classic/html/_generic.help-empty.html0000644000000000000000000000026114727466072025572 0ustar 00000000000000 Empty page (no search performed yet)

Please specify your search parameters!

code-513942bca8d2/share/roundup/templates/classic/html/_generic.help-list.html0000644000000000000000000000525714727466072025421 0ustar 00000000000000 Search result for user helper 

  
You are not
  allowed to view this page.


  
  
  

    

      

       
        << previous
       
       1..25 out of 50
       
       
        next >>
       
      

     


  
  
           

      

          x
         
       

     
     
       

     

     
       

         
             
             
             
                 
             
           
         

       
     

   

     
     
     
     
     
  

code-513942bca8d2/share/roundup/templates/classic/html/_generic.help-search.html0000644000000000000000000000054614727466072025707 0ustar  00000000000000
  
    Frame for search input fields
  
  
    
Generic template
    help-search
    or version for class
    user
    is not yet implemented

  


code-513942bca8d2/share/roundup/templates/classic/html/_generic.help-submit.html0000644000000000000000000000554014727466072025744 0ustar  00000000000000
  
      
      
      
      Generic submit page for framed helper windows
      
      
      
      
  
 
 
 

     

       
     

     
     
     
     
 

 
 

code-513942bca8d2/share/roundup/templates/classic/html/_generic.help.html0000644000000000000000000001050714727466072024442 0ustar  00000000000000

  
      
      
      
      <tal:x i18n:name="property"
       tal:content="property | default" i18n:translate="" /> help - <span i18n:name="tracker"
       tal:replace="config/TRACKER_NAME" />
      
      
      
  
 
 


     

       
       
       
       
     

     

      

       
        << previous
         
       
       .. out of 
       
       
        next >>
         
       
      

     


     
           

       

            x
           
       

       

         
             
             
             
                 
             
           
       

       

            x
           
       

     


 

 


code-513942bca8d2/share/roundup/templates/classic/html/_generic.index.html0000644000000000000000000000525114727466072024621 0ustar  00000000000000


<span tal:replace="python:context._classname.capitalize()"
 i18n:name="class" /> editing - <span i18n:name="tracker"
 tal:replace="config/TRACKER_NAME" />
 editing



You are not allowed to view this page.

Please login with your username and password.





 You may edit the contents of the
 
 class using this form. Commas, newlines and double quotes (") must be
 handled delicately. You may include commas and newlines by enclosing the
 values in double-quotes ("). Double quotes themselves must be quoted by
 doubling ("").





 Multilink properties have their multiple values colon (":") separated
 (... ,"one:two:three", ...)





 Remove entries by deleting their line. Add new entries by appending
 them to the table - put an X in the id column. If you wish to restore a
 removed item and you know its id then just put that id in the id column.
















 

 

   
 

 

   
 

 






code-513942bca8d2/share/roundup/templates/classic/html/_generic.item.html0000644000000000000000000000375514727466072024457 0ustar  00000000000000
<span tal:replace="python:context._classname.capitalize()"
 i18n:name="class" /> editing - <span i18n:name="tracker"
 tal:replace="config/TRACKER_NAME" />
 editing





 You are not allowed to view this page.




 Please login with your username and password.











  




 
  
 




  
 
  submit button will go here
 










Showing 10 items.
Show all history
(warning: this could be VERY long)








code-513942bca8d2/share/roundup/templates/classic/html/_generic.keywords_expr.html0000644000000000000000000000073114727466072026415 0ustar  00000000000000

 
  
  
  
 
 
 

code-513942bca8d2/share/roundup/templates/classic/html/_generic.translation0000644000000000000000000000122414727466072025101 0ustar  00000000000000{
   "RoundupTranslations": "RoundupTranslations"
}

code-513942bca8d2/share/roundup/templates/classic/html/classhelper.css0000644000000000000000000000426514727466072024075 0ustar  00000000000000.popup-tablediv {
    overflow: auto;
}

.popup-table {
    table-layout: auto;
    width: 100%;
    font-size: .9em;
}

table th {
    font-weight: normal;
    text-align: left;
    padding-left: .3em;
    color: #444;
    background-color: #efefef;
    border-bottom: 1px solid #afafaf;
    border-top: 1px solid #afafaf;
    text-transform: uppercase;
    vertical-align: middle;
    line-height: 1.5em;
}

table td {
    vertical-align: middle;
    padding-left: .3em;
    padding-right: .2em;
    border-bottom: 1px solid #efefef;
    text-align: left;
    empty-cells: show;
    white-space: nowrap;
    vertical-align: middle;
}

table.popup-table tr:hover {
    background-color: #eee;
    cursor: pointer;
}

.row-style {
    cursor: pointer;
}

.table-header {
    width: 15px;
}

/* Accumulator */

.popup-control {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-evenly;
    gap: 8px;
    padding: 8px;
    border-top: 2px solid #444;
    background-color: #eee;
}

button {
    min-width: 3em;
}

@media (pointer: coarse) {
    /* make min width 48px (3em*16px/em) on touch screens */
  button {
    min-height: 3em;
  }
  table td { padding-block: 2em; }
}

.popup-apply {
    background-color: #c1cee6;
    font-weight: bold;
    min-width: 7em;
}

/* Pagination */

.popup-pagination {
    display: flex;
    justify-content: space-evenly;
    padding: 8px;
}

.popup-pagination button {
    min-width: 40px;
    width: 30%;
    cursor: pointer;
    color: blue;
}

.popup-pagination button:disabled {
    color: gray;
    opacity: 0.4;
    cursor: default;
}

/* Search */
.popup-search {
    border-bottom: 2px solid #444;
}

.search-label {
    text-transform: capitalize;
    font-weight: bold;
}

.search-button {
    background-color: #c1cee6;
    font-weight: bold;
    min-width: 7em;
}

.reset-button {
    margin-left: 60px;
}

.flex-container {
    margin: 0;
    display: flex;
    flex-direction: column;
    height: 100%;
}

.separator {
    flex-grow: 1;
}

.search-error input {
    border: 2px solid red;
}

.search-error > .error-message {
    color: red;
    font-size: 14px;
    margin-left: 4px;
    padding-block-start: 0.25em;
}

*:focus-visible { outline-offset: 3px; }
code-513942bca8d2/share/roundup/templates/classic/html/classhelper.js0000644000000000000000000014501314727466072023716 0ustar  00000000000000/**
 * Properties for the ClassHelper component, 
 * made into a type for better readability.
 * @typedef {Object} HelpUrlProps
 * Type of data that needs to be shown (eg. issue, user, keywords) parsed from helpurl
 * @property {string} apiClassName
 * @property {number} width // width of the popup window
 * @property {number} height // height of the popup window
 * The form on which the classhelper is being used
 * @property {string | null} formName
 * The form property on which the classhelper is being used
 * @property {string | null} formProperty
 * @property {string | null} tableSelectionType // it has to be "checkbox" or "radio"(if any)
 * The fields on which the table is sorted
 * @property {string[] | undefined} sort
 * The actual fields to be displayed in the table
 * @property {string[] | undefined} fields
 * @property {number} pageIndex
 * @property {number} pageSize
 */


// change this to true to disable the classhelper
const DISABLE_CLASSHELPER = false

// Let user customize the css file name
const CSS_STYLESHEET_FILE_NAME = "@@file/classhelper.css";

const CLASSHELPER_TAG_NAME = "roundup-classhelper";
const CLASSHELPER_ATTRIBUTE_SEARCH_WITH = "data-search-with";
const CLASSHELPER_ATTRIBUTE_POPUP_TITLE = "data-popup-title";
const CLASSHELPER_ATTRIBUTE_POPUP_TITLE_ITEM_CLASS_LOOKUP = "{className}";
const CLASSHELPER_ATTRIBUTE_POPUP_TITLE_ITEM_DESIGNATOR_LOOKUP = "{itemDesignator}";
const CLASSHELPER_POPUP_FEATURES = (width, height) => `popup=yes,width=${width},height=${height}`;
const CLASSHELPER_POPUP_URL = "about:blank";
const CLASSHELPER_POPUP_TARGET = "_blank";

const CLASSHELPER_READONLY_POPUP_TITLE = "Info on {className} - {itemDesignator} - Classhelper"
const CLASSHELPER_TABLE_SELECTION_NONE = "table-selection-none";
const CLASSHELPER_TRANSLATION_KEYWORDS = ["apply", "cancel", "next", "prev", "search", "reset", CLASSHELPER_READONLY_POPUP_TITLE ];

const ALTERNATIVE_DROPDOWN_PATHNAMES = {
    "roles": "/rest/data/user/roles"
}

/**
 * This is a custom web component(user named html tag) that wraps a helpurl link 
 * and provides additional functionality.
 * 
 * The classhelper is an interactive popup window that displays a table of data.
 * Users can interact with this window to search, navigate and select data from the table.
 * The selected data is either "Id" or "a Value" from the table row.
 * There can be multiple selections in the table.
 * The selected data is then populated in a form field in the main window.
 * 
 * How to use.
 * ------------
 * The helpurl must be wrapped under this web component(user named html tag).
 * ```html
 * 
 *   ( helpurl template here, this can be tal, chameleon, jinja2.
 *     In HTML DOM this is an helpurl anchor tag.
 *    )
 * 
 * ```
 * 
 * The data-search-with attribute of the web component is optional.
 * 
 * data-search-with attribute value is a list of comma separated names of table data fields.
 * (It is possible that a data field is present in search form but absent in the table).
 * 
 * A square parentheses open+close ("[]") can be added to the column name eg."status[]",
 * this will make that search field as a dropdown in the search form in popup window, 
 * then a user can see all the possible values that column can have.
 * 
 * eg. data-search-with="title,status[],keyword[]+name" where status can have values like "open", 
 * "closed" a dropdown will be shown with null, open and closed. This is an aesthetic usage 
 * instead of writing in a text field for options in status.
 * 
 * A plus sign or minus sign with data field can be used to specify the sort order of the dropdown.
 * In the above example, keyword[]+name will sort the dropdown in ascending order(a-z) of name of the keyword.
 * A value keyword[]-name will sort the dropdown in descending order(z-a) of name of the keyword.
 * 
 * data-search-with="<>[]{+|-}{id|name}"
 * Here column name is required,
 * optionally there can be [] for a dropdown,
 * optionally with "[]" present to a column name there can be 
 * [+ or -] with succeeding "id" or "name" for sorting dropdown.
 * 
 * The data-popup-title attribute of the web component is optional.
 * the value of this attribute is the title of the popup window.
 * the user can use "{itemDesignator}" in the title to replace in the attribute value.
 * and the current context of classhelper will replace "{itemDesignator}".
 * 
 */
class ClassHelper extends HTMLElement {

    static observedAttributes = [CLASSHELPER_ATTRIBUTE_SEARCH_WITH]

    /** @type {Window} handler to popup window */
    popupRef = null;

    /** 
     * Result from making a call to the rest api, for the translation keywords.
     * @type {Object.} */
    static translations = null;

    /** 
     * Stores the result from api calls made to rest api,
     * for the parameters in data-search-with attribute of this web component
     * where a parameter is defined as a dropdown in 
     * @type {Object.>} */
    dropdownsData = null;

    /** @type {HTMLAnchorElement} */
    helpurl = null;

    /** @type {string} */
    helpurlScript = null;

    /** @type {HelpUrlProps} */
    helpurlProps = null;

    /** 
 * The qualified domain name with protocol and port(if any)
 * with the tracker name if any.
 * eg. http://localhost:8080/demo or https://demo.roundup-tracker.org
 * @type {string} */
    trackerBaseURL = null;

    /** no-op function */
    preventDefault = e => e.preventDefault();

    connectedCallback() {
        try {
            this.helpurl = this.findClassHelpLink();

            // Removing the helpurl click behavior
            this.helpurlScript = this.helpurl.getAttribute("onclick");
            this.helpurl.removeAttribute("onclick", "");
            this.helpurl.addEventListener("click", this.preventDefault);

            this.helpurlProps = ClassHelper.parseHelpUrlProps(this.helpurl);

            this.trackerBaseURL = window.location.href.substring(0, window.location.href.lastIndexOf("/"));

        } catch (err) {
            console.warn("Classhelper not intercepting helpurl.");
            if (this.helpurl != null) {
                this.helpurl.removeEventListener("click", this.preventDefault);
                this.helpurl.setAttribute("onclick", this.helpurlScript);
            }
            console.error(err);
            return;
        }

        const initialRequestURL = ClassHelper.getRestURL(this.trackerBaseURL, this.helpurlProps);

        this.fetchDropdownsData()
            .catch(error => {
                // Top level handling for dropdowns errors.
                console.error(error);
            });

        const cleanUpClosure = () => {
            console.warn("Classhelper not intercepting helpurl.");
            this.removeEventListener("click", handleClickEvent);
            this.helpurl.removeEventListener("click", this.preventDefault);
            this.helpurl.setAttribute("onclick", this.helpurlScript);
        }

        const handleClickEvent = (event) => {
            if (this.popupRef != null && !this.popupRef.closed) {
                this.popupRef.focus();
                return;
            }

            this.openPopUp(initialRequestURL, this.helpurlProps)
                .catch(error => {
                    // Top level error handling for openPopUp method.
                    cleanUpClosure();
                    console.error(error);
                    if (this.popupRef != null) {
                        this.popupRef.close();
                    }
                    window.alert("Error: Failed to open classhelper, check console for more details.");
                    this.helpurl.click();
                });
        };

        const handlePopupReadyEvent = (event) => {
            // we get a document Fragment in event.detail we replace it with the root
            // replaceChild method consumes the documentFragment content, subsequent calls will be no-op.
            if (event.detail.childElementCount === 1) {
                this.popupRef.document.replaceChild(event.detail, this.popupRef.document.documentElement);
            }
        }

        const handleNextPageEvent = (event) => {
            this.pageChange(event.detail.value, this.helpurlProps)
                .catch(error => {
                    // Top level error handling for nextPage method.
                    cleanUpClosure();
                    console.error(error, `request data url: ${event.detail.value}`);
                    if (this.popupRef != null) {
                        this.popupRef.close();
                    }
                    window.alert("Error: Failed to load next page, check console for more details.");
                    this.helpurl.click();
                });
        }

        const handlePrevPageEvent = (event) => {
            this.pageChange(event.detail.value, this.helpurlProps)
                .catch(error => {
                    // Top level error handling for prevPage method.
                    cleanUpClosure();
                    console.error(error, `request data url: ${event.detail.value}`);
                    if (this.popupRef != null) {
                        this.popupRef.close();
                    }
                    window.alert("Error: Failed to load next page, check console for more details.");
                    this.helpurl.click();
                });
        }

        const handleValueSelectedEvent = (event) => {
            // does not throw error
            this.valueSelected(this.helpurlProps, event.detail.value);
        }

        const handleSearchEvent = (event) => {
            this.helpurlProps.pageIndex = 1;
            const searchURL = ClassHelper.getSearchURL(this.trackerBaseURL, this.helpurlProps, event.detail.value);
            this.searchEvent(searchURL, this.helpurlProps)
                .catch(error => {
                    // Top level error handling for searchEvent method.
                    cleanUpClosure();
                    console.error(error, `request data url: ${event.detail.value}`);
                    if (this.popupRef != null) {
                        this.popupRef.close();
                    }
                    window.alert("Error: Failed to load next page, check console for more details.");
                    this.helpurl.click();
                });
        }

        const handleSelectionEvent = (event) => {
            // does not throw error
            this.selectionEvent(event.detail.value);
        }

        this.addEventListener("click", handleClickEvent);
        this.addEventListener("popupReady", handlePopupReadyEvent);
        this.addEventListener("prevPage", handlePrevPageEvent);
        this.addEventListener("nextPage", handleNextPageEvent);
        this.addEventListener("valueSelected", handleValueSelectedEvent);
        this.addEventListener("search", handleSearchEvent);
        this.addEventListener("selection", handleSelectionEvent);
    }

    attributeChangedCallback(name, oldValue, _newValue) {
        if (name === CLASSHELPER_ATTRIBUTE_SEARCH_WITH) {
            if (!oldValue || oldValue === _newValue) {
                return;
            }
            this.fetchDropdownsData().catch(error => {
                // Top level handling for dropdowns errors.
                console.error(error.message);
            });

            let oldForm = this.popupRef.document.getElementById("popup-search");
            let newForm = this.getSearchFragment();
            this.popupRef.document.body.replaceChild(newForm, oldForm);
        }
    }

    static async fetchTranslations() {
        // Singleton implementation
        if (ClassHelper.translations != null) {
            return;
        }

        const keys = new Set();

        const classhelpers = document.getElementsByTagName(CLASSHELPER_TAG_NAME);
        for (let classhelper of classhelpers) {
            if (classhelper.dataset.searchWith) {
                classhelper.dataset.searchWith
                    .split(',')
                    .forEach(param => {
                        keys.add(param.split("[]")[0]);
                    });
            }

	    if (classhelper.dataset.popupTitle) {
		keys.add(classhelper.dataset.popupTitle)
	    }

            const a = classhelper.querySelector("a");
            if (a && a.dataset.helpurl) {
                let searchParams = new URLSearchParams(a.dataset.helpurl.split("?")[1]);
                let properties = searchParams.get("properties");
                if (properties) {
                    properties.split(',').forEach(key => keys.add(key));
                }
            }
        }

        CLASSHELPER_TRANSLATION_KEYWORDS.forEach(key => keys.add(key));

        ClassHelper.translations = {};
        for (let key of keys) {
            ClassHelper.translations[key] = key;
        }

        let tracker_path = window.location.pathname.split('/').slice(0,-1).join('/')
        let url = new URL(window.location.origin + tracker_path + '/');
        url.searchParams.append("@template", "translation");
        url.searchParams.append("properties", Array.from(keys.values()).join(','));

        let resp, json;

        try {
            resp = await fetch(url);
        } catch (error) {
            let message = `Error fetching translations from roundup rest api\n`;
            message += `url: ${url.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        try {
            json = await resp.json();
        } catch (error) {
            let message = `Error parsing json from roundup rest api\n`;
            message += `url: ${url.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        if (!resp.ok) {
            let message = `Unexpected response\n`;
            message += `url: ${url.toString()}\n`;
            message += `response status: ${resp.status}\n`;
            message += `response body: ${JSON.stringify(json)}\n`;
            throw new Error(message);
        }

        for (let entry of Object.entries(json)) {
            ClassHelper.translations[entry[0]] = entry[1];
        }
    }

    async fetchDropdownsData() {
        // Singleton implementation
        if (this.dropdownsData != null) {
            return;
        }
        this.dropdownsData = {};

        if (this.dataset.searchWith == null) {
            return;
        }

        const params = this.dataset.searchWith.split(',');

        for (let param of params) {
            if (param.includes("[]")) {
                const segments = param.split("[]");
                param = segments[0];
                const sortOrder = segments[1];

                let url = this.trackerBaseURL;
                if (ALTERNATIVE_DROPDOWN_PATHNAMES[param]) {
                    url += ALTERNATIVE_DROPDOWN_PATHNAMES[param];
                } else {
                    url += `/rest/data/${param}`;
                }
                url += "?@verbose=2";

                if (sortOrder) {
                    url += `&@sort=${sortOrder}`;
                }

                let resp, json;
                try {
                    resp = await fetch(url);
                } catch (error) {
                    let message = `Error fetching translations from roundup rest api\n`;
                    message += `url: ${url.toString()}\n`;
                    throw new Error(message, { cause: error });
                }

                try {
                    json = await resp.json();
                } catch (error) {
                    let message = `Error parsing json from roundup rest api\n`;
                    message += `url: ${url.toString()}\n`;
                    throw new Error(message, { cause: error });
                }

                if (!resp.ok) {
                    let message = `Unexpected response\n`;
                    message += `url: ${url.toString()}\n`;
                    message += `response status: ${resp.status}\n`;
                    message += `response body: ${JSON.stringify(json)}\n`;
                    throw new Error(message);
                }

                let list = new Map();

                if (json.data.collection.length > 0) {
                    let idKey = "id";
                    let valueKey = Object.keys(json.data.collection[0]).find(key => key !== "id" && key !== "link");

                    if (!valueKey) {
                        let message = `No suitable key found for value in dropdown data\n`;
                        message += `url: ${url.toString()}\n`;
                        throw new Error("No value key found in dropdown data for: " + url);
                    }

                    for (let entry of json.data.collection) {
                        list.set(entry[idKey], entry[valueKey]);
                    }

                }
                this.dropdownsData[param] = list;
            }
        }
    }

    /**
     * Find the anchor tag that provides the classhelp link.
     * @returns {HTMLAnchorElement}
     * @throws {Error} when the anchor tag is not classhelp link
     */
    findClassHelpLink() {
        const links = this.querySelectorAll("a");
        if (links.length != 1) {
            throw new Error("roundup-classhelper must wrap a single classhelp link");
        }
        const link = links.item(0);

        if (!link.dataset.helpurl) {
            throw new Error("roundup-classhelper link must have a data-helpurl attribute");
        }

        if (!link.dataset.width) {
            throw new Error("roundup-classhelper link must have a data-width attribute");
        }

        if (!link.dataset.height) {
            throw new Error("roundup-classhelper link must have a data-height attribute");
        }

        if (!link.getAttribute("onclick")) {
            throw new Error("roundup-classhelper link should have an onclick attribute set");
        }

        return link;
    }

    /**
     * This method parses the helpurl link to get the necessary data for the classhelper.
     * @param {HTMLAnchorElement} link
     * @returns {HelpUrlProps}
     * @throws {Error} when the helpurl link is not proper
     */
    static parseHelpUrlProps(link) {
        const width = parseInt(link.dataset.width);
        if (isNaN(width)) {
            throw new Error("width in helpurl must be a number");
        }

        const height = parseInt(link.dataset.height);
        if (isNaN(height)) {
            throw new Error("height in helpurl must be a number");
        }

        const urlParts = link.dataset.helpurl.split("?");

        if (urlParts.length != 2) {
            throw new Error("invalid helpurl from link, missing query params");
        }

        const apiClassName = urlParts[0];
        const searchParams = new URLSearchParams(urlParts[1]);

        const tableSelectionType = searchParams.get("type");
        const formName = searchParams.get("form");
        const formProperty = searchParams.get("property");

        const startWith = parseInt(searchParams.get("@startwith"));
        if (isNaN(startWith)) {
            throw new Error("startwith in helpurl must be a number");
        }

        const pageIndex = startWith + 1;
        const pageSize = parseInt(searchParams.get("@pagesize"));

        if (isNaN(pageSize)) {
            throw new Error("pagesize in helpurl must be a number");
        }

        const sort = searchParams.get("@sort")?.split(",");
        const fields = searchParams.get("properties")?.split(",");

        return {
            width,
            height,
            apiClassName,
            tableSelectionType,
            formName,
            formProperty,
            pageIndex,
            pageSize,
            sort,
            fields
        }
    }

    /** 
     * from roundup docs rest api url - "{host}/{tracker}
     * we pass helpurl which is parsed from anchor tag and return a URL.
     * @param {HelpUrlProps} props
     * @returns {URL}
     */
    static getRestURL(trackerBaseURL, props) {
        const restDataPath = "rest/data";
        const base = trackerBaseURL + "/" + restDataPath + "/" + props.apiClassName;
        let url = new URL(base);

        url.searchParams.append("@page_index", props.pageIndex);
        url.searchParams.append("@page_size", props.pageSize);
        let fields = props.fields.join(',');
        url.searchParams.append("@fields", fields);

        if (props.sort) {
            let sort = props.sort.join(',');
            url.searchParams.append("@sort", sort);
        }

        return url;
    }

    static getSearchURL(trackerBaseURL, props, formData) {
        const url = new URL(ClassHelper.getRestURL(trackerBaseURL, props).toString());
        for (let entry of formData.entries()) {
            if (entry[1] != null && entry[1] != "") {
                url.searchParams.append(entry[0], entry[1]);
            }
        }
        return url;
    }

    getSearchFragment(formData) {
        const fragment = document.createDocumentFragment();
        const form = document.createElement("form");
        form.setAttribute("id", "popup-search");
        form.classList.add("popup-search"); // Add class for styling

        const params = this.dataset.searchWith.split(',');

        const table = document.createElement("table");
        table.classList.add("search-table"); // Add class for styling
        table.setAttribute("role", "presentation");

        for (var param of params) {
            param = param.split("[]")[0];

            const row = document.createElement("tr");
            const labelCell = document.createElement("td");
            const inputCell = document.createElement("td");

            const label = document.createElement("label");
            label.classList.add("search-label"); // Add class for styling
            label.setAttribute("for", param);
            label.textContent = ClassHelper.translations[param] + ":";

            let focusSet = false
            let input;
            if (this.dropdownsData[param]) {
                input = document.createElement("select");

                let nullOption = document.createElement("option");
                nullOption.value = "";
                nullOption.textContent = "---";
                input.appendChild(nullOption);

                for (let key of this.dropdownsData[param].keys()) {
                    let option = document.createElement("option");
                    option.value = key;
                    option.textContent = this.dropdownsData[param].get(key);
                    if (formData) {
                        let value = formData.get(param);
                        if (value && value == key) {
                            option.selected = "selected";
                        }
                    }
                    input.appendChild(option);
                }
            } else {
                input = document.createElement("input");
                input.setAttribute("type", "text");
                input.setAttribute("autocapitalize", "off")

                if (formData) {
                    let value = formData.get(param);
                    if (value) {
                        input.value = value;
                    }
                }
            }

            input.setAttribute("name", param);
            input.setAttribute("id", param);
            input.classList.add("search-input"); // Add class for styling   
	    if (!focusSet) {
	      input.setAttribute("autofocus", "");
	      focusSet = true;
	    }

            labelCell.appendChild(label);
            inputCell.appendChild(input);

            row.appendChild(labelCell);
            row.appendChild(inputCell);

            table.appendChild(row);
        }

        // Add search and reset buttons
        const buttonRow = document.createElement("tr");
        const emptyButtonCell = document.createElement("td");
        const buttonCell = document.createElement("td");
        buttonCell.colSpan = 1;

        const search = document.createElement("button");
        search.textContent = ClassHelper.translations["search"];
        search.classList.add("search-button"); // Add class for styling
        search.addEventListener("click", (e) => {
            e.preventDefault();
            let fd = new FormData(form);

            let hasError = this.popupRef.document.getElementsByClassName("search-error").item(0);
            if (hasError != null) {
                let current = fd.get(hasError.dataset.errorField)
                let prev = hasError.dataset.errorValue;
                if (current === prev) {
                    return;
                }
            }

            this.dispatchEvent(new CustomEvent("search", {
                detail: {
                    value: fd
                }
            }));
        });

        const reset = document.createElement("button");
        reset.textContent = ClassHelper.translations["reset"];
        reset.classList.add("reset-button"); // Add class for styling
        reset.addEventListener("click", (e) => {
            e.preventDefault();
            form.reset();
            let fd = new FormData(form);
            this.dispatchEvent(new CustomEvent("search", {
                detail: {
                    value: fd
                }
            }));
        });

        buttonCell.appendChild(search);
        buttonCell.appendChild(reset);
        buttonRow.appendChild(emptyButtonCell);
        buttonRow.appendChild(buttonCell);

        table.appendChild(buttonRow);

        form.appendChild(table);
        fragment.appendChild(form);

        return fragment;
    }

    getPaginationFragment(prevUrl, nextUrl, index, size, total) {
        const fragment = document.createDocumentFragment();

        const container = document.createElement("div");
        container.id = "popup-pagination";
        container.classList.add("popup-pagination");

        const info = document.createElement('span');

        let startNumber = 0, endNumber = 0;

        if (total > 0) {
            startNumber = (parseInt(index) - 1) * parseInt(size) + 1;
            if (total < size) {
                endNumber = startNumber + total - 1;
            } else {
                endNumber = parseInt(index) * parseInt(size);
            }
        }

        info.textContent = `${startNumber} - ${endNumber}`;

        const prev = document.createElement("button");
        prev.innerHTML = "<";
        prev.setAttribute("aria-label", ClassHelper.translations["prev"]);
        prev.setAttribute("disabled", "disabled");
        if (prevUrl) {
            prev.removeAttribute("disabled");
            prev.addEventListener("click", () => {
                this.dispatchEvent(new CustomEvent("prevPage", {
                    detail: {
                        value: prevUrl
                    }
                }));
            });
        }

        const next = document.createElement("button");
        next.innerHTML = ">";
        next.setAttribute("aria-label", ClassHelper.translations["next"]);
        next.setAttribute("disabled", "disabled");
        if (nextUrl) {
            next.removeAttribute("disabled");
            next.addEventListener("click", () => {
                this.dispatchEvent(new CustomEvent("nextPage", {
                    detail: {
                        value: nextUrl
                    }
                }));
            });
        }

        container.append(prev, info, next);
        fragment.appendChild(container);
        return fragment;
    }

    getAccumulatorFragment(preSelectedValues) {
        const fragment = document.createDocumentFragment();
        const container = document.createElement("div");
        container.id = "popup-control";

        const form = document.createElement("form")
        form.id = "accumulator-form"
        form.classList.add("popup-control");

        const preview = document.createElement("input");
        preview.id = "popup-preview";
        preview.classList.add("popup-preview");
        preview.type = "text";
        preview.name = "preview";
        if (preSelectedValues.length > 0) {
            preview.value = preSelectedValues.join(',');
        }

        const cancel = document.createElement("button");
        cancel.textContent = ClassHelper.translations["cancel"];
        cancel.setAttribute("type", "button");
        cancel.addEventListener("click", () => {
            this.popupRef.close();
        });

        const apply = document.createElement("button");
        apply.id = "popup-apply";
        apply.classList.add("popup-apply");
        apply.textContent = ClassHelper.translations["apply"];
        apply.addEventListener("click", () => {
            this.dispatchEvent(new CustomEvent("valueSelected", {
                detail: {
                    value: preview.value
                }
            }))
        })

        form.append(preview, apply, cancel);
        container.append(form)
        fragment.appendChild(container);

        return fragment;
    }

    /**
     * 
     * @param {string[]} headers 
     * @param {Object.[]} data 
     * @returns 
     */
    getTableFragment(headers, data, preSelectedValues) {
        let includeCheckbox = !this.popupRef.document.body.classList.contains(CLASSHELPER_TABLE_SELECTION_NONE);

        const fragment = document.createDocumentFragment();

        const container = document.createElement('div');
        container.id = "popup-tablediv";
        container.classList.add("popup-tablediv");

        const table = document.createElement('table');
        table.classList.add("popup-table");
        const thead = document.createElement('thead');
        const tbody = document.createElement('tbody');
        const tfoot = document.createElement('tfoot');

        // Create table headers
        const headerRow = document.createElement('tr');

        if (includeCheckbox) {
            let thx = document.createElement("th");
            thx.textContent = "X";
            thx.classList.add("table-header");
            headerRow.appendChild(thx);
        }

        headers.forEach(header => {
            const th = document.createElement('th');
            th.textContent = ClassHelper.translations[header];
            headerRow.appendChild(th);
        });
        thead.appendChild(headerRow);

        // Create table body with data
        data.forEach((entry) => {
            const row = document.createElement('tr');
            row.dataset.id = entry[headers[0]];
            row.setAttribute("tabindex", 0);
            row.classList.add("row-style");

            if (includeCheckbox) {
                const td = document.createElement('td');
                const checkbox = document.createElement("input");
                checkbox.setAttribute("type", "checkbox");
                checkbox.checked = false;
                checkbox.setAttribute("tabindex", -1);
                td.appendChild(checkbox)
                row.appendChild(td);
                if (preSelectedValues.includes(entry[headers[0]])) {
                    checkbox.checked = true;
                }
            }

            headers.forEach(header => {
                const td = document.createElement('td');
                td.textContent = entry[header];
                row.appendChild(td);
            });
            tbody.appendChild(row);
        });

        if (includeCheckbox) {
            tbody.addEventListener("click", (e) => {
                let id, tr;
                if (e.target.tagName === "INPUT" ) {
                    tr = e.target.parentElement.parentElement;
                    id = tr.dataset.id;
	        } else if (e.target.tagName === "TD") {
                    tr = e.target.parentElement;
                    id = tr.dataset.id;
                } else if (e.target.tagName === "TR") {
                    tr = e.target;
                    id = tr.dataset.id;
                }

              if (e.target.tagName !== "INPUT") {
		/* checkbox is only child of the first td of the table row */
		let checkbox = tr.children.item(0).children.item(0);
		checkbox.checked = !checkbox.checked;
                }

                this.dispatchEvent(new CustomEvent("selection", {
                    detail: {
                        value: id
                    }
                }));
            });

        }

        // Create table footer with the same column values as headers
        const footerRow = headerRow.cloneNode(true);
        tfoot.appendChild(footerRow);

        // Assemble the table
        table.appendChild(thead);
        table.appendChild(tbody);
        table.appendChild(tfoot); // Append the footer

        container.appendChild(table);

        fragment.appendChild(container);

        return fragment;
    }

    /**
     * main method called when classhelper is clicked
     * @param {URL | string} apiURL
     * @param {HelpUrlProps} props 
     * @param {string[]} preSelectedValues
     * @param {FormData} formData
     * @throws {Error} when fetching or parsing data from roundup rest api fails
     */
    async openPopUp(apiURL, props) {

        /** @type {Response} */
        let resp, json;
        /** @type {any} */
        let collection;
        /** @type {string} */
        let prevPageURL;
        /** @type {string} */
        let nextPageURL;
        /** @type {string[]} */
        let preSelectedValues = [];

        if (document.URL.endsWith("#classhelper-abort")) {
          throw new Error("Aborting due to #classhelper-abort fragment",
			  { cause: "Abort requested." });
        }

        try {
            resp = await fetch(apiURL);
        } catch (error) {
            let message = `Error fetching data from roundup rest api`;
            message += `url: ${apiURL.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        try {
            json = await resp.json();
        } catch (error) {
            let message = "Error parsing json from roundup rest api\n";
            message += `url: ${apiURL.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        if (!resp.ok) {
            let message = `Unexpected response\n`;
            message += `url: ${apiURL.toString()}\n`;
            message += `response status: ${resp.status}\n`;
            message += `response body: ${JSON.stringify(json)}\n`;
            throw new Error(message);
        }

        collection = json.data.collection;

        const links = json.data["@links"];
        if (links?.prev?.length > 0) {
            prevPageURL = links.prev[0].uri;
        }
        if (links?.next?.length > 0) {
            nextPageURL = links.next[0].uri;
        }

        if (props.formProperty) {
            // Find preselected values
            const input = document.getElementsByName(props.formProperty).item(0);
            if (input?.value) {
                preSelectedValues = input.value.split(',');
            }
        }

        const popupFeatures = CLASSHELPER_POPUP_FEATURES(props.width, props.height);
        this.popupRef = window.open(CLASSHELPER_POPUP_URL, CLASSHELPER_POPUP_TARGET, popupFeatures);

        if (this.popupRef == null) {
            throw new Error("Browser Failed to open Popup Window");
        }

        // Create the popup root level page
        const page = document.createDocumentFragment();
        const html = document.createElement("html");
        const head = document.createElement("head");
        const body = document.createElement("body");

        body.classList.add("flex-container");
        if (!props.formProperty) {
            this.popupRef.document.body.classList.add(CLASSHELPER_TABLE_SELECTION_NONE);
            body.classList.add(CLASSHELPER_TABLE_SELECTION_NONE);
        }

        const itemDesignator = window.location.pathname.split("/").at(-1);
        let titleText;

        if (this.dataset.popupTitle) {
            titleText = ClassHelper.translations[this.dataset.popupTitle];
            titleText = titleText.replace(
		CLASSHELPER_ATTRIBUTE_POPUP_TITLE_ITEM_DESIGNATOR_LOOKUP,
		itemDesignator);
        } else {
            titleText = `${itemDesignator} - Classhelper`;
            if (props.formProperty) {
                // use the formProperty as the label for the window
                titleText = props.formProperty + " - " + titleText;
            } else if (props.apiClassName) {
                titleText = ClassHelper.translations[
                    CLASSHELPER_READONLY_POPUP_TITLE
		].replace(
		    CLASSHELPER_ATTRIBUTE_POPUP_TITLE_ITEM_DESIGNATOR_LOOKUP,
		    itemDesignator);
                titleText = titleText.replace(
		    CLASSHELPER_ATTRIBUTE_POPUP_TITLE_ITEM_CLASS_LOOKUP,
		    props.apiClassName);
            }
        }

        const titleTag = document.createElement("title");
        titleTag.textContent = titleText;
        head.appendChild(titleTag);

        const styleSheet = document.createElement("link");
        styleSheet.rel = "stylesheet";
        styleSheet.type = "text/css";
        styleSheet.href = this.trackerBaseURL + '/' + CSS_STYLESHEET_FILE_NAME;
        head.appendChild(styleSheet);

        if (this.dataset.searchWith) {
            const searchFrag = this.getSearchFragment(null);
            body.appendChild(searchFrag);
        }

        const paginationFrag = this.getPaginationFragment(prevPageURL, nextPageURL, props.pageIndex, props.pageSize, collection.length);
        body.appendChild(paginationFrag);

        const tableFrag = this.getTableFragment(props.fields, collection, preSelectedValues);
        body.appendChild(tableFrag);

        const separator = document.createElement("div");
        separator.classList.add("separator");
        body.appendChild(separator);

        if (props.formProperty) {
            const accumulatorFrag = this.getAccumulatorFragment(preSelectedValues);
            body.appendChild(accumulatorFrag);
        }

        html.appendChild(head);
        html.appendChild(body);
        page.appendChild(html);

        const dispatchPopupReady = () => this.dispatchEvent(new CustomEvent("popupReady", { detail: page }));

        // Wait for the popup window to load, onload fire popupReady event on the classhelper
        this.popupRef.addEventListener("load", dispatchPopupReady);

        // If load event was already fired way before the event listener was attached
        // we need to trigger it manually if popupRef is readyState complete
        if (this.popupRef.document.readyState === "complete") {
            dispatchPopupReady();
            // if we did successfully trigger the event, we can remove the event listener
            // else wait for it to be removed with closing of popup window, this cleaning up closure
            this.popupRef.removeEventListener("load", dispatchPopupReady);
        }

        this.popupRef.addEventListener("keydown", (e) => {
            if (e.key === "ArrowDown") {
                if (e.target.tagName === "TR") {
                    e.preventDefault();
                    if (e.target.nextElementSibling != null) {
                        e.target.nextElementSibling.focus();
                    } else {
                        e.target.parentElement.firstChild.focus();
                    }
                } else if (e.target.tagName != "INPUT" && e.target.tagName != "SELECT") {
                    e.preventDefault();
                    this.popupRef.document.querySelector("tr.row-style").parentElement.firstChild.focus();
                }
            } else if (e.key === "ArrowUp") {
                if (e.target.tagName === "TR") {
                    e.preventDefault();
                    if (e.target.previousElementSibling != null) {
                        e.target.previousElementSibling.focus();
                    } else {
                        e.target.parentElement.lastChild.focus();
                    }
                } else if (e.target.tagName != "INPUT" && e.target.tagName != "SELECT") {
                    e.preventDefault();
                    this.popupRef.document.querySelector("tr.row-style").parentElement.lastChild.focus();
                }
            } else if (e.key === ">") {
                if (e.target.tagName === "TR" || e.target.tagName != "INPUT" && e.target.tagName != "SELECT") {
                    this.popupRef.document.getElementById("popup-pagination").lastChild.focus();
                }
            } else if (e.key === "<") {
                if (e.target.tagName === "TR" || e.target.tagName != "INPUT" && e.target.tagName != "SELECT") {
                    this.popupRef.document.getElementById("popup-pagination").firstChild.focus();
                }
            } else if (e.key === "Enter") {
                if (e.target.tagName == "TR" && e.shiftKey == false) {
                    e.preventDefault();
                    let tr = e.target;
                    let checkbox = tr.children.item(0).children.item(0)
                    checkbox.checked = !checkbox.checked;
                    this.dispatchEvent(new CustomEvent("selection", {
                        detail: {
                            value: tr.dataset.id
                        }
                    }));
                } else if (e.shiftKey) {
                    e.preventDefault();
                    const applyBtn = this.popupRef.document.getElementById("popup-apply");
                    if (applyBtn) {
                        applyBtn.focus();
                    }
                }
            } else if (e.key === " ") {
                if (e.target.tagName == "TR" && e.shiftKey == false) {
                    e.preventDefault();
                    let tr = e.target;
                    let checkbox = tr.children.item(0).children.item(0)
                    checkbox.checked = !checkbox.checked;
                    this.dispatchEvent(new CustomEvent("selection", {
                        detail: {
                            value: tr.dataset.id
                        }
                    }));
                }
            }
        });
    }

    /** method when next or previous button is clicked
     * @param {URL | string} apiURL
     * @param {HelpUrlProps} props
     * @throws {Error} when fetching or parsing data from roundup rest api fails
     */
    async pageChange(apiURL, props) {

        /** @type {Response} */
        let resp, json;
        /** @type {any} */
        let collection;
        /** @type {string} */
        let prevPageURL;
        /** @type {string} */
        let nextPageURL;
        /** @type {URL} */
        let selfPageURL;
        /** @type {string[]} */
        let accumulatorValues = [];

        try {
            resp = await fetch(apiURL);
        } catch (error) {
            let message = `Error fetching data from roundup rest api`;
            message += `url: ${apiURL.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        try {
            json = await resp.json();
        } catch (error) {
            let message = "Error parsing json from roundup rest api\n";
            message += `url: ${apiURL.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        if (!resp.ok) {
            let message = `Unexpected response\n`;
            message += `url: ${apiURL.toString()}\n`;
            message += `response status: ${resp.status}\n`;
            message += `response body: ${JSON.stringify(json)}\n`;
            throw new Error(message);
        }

        collection = json.data.collection;

        const links = json.data["@links"];
        if (links?.prev?.length > 0) {
            prevPageURL = links.prev[0].uri;
        }
        if (links?.next?.length > 0) {
            nextPageURL = links.next[0].uri;
        }
        if (links?.self?.length > 0) {
            selfPageURL = new URL(links.self[0].uri);
        }

        const preview = this.popupRef.document.getElementById("popup-preview");
        if (preview) {
            accumulatorValues = preview.value.split(",");
        }

        const popupDocument = this.popupRef.document;
        const popupBody = this.popupRef.document.body;
        const pageIndex = selfPageURL.searchParams.get("@page_index");

        const oldPaginationFrag = popupDocument.getElementById("popup-pagination");
        const newPaginationFrag = this.getPaginationFragment(prevPageURL, nextPageURL, pageIndex, props.pageSize, collection.length);
        popupBody.replaceChild(newPaginationFrag, oldPaginationFrag);

        let oldTableFrag = popupDocument.getElementById("popup-tablediv");
        let newTableFrag = this.getTableFragment(props.fields, collection, accumulatorValues);
        popupBody.replaceChild(newTableFrag, oldTableFrag);
    }

    /** method when a value is selected in 
     * @param {HelpUrlProps} props
     * @param {string} value
     */
    valueSelected(props, value) {
        if (!props.formProperty) {
            return;
        }

        const input = document.getElementsByName(props.formProperty).item(0);
        input.value = value;
        this.popupRef.close();
    }

    /** method when search is performed within classhelper, here we need to update the classhelper table with search results
     * @param {URL} apiURL
     * @param {HelpUrlProps} props
     * @throws {Error} when fetching or parsing data from roundup rest api fails
     */
    async searchEvent(apiURL, props) {

        /** @type {Response} */
        let resp, json;
        /** @type {any} */
        let collection;
        /** @type {string} */
        let prevPageURL;
        /** @type {string} */
        let nextPageURL;
        /** @type {URL} */
        let selfPageURL;
        /** @type {string[]} */
        let accumulatorValues = [];

        try {
            resp = await fetch(apiURL);
        } catch (error) {
            let message = `Error fetching data from roundup rest api`;
            message += `url: ${apiURL.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        try {
            json = await resp.json();
        } catch (error) {
            let message = "Error parsing json from roundup rest api\n";
            message += `url: ${apiURL.toString()}\n`;
            throw new Error(message, { cause: error });
        }

        if (!resp.ok && resp.status === 400) {
            // In the error message we will have the field name that caused the error.
            // and the value that caused the error, in a double quoted string
            //  "(value)"  "(key)", this regex is a capture group
            // that captures the value and key in the error message.
            let regexCaptureDoubleQuotedString = /"(.*?)"/g;
            let iterator = json.error.msg.matchAll(regexCaptureDoubleQuotedString);
            let results = Array.from(iterator);

            if (results.length == 2) {
                let value = results[0][1];
                let field = results[1][1];

                // Find the input element with the name of the key
                let input = this.popupRef.document.getElementsByName(field).item(0);
                if (input) {
                    let parent = input.parentElement;
                    parent.classList.add("search-error");
                    parent.dataset.errorValue = value;
                    parent.dataset.errorField = field;
                    // remove if there was already an error message
                    parent.getElementsByClassName("error-message").item(0)?.remove();
                    let span = document.createElement("div");
                    span.classList.add("error-message");
                    span.textContent = `Invalid value: ${value}`;
                    parent.appendChild(span);
                    return;
                }
            }
        }

        if (!resp.ok && resp.status === 403) {
            this.popupRef.alert(json.error.msg);
            return;
        }

        if (!resp.ok) {
            let message = `Unexpected response\n`;
            message += `url: ${apiURL.toString()}\n`;
            message += `response status: ${resp.status}\n`;
            message += `response body: ${JSON.stringify(json)}\n`;
            throw new Error(message);
        }

        collection = json.data.collection;

        const links = json.data["@links"];
        if (links?.prev?.length > 0) {
            prevPageURL = links.prev[0].uri;
        }
        if (links?.next?.length > 0) {
            nextPageURL = links.next[0].uri;
        }
        if (links?.self?.length > 0) {
            selfPageURL = new URL(links.self[0].uri);
        }

        const preview = this.popupRef.document.getElementById("popup-preview");
        if (preview) {
            accumulatorValues = preview.value.split(",");
        }

        const popupDocument = this.popupRef.document;
        const popupBody = this.popupRef.document.body;
        const pageIndex = selfPageURL.searchParams.get("@page_index");

        // remove any previous error messages
        let errors = Array.from(popupDocument.getElementsByClassName("search-error"));
        errors.forEach(element => {
            element.classList.remove("search-error");
            element.getElementsByClassName("error-message").item(0)?.remove();
        });

        const oldPaginationFrag = popupDocument.getElementById("popup-pagination");
        let newPaginationFrag = this.getPaginationFragment(prevPageURL, nextPageURL, pageIndex, props.pageSize, collection.length);
        popupBody.replaceChild(newPaginationFrag, oldPaginationFrag);


        let oldTableFrag = popupDocument.getElementById("popup-tablediv");
        let newTableFrag = this.getTableFragment(props.fields, collection, accumulatorValues);
        popupBody.replaceChild(newTableFrag, oldTableFrag);
    }

    /** method when an entry in classhelper table is selected
     * @param {string} value
     */
    selectionEvent(value) {
        const preview = this.popupRef.document.getElementById("popup-preview");
        if (!preview) {
            return;
        }

        if (preview.value == "" || preview.value == null) {
            preview.value = value
        } else {
            const values = preview.value.split(',');
            const exists = values.findIndex(v => v == value.toString());

            if (exists > -1) {
                values.splice(exists, 1);
                preview.value = values.join(',');
            } else {
                preview.value += ',' + value;
            }
        }
    }
}

function enableClassHelper() {
    if (document.URL.endsWith("#classhelper-wc-toggle")) {
        return;
    }

    if (DISABLE_CLASSHELPER) {
      return;
    }

    /** make api call if error then do not register*/
    // http://localhost/demo/rest

    fetch("rest")
        .then(resp => resp.json())
        .then(json => {
            if (json.error) {
                console.log(json.error);
                return;
            }
            customElements.define(CLASSHELPER_TAG_NAME, ClassHelper);
            ClassHelper.fetchTranslations()
            .catch(error => {
                console.warn("Classhelper failed in translating.")
                console.error(error);
            });
        }).catch(err => {
            console.error(err);
        });
}

enableClassHelper();
code-513942bca8d2/share/roundup/templates/classic/html/file.index.html0000644000000000000000000000234214727466072023763 0ustar  00000000000000

List of files - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker" />
List of files






 
Download
     Content Type
     Uploaded By
     Date
 

 

  
   dld link
  
  content type
  creator's name
  creation date
 


 





code-513942bca8d2/share/roundup/templates/classic/html/file.item.html0000644000000000000000000000331314727466072023611 0ustar  00000000000000
File display - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
File display





 You are not allowed to view this page.




 Please login with your username and password.







 

  Name
  
 

 

  Content Type
  
 


 

  
    
   
   
   
  
  submit button here
 






download






code-513942bca8d2/share/roundup/templates/classic/html/help.html0000644000000000000000000000270314727466072022667 0ustar  00000000000000




  x
  





  

   
    << previous
     
   
   .. out of 
   
   
    next >>
     
   
  

 

code-513942bca8d2/share/roundup/templates/classic/html/help_controls.js0000644000000000000000000002141014727466072024256 0ustar  00000000000000// initial values for either Nosy, Superseder, Keyword and Waiting On,
// depending on which has called
original_field = form[field].value;

// Some browsers (ok, IE) don't define the "undefined" variable.
undefined = document.geez_IE_is_really_friggin_annoying;

function trim(value) {
  var temp = value;
  var obj = /^(\s*)([\W\w]*)(\b\s*$)/;
  if (obj.test(temp)) { temp = temp.replace(obj, '$2'); }
  var obj = /  /g;
  while (temp.match(obj)) { temp = temp.replace(obj, " "); }
  return temp;
}

function determineList() {
     // generate a comma-separated list of the checked items
     var list = new String('');

     // either a checkbox object or an array of checkboxes
     var check = document.frm_help.check;

     if ((check.length == undefined) && (check.checked != undefined)) {
         // only one checkbox on page
         if (check.checked) {
             list = check.value;
         }
     } else {
         // array of checkboxes
         for (box=0; box < check.length; box++) {
             if (check[box].checked) {
                 if (list.length == 0) {
                     separator = '';
                 }
                 else {
                     separator = ',';
                 }
                 // we used to use an Array and push / join, but IE5.0 sux
                 list = list + separator + check[box].value;
             }
         }
     }
     return list;
}

/**
 * update the field in the opening window;
 * the text_field variable must be set in the calling page
 */
function updateOpener() {
  // write back to opener window
  if (document.frm_help.check==undefined) { return; }
  form[field].value = text_field.value;

  /* trigger change event on the field we changed */
  if ("createEvent" in document) {
    var evt = document.createEvent("HTMLEvents");
    evt.initEvent("change", true, true);
    form[field].dispatchEvent(evt);
  }
    else
	form[field].fireEvent("onchange");
}

function updateList() {
  // write back to opener window
  if (document.frm_help.check==undefined) { return; }
  form[field].value = determineList();

  /* trigger change event on the field we changed */
  if ("createEvent" in document) {
    var evt = document.createEvent("HTMLEvents");
    evt.initEvent("change", true, true);
    form[field].dispatchEvent(evt);
  }
    else
	form[field].fireEvent("onchange");
}

function updatePreview() {
  // update the preview box
  if (document.frm_help.check==undefined) { return; }
  writePreview(determineList());
}

function clearList() {
  // uncheck all checkboxes
  if (document.frm_help.check==undefined) { return; }
  for (box=0; box < document.frm_help.check.length; box++) {
      document.frm_help.check[box].checked = false;
  }
}

function reviseList_framed(form, textfield) {
  // update the checkboxes based on the preview field
  // alert('reviseList_framed')
  // alert(form)
  if (form.check==undefined)
      return;
  // alert(textfield)
  var to_check;
  var list = textfield.value.split(",");
  if (form.check.length==undefined) {
      check = form.check;
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
  } else {
    for (box=0; box < form.check.length; box++) {
      check = form.check[box];
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
    }
  }
}

function reviseList(vals) {
  // update the checkboxes based on the preview field
  if (document.frm_help.check==undefined) { return; }
  var to_check;
  var list = vals.split(",");
  if (document.frm_help.check.length==undefined) {
      check = document.frm_help.check;
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
  } else {
    for (box=0; box < document.frm_help.check.length; box++) {
      check = document.frm_help.check[box];
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
    }
  }
}

function resetList() {
  // reset preview and check boxes to initial values
  if (document.frm_help.check==undefined) { return; }
  writePreview(original_field);
  reviseList(original_field);
}

function writePreview(val) {
   // writes a value to the text_preview
   document.frm_help.text_preview.value = val;
}

function focusField(name) {
    for(i=0; i < document.forms.length; ++i) {
      var obj = document.forms[i].elements[name];
      if (obj && obj.focus) {obj.focus();}
    }
}

function selectField(name) {
    for(i=0; i < document.forms.length; ++i) {
      var obj = document.forms[i].elements[name];
      if (obj && obj.focus){obj.focus();}
      if (obj && obj.select){obj.select();}
    }
}

function checkRequiredFields(fields)
{
    var bonk='';
    var res='';
    var argv = checkRequiredFields.arguments;
    var argc = argv.length;
    var input = '';
    var val='';

    for (var i=0; i < argc; i++) {
        fi = argv[i];
        input = document.getElementById(fi);
        if (input) {
            val = input.value
            if (val == '' || val == '-1' || val == -1) {
                if (res == '') {
                    res = fi;
                    bonk = input;
                } else {
                    res += ', '+fi;
                }
            }
        } else {
            alert('Field with id='+fi+' not found!')
        }
    }
    if (res == '') {
        return submit_once();
    } else {
        alert('Missing value here ('+res+')!');
        if (window.event && window.event.returnvalue) {
            event.returnValue = 0;    // work-around for IE
        }
        bonk.focus();
        return false;
    }
}

/**
 * seeks the given value (2nd argument)
 * in the value of the given input element (1st argument),
 * which is considered a list of values, separated by commas
 */
function has_value(input, val)
{
    var actval = input.value
    var arr = feld.value.split(',');
    var max = arr.length;
    for (i=0;i remove_val()
 *
 * This will work nicely even for batched lists
 */
function append_val(name, val)
{
    var feld = document.itemSynopsis[name];
    var actval = feld.value;
    if (actval == '') {
        feld.value = val
    } else {
        var arr = feld.value.split(',');
        var max = arr.length;
        for (i=0;i append_val()
 */
function remove_val(name, val)
{
    var feld = document.itemSynopsis[name];
    var actval = feld.value;
    var changed=false;
    if (actval == '') {
	return
    } else {
        var arr = feld.value.split(',');
        var max = arr.length;
        var neu = ''
        for (i=0;i
List of classes - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
List of classes


 




  
   classname
  
 

 

  name
  type
 








code-513942bca8d2/share/roundup/templates/classic/html/home.html0000644000000000000000000000106114727466072022663 0ustar  00000000000000

code-513942bca8d2/share/roundup/templates/classic/html/issue.index.html0000644000000000000000000001520314727466072024174 0ustar  00000000000000

  <span tal:omit-tag="true" i18n:translate="" >List of issues</span>
  <span tal:condition="request/dispname"
   tal:replace="python:' - %s '%request.dispname"
  /> - <span tal:replace="config/TRACKER_NAME" />


  List of issues
  





 You are not allowed to view this page.




 Please login with your username and password.



 
  
 

  

   Priority
   ID
   Creation
   Activity
   Actor
   Keyword
   Title
   Status
   Creator
   Assigned To
  

 

   
    
     
    
   
  


  

    
    
    
    
    
    
   
    title
   
    
    
    
  


 

 

  
   

    

     
      << previous
       
     
     .. out of 
     
      next >>
       
     
    

   

  		
 

 



Download as CSV




 
  
  

  

   
    Sort on:
   
   
    
   
   Descending:
   
   
  

  
  

   
    Group on:
   
   
    
   
   Descending:
   
   
  

  
  

              
              
  

 







 vim: sw=1 ts=8 et si

code-513942bca8d2/share/roundup/templates/classic/html/issue.item.html0000644000000000000000000001672714727466072024037 0ustar  00000000000000


<tal:block condition="context/id" i18n:translate=""
 >Issue <tal:x tal:content="context/id" i18n:name="id"
 />: <tal:x content="context/title" i18n:name="title"
 /> - <tal:x content="config/TRACKER_NAME" i18n:name="tracker"
/></tal:block>
<tal:block condition="not:context/id" i18n:translate=""
 >New Issue - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker"
/></tal:block>


 New Issue
 New Issue Editing
 Issue
 Issue Editing






 You are not allowed to view this page.




 Please login with your username and password.












 Title
 title





 Priority
 priority
 Status
 status





 Superseder
 
  
  
    
  
  
   
View:
     
  
 		
 Nosy List
 
  
  
    

 		





 Assigned To
 assignedto menu
 Keywords
 
  
  
    
  
 





 Change Note
 
  
 





 File
 





 
   
  
  
 
 
  submit button
  Make a copy
 













 Note: 
 highlighted
  fields are required.








 Created on 
 by ,
 last changed 
 by .





 
Files

 

  File name
  Uploaded
  Type
  Edit
  Remove
 

 

  
   dld link
  
  
   creator's name,
   creation date
  
  
  edit
  
  
   

    
    
    
    
   

  		
 





  

 
Messages

 

   msg (view)
   Author: 
   Date: 
   
    

     
     
     
     
    

   		
  

  

   
    
content

   		
  

 











code-513942bca8d2/share/roundup/templates/classic/html/issue.search.html0000644000000000000000000002022514727466072024332 0ustar  00000000000000
Issue searching - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
Issue searching




      





  
 Filter on
 Display
 Sort on
 Group on





  All text*:
  
   
   
   





  Title:
  
  
  
   





  Keyword:
  
    
  
  
  
  





  ID:
  
  
  
   





  Creation Date:
  
  
  
  





  Creator:
  
    
  
  
  
  





  Activity:
  
  
  
   





  Actor:
  
    
  
  
  
   





  Priority:
  
    
  
  
  
  





  Status:
  
    
      
      
    
  
  
  
  





  Assigned to:
  
    
      
      
    
  
  
  
  





 No Sort or group:
  
  
 
 





Pagesize:






Start With:






Sort Descending:







Group Descending:







 Query name**:
 
  
  
  
 





  
    
   
  
  




 
 
  
   *: The "all text" field will look in message bodies and issue titles
  

  
   **: If you supply a name, the query will be saved off and available as a
       link in the sidebar
  
 		










code-513942bca8d2/share/roundup/templates/classic/html/keyword.item.html0000644000000000000000000000463614727466072024367 0ustar  00000000000000

Keyword editing - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
Keyword editing




 
Existing Keywords

 

  
    keyword here
  
 

 

  
   To edit an existing keyword (for spelling or typing errors),
   click on its entry above.
  
 






 To create a new keyword, enter it below and click "Submit New Entry".






 

  

   Keyword
   name
   
     
       If we get here and do not have an id, we are creating a new
       keyword. It would be nice to provide some mechanism to
       determine the preferred state of the "Continue adding keywords"
       checkbox. By default I have it enabled.
     
     
     
   
  


  

   
     
    
    
   
   
    submit button will go here
   
  

 






code-513942bca8d2/share/roundup/templates/classic/html/msg.index.html0000644000000000000000000000152214727466072023631 0ustar  00000000000000
List of messages - <span tal:replace="config/TRACKER_NAME"
 i18n:name="tracker"/>
Message listing


  



 
Messages

 

   author
   date
  

  

   
content

  

 

 




code-513942bca8d2/share/roundup/templates/classic/html/msg.item.html0000644000000000000000000000524314727466072023464 0ustar  00000000000000


<tal:block condition="context/id" i18n:translate=""
 >Message <span tal:replace="context/id" i18n:name="id"
 /> - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker"
/></tal:block>
<tal:block condition="not:context/id" i18n:translate=""
 >New Message - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker"
/></tal:block>


 New Message
 New Message Editing
 Message
 Message Editing





 You are not allowed to view this page.




 Please login with your username and password.









 Author
 





 Recipients
 





 Date
 







 
Content

 

  

 






 
Files

 

  File name
  Uploaded
 

 

  
   dld link
  
  
   creator's name,
   creation date
  
 











code-513942bca8d2/share/roundup/templates/classic/html/page.html0000644000000000000000000003612314727466072022656 0ustar  00000000000000


title goes here














  
 
   
   

     
body title

   

 		





 
  

   Your Queries (edit)

   
    link

   
  


  

   

    Issues

    
      Create New

    
    Show Unassigned

    Show All

    Search

    
    
    
    
   

  


  

   Keywords

   
    Create New

   
   
    Edit Existing

   
  


  

   Administration

   
    Class List

   
   
    User List

   
   Add User
  


  

   

    Login

    

    

    
    
    

    
    

    
    
    
    Register

    Lost your login?

   

  


  

   Hello, username

    Your Issues

   Your Details

   Logout
  

  

   Help

   Roundup docs
  

 		
 
  

  

    
     clear this message
  

 		




 Page content goes here

















  
  



  



  
  (cal)



  
  
  
  
  



  



  

    
    (expr)
  





  




  



  
  
  
  



 
    
 
  • 
  
  
    • 
 
  • 
  
  
 
    • 
 




  



  



  










    
    

code-513942bca8d2/share/roundup/templates/classic/html/query.edit.html0000644000000000000000000001522514727466072024033 0ustar  00000000000000

"Your Queries" Editing - <span tal:replace="config/TRACKER_NAME"
 i18n:name="tracker" />
"Your Queries" Editing



You are not allowed to edit queries.







 
 

 
    
 
    



Query
    Include in "Your Queries"
    Edit
    Private to you?
    delete/restore
 (javascript
required)		




 Queries I created





 query

 
  
  
 

 edit

 
  
 

 
  
  
  




 Queries others created
 Owner





 query

 

 [not yours to edit]
 edit
 put query owner here
 





 Active retired/private queries




 query
  
 
 [query is retired]
 [query is retired]
 
  
  
 put query owner here
 




 query
  
 
 [query is private]
 
  
   
 put query owner here
 





   
   
   
   










code-513942bca8d2/share/roundup/templates/classic/html/query.item.html0000644000000000000000000000113314727466072024035 0ustar  00000000000000


  
    You can not view query
    
      You can not view query.
    
    
      You are not allowed to view 
      with id 
    
  

code-513942bca8d2/share/roundup/templates/classic/html/style.css0000644000000000000000000001612114727466072022722 0ustar  00000000000000/* main page styles */
body.body {
  font-family: sans-serif, Arial, Helvetica;
  background-color: white;
  color: #333;
  margin: 0;
}
a[href]:hover {
  color:blue;
  text-decoration: underline;
}
a[href], a[href]:link {
  color:blue;
  text-decoration: none;
}

pre {
  white-space: pre-wrap;
}

table.body {
  border: 0;
  padding: 0;
  border-spacing: 0;
  border-collapse: separate;
}

td.page-header-left {
  padding: 5px;
  border-bottom: 1px solid #444;
}
td.sidebar {
  padding: 1px 0 0 1px;
  white-space: nowrap;
}

/* don't display the sidebar when printing */
@media print {
    td.page-header-left {
        display: none;
    }
    td.sidebar {
        display: none;
    }
    .index-controls {
        display: none;
    }
    #searchbox {
        display: none;
    }
}

td.page-header-top {
  padding: 5px;
  border-bottom: 1px solid #444;
}

div#searchbox {
  float: right;
  padding-top: 1em;
}

div#searchbox input#search-text {
  width: 10em;
}

form {
  margin: 0;
}

textarea {
    font-family: monospace;
}

td.sidebar p.classblock {
  padding: 2px 5px 2px 5px;
  margin: 1px;
  border: 1px solid #444;
  background-color: #eee;
}

td.sidebar p.userblock {
  padding: 2px 5px 2px 5px;
  margin: 1px 1px 1px 1px;
  border: 1px solid #444;
  background-color: #eef;
}

.form-small {
  padding: 0;
  font-size: 75%;
}


td.content {
  padding: 1px 5px 1px 5px;
  vertical-align: top;
  width: 100%;
}

td.date, th.date { 
  white-space: nowrap;
}

p.ok-message {
  background-color: #22bb22;
  padding: 5px;
  color: white;
  font-weight: bold;
}
p.error-message {
  background-color: #bb2222;
  padding: 5px;
  color: white;
  font-weight: bold;
}
p.error-message a[href] {
  color: white;
  text-decoration: underline;
}


/* style for search forms */
ul.search-checkboxes {
    display: inline;
    padding: 0;
    list-style: none;
}
ul.search-checkboxes > li {
    display: inline;
    padding-right: .5em;
}


/* style for forms */
table.form {
  padding: 2px;
  border-spacing: 0;
  border-collapse: separate;
}

table.form th {
  color: #338;
  text-align: right;
  vertical-align: top;
  font-weight: normal;
  white-space: nowrap;
}

table.form th.header {
  font-weight: bold;
  background-color: #eef;
  text-align: left;
}

table.form th.required {
  font-weight: bold;
}

table.form td {
  color: #333;
  empty-cells: show;
  vertical-align: top;
}

table.form td.optional {
  font-weight: bold;
  font-style: italic;
}

table.form td.html {
  color: #777;
}

/* style for lists */
table.list {
  border-spacing: 0;
  border-collapse: separate;
  width: 100%;
}

table.list th {
  padding: 0 4px 0 4px;
  color: #404070;
  background-color: #eef;
  border: 1px solid white;
  vertical-align: top;
  empty-cells: show;
}
table.list th a[href]:hover { color: #404070 }
table.list th a[href]:link { color: #404070 }
table.list th a[href] { color: #404070 }
table.list th.group {
  background-color: #f4f4ff;
  text-align: center;
}

table.list td {
  padding: 0 4px 0 4px;
  border: 1px solid white;
  color: #404070;
  background-color: #efefef;
  vertical-align: top;
  empty-cells: show;
}

table.list tr.navigation th {
  width: 33%;
  border-style: hidden;
  text-align: center;
}
table.list tr.navigation td {
    border: none
}
table.list tr.navigation th:first-child {
  text-align: left;
}
table.list tr.navigation th:last-child {
  text-align: right;
}


/* style for message displays */
table.messages {
  border-spacing: 0;
  border-collapse: separate;
  width: 100%;
}

table.messages th.header{
  padding-top: 10px;
  border-bottom: 1px solid gray;
  font-weight: bold;
  background-color: white;
  color: #707040;
}

table.messages th {
  font-weight: bold;
  color: black;
  text-align: left;
  border-bottom: 1px solid #afafaf;
}

table.messages td {
  font-family: monospace;
  background-color: #efefef;
  border-bottom: 1px solid #afafaf;
  color: black;
  empty-cells: show;
  border-right: 1px solid #afafaf;
  vertical-align: top;
  padding: 2px 5px 2px 5px;
}

table.messages td:first-child {
  border-left: 1px solid #afafaf;
  border-right: 1px solid #afafaf;
}

/* style for file displays */
table.files {
  border-spacing: 0;
  border-collapse: separate;
  width: 100%;
}

table.files th.header{
  padding-top: 10px;
  border-bottom: 1px solid gray;
  font-weight: bold;
  background-color: white;
  color: #707040;
}

table.files th {
  border-bottom: 1px solid #afafaf;
  font-weight: bold;
  text-align: left;
}

table.files td {
  font-family: monospace;
  empty-cells: show;
}

/* style for history displays */
table.history {
  border-spacing: 0;
  border-collapse: separate;
  width: 100%;
}

table.history th.header{
  padding-top: 10px;
  border-bottom: 1px solid gray;
  font-weight: bold;
  background-color: white;
  color: #707040;
  font-size: 100%;
}

table.history th {
  border-bottom: 1px solid #afafaf;
  font-weight: bold;
  text-align: left;
  font-size: 90%;
}

table.history td {
  font-size: 90%;
  vertical-align: top;
  empty-cells: show;
}


/* style for class list */
table.classlist {
  border-spacing: 0;
  border-collapse: separate;
  width: 100%;
}

table.classlist th.header{
  padding-top: 10px;
  border-bottom: 1px solid gray;
  font-weight: bold;
  background-color: white;
  color: #707040;
}

table.classlist th {
  font-weight: bold;
  text-align: left;
}


/* style for class help display */
table.classhelp {      /* the table-layout: fixed;        */ 
  table-layout: fixed; /* compromises quality for speed   */
  overflow: hidden;
  font-size: .9em;
  padding-bottom: 3em;
}

table.classhelp th {
  font-weight: normal;
  text-align: left;
  color: #444;
  background-color: #efefef;
  border-bottom: 1px solid #afafaf;
  border-top: 1px solid #afafaf;
  text-transform: uppercase;
  vertical-align: middle;
  line-height:1.5em;
}

table.classhelp td {
  vertical-align: middle;
  padding-right: .2em;
  border-bottom: 1px solid #efefef;
  text-align: left;
  empty-cells: show;
  white-space: nowrap;
  vertical-align: middle;
}

table.classhelp tr:hover {
  background-color: #eee;
}

label.classhelp-label {
  cursor: pointer;
}

#classhelp-controls {
  position: fixed;
  display: block;
  top: auto;
  right: 0;
  bottom: 0;
  left: 0;
  padding: .5em;
  border-top: 2px solid #444;
  background-color: #eee;
}

#classhelp-controls input.apply {
  width: 7em;
  font-weight: bold;
  margin-right: 2em;
  margin-left: 2em;
}

#classhelp-controls input.preview {
   margin-right: 3em;
   margin-left: 1em;
}

/* style for "other" displays */
table.otherinfo {
  border-spacing: 0;
  border-collapse: separate;
  width: 100%;
}

table.otherinfo th.header{
  padding-top: 10px;
  border-bottom: 1px solid gray;
  font-weight: bold;
  background-color: white;
  color: #707040;
}

table.otherinfo th {
  border-bottom: 1px solid #afafaf;
  font-weight: bold;
  text-align: left;
}

input[type="text"]:focus,
input[type="checkbox"]:focus,
input[type="radio"]:focus,
input[type="password"]:focus,
textarea:focus, select:focus {
  background-color: #ffffc0;
}

.calendar_display {
  text-align: center;
}

.calendar_display td {
  padding: 1px 4px 1px 4px;
}

.calendar_display .today {
  background-color: #afafaf;
}

/* vim: sts=2 sw=2 et
*/
code-513942bca8d2/share/roundup/templates/classic/html/user.forgotten.html0000644000000000000000000000327314727466072024726 0ustar  00000000000000

Password reset request - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
Password reset request



You have two options if you have forgotten your password.
If you know the email address you registered with, enter it below.




    

      

        Email Address:
        
      

      

         
        
          
          
          
          
        
      





Or, if you know your username, then enter it below.




 
Username:  

 







A confirmation email will be sent to you -
please follow the instructions within it to complete the reset process.




code-513942bca8d2/share/roundup/templates/classic/html/user.help-search.html0000644000000000000000000000600614727466072025107 0ustar  00000000000000
  
    Search input for user helper
    
    
    
  
  
    
    

   
   
   
   



  Name
  





  Phone
  





  role
  
    
  





   
  
    
    
    
    
    
    
  



   






  

code-513942bca8d2/share/roundup/templates/classic/html/user.help.html0000644000000000000000000000356414727466072023652 0ustar  00000000000000

  
      
      
      
      <tal:x i18n:translate=""><tal:x i18n:name="property"
       tal:content="property" i18n:translate="" /> help - <span i18n:name="tracker"
	       tal:replace="config/TRACKER_NAME" /></tal:x>
      
      
      
  

  
  
  
  
  


  <body>
<p i18n:translate="">
Your browser is not capable of using frames; you should be redirected immediately,
or visit <a href="#" tal:attributes="href string:?${qs}&template=help-noframes"
i18n:name="link">this link</a>.
</p>
</body>



code-513942bca8d2/share/roundup/templates/classic/html/user.index.html0000644000000000000000000001002214727466072024014 0ustar  00000000000000

User listing - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
User listing


You are not allowed to view this page.

Please login with your username and password.







   
Search for users

   

       Username
       
           
       
       Realname
       
           
       

       
   




   








 Username
 Real name
 Organisation
 Email address
 Phone number
 Retire




 
  username
 
  
  
  
  
 
    

     
     
     
     
    

 		



 

  
   

    

     
      << previous
       
     
     .. out of 
     
      next >>
       
     
    

   

  		
 







code-513942bca8d2/share/roundup/templates/classic/html/user.item.html0000644000000000000000000001443114727466072023653 0ustar  00000000000000


<tal:if condition="context/id" i18n:translate=""
 >User <tal:x content="context/id" i18n:name="id"
 />: <tal:x content="context/username" i18n:name="title"
 /> - <tal:x content="config/TRACKER_NAME" i18n:name="tracker"
/></tal:if>
<tal:if condition="not:context/id" i18n:translate=""
 >New User - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker"
/></tal:if>






 New User
 New User Editing
 User
 User Editing






 You are not allowed to view this page.




 Please login with your username and password.








 
 

 

  Name
  
 

 

   Login Name
   
 

 

  Login Password
  
 

 

  Confirm Password
  
 

 
 

  
  
    
      
    
    
      
    
   (to give the user more than one role,
    enter a comma,separated,list)
  
 

 

 

  Phone
  
 


 

  Organisation
  
 


 

  Timezone
  
   (the default is
    )
  
 


 

  E-mail address
  
      calvin@the-z.org
      
      
      
       
  
 


 

  
  
    
  
 


 

  
    
   
   
  
  
    
  
 











 Note: 
 highlighted
  fields are required.














code-513942bca8d2/share/roundup/templates/classic/html/user.register.html0000644000000000000000000000545714727466072024551 0ustar  00000000000000

Registering with <span i18n:name="tracker"
 tal:replace="db/config/TRACKER_NAME" />
Registering with 








 

  Name
  realname
 

 

  Login Name
  username
 

 

  Login Password
  password
 

 

  Confirm Password
  password
 

 

  Roles
  roles
  
   
  
 

 

  Phone
  phone
 

 

  Organisation
  organisation
 

 

  E-mail address
  address
 

 

  Alternate E-mail addresses
One address per line		
  alternate_addresses
 


 

   
  
   
   
   
   
   
  
 











 Note: 
 highlighted
  fields are required.









code-513942bca8d2/share/roundup/templates/classic/html/user.rego_progress.html0000644000000000000000000000117314727466072025574 0ustar  00000000000000

Registration in progress - <span i18n:name="tracker"
 tal:replace="config/TRACKER_NAME" />
Registration in progress...



You will shortly receive an email
to confirm your registration. To complete the registration process,
visit the link indicated in the email.





code-513942bca8d2/share/roundup/templates/classic/html/user_utils.js0000644000000000000000000000600114727466072023600 0ustar  00000000000000// User Editing Utilities

/**
 * for new users:
 * Depending on the input field which calls it, takes the value
 * and dispatches it to certain other input fields:
 *
 * address
 *  +-> username
 *  |    `-> realname
 *  `-> organisation
 */
function split_name(that) {
    var raw = that.value
    var val = trim(raw)
    if (val == '') {
        return
    }
    var username=''
    var realname=''
    var address=''
    switch (that.name) {
        case 'address':
            address=val
            break
        case 'username':
            username=val
            break
        case 'realname':
            realname=val
            break
        case 'firstname':
        case 'lastname':
           return
        default:
            alert('Ooops - unknown name field '+that.name+'!')
            return
    }
    var the_form = that.form;

    function field_empty(name) {
        return the_form[name].value == ''
    }

    // no break statements - on purpose!
    switch (that.name) {
        case 'address':
            var split1 = address.split('@')
            if (field_empty('username')) {
                username = split1[0]
                the_form.username.value = username
            }
            if (field_empty('organisation')) {
                the_form.organisation.value = default_organisation(split1[1])
            }
        case 'username':
            if (field_empty('realname')) {
                realname = Cap(username.split('.').join(' '))
                the_form.realname.value = realname
            }
        case 'realname':
            if (field_empty('username')) {
                username = Cap(realname.replace(' ', '.'))
                the_form.username.value = username
            }
            if (the_form.firstname && the_form.lastname) {
                var split2 = realname.split(' ')
                var firstname='', lastname=''
                firstname = split2[0]
                lastname = split2.slice(1).join(' ')
                if (field_empty('firstname')) {
                    the_form.firstname.value = firstname
                }
                if (field_empty('lastname')) {
                    the_form.lastname.value = lastname
                }
            }
    }
}

function SubCap(str) {
    switch (str) {
        case 'de': case 'do': case 'da':
        case 'du': case 'von':
            return str;
    }
    if (str.toLowerCase().slice(0,2) == 'mc') {
        return 'Mc'+str.slice(2,3).toUpperCase()+str.slice(3).toLowerCase()
    }
    return str.slice(0,1).toUpperCase()+str.slice(1).toLowerCase()
}

function Cap(str) {
    var liz = str.split(' ')
    for (var i=0; i/db/files/]
#   type = String()       [MIME type of the content, default 'text/plain']
msg = FileClass(db, "msg",
                author=Link("user", do_journal='no'),
                recipients=Multilink("user", do_journal='no'),
                date=Date(),
                summary=String(),
                files=Multilink("file"),
                messageid=String(),
                inreplyto=String())

file = FileClass(db, "file",
                name=String())

# IssueClass automatically gets these properties in addition to the Class ones:
#   title = String()
#   messages = Multilink("msg")
#   files = Multilink("file")
#   nosy = Multilink("user")
#   superseder = Multilink("issue")
issue = IssueClass(db, "issue",
                assignedto=Link("user"),
                keyword=Multilink("keyword"),
                priority=Link("priority"),
                status=Link("status"))

#
# TRACKER SECURITY SETTINGS
#
# See the configuration and customisation document for information
# about security setup.

#
# REGULAR USERS
#
# Give the regular users access to the web and email interface
db.security.addPermissionToRole('User', 'Web Access')
db.security.addPermissionToRole('User', 'Email Access')
db.security.addPermissionToRole('User', 'Rest Access')
db.security.addPermissionToRole('User', 'Xmlrpc Access')

# Assign the access and edit Permissions for issue, file and message
# to regular users now
for cl in 'issue', 'file', 'msg', 'keyword':
    db.security.addPermissionToRole('User', 'View', cl)
    db.security.addPermissionToRole('User', 'Edit', cl)
    db.security.addPermissionToRole('User', 'Create', cl)
for cl in 'priority', 'status':
    db.security.addPermissionToRole('User', 'View', cl)

# May users view other user information? Comment these lines out
# if you don't want them to
p = db.security.addPermission(name='View', klass='user', 
    properties=('id', 'organisation', 'phone', 'realname', 'timezone',
    'username'))
db.security.addPermissionToRole('User', p)

# Users should be able to edit their own details -- this permission is
# limited to only the situation where the Viewed or Edited item is their own.
def own_record(db, userid, itemid):
    '''Determine whether the userid matches the item being accessed.'''
    return userid == itemid
p = db.security.addPermission(name='View', klass='user', check=own_record,
    description="User is allowed to view their own user details")
db.security.addPermissionToRole('User', p)
p = db.security.addPermission(name='Edit', klass='user', check=own_record,
    properties=('username', 'password', 'address', 'realname', 'phone',
        'organisation', 'alternate_addresses', 'queries', 'timezone'),
    description="User is allowed to edit their own user details")
db.security.addPermissionToRole('User', p)

# Users should be able to edit and view their own queries. They should also
# be able to view any marked as not private. They should not be able to
# edit others' queries, even if they're not private
def view_query(db, userid, itemid):
    private_for = db.query.get(itemid, 'private_for')
    if not private_for: return True
    return userid == private_for
def edit_query(db, userid, itemid):
    return userid == db.query.get(itemid, 'creator')
p = db.security.addPermission(name='View', klass='query', check=view_query,
    description="User is allowed to view their own and public queries")
db.security.addPermissionToRole('User', p)
p = db.security.addPermission(name='Search', klass='query')
db.security.addPermissionToRole('User', p)
p = db.security.addPermission(name='Edit', klass='query', check=edit_query,
    description="User is allowed to edit their queries")
db.security.addPermissionToRole('User', p)
p = db.security.addPermission(name='Retire', klass='query', check=edit_query,
    description="User is allowed to retire their queries")
db.security.addPermissionToRole('User', p)
p = db.security.addPermission(name='Restore', klass='query', check=edit_query,
    description="User is allowed to restore their queries")
db.security.addPermissionToRole('User', p)
p = db.security.addPermission(name='Create', klass='query',
    description="User is allowed to create queries")
db.security.addPermissionToRole('User', p)


#
# ANONYMOUS USER PERMISSIONS
#
# Let anonymous users access the web interface. Note that almost all
# trackers will need this Permission. The only situation where it's not
# required is in a tracker that uses an HTTP Basic Authenticated front-end.
db.security.addPermissionToRole('Anonymous', 'Web Access')

# Let anonymous users access the email interface (note that this implies
# that they will be registered automatically, hence they will need the
# "Register" user Permission below)
# This is disabled by default to stop spam from auto-registering users on
# public trackers.
#db.security.addPermissionToRole('Anonymous', 'Email Access')

# Assign the appropriate permissions to the anonymous user's Anonymous
# Role. Choices here are:
# - Allow anonymous users to register
db.security.addPermissionToRole('Anonymous', 'Register', 'user')

# Allow anonymous users access to view issues (and the related, linked
# information)
for cl in 'issue', 'file', 'msg', 'keyword', 'priority', 'status':
    db.security.addPermissionToRole('Anonymous', 'View', cl)

# Allow the anonymous user to use the "Show Unassigned" search.
# It acts like "Show Open" if this permission is not available.
# If you are running a tracker that does not allow read access for
# anonymous, you should remove this entry as it can be used to perform
# a username guessing attack against a roundup install.
p = db.security.addPermission(name='Search', klass='user')
db.security.addPermissionToRole ('Anonymous', p)

# [OPTIONAL]
# Allow anonymous users access to create or edit "issue" items (and the
# related file and message items)
#for cl in 'issue', 'file', 'msg':
#   db.security.addPermissionToRole('Anonymous', 'Create', cl)
#   db.security.addPermissionToRole('Anonymous', 'Edit', cl)


# vim: set filetype=python sts=4 sw=4 et si :
code-513942bca8d2/share/roundup/templates/devel/TEMPLATE-INFO.txt0000644000000000000000000000050514727466072022266 0ustar  00000000000000Name: devel
Description: This is a generic issue tracker that may be used to track bugs,
             feature requests, project issues or any number of other types
             of issues. Most users of Roundup will find that this template
             suits them, with perhaps a few customisations.
Intended-For: Developers

code-513942bca8d2/share/roundup/templates/devel/detectors/messagesummary.py0000644000000000000000000000075214727466072025175 0ustar  00000000000000from roundup.mailgw import parseContent

def summarygenerator(db, cl, nodeid, newvalues):
    ''' If the message doesn't have a summary, make one for it.
    '''
    if 'summary' in newvalues or 'content' not in newvalues:
        return

    summary, content = parseContent(newvalues['content'], config=db.config)
    newvalues['summary'] = summary


def init(db):
    # fire before changes are made
    db.msg.audit('create', summarygenerator)

# vim: set filetype=python ts=4 sw=4 et si
code-513942bca8d2/share/roundup/templates/devel/detectors/no_texthtml.py0000644000000000000000000000041114727466072024470 0ustar  00000000000000
def audit_html_files(db, cl, nodeid, newvalues):
    if 'type' in newvalues and newvalues['type'] == 'text/html':
        newvalues['type'] = 'text/plain'
    

def init(db):
    db.file.audit('set', audit_html_files)
    db.file.audit('create', audit_html_files)
code-513942bca8d2/share/roundup/templates/devel/detectors/nosyreaction.py0000644000000000000000000001134414727466072024647 0ustar  00000000000000from roundup import roundupdb, hyperdb

def nosyreaction(db, cl, nodeid, oldvalues):
    ''' A standard detector is provided that watches for additions to the
        "messages" property.
        
        When a new message is added, the detector sends it to all the users on
        the "nosy" list for the issue that are not already on the "recipients"
        list of the message.
        
        Those users are then appended to the "recipients" property on the
        message, so multiple copies of a message are never sent to the same
        user.
        
        The journal recorded by the hyperdatabase on the "recipients" property
        then provides a log of when the message was sent to whom. 
    '''
    # send a copy of all new messages to the nosy list
    for msgid in determineNewMessages(cl, nodeid, oldvalues):
        try:
            cl.nosymessage(nodeid, msgid, oldvalues)
        except roundupdb.MessageSendError as message:
            raise roundupdb.DetectorError(message)

def determineNewMessages(cl, nodeid, oldvalues):
    ''' Figure a list of the messages that are being added to the given
        node in this transaction.
    '''
    messages = []
    if oldvalues is None:
        # the action was a create, so use all the messages in the create
        messages = cl.get(nodeid, 'messages')
    elif 'messages' in oldvalues:
        # the action was a set (so adding new messages to an existing issue)
        m = {}
        for msgid in oldvalues['messages']:
            m[msgid] = 1
        messages = []
        # figure which of the messages now on the issue weren't there before
        for msgid in cl.get(nodeid, 'messages'):
            if msgid not in m:
                messages.append(msgid)
    return messages

def updatenosy(db, cl, nodeid, newvalues):
    '''Update the nosy list for changes to the assignedto
    '''
    # nodeid will be None if this is a new node
    current_nosy = set()
    if nodeid is None:
        ok = ('new', 'yes')
    else:
        ok = ('yes',)
        # old node, get the current values from the node if they haven't
        # changed
        if 'nosy' not in newvalues:
            nosy = cl.get(nodeid, 'nosy')
            for value in nosy:
                current_nosy.add(value)

    # if the nosy list changed in this transaction, init from the new value
    if 'nosy' in newvalues:
        nosy = newvalues.get('nosy', [])
        for value in nosy:
            if not db.hasnode('user', value):
                continue
            current_nosy.add(value)

    new_nosy = set(current_nosy)

    # add assignedto(s) to the nosy list
    if 'assignedto' in newvalues and newvalues['assignedto'] is not None:
        propdef = cl.getprops()
        if isinstance(propdef['assignedto'], hyperdb.Link):
            assignedto_ids = [newvalues['assignedto']]
        elif isinstance(propdef['assignedto'], hyperdb.Multilink):
            assignedto_ids = newvalues['assignedto']
        for assignedto_id in assignedto_ids:
            new_nosy.add(assignedto_id)

    # see if there's any new messages - if so, possibly add the author and
    # recipient to the nosy
    if 'messages' in newvalues:
        if nodeid is None:
            ok = ('new', 'yes')
            messages = newvalues['messages']
        else:
            ok = ('yes',)
            # figure which of the messages now on the issue weren't
            oldmessages = cl.get(nodeid, 'messages')
            messages = []
            for msgid in newvalues['messages']:
                if msgid not in oldmessages:
                    messages.append(msgid)

        # configs for nosy modifications
        add_author = getattr(db.config, 'ADD_AUTHOR_TO_NOSY', 'new')
        add_recips = getattr(db.config, 'ADD_RECIPIENTS_TO_NOSY', 'new')

        # now for each new message:
        msg = db.msg
        for msgid in messages:
            if add_author in ok:
                authid = msg.get(msgid, 'author')
                new_nosy.add(authid)

            # add on the recipients of the message
            if add_recips in ok:
                for recipient in msg.get(msgid, 'recipients'):
                    new_nosy.add(recipient)

    if current_nosy != new_nosy:
        # that's it, save off the new nosy list
        newvalues['nosy'] = list(new_nosy)

def init(db):
    db.bug.react('create', nosyreaction)
    db.bug.react('set', nosyreaction)
    db.bug.audit('create', updatenosy)
    db.bug.audit('set', updatenosy)

    db.task.react('create', nosyreaction)
    db.task.react('set', nosyreaction)
    db.task.audit('create', updatenosy)
    db.task.audit('set', updatenosy)

    db.milestone.react('create', nosyreaction)
    db.milestone.react('set', nosyreaction)
    db.milestone.audit('create', updatenosy)
    db.milestone.audit('set', updatenosy)
code-513942bca8d2/share/roundup/templates/devel/detectors/patches.py0000644000000000000000000000276314727466072023566 0ustar  00000000000000# Auditor for patch files
# Patches should be declared as text/plain (also .py files),
# independent of what the browser says, and
# the "patch" keyword should get set automatically.

import posixpath

patchtypes = ('.diff', '.patch')
sourcetypes = ('.diff', '.patch', '.py')

def ispatch(file, types):
    return posixpath.splitext(file)[1] in types

def patches_text_plain(db, cl, nodeid, newvalues):
    if ispatch(newvalues['name'], sourcetypes):
        newvalues['type'] = 'text/plain'

def patches_keyword(db, cl, nodeid, newvalues):
    # Check whether there are any new files
    newfiles = set(newvalues.get('files',()))
    if nodeid:
        newfiles -= set(db.bug.get(nodeid, 'files'))
    # Check whether any of these is a patch
    newpatch = False
    for fileid in newfiles:
        if ispatch(db.file.get(fileid, 'name'), patchtypes):
            newpatch = True
            break
    if newpatch:
        # Add the patch keyword if its not already there
        patchid = db.keyword.lookup("patch")
        oldkeywords = []
        if nodeid:
            oldkeywords = db.bug.get(nodeid, 'keywords')
            if patchid in oldkeywords:
                # This is already marked as a patch
                return
        if 'keywords' not in newvalues:
            newvalues['keywords'] = oldkeywords
        newvalues['keywords'].append(patchid)

def init(db): pass
#    db.file.audit('create', patches_text_plain)
#    db.bug.audit('create', patches_keyword)
#    db.bug.audit('set', patches_keyword)
code-513942bca8d2/share/roundup/templates/devel/detectors/severityauditor.py0000644000000000000000000000046514727466072025376 0ustar  00000000000000
def init_severity(db, cl, nodeid, newvalues):
    """Make sure severity is set on new bugs"""
    if 'severity' in newvalues and newvalues['severity']:
        return

    normal = db.severity.lookup('normal')
    newvalues['severity'] = normal

def init(db): pass
    #db.bug.audit('create', init_severity)
code-513942bca8d2/share/roundup/templates/devel/detectors/statusauditor.py0000644000000000000000000000050514727466072025042 0ustar  00000000000000def preset_new(db, cl, nodeid, newvalues):
    """ Make sure the status is set on new bugs"""

    if 'status' in newvalues and newvalues['status']:
        return

    new = db.status.lookup('new')
    newvalues['status'] = new


def init(db): pass
    # fire before changes are made
    #db.bug.audit('create', preset_new)
code-513942bca8d2/share/roundup/templates/devel/detectors/userauditor.py0000644000000000000000000001047714727466072024506 0ustar  00000000000000# Copyright (c) 2003 Richard Jones (richard@mechanicalcat.net)
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
#   The above copyright notice and this permission notice shall be included in
#   all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.
#

import re

# regular expression thanks to: http://www.regular-expressions.info/email.html
# this is the "99.99% solution for syntax only".
email_regexp = (r"[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*", r"(localhost|(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9]))")
email_rfc = re.compile('^' + email_regexp[0] + '@' + email_regexp[1] + '$', re.IGNORECASE)
email_local = re.compile('^' + email_regexp[0] + '$', re.IGNORECASE)

valid_username = re.compile('^[a-z0-9_@!%.+-]+$', re.IGNORECASE)

def valid_address(address):
    ''' If we see an @-symbol in the address then check against the full
        RFC syntax. Otherwise it is a local-only address so only check
        the local part of the RFC syntax.
    '''
    if '@' in address:
        return email_rfc.match(address)
    else:
        return email_local.match(address)

def get_addresses(user):
    ''' iterate over all known addresses in a newvalues dict
        this takes of the address/alterate_addresses handling
    '''
    if 'address' in user:
        yield user['address']
    if user.get('alternate_addresses', None):
        for address in user['alternate_addresses'].split('\n'):
            yield address

def audit_user_fields(db, cl, nodeid, newvalues):
    ''' Make sure user properties are valid.

        - email address is syntactically valid
        - email address is unique
        - roles specified exist
        - timezone is valid
        - username matches A-z0-9_-.@!+% (email symbols)
    '''

    if 'username' in newvalues:
        if not valid_username.match(newvalues['username']):
            raise ValueError("Username/Login Name must consist only of the letters a-z (any case), digits 0-9 and the symbols: @._-!+%")
        
    for address in get_addresses(newvalues):
        if not valid_address(address):
            raise ValueError('Email address syntax is invalid "%s"'%address)

        check_main = db.user.stringFind(address=address)
        # make sure none of the alts are owned by anyone other than us (x!=nodeid)
        check_alts = [x for x in db.user.filter(None, {'alternate_addresses' : address}) if x != nodeid]
        if check_main or check_alts:
            raise ValueError('Email address %s already in use' % address)

    newroles = newvalues.get('roles')
    if newroles:
        for rolename in [r.lower().strip() for r in newroles.split(',')]:
            if rolename and rolename not in db.security.role:
                raise ValueError('Role "%s" does not exist'%rolename)

    tz = newvalues.get('timezone', None)
    if tz:
        # if they set a new timezone validate the timezone by attempting to
        # use it before we store it to the db.
        import roundup.date
        import datetime
        try:
            TZ = roundup.date.get_timezone(tz)
            dt = datetime.datetime.now()
            local = TZ.localize(dt).utctimetuple()
        except IOError:
            raise ValueError('Timezone "%s" does not exist' % tz)
        except ValueError:
            raise ValueError('Timezone "%s" exceeds valid range [-23...23]' % tz)

def init(db):
    # fire before changes are made
    db.user.audit('set', audit_user_fields)
    db.user.audit('create', audit_user_fields)

# vim: sts=4 sw=4 et si
code-513942bca8d2/share/roundup/templates/devel/extensions/local_replace.py0000644000000000000000000000522414727466072025122 0ustar  00000000000000from __future__ import print_function
import re

hg_url_base = r'http://sourceforge.net/p/roundup/code/ci/'

substitutions = [ (re.compile(r'debian:\#(?P\d+)'),
                   r'debian#\g' ),
                  (re.compile(r'\#(?P\s*)(?P\d+)'),
                   r"#\g\g" ),
                  (re.compile(r'(?P^|\s+)issue(?P\s*)(?P\d+)'),
                   r"\gissue\g\g" ),
                  # matching the typical number:hash format of hg's own output
                  # and then use use hash instead of the number
                  (re.compile(r'(?P(^|\s+))(?P(rev|hg|changeset:   ))(?P\d+):(?P[0-9a-fA-F]{12,40})(?P\W+|$)'),
                      r'\g\g\g:\g\g'),
                  # matching hg revison number or hash
                  (re.compile(r'(?P(^|\s+))(?P(revision|rev|r)\s?)(?P([1-9][0-9]*)|[0-9a-fA-F]{4,40})(?P\W+|$)'),
                   r'\g\g\g\g'),
                  ]

def local_replace(message):

    for cre, replacement in substitutions:
        message = cre.sub(replacement, message)

    return message


def init(instance):
    instance.registerUtil('localReplace', local_replace)

def quicktest(msgstr, should_replace = True):
    testcount['run'] += 1
    replacedstr = local_replace(msgstr)

    if not (not replacedstr == msgstr ) == should_replace:
        print("(fail)", end=' ')
        testcount['failed'] += 1

    if replacedstr == msgstr:
        print( "'%s'" % (msgstr,))
    else:
        print("'%s' -> '%s'" % (msgstr, replacedstr))

if "__main__" == __name__:
    testcount = {'run':0 , 'failed': 0}
    print("Replacement examples:")
    quicktest(" debian:#222")
    quicktest(" #555")
    quicktest("issue333")
    quicktest(" revision 222")
    quicktest(" r 222")
    quicktest(" wordthatendswithr 222", False)
    quicktest(" references", False)
    quicktest(" too many spaces r  222", False)
    quicktest("re-evaluate", False)
    quicktest("rex140eb", False)
    quicktest("rev 012", False) # too short for a hg hash
    quicktest("rev 0123")
    quicktest("re140eb")
    quicktest(" r7140eb")
    quicktest(" rev7140eb ")
    quicktest("rev7140eb")
    quicktest("rev7140eb,")
    quicktest("rev4891:ad3d628e73f2")
    quicktest("hg4891:ad3d628e73f2")
    quicktest("changeset:   4542:46239c21a1eb")
    print()
    print(testcount)
code-513942bca8d2/share/roundup/templates/devel/extensions/spambayes.py0000644000000000000000000000522214727466072024317 0ustar  00000000000000import re, math
from roundup.cgi.actions import Action
from roundup.cgi.exceptions import *
from roundup.anypy import xmlrpc_

import socket

REVPAT = re.compile(r'(r[0-9]+\b|rev(ision)? [0-9]+\b)')

def extract_classinfo(db, classname, nodeid):
    node = db.getnode(classname, nodeid)

    authorage = node['creation'].timestamp() - \
                db.getnode('user', node.get('author', node.get('creator')))['creation'].timestamp()

    authorid = node.get('author', node.get('creator'))

    content = db.getclass(classname).get(nodeid, 'content')

    tokens = ["klass:%s" % classname,
              "author:%s" % authorid,
              "authorage:%d" % int(math.log(authorage)),
              "hasrev:%s" % (REVPAT.search(content) is not None)]

    return (content, tokens)

def train_spambayes(db, content, tokens, is_spam):
    spambayes_uri = db.config.detectors['SPAMBAYES_URI']

    server = xmlrpc_.client.ServerProxy(spambayes_uri, verbose=False)
    try:
        server.train({'content':content}, tokens, {}, is_spam)
        return (True, None)
    except (socket.error, xmlrpc_.client.Error) as e:
        return (False, str(e))


class SpambayesClassify(Action):
    permissionType = 'SB: May Classify'
    
    def handle(self):
        (content, tokens) = extract_classinfo(self.db,
                                              self.classname, self.nodeid)

        if "trainspam" in self.form:
            is_spam = True
        elif "trainham" in self.form:
            is_spam = False

        (status, errmsg) = train_spambayes(self.db, content, tokens,
                                           is_spam)

        node = self.db.getnode(self.classname, self.nodeid)
        props = {}

        if status:
            if node.get('spambayes_misclassified', False):
                props['spambayes_misclassified'] = True

            props['spambayes_score'] = 1.0
            
            s = " SPAM"
            if not is_spam:
                props['spambayes_score'] = 0.0
                s = " HAM"
            self.client.add_ok_message(self._('Message classified as') + s)
        else:
            self.client.add_error_message(self._('Unable to classify message, got error:') + errmsg)

        klass = self.db.getclass(self.classname)
        klass.set(self.nodeid, **props)
        self.db.commit()

def sb_is_spam(obj):
    cutoff_score = float(obj._db.config.detectors['SPAMBAYES_SPAM_CUTOFF'])
    try:
        score = obj['spambayes_score']
    except KeyError:
        return False
    return score >= cutoff_score

def init(instance):
    instance.registerAction("spambayes_classify", SpambayesClassify)
    instance.registerUtil('sb_is_spam', sb_is_spam)
    
code-513942bca8d2/share/roundup/templates/devel/extensions/timezone.py0000644000000000000000000000171514727466072024170 0ustar  00000000000000# Utility for replacing the simple input field for the timezone with
# a select-field that lists the available values.

try:
    from html import escape
except ImportError:
    from cgi import escape

try:
    import pytz
except ImportError:
    pytz = None


def tzfield(prop, name, default):
    if pytz:
        value = prop.plain()        
        if '' == value:
            value = default
        else:
            try:
                value = "Etc/GMT%+d" % int(value)
            except ValueError:
                pass

        l = ['')
        return '\n'.join(l)
        
    else:
        return prop.field()

def init(instance):
    instance.registerUtil('tzfield', tzfield)
code-513942bca8d2/share/roundup/templates/devel/html/_generic.404.html0000644000000000000000000000067414727466072023503 0ustar  00000000000000

  
  Item Not Found
  
  
  Item Not Found
  


    There is no  with id
    


code-513942bca8d2/share/roundup/templates/devel/html/_generic.calendar.html0000644000000000000000000000146314727466072024742 0ustar  00000000000000

 
  
  
  
  
  
 
 
 

code-513942bca8d2/share/roundup/templates/devel/html/_generic.collision.html0000644000000000000000000000136714727466072025167 0ustar  00000000000000
<span tal:replace="python:context._classname.capitalize()"
 i18n:name="class" /> Edit Collision - <span i18n:name="tracker"
 tal:replace="config/TRACKER_NAME" />
 Edit Collision




code-513942bca8d2/share/roundup/templates/devel/html/_generic.help-empty.html0000644000000000000000000000026114727466072025250 0ustar  00000000000000
  
    Empty page (no search performed yet)
  
  
    
Please specify your search parameters!

  

code-513942bca8d2/share/roundup/templates/devel/html/_generic.help-list.html0000644000000000000000000000364614727466072025077 0ustar  00000000000000
  
You are not
  allowed to view this page.


  
   
    

      

       << previous
       1..25 out of 50
       next >>
      

    

    

    
           

      
        

           x
          
        

      
      
        

      

      
       

         
             
             
             
                 
             
           
         

       
     

   

     
     
     
     
     

code-513942bca8d2/share/roundup/templates/devel/html/_generic.help-search.html0000644000000000000000000000054614727466072025365 0ustar  00000000000000
  
    Frame for search input fields
  
  
    
Generic template
    help-search
    or version for class
    user
    is not yet implemented

  


code-513942bca8d2/share/roundup/templates/devel/html/_generic.help-submit.html0000644000000000000000000000554214727466072025424 0ustar  00000000000000
  
      
      
      
      Generic submit page for framed helper windows
      
      
      
      
  
 
 
 

     

       
     

     
     
     
     
 

 
 

code-513942bca8d2/share/roundup/templates/devel/html/_generic.help.html0000644000000000000000000000675414727466072024131 0ustar  00000000000000


 

     
           

      
       

       

      

      
       

       

      

       

         
               
           
         
       

     


 

   
 
 
 
     

      

       
        << previous
         
       
       .. out of 
       
       
        next >>
         
       
      

     


     
             

       

           
       

       

         
                 
             
           
       

       

           
       

     

 
 
 

code-513942bca8d2/share/roundup/templates/devel/html/_generic.index.html0000644000000000000000000000477214727466072024306 0ustar  00000000000000
<span tal:replace="python:context._classname.capitalize()"
 i18n:name="class" /> editing - <span i18n:name="tracker"
 tal:replace="config/TRACKER_NAME" />
 editing



You are not allowed to view this page.

Please login with your username and password.





 You may edit the contents of the
 
 class using this form. Commas, newlines and double quotes (") must be
 handled delicately. You may include commas and newlines by enclosing the
 values in double-quotes ("). Double quotes themselves must be quoted by
 doubling ("").





 Multilink properties have their multiple values colon (":") separated
 (... ,"one:two:three", ...)





 Remove entries by deleting their line. Add new entries by appending
 them to the table - put an X in the id column.
















 

 

   
 

 

   
 

 






code-513942bca8d2/share/roundup/templates/devel/html/_generic.item.html0000644000000000000000000000322414727466072024124 0ustar  00000000000000
<span tal:replace="python:context._classname.capitalize()"
 i18n:name="class" /> editing - <span i18n:name="tracker"
 tal:replace="config/TRACKER_NAME" />
 editing





 You are not allowed to view this page.




 Please login with your username and password.











  




 
  
 




  
 
  submit button will go here
 
















code-513942bca8d2/share/roundup/templates/devel/html/_generic.keywords_expr.html0000644000000000000000000000073014727466072026072 0ustar  00000000000000

 
  
  
  
 
 
 

code-513942bca8d2/share/roundup/templates/devel/html/_generic.query.html0000644000000000000000000000252414727466072024335 0ustar  00000000000000
  
You are not
  allowed to view this page.


  
    

     
           

      
	

        

      

      
        

	

      

      
       

         
             
             
             
                 
             
           
         

       
     

    

  


code-513942bca8d2/share/roundup/templates/devel/html/bug.index.html0000644000000000000000000001704514727466072023305 0ustar  00000000000000

  <span tal:omit-tag="true" i18n:translate="" >List of bugs</span>
  <span tal:condition="request/dispname"
   tal:replace="python:' - %s '%request.dispname"
  /> - <span tal:replace="config/TRACKER_NAME" />


  List of bugs
  





 You are not allowed to view this page.




 Please login with your username and password.



 
  
 

  

   Severity
   ID
   Creation
   Activity
   Actor
   Title
   Components
   Versions
   Status
   Resolution
   Creator
   Assigned To
   Keywords
   Depends On
   Type
  

 

   
    
     
    
   
  


  

    
    
    
    
    
   
    title
   
    
    
    
    
    
    
    
    
    
  


 

 

  
   

    

     
      << previous
       
     
     .. out of 
     
      next >>
       
     
    

   

  		
 

 






 
  


  

   
    Group on:
   
   
    
   
   Descending:
   
   
  

  
  

              
              
  

 







code-513942bca8d2/share/roundup/templates/devel/html/bug.item.html0000644000000000000000000003113714727466072023132 0ustar  00000000000000

<tal:block condition="context/id" i18n:translate=""
 >Bug <span tal:replace="context/id" i18n:name="id"
 />: <span tal:replace="context/title" i18n:name="title"
 /> - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker"
/></tal:block>
<tal:block condition="not:context/id" i18n:translate=""
 >New Bug report - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker"
/></tal:block>


 New Bug
 New Bug Editing
 Bug 
 Bug  Editing






 You are not allowed to view this page.




 Please login with your username and password.









classification




 Title:
 title
 
  
  
 





 
   
   Type:
 
 type
 
   
   Severity:
 
 severity





 
   
   Components:
 
 components
 
   
   Versions:
 
 versions








process




 
   
   Status:
 
 status
 
   
   Resolution:
 
 resolution





 
  Dependencies:
  
 
 
  
  
   
View: 
  
 		
 
  Superseder:
  
 
 
  
 

   
View:
      
   
 		
 

 

 Assigned To:
 assignedto menu
 Nosy List:
  
 
 
  
 




 
   
   Priority:
 
 priority
 Keywords:
 keywords






 Comment:
 
  
 





 File:
 
   
   
 




 File Description:
 












 
   
  
  
 
 
  submit button
  Make a copy
 









 Created on 
 by ,
 last changed 
 by .





 
Files

 

  File name
  Uploaded
  Description
  Edit
  Remove
 

 

  
   dld link
  
  
   creator's name,
   creation date
  
  
  edit
  
  
   

    
    
    
   

  		
 





  

 
Messages

 

   msg
   Author:  ()
   Date: 
   
    

     
     
     
    

   		
  

  

   
    
content

   		
  

 











code-513942bca8d2/share/roundup/templates/devel/html/bug.search.html0000644000000000000000000002540114727466072023436 0ustar  00000000000000
Bug searching - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
Bug searching




      





  
 Filter on
 Display
 Sort on
 Group on





  All text*:
  
   
   
   





  Title:
  
  
  
   





  ID:
  
  
  
   





  Creation Date:
  
  
  
  





  Creator:
  
    
  
  
  
  





  Activity:
  
  
  
   





  Last actor:
  
    
  
  
  
   





  Nosy list member:
  
  
  
   





  Type:
  
    
  
  
  
  





  Components:
  
    
  
  
  
  





  Versions:
  
    
  
  
  
  







  Depends on:
  
  
  
  





  Assigned to:
  
    
      
      
    
  
  
  
  





  Keyword:
  
    
  
  
  
  





  Priority:
  
    
  
  
  
  





  Status:
  
    
      
      
    
  
  
  
  





  Resolution:
  
  
  
  





 No Sort or group:
  
  
 
 





Pagesize:






Start With:






Sort Descending:







Group Descending:







 Query name**:
 
  
  
  
 





  
    
   
  
  




 
 
  
   *: The "all text" field will look in message bodies and bug titles
  

  
   **: If you supply a name, the query will be saved off and available as a
       link in the sidebar
  
 		










code-513942bca8d2/share/roundup/templates/devel/html/favicon.ico0000644000000000000000000003535614727466072022662 0ustar  00000000000000 h6   00 %F(  @5BGE8?L9/&{;ND:0&@		XND:0%A5,!<5bXN=4*!yA u@os=p:KlbXNC9/$z4}CרyAt=K2[olaWMC9.$AF}Dx@g6NnjaWMB8.$GJG|Cv?i6E1\LHGAEkA8-#FMIF{Bu>p;j7i6h5`2OEB7-=ÏPLHEyAt=o:i6i6i6`2CKA6$ƑROKH}Dx@s=m9i6i6i6HUJ>
ďN~LH}Ct=l9f6l8i6i6HIF{Bu>p;j7i6ALEyAt>o:i6(NJH~Dx@q94/*% |D!OMHC>94/*%s{z3
WRMHC>94/*:[VRMHC=94/;`[VQMHC=83/*% ,
e`[VQLGC=83.)%'$7AF6je`[VQLZNHHHHHHHHHFA6!
v>vzBبy@xAv?Hoje`[VQLGB=83.)${C!}DFE|CzBx@Htojd_[VQLGB=83.)${9HHGF~D|CyAIusojd_ZUQLGB=83.)$HIJIGF}D{BMuusnid_ZUPLGB=82.)$ud-KKJHGE}CuR+otuusnid_ZUPKFB=82-($8M׼LKIHF~Ep=a؃uuusnid_ZUPKFA<82-(#ÏPOMKJHGE}Dp:bF#eLIHHHHHHHGفMKFA<72-("<őQÏPNMKJHFE|CzBx@v?s=qs=p;n:l8j6i6i6h5dF$pMKFA<72*.ǓSǒRĐPOMLJIGF~D{ByAw?t>r*̓U~ʕTǒRĐQŽONLJIGF~D|CyAw@u>s=p;n9l8i6i6H^YTOJA̖SkǓRƒRďPOMLJIGE}D{ByAw?t>rs=q;o:l8HONLJIGF~D{CyAw?u>rrm9ɐOCƐPĐPOMLJIGF~D{ByAt=ǛXĐRO˿MؾMKJHF~CتzBw?\(0` %
#.6:=BEA=:3+!	3,s.,+&%#ݞ	oL@.	9C<<:730-)&# `|Z>BPFC@=:730-)&# r>K3LJGC@=9630-)&"C$a~Y+	RPMJGC@=9630-)&"^ݞ9VTPMJGC@=9630,)iAZWTPMJFC@=963/,^G]ZWTPMIFC@=962/,II`]ZWTPMIFC@=962/,)&"Id`]ZVSPMIFC?<962/,(%"7gd`]YVSPMIFC?<962/,(%"+-?GIII7jgd`]YVSPMI\PIIIIIIIIIIIIIIIIF;'j;+u>zBzByAw@v?t>Imjfc`]YVSOLIFC?<952/,(%"ӓL2nD%}D~E}C{BzAx@w?u>Ipmjfc`]YVSOLIFC?<852/,(%!	O+EرFE~D|C{ByAx@v?Itpmjfc`]YVSOLIFB?<852/+(%!ڟCDoHGFE}D|CzByAw@Iuspmjfc`\YVSOLIEB?<852.+(%!
a~Y+	IضIHGF~E}D{CzBxAIuuspmjfc_\YVSOLHEB?<852.+(%!ӓ=KKJIGFE~D|C{BzAKsuuspmjfc_\YVSOLHEB?<852.+(%!JHmKJIHGFE~D|C{BS<Yruuusplifc_\YUROLHEB>;852.+'$!
yc)LLKJIHGFE}D|C_4juuuusolifc_\YUROLHEB>;852.+'$!Ւ2LؽMLKJIHGF~E}DwAPruuuusolifc_\YUROLHEB>;851.+'$!:N㿋NLKJIHGFE~D|Ce7J`ruuuusolieb_\YUROKHEB>;841.+'$!<ŽONMLKJIHGFE~D|Ce7<{Yjruuusolieb_\YURNKHEB>;841.+'$!<ÏPONMLKJIHGFE}D|Cv?م_4QKIIIIIIIIIIIG9YLMKHEB>;841.+'$<ŐQÎPONMLKJIHGF~E}C{BzAx@w?u>t=r;841-*'"9ŏPĐQŽPONLKJIHGFE~D|C{ByAx@v?u>s=r;841-*%1ƑQőQďPŽONMLKJIHGFE~D|C{ByAw@v?t>s=q;741-%)ǑQǒRŐQÏPONMLKJIHGFE}D|CzByAw@v?t>s=qt=rs=rs=qs=qt=rs=rs=qs=qt=rs=rs=qt=rs=rs=qs=l8ǐRƑRĐQǕ[ܿƧXLKJIHGF~E}C{BzAx@w?u>r<^3F
ǛXŒPƑQĐPŽONMLKJIHGFE~D|C{ByAx@t>j7eǛXőQďOÏPONMLKJIHGFE}D|CzBw?؝n
List of files - <span tal:replace="config/TRACKER_NAME" i18n:name="tracker" />
List of files






 
Download
     Description
     Content Type
     Uploaded By
     Date
 

 

  
   dld link
  
  description
  content type
  creator's name
  creation date
 


 





code-513942bca8d2/share/roundup/templates/devel/html/file.item.html0000644000000000000000000000602214727466072023267 0ustar  00000000000000
File display - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
File display





 You are not allowed to view this page.




 Please login with your username and password.







 

  Name
  
 

 

  Description
  
 

 

  Content Type
  
  Please note that
  for security reasons, it's not permitted to set content type to text/html.
 

 

  
    
   
   
   
  
  submit button here
 








download











code-513942bca8d2/share/roundup/templates/devel/html/help.css0000644000000000000000000000075014727466072022171 0ustar  00000000000000@import url(style.css);

body { padding: 0;}
body > .header,
body > .footer
{
  margin: 0;
}
body .content { width: auto;}
.header h1 { font-size: 110%; }

table.classhelp th
{
  border-top: 1px solid #afafaf;
  border-bottom: 1px solid #afafaf;
  empty-cells: show;
  text-align: left;
  vertical-align: middle;
  white-space: nowrap;
}

table.classhelp td
{
  border-bottom: 1px solid #efefef;
  empty-cells: show;
  text-align: left;
  vertical-align: middle;
  white-space: nowrap;
}
code-513942bca8d2/share/roundup/templates/devel/html/help.html0000644000000000000000000000552314727466072022350 0ustar  00000000000000



  
  
    <tal:x i18n:name="what" tal:content="what" i18n:translate="" />
    help - <span i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
  
  
  
  
  


  

    
Roundup Issue Tracker: Help - item

  

  

    Page content goes here
  
 
  

    
  
 







  





  

   
    << previous
     
   
   .. out of 
   
   
    next >>
     
   
  



code-513942bca8d2/share/roundup/templates/devel/html/help_controls.js0000644000000000000000000002140614727466072023741 0ustar  00000000000000// initial values for either Nosy, Superseder, Topic and Waiting On,
// depending on which has called
original_field = form[field].value;

// Some browsers (ok, IE) don't define the "undefined" variable.
undefined = document.geez_IE_is_really_friggin_annoying;

function trim(value) {
  var temp = value;
  var obj = /^(\s*)([\W\w]*)(\b\s*$)/;
  if (obj.test(temp)) { temp = temp.replace(obj, '$2'); }
  var obj = /  /g;
  while (temp.match(obj)) { temp = temp.replace(obj, " "); }
  return temp;
}

function determineList() {
     // generate a comma-separated list of the checked items
     var list = new String('');

     // either a checkbox object or an array of checkboxes
     var check = document.frm_help.check;

     if ((check.length == undefined) && (check.checked != undefined)) {
         // only one checkbox on page
         if (check.checked) {
             list = check.value;
         }
     } else {
         // array of checkboxes
         for (box=0; box < check.length; box++) {
             if (check[box].checked) {
                 if (list.length == 0) {
                     separator = '';
                 }
                 else {
                     separator = ',';
                 }
                 // we used to use an Array and push / join, but IE5.0 sux
                 list = list + separator + check[box].value;
             }
         }
     }
     return list;
}

/**
 * update the field in the opening window;
 * the text_field variable must be set in the calling page
 */
function updateOpener() {
  // write back to opener window
  if (document.frm_help.check==undefined) { return; }
  form[field].value = text_field.value;

  /* trigger change event on the field we changed */
  if ("createEvent" in document) {
    var evt = document.createEvent("HTMLEvents");
    evt.initEvent("change", true, true);
    form[field].dispatchEvent(evt);
  }
    else
	form[field].fireEvent("onchange");
}

function updateList() {
  // write back to opener window
  if (document.frm_help.check==undefined) { return; }
  form[field].value = determineList();

  /* trigger change event on the field we changed */
  if ("createEvent" in document) {
    var evt = document.createEvent("HTMLEvents");
    evt.initEvent("change", true, true);
    form[field].dispatchEvent(evt);
  }
    else
	form[field].fireEvent("onchange");
}

function updatePreview() {
  // update the preview box
  if (document.frm_help.check==undefined) { return; }
  writePreview(determineList());
}

function clearList() {
  // uncheck all checkboxes
  if (document.frm_help.check==undefined) { return; }
  for (box=0; box < document.frm_help.check.length; box++) {
      document.frm_help.check[box].checked = false;
  }
}

function reviseList_framed(form, textfield) {
  // update the checkboxes based on the preview field
  // alert('reviseList_framed')
  // alert(form)
  if (form.check==undefined)
      return;
  // alert(textfield)
  var to_check;
  var list = textfield.value.split(",");
  if (form.check.length==undefined) {
      check = form.check;
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
  } else {
    for (box=0; box < form.check.length; box++) {
      check = form.check[box];
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
    }
  }
}

function reviseList(vals) {
  // update the checkboxes based on the preview field
  if (document.frm_help.check==undefined) { return; }
  var to_check;
  var list = vals.split(",");
  if (document.frm_help.check.length==undefined) {
      check = document.frm_help.check;
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
  } else {
    for (box=0; box < document.frm_help.check.length; box++) {
      check = document.frm_help.check[box];
      to_check = false;
      for (val in list) {
          if (check.value==trim(list[val])) {
              to_check = true;
              break;
          }
      }
      check.checked = to_check;
    }
  }
}

function resetList() {
  // reset preview and check boxes to initial values
  if (document.frm_help.check==undefined) { return; }
  writePreview(original_field);
  reviseList(original_field);
}

function writePreview(val) {
   // writes a value to the text_preview
   document.frm_help.text_preview.value = val;
}

function focusField(name) {
    for(i=0; i < document.forms.length; ++i) {
      var obj = document.forms[i].elements[name];
      if (obj && obj.focus) {obj.focus();}
    }
}

function selectField(name) {
    for(i=0; i < document.forms.length; ++i) {
      var obj = document.forms[i].elements[name];
      if (obj && obj.focus){obj.focus();}
      if (obj && obj.select){obj.select();}
    }
}

function checkRequiredFields(fields)
{
    var bonk='';
    var res='';
    var argv = checkRequiredFields.arguments;
    var argc = argv.length;
    var input = '';
    var val='';

    for (var i=0; i < argc; i++) {
        fi = argv[i];
        input = document.getElementById(fi);
        if (input) {
            val = input.value
            if (val == '' || val == '-1' || val == -1) {
                if (res == '') {
                    res = fi;
                    bonk = input;
                } else {
                    res += ', '+fi;
                }
            }
        } else {
            alert('Field with id='+fi+' not found!')
        }
    }
    if (res == '') {
        return submit_once();
    } else {
        alert('Missing value here ('+res+')!');
        if (window.event && window.event.returnvalue) {
            event.returnValue = 0;    // work-around for IE
        }
        bonk.focus();
        return false;
    }
}

/**
 * seeks the given value (2nd argument)
 * in the value of the given input element (1st argument),
 * which is considered a list of values, separated by commas
 */
function has_value(input, val)
{
    var actval = input.value
    var arr = feld.value.split(',');
    var max = arr.length;
    for (i=0;i remove_val()
 *
 * This will work nicely even for batched lists
 */
function append_val(name, val)
{
    var feld = document.itemSynopsis[name];
    var actval = feld.value;
    if (actval == '') {
        feld.value = val
    } else {
        var arr = feld.value.split(',');
        var max = arr.length;
        for (i=0;i append_val()
 */
function remove_val(name, val)
{
    var feld = document.itemSynopsis[name];
    var actval = feld.value;
    var changed=false;
    if (actval == '') {
	return
    } else {
        var arr = feld.value.split(',');
        var max = arr.length;
        var neu = ''
        for (i=0;i
List of classes - <span
 i18n:name="tracker" tal:replace="config/TRACKER_NAME" />
List of classes


 




  
   classname
  
 

 

  name
  type
 








code-513942bca8d2/share/roundup/templates/devel/html/home.html0000644000000000000000000000074314727466072022347 0ustar  00000000000000

code-513942bca8d2/share/roundup/templates/devel/html/jquery-3.6.3.js0000644000000000000000000107544714727466072023071 0ustar  00000000000000/*!
 * jQuery JavaScript Library v3.6.3
 * https://jquery.com/
 *
 * Includes Sizzle.js
 * https://sizzlejs.com/
 *
 * Copyright OpenJS Foundation and other contributors
 * Released under the MIT license
 * https://jquery.org/license
 *
 * Date: 2022-12-20T21:28Z
 */
( function( global, factory ) {

	"use strict";

	if ( typeof module === "object" && typeof module.exports === "object" ) {

		// For CommonJS and CommonJS-like environments where a proper `window`
		// is present, execute the factory and get jQuery.
		// For environments that do not have a `window` with a `document`
		// (such as Node.js), expose a factory as module.exports.
		// This accentuates the need for the creation of a real `window`.
		// e.g. var jQuery = require("jquery")(window);
		// See ticket trac-14549 for more info.
		module.exports = global.document ?
			factory( global, true ) :
			function( w ) {
				if ( !w.document ) {
					throw new Error( "jQuery requires a window with a document" );
				}
				return factory( w );
			};
	} else {
		factory( global );
	}

// Pass this if window is not defined yet
} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) {

// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1
// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode
// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common
// enough that all such attempts are guarded in a try block.
"use strict";

var arr = [];

var getProto = Object.getPrototypeOf;

var slice = arr.slice;

var flat = arr.flat ? function( array ) {
	return arr.flat.call( array );
} : function( array ) {
	return arr.concat.apply( [], array );
};


var push = arr.push;

var indexOf = arr.indexOf;

var class2type = {};

var toString = class2type.toString;

var hasOwn = class2type.hasOwnProperty;

var fnToString = hasOwn.toString;

var ObjectFunctionString = fnToString.call( Object );

var support = {};

var isFunction = function isFunction( obj ) {

		// Support: Chrome <=57, Firefox <=52
		// In some browsers, typeof returns "function" for HTML  elements
		// (i.e., `typeof document.createElement( "object" ) === "function"`).
		// We don't want to classify *any* DOM node as a function.
		// Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5
		// Plus for old WebKit, typeof returns "function" for HTML collections
		// (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756)
		return typeof obj === "function" && typeof obj.nodeType !== "number" &&
			typeof obj.item !== "function";
	};


var isWindow = function isWindow( obj ) {
		return obj != null && obj === obj.window;
	};


var document = window.document;



	var preservedScriptAttributes = {
		type: true,
		src: true,
		nonce: true,
		noModule: true
	};

	function DOMEval( code, node, doc ) {
		doc = doc || document;

		var i, val,
			script = doc.createElement( "script" );

		script.text = code;
		if ( node ) {
			for ( i in preservedScriptAttributes ) {

				// Support: Firefox 64+, Edge 18+
				// Some browsers don't support the "nonce" property on scripts.
				// On the other hand, just using `getAttribute` is not enough as
				// the `nonce` attribute is reset to an empty string whenever it
				// becomes browsing-context connected.
				// See https://github.com/whatwg/html/issues/2369
				// See https://html.spec.whatwg.org/#nonce-attributes
				// The `node.getAttribute` check was added for the sake of
				// `jQuery.globalEval` so that it can fake a nonce-containing node
				// via an object.
				val = node[ i ] || node.getAttribute && node.getAttribute( i );
				if ( val ) {
					script.setAttribute( i, val );
				}
			}
		}
		doc.head.appendChild( script ).parentNode.removeChild( script );
	}


function toType( obj ) {
	if ( obj == null ) {
		return obj + "";
	}

	// Support: Android <=2.3 only (functionish RegExp)
	return typeof obj === "object" || typeof obj === "function" ?
		class2type[ toString.call( obj ) ] || "object" :
		typeof obj;
}
/* global Symbol */
// Defining this global in .eslintrc.json would create a danger of using the global
// unguarded in another place, it seems safer to define global only for this module



var
	version = "3.6.3",

	// Define a local copy of jQuery
	jQuery = function( selector, context ) {

		// The jQuery object is actually just the init constructor 'enhanced'
		// Need init if jQuery is called (just allow error to be thrown if not included)
		return new jQuery.fn.init( selector, context );
	};

jQuery.fn = jQuery.prototype = {

	// The current version of jQuery being used
	jquery: version,

	constructor: jQuery,

	// The default length of a jQuery object is 0
	length: 0,

	toArray: function() {
		return slice.call( this );
	},

	// Get the Nth element in the matched element set OR
	// Get the whole matched element set as a clean array
	get: function( num ) {

		// Return all the elements in a clean array
		if ( num == null ) {
			return slice.call( this );
		}

		// Return just the one element from the set
		return num < 0 ? this[ num + this.length ] : this[ num ];
	},

	// Take an array of elements and push it onto the stack
	// (returning the new matched element set)
	pushStack: function( elems ) {

		// Build a new jQuery matched element set
		var ret = jQuery.merge( this.constructor(), elems );

		// Add the old object onto the stack (as a reference)
		ret.prevObject = this;

		// Return the newly-formed element set
		return ret;
	},

	// Execute a callback for every element in the matched set.
	each: function( callback ) {
		return jQuery.each( this, callback );
	},

	map: function( callback ) {
		return this.pushStack( jQuery.map( this, function( elem, i ) {
			return callback.call( elem, i, elem );
		} ) );
	},

	slice: function() {
		return this.pushStack( slice.apply( this, arguments ) );
	},

	first: function() {
		return this.eq( 0 );
	},

	last: function() {
		return this.eq( -1 );
	},

	even: function() {
		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
			return ( i + 1 ) % 2;
		} ) );
	},

	odd: function() {
		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
			return i % 2;
		} ) );
	},

	eq: function( i ) {
		var len = this.length,
			j = +i + ( i < 0 ? len : 0 );
		return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] );
	},

	end: function() {
		return this.prevObject || this.constructor();
	},

	// For internal use only.
	// Behaves like an Array's method, not like a jQuery method.
	push: push,
	sort: arr.sort,
	splice: arr.splice
};

jQuery.extend = jQuery.fn.extend = function() {
	var options, name, src, copy, copyIsArray, clone,
		target = arguments[ 0 ] || {},
		i = 1,
		length = arguments.length,
		deep = false;

	// Handle a deep copy situation
	if ( typeof target === "boolean" ) {
		deep = target;

		// Skip the boolean and the target
		target = arguments[ i ] || {};
		i++;
	}

	// Handle case when target is a string or something (possible in deep copy)
	if ( typeof target !== "object" && !isFunction( target ) ) {
		target = {};
	}

	// Extend jQuery itself if only one argument is passed
	if ( i === length ) {
		target = this;
		i--;
	}

	for ( ; i < length; i++ ) {

		// Only deal with non-null/undefined values
		if ( ( options = arguments[ i ] ) != null ) {

			// Extend the base object
			for ( name in options ) {
				copy = options[ name ];

				// Prevent Object.prototype pollution
				// Prevent never-ending loop
				if ( name === "__proto__" || target === copy ) {
					continue;
				}

				// Recurse if we're merging plain objects or arrays
				if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
					( copyIsArray = Array.isArray( copy ) ) ) ) {
					src = target[ name ];

					// Ensure proper type for the source value
					if ( copyIsArray && !Array.isArray( src ) ) {
						clone = [];
					} else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) {
						clone = {};
					} else {
						clone = src;
					}
					copyIsArray = false;

					// Never move original objects, clone them
					target[ name ] = jQuery.extend( deep, clone, copy );

				// Don't bring in undefined values
				} else if ( copy !== undefined ) {
					target[ name ] = copy;
				}
			}
		}
	}

	// Return the modified object
	return target;
};

jQuery.extend( {

	// Unique for each copy of jQuery on the page
	expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),

	// Assume jQuery is ready without the ready module
	isReady: true,

	error: function( msg ) {
		throw new Error( msg );
	},

	noop: function() {},

	isPlainObject: function( obj ) {
		var proto, Ctor;

		// Detect obvious negatives
		// Use toString instead of jQuery.type to catch host objects
		if ( !obj || toString.call( obj ) !== "[object Object]" ) {
			return false;
		}

		proto = getProto( obj );

		// Objects with no prototype (e.g., `Object.create( null )`) are plain
		if ( !proto ) {
			return true;
		}

		// Objects with prototype are plain iff they were constructed by a global Object function
		Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
		return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
	},

	isEmptyObject: function( obj ) {
		var name;

		for ( name in obj ) {
			return false;
		}
		return true;
	},

	// Evaluates a script in a provided context; falls back to the global one
	// if not specified.
	globalEval: function( code, options, doc ) {
		DOMEval( code, { nonce: options && options.nonce }, doc );
	},

	each: function( obj, callback ) {
		var length, i = 0;

		if ( isArrayLike( obj ) ) {
			length = obj.length;
			for ( ; i < length; i++ ) {
				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
					break;
				}
			}
		} else {
			for ( i in obj ) {
				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
					break;
				}
			}
		}

		return obj;
	},

	// results is for internal usage only
	makeArray: function( arr, results ) {
		var ret = results || [];

		if ( arr != null ) {
			if ( isArrayLike( Object( arr ) ) ) {
				jQuery.merge( ret,
					typeof arr === "string" ?
						[ arr ] : arr
				);
			} else {
				push.call( ret, arr );
			}
		}

		return ret;
	},

	inArray: function( elem, arr, i ) {
		return arr == null ? -1 : indexOf.call( arr, elem, i );
	},

	// Support: Android <=4.0 only, PhantomJS 1 only
	// push.apply(_, arraylike) throws on ancient WebKit
	merge: function( first, second ) {
		var len = +second.length,
			j = 0,
			i = first.length;

		for ( ; j < len; j++ ) {
			first[ i++ ] = second[ j ];
		}

		first.length = i;

		return first;
	},

	grep: function( elems, callback, invert ) {
		var callbackInverse,
			matches = [],
			i = 0,
			length = elems.length,
			callbackExpect = !invert;

		// Go through the array, only saving the items
		// that pass the validator function
		for ( ; i < length; i++ ) {
			callbackInverse = !callback( elems[ i ], i );
			if ( callbackInverse !== callbackExpect ) {
				matches.push( elems[ i ] );
			}
		}

		return matches;
	},

	// arg is for internal usage only
	map: function( elems, callback, arg ) {
		var length, value,
			i = 0,
			ret = [];

		// Go through the array, translating each of the items to their new values
		if ( isArrayLike( elems ) ) {
			length = elems.length;
			for ( ; i < length; i++ ) {
				value = callback( elems[ i ], i, arg );

				if ( value != null ) {
					ret.push( value );
				}
			}

		// Go through every key on the object,
		} else {
			for ( i in elems ) {
				value = callback( elems[ i ], i, arg );

				if ( value != null ) {
					ret.push( value );
				}
			}
		}

		// Flatten any nested arrays
		return flat( ret );
	},

	// A global GUID counter for objects
	guid: 1,

	// jQuery.support is not used in Core but other projects attach their
	// properties to it so it needs to exist.
	support: support
} );

if ( typeof Symbol === "function" ) {
	jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ];
}

// Populate the class2type map
jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ),
	function( _i, name ) {
		class2type[ "[object " + name + "]" ] = name.toLowerCase();
	} );

function isArrayLike( obj ) {

	// Support: real iOS 8.2 only (not reproducible in simulator)
	// `in` check used to prevent JIT error (gh-2145)
	// hasOwn isn't used here due to false negatives
	// regarding Nodelist length in IE
	var length = !!obj && "length" in obj && obj.length,
		type = toType( obj );

	if ( isFunction( obj ) || isWindow( obj ) ) {
		return false;
	}

	return type === "array" || length === 0 ||
		typeof length === "number" && length > 0 && ( length - 1 ) in obj;
}
var Sizzle =
/*!
 * Sizzle CSS Selector Engine v2.3.9
 * https://sizzlejs.com/
 *
 * Copyright JS Foundation and other contributors
 * Released under the MIT license
 * https://js.foundation/
 *
 * Date: 2022-12-19
 */
( function( window ) {
var i,
	support,
	Expr,
	getText,
	isXML,
	tokenize,
	compile,
	select,
	outermostContext,
	sortInput,
	hasDuplicate,

	// Local document vars
	setDocument,
	document,
	docElem,
	documentIsHTML,
	rbuggyQSA,
	rbuggyMatches,
	matches,
	contains,

	// Instance-specific data
	expando = "sizzle" + 1 * new Date(),
	preferredDoc = window.document,
	dirruns = 0,
	done = 0,
	classCache = createCache(),
	tokenCache = createCache(),
	compilerCache = createCache(),
	nonnativeSelectorCache = createCache(),
	sortOrder = function( a, b ) {
		if ( a === b ) {
			hasDuplicate = true;
		}
		return 0;
	},

	// Instance methods
	hasOwn = ( {} ).hasOwnProperty,
	arr = [],
	pop = arr.pop,
	pushNative = arr.push,
	push = arr.push,
	slice = arr.slice,

	// Use a stripped-down indexOf as it's faster than native
	// https://jsperf.com/thor-indexof-vs-for/5
	indexOf = function( list, elem ) {
		var i = 0,
			len = list.length;
		for ( ; i < len; i++ ) {
			if ( list[ i ] === elem ) {
				return i;
			}
		}
		return -1;
	},

	booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" +
		"ismap|loop|multiple|open|readonly|required|scoped",

	// Regular expressions

	// http://www.w3.org/TR/css3-selectors/#whitespace
	whitespace = "[\\x20\\t\\r\\n\\f]",

	// https://www.w3.org/TR/css-syntax-3/#ident-token-diagram
	identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace +
		"?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+",

	// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors
	attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace +

		// Operator (capture 2)
		"*([*^$|!~]?=)" + whitespace +

		// "Attribute values must be CSS identifiers [capture 5]
		// or strings [capture 3 or capture 4]"
		"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" +
		whitespace + "*\\]",

	pseudos = ":(" + identifier + ")(?:\\((" +

		// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:
		// 1. quoted (capture 3; capture 4 or capture 5)
		"('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" +

		// 2. simple (capture 6)
		"((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" +

		// 3. anything else (capture 2)
		".*" +
		")\\)|)",

	// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter
	rwhitespace = new RegExp( whitespace + "+", "g" ),
	rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" +
		whitespace + "+$", "g" ),

	rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ),
	rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace +
		"*" ),
	rdescend = new RegExp( whitespace + "|>" ),

	rpseudo = new RegExp( pseudos ),
	ridentifier = new RegExp( "^" + identifier + "$" ),

	matchExpr = {
		"ID": new RegExp( "^#(" + identifier + ")" ),
		"CLASS": new RegExp( "^\\.(" + identifier + ")" ),
		"TAG": new RegExp( "^(" + identifier + "|[*])" ),
		"ATTR": new RegExp( "^" + attributes ),
		"PSEUDO": new RegExp( "^" + pseudos ),
		"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" +
			whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" +
			whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ),
		"bool": new RegExp( "^(?:" + booleans + ")$", "i" ),

		// For use in libraries implementing .is()
		// We use this for POS matching in `select`
		"needsContext": new RegExp( "^" + whitespace +
			"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace +
			"*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" )
	},

	rhtml = /HTML$/i,
	rinputs = /^(?:input|select|textarea|button)$/i,
	rheader = /^h\d$/i,

	rnative = /^[^{]+\{\s*\[native \w/,

	// Easily-parseable/retrievable ID or TAG or CLASS selectors
	rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,

	rsibling = /[+~]/,

	// CSS escapes
	// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
	runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ),
	funescape = function( escape, nonHex ) {
		var high = "0x" + escape.slice( 1 ) - 0x10000;

		return nonHex ?

			// Strip the backslash prefix from a non-hex escape sequence
			nonHex :

			// Replace a hexadecimal escape sequence with the encoded Unicode code point
			// Support: IE <=11+
			// For values outside the Basic Multilingual Plane (BMP), manually construct a
			// surrogate pair
			high < 0 ?
				String.fromCharCode( high + 0x10000 ) :
				String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );
	},

	// CSS string/identifier serialization
	// https://drafts.csswg.org/cssom/#common-serializing-idioms
	rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,
	fcssescape = function( ch, asCodePoint ) {
		if ( asCodePoint ) {

			// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER
			if ( ch === "\0" ) {
				return "\uFFFD";
			}

			// Control characters and (dependent upon position) numbers get escaped as code points
			return ch.slice( 0, -1 ) + "\\" +
				ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " ";
		}

		// Other potentially-special ASCII characters get backslash-escaped
		return "\\" + ch;
	},

	// Used for iframes
	// See setDocument()
	// Removing the function wrapper causes a "Permission Denied"
	// error in IE
	unloadHandler = function() {
		setDocument();
	},

	inDisabledFieldset = addCombinator(
		function( elem ) {
			return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset";
		},
		{ dir: "parentNode", next: "legend" }
	);

// Optimize for push.apply( _, NodeList )
try {
	push.apply(
		( arr = slice.call( preferredDoc.childNodes ) ),
		preferredDoc.childNodes
	);

	// Support: Android<4.0
	// Detect silently failing push.apply
	// eslint-disable-next-line no-unused-expressions
	arr[ preferredDoc.childNodes.length ].nodeType;
} catch ( e ) {
	push = { apply: arr.length ?

		// Leverage slice if possible
		function( target, els ) {
			pushNative.apply( target, slice.call( els ) );
		} :

		// Support: IE<9
		// Otherwise append directly
		function( target, els ) {
			var j = target.length,
				i = 0;

			// Can't trust NodeList.length
			while ( ( target[ j++ ] = els[ i++ ] ) ) {}
			target.length = j - 1;
		}
	};
}

function Sizzle( selector, context, results, seed ) {
	var m, i, elem, nid, match, groups, newSelector,
		newContext = context && context.ownerDocument,

		// nodeType defaults to 9, since context defaults to document
		nodeType = context ? context.nodeType : 9;

	results = results || [];

	// Return early from calls with invalid selector or context
	if ( typeof selector !== "string" || !selector ||
		nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {

		return results;
	}

	// Try to shortcut find operations (as opposed to filters) in HTML documents
	if ( !seed ) {
		setDocument( context );
		context = context || document;

		if ( documentIsHTML ) {

			// If the selector is sufficiently simple, try using a "get*By*" DOM method
			// (excepting DocumentFragment context, where the methods don't exist)
			if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) {

				// ID selector
				if ( ( m = match[ 1 ] ) ) {

					// Document context
					if ( nodeType === 9 ) {
						if ( ( elem = context.getElementById( m ) ) ) {

							// Support: IE, Opera, Webkit
							// TODO: identify versions
							// getElementById can match elements by name instead of ID
							if ( elem.id === m ) {
								results.push( elem );
								return results;
							}
						} else {
							return results;
						}

					// Element context
					} else {

						// Support: IE, Opera, Webkit
						// TODO: identify versions
						// getElementById can match elements by name instead of ID
						if ( newContext && ( elem = newContext.getElementById( m ) ) &&
							contains( context, elem ) &&
							elem.id === m ) {

							results.push( elem );
							return results;
						}
					}

				// Type selector
				} else if ( match[ 2 ] ) {
					push.apply( results, context.getElementsByTagName( selector ) );
					return results;

				// Class selector
				} else if ( ( m = match[ 3 ] ) && support.getElementsByClassName &&
					context.getElementsByClassName ) {

					push.apply( results, context.getElementsByClassName( m ) );
					return results;
				}
			}

			// Take advantage of querySelectorAll
			if ( support.qsa &&
				!nonnativeSelectorCache[ selector + " " ] &&
				( !rbuggyQSA || !rbuggyQSA.test( selector ) ) &&

				// Support: IE 8 only
				// Exclude object elements
				( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) {

				newSelector = selector;
				newContext = context;

				// qSA considers elements outside a scoping root when evaluating child or
				// descendant combinators, which is not what we want.
				// In such cases, we work around the behavior by prefixing every selector in the
				// list with an ID selector referencing the scope context.
				// The technique has to be used as well when a leading combinator is used
				// as such selectors are not recognized by querySelectorAll.
				// Thanks to Andrew Dupont for this technique.
				if ( nodeType === 1 &&
					( rdescend.test( selector ) || rcombinators.test( selector ) ) ) {

					// Expand context for sibling selectors
					newContext = rsibling.test( selector ) && testContext( context.parentNode ) ||
						context;

					// We can use :scope instead of the ID hack if the browser
					// supports it & if we're not changing the context.
					if ( newContext !== context || !support.scope ) {

						// Capture the context ID, setting it first if necessary
						if ( ( nid = context.getAttribute( "id" ) ) ) {
							nid = nid.replace( rcssescape, fcssescape );
						} else {
							context.setAttribute( "id", ( nid = expando ) );
						}
					}

					// Prefix every selector in the list
					groups = tokenize( selector );
					i = groups.length;
					while ( i-- ) {
						groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " +
							toSelector( groups[ i ] );
					}
					newSelector = groups.join( "," );
				}

				try {

					// `qSA` may not throw for unrecognized parts using forgiving parsing:
					// https://drafts.csswg.org/selectors/#forgiving-selector
					// like the `:has()` pseudo-class:
					// https://drafts.csswg.org/selectors/#relational
					// `CSS.supports` is still expected to return `false` then:
					// https://drafts.csswg.org/css-conditional-4/#typedef-supports-selector-fn
					// https://drafts.csswg.org/css-conditional-4/#dfn-support-selector
					if ( support.cssSupportsSelector &&

						// eslint-disable-next-line no-undef
						!CSS.supports( "selector(:is(" + newSelector + "))" ) ) {

						// Support: IE 11+
						// Throw to get to the same code path as an error directly in qSA.
						// Note: once we only support browser supporting
						// `CSS.supports('selector(...)')`, we can most likely drop
						// the `try-catch`. IE doesn't implement the API.
						throw new Error();
					}

					push.apply( results,
						newContext.querySelectorAll( newSelector )
					);
					return results;
				} catch ( qsaError ) {
					nonnativeSelectorCache( selector, true );
				} finally {
					if ( nid === expando ) {
						context.removeAttribute( "id" );
					}
				}
			}
		}
	}

	// All others
	return select( selector.replace( rtrim, "$1" ), context, results, seed );
}

/**
 * Create key-value caches of limited size
 * @returns {function(string, object)} Returns the Object data after storing it on itself with
 *	property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)
 *	deleting the oldest entry
 */
function createCache() {
	var keys = [];

	function cache( key, value ) {

		// Use (key + " ") to avoid collision with native prototype properties (see Issue #157)
		if ( keys.push( key + " " ) > Expr.cacheLength ) {

			// Only keep the most recent entries
			delete cache[ keys.shift() ];
		}
		return ( cache[ key + " " ] = value );
	}
	return cache;
}

/**
 * Mark a function for special use by Sizzle
 * @param {Function} fn The function to mark
 */
function markFunction( fn ) {
	fn[ expando ] = true;
	return fn;
}

/**
 * Support testing using an element
 * @param {Function} fn Passed the created element and returns a boolean result
 */
function assert( fn ) {
	var el = document.createElement( "fieldset" );

	try {
		return !!fn( el );
	} catch ( e ) {
		return false;
	} finally {

		// Remove from its parent by default
		if ( el.parentNode ) {
			el.parentNode.removeChild( el );
		}

		// release memory in IE
		el = null;
	}
}

/**
 * Adds the same handler for all of the specified attrs
 * @param {String} attrs Pipe-separated list of attributes
 * @param {Function} handler The method that will be applied
 */
function addHandle( attrs, handler ) {
	var arr = attrs.split( "|" ),
		i = arr.length;

	while ( i-- ) {
		Expr.attrHandle[ arr[ i ] ] = handler;
	}
}

/**
 * Checks document order of two siblings
 * @param {Element} a
 * @param {Element} b
 * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b
 */
function siblingCheck( a, b ) {
	var cur = b && a,
		diff = cur && a.nodeType === 1 && b.nodeType === 1 &&
			a.sourceIndex - b.sourceIndex;

	// Use IE sourceIndex if available on both nodes
	if ( diff ) {
		return diff;
	}

	// Check if b follows a
	if ( cur ) {
		while ( ( cur = cur.nextSibling ) ) {
			if ( cur === b ) {
				return -1;
			}
		}
	}

	return a ? 1 : -1;
}

/**
 * Returns a function to use in pseudos for input types
 * @param {String} type
 */
function createInputPseudo( type ) {
	return function( elem ) {
		var name = elem.nodeName.toLowerCase();
		return name === "input" && elem.type === type;
	};
}

/**
 * Returns a function to use in pseudos for buttons
 * @param {String} type
 */
function createButtonPseudo( type ) {
	return function( elem ) {
		var name = elem.nodeName.toLowerCase();
		return ( name === "input" || name === "button" ) && elem.type === type;
	};
}

/**
 * Returns a function to use in pseudos for :enabled/:disabled
 * @param {Boolean} disabled true for :disabled; false for :enabled
 */
function createDisabledPseudo( disabled ) {

	// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable
	return function( elem ) {

		// Only certain elements can match :enabled or :disabled
		// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
		// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
		if ( "form" in elem ) {

			// Check for inherited disabledness on relevant non-disabled elements:
			// * listed form-associated elements in a disabled fieldset
			//   https://html.spec.whatwg.org/multipage/forms.html#category-listed
			//   https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
			// * option elements in a disabled optgroup
			//   https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
			// All such elements have a "form" property.
			if ( elem.parentNode && elem.disabled === false ) {

				// Option elements defer to a parent optgroup if present
				if ( "label" in elem ) {
					if ( "label" in elem.parentNode ) {
						return elem.parentNode.disabled === disabled;
					} else {
						return elem.disabled === disabled;
					}
				}

				// Support: IE 6 - 11
				// Use the isDisabled shortcut property to check for disabled fieldset ancestors
				return elem.isDisabled === disabled ||

					// Where there is no isDisabled, check manually
					/* jshint -W018 */
					elem.isDisabled !== !disabled &&
					inDisabledFieldset( elem ) === disabled;
			}

			return elem.disabled === disabled;

		// Try to winnow out elements that can't be disabled before trusting the disabled property.
		// Some victims get caught in our net (label, legend, menu, track), but it shouldn't
		// even exist on them, let alone have a boolean value.
		} else if ( "label" in elem ) {
			return elem.disabled === disabled;
		}

		// Remaining elements are neither :enabled nor :disabled
		return false;
	};
}

/**
 * Returns a function to use in pseudos for positionals
 * @param {Function} fn
 */
function createPositionalPseudo( fn ) {
	return markFunction( function( argument ) {
		argument = +argument;
		return markFunction( function( seed, matches ) {
			var j,
				matchIndexes = fn( [], seed.length, argument ),
				i = matchIndexes.length;

			// Match elements found at the specified indexes
			while ( i-- ) {
				if ( seed[ ( j = matchIndexes[ i ] ) ] ) {
					seed[ j ] = !( matches[ j ] = seed[ j ] );
				}
			}
		} );
	} );
}

/**
 * Checks a node for validity as a Sizzle context
 * @param {Element|Object=} context
 * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value
 */
function testContext( context ) {
	return context && typeof context.getElementsByTagName !== "undefined" && context;
}

// Expose support vars for convenience
support = Sizzle.support = {};

/**
 * Detects XML nodes
 * @param {Element|Object} elem An element or a document
 * @returns {Boolean} True iff elem is a non-HTML XML node
 */
isXML = Sizzle.isXML = function( elem ) {
	var namespace = elem && elem.namespaceURI,
		docElem = elem && ( elem.ownerDocument || elem ).documentElement;

	// Support: IE <=8
	// Assume HTML when documentElement doesn't yet exist, such as inside loading iframes
	// https://bugs.jquery.com/ticket/4833
	return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" );
};

/**
 * Sets document-related variables once based on the current document
 * @param {Element|Object} [doc] An element or document object to use to set the document
 * @returns {Object} Returns the current document
 */
setDocument = Sizzle.setDocument = function( node ) {
	var hasCompare, subWindow,
		doc = node ? node.ownerDocument || node : preferredDoc;

	// Return early if doc is invalid or already selected
	// Support: IE 11+, Edge 17 - 18+
	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
	// two documents; shallow comparisons work.
	// eslint-disable-next-line eqeqeq
	if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) {
		return document;
	}

	// Update global variables
	document = doc;
	docElem = document.documentElement;
	documentIsHTML = !isXML( document );

	// Support: IE 9 - 11+, Edge 12 - 18+
	// Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936)
	// Support: IE 11+, Edge 17 - 18+
	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
	// two documents; shallow comparisons work.
	// eslint-disable-next-line eqeqeq
	if ( preferredDoc != document &&
		( subWindow = document.defaultView ) && subWindow.top !== subWindow ) {

		// Support: IE 11, Edge
		if ( subWindow.addEventListener ) {
			subWindow.addEventListener( "unload", unloadHandler, false );

		// Support: IE 9 - 10 only
		} else if ( subWindow.attachEvent ) {
			subWindow.attachEvent( "onunload", unloadHandler );
		}
	}

	// Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only,
	// Safari 4 - 5 only, Opera <=11.6 - 12.x only
	// IE/Edge & older browsers don't support the :scope pseudo-class.
	// Support: Safari 6.0 only
	// Safari 6.0 supports :scope but it's an alias of :root there.
	support.scope = assert( function( el ) {
		docElem.appendChild( el ).appendChild( document.createElement( "div" ) );
		return typeof el.querySelectorAll !== "undefined" &&
			!el.querySelectorAll( ":scope fieldset div" ).length;
	} );

	// Support: Chrome 105+, Firefox 104+, Safari 15.4+
	// Make sure forgiving mode is not used in `CSS.supports( "selector(...)" )`.
	//
	// `:is()` uses a forgiving selector list as an argument and is widely
	// implemented, so it's a good one to test against.
	support.cssSupportsSelector = assert( function() {
		/* eslint-disable no-undef */

		return CSS.supports( "selector(*)" ) &&

			// Support: Firefox 78-81 only
			// In old Firefox, `:is()` didn't use forgiving parsing. In that case,
			// fail this test as there's no selector to test against that.
			// `CSS.supports` uses unforgiving parsing
			document.querySelectorAll( ":is(:jqfake)" ) &&

			// `*` is needed as Safari & newer Chrome implemented something in between
			// for `:has()` - it throws in `qSA` if it only contains an unsupported
			// argument but multiple ones, one of which is supported, are fine.
			// We want to play safe in case `:is()` gets the same treatment.
			!CSS.supports( "selector(:is(*,:jqfake))" );

		/* eslint-enable */
	} );

	/* Attributes
	---------------------------------------------------------------------- */

	// Support: IE<8
	// Verify that getAttribute really returns attributes and not properties
	// (excepting IE8 booleans)
	support.attributes = assert( function( el ) {
		el.className = "i";
		return !el.getAttribute( "className" );
	} );

	/* getElement(s)By*
	---------------------------------------------------------------------- */

	// Check if getElementsByTagName("*") returns only elements
	support.getElementsByTagName = assert( function( el ) {
		el.appendChild( document.createComment( "" ) );
		return !el.getElementsByTagName( "*" ).length;
	} );

	// Support: IE<9
	support.getElementsByClassName = rnative.test( document.getElementsByClassName );

	// Support: IE<10
	// Check if getElementById returns elements by name
	// The broken getElementById methods don't pick up programmatically-set names,
	// so use a roundabout getElementsByName test
	support.getById = assert( function( el ) {
		docElem.appendChild( el ).id = expando;
		return !document.getElementsByName || !document.getElementsByName( expando ).length;
	} );

	// ID filter and find
	if ( support.getById ) {
		Expr.filter[ "ID" ] = function( id ) {
			var attrId = id.replace( runescape, funescape );
			return function( elem ) {
				return elem.getAttribute( "id" ) === attrId;
			};
		};
		Expr.find[ "ID" ] = function( id, context ) {
			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
				var elem = context.getElementById( id );
				return elem ? [ elem ] : [];
			}
		};
	} else {
		Expr.filter[ "ID" ] =  function( id ) {
			var attrId = id.replace( runescape, funescape );
			return function( elem ) {
				var node = typeof elem.getAttributeNode !== "undefined" &&
					elem.getAttributeNode( "id" );
				return node && node.value === attrId;
			};
		};

		// Support: IE 6 - 7 only
		// getElementById is not reliable as a find shortcut
		Expr.find[ "ID" ] = function( id, context ) {
			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
				var node, i, elems,
					elem = context.getElementById( id );

				if ( elem ) {

					// Verify the id attribute
					node = elem.getAttributeNode( "id" );
					if ( node && node.value === id ) {
						return [ elem ];
					}

					// Fall back on getElementsByName
					elems = context.getElementsByName( id );
					i = 0;
					while ( ( elem = elems[ i++ ] ) ) {
						node = elem.getAttributeNode( "id" );
						if ( node && node.value === id ) {
							return [ elem ];
						}
					}
				}

				return [];
			}
		};
	}

	// Tag
	Expr.find[ "TAG" ] = support.getElementsByTagName ?
		function( tag, context ) {
			if ( typeof context.getElementsByTagName !== "undefined" ) {
				return context.getElementsByTagName( tag );

			// DocumentFragment nodes don't have gEBTN
			} else if ( support.qsa ) {
				return context.querySelectorAll( tag );
			}
		} :

		function( tag, context ) {
			var elem,
				tmp = [],
				i = 0,

				// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too
				results = context.getElementsByTagName( tag );

			// Filter out possible comments
			if ( tag === "*" ) {
				while ( ( elem = results[ i++ ] ) ) {
					if ( elem.nodeType === 1 ) {
						tmp.push( elem );
					}
				}

				return tmp;
			}
			return results;
		};

	// Class
	Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) {
		if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) {
			return context.getElementsByClassName( className );
		}
	};

	/* QSA/matchesSelector
	---------------------------------------------------------------------- */

	// QSA and matchesSelector support

	// matchesSelector(:active) reports false when true (IE9/Opera 11.5)
	rbuggyMatches = [];

	// qSa(:focus) reports false when true (Chrome 21)
	// We allow this because of a bug in IE8/9 that throws an error
	// whenever `document.activeElement` is accessed on an iframe
	// So, we allow :focus to pass through QSA all the time to avoid the IE error
	// See https://bugs.jquery.com/ticket/13378
	rbuggyQSA = [];

	if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) {

		// Build QSA regex
		// Regex strategy adopted from Diego Perini
		assert( function( el ) {

			var input;

			// Select is set to empty string on purpose
			// This is to test IE's treatment of not explicitly
			// setting a boolean content attribute,
			// since its presence should be enough
			// https://bugs.jquery.com/ticket/12359
			docElem.appendChild( el ).innerHTML = "" +
				"";

			// Support: IE8, Opera 11-12.16
			// Nothing should be selected when empty strings follow ^= or $= or *=
			// The test attribute must be unknown in Opera but "safe" for WinRT
			// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section
			if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) {
				rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" );
			}

			// Support: IE8
			// Boolean attributes and "value" are not treated correctly
			if ( !el.querySelectorAll( "[selected]" ).length ) {
				rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" );
			}

			// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+
			if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) {
				rbuggyQSA.push( "~=" );
			}

			// Support: IE 11+, Edge 15 - 18+
			// IE 11/Edge don't find elements on a `[name='']` query in some cases.
			// Adding a temporary attribute to the document before the selection works
			// around the issue.
			// Interestingly, IE 10 & older don't seem to have the issue.
			input = document.createElement( "input" );
			input.setAttribute( "name", "" );
			el.appendChild( input );
			if ( !el.querySelectorAll( "[name='']" ).length ) {
				rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" +
					whitespace + "*(?:''|\"\")" );
			}

			// Webkit/Opera - :checked should return selected option elements
			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
			// IE8 throws error here and will not see later tests
			if ( !el.querySelectorAll( ":checked" ).length ) {
				rbuggyQSA.push( ":checked" );
			}

			// Support: Safari 8+, iOS 8+
			// https://bugs.webkit.org/show_bug.cgi?id=136851
			// In-page `selector#id sibling-combinator selector` fails
			if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) {
				rbuggyQSA.push( ".#.+[+~]" );
			}

			// Support: Firefox <=3.6 - 5 only
			// Old Firefox doesn't throw on a badly-escaped identifier.
			el.querySelectorAll( "\\\f" );
			rbuggyQSA.push( "[\\r\\n\\f]" );
		} );

		assert( function( el ) {
			el.innerHTML = "" +
				"";

			// Support: Windows 8 Native Apps
			// The type and name attributes are restricted during .innerHTML assignment
			var input = document.createElement( "input" );
			input.setAttribute( "type", "hidden" );
			el.appendChild( input ).setAttribute( "name", "D" );

			// Support: IE8
			// Enforce case-sensitivity of name attribute
			if ( el.querySelectorAll( "[name=d]" ).length ) {
				rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" );
			}

			// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)
			// IE8 throws error here and will not see later tests
			if ( el.querySelectorAll( ":enabled" ).length !== 2 ) {
				rbuggyQSA.push( ":enabled", ":disabled" );
			}

			// Support: IE9-11+
			// IE's :disabled selector does not pick up the children of disabled fieldsets
			docElem.appendChild( el ).disabled = true;
			if ( el.querySelectorAll( ":disabled" ).length !== 2 ) {
				rbuggyQSA.push( ":enabled", ":disabled" );
			}

			// Support: Opera 10 - 11 only
			// Opera 10-11 does not throw on post-comma invalid pseudos
			el.querySelectorAll( "*,:x" );
			rbuggyQSA.push( ",.*:" );
		} );
	}

	if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches ||
		docElem.webkitMatchesSelector ||
		docElem.mozMatchesSelector ||
		docElem.oMatchesSelector ||
		docElem.msMatchesSelector ) ) ) ) {

		assert( function( el ) {

			// Check to see if it's possible to do matchesSelector
			// on a disconnected node (IE 9)
			support.disconnectedMatch = matches.call( el, "*" );

			// This should fail with an exception
			// Gecko does not error, returns false instead
			matches.call( el, "[s!='']:x" );
			rbuggyMatches.push( "!=", pseudos );
		} );
	}

	if ( !support.cssSupportsSelector ) {

		// Support: Chrome 105+, Safari 15.4+
		// `:has()` uses a forgiving selector list as an argument so our regular
		// `try-catch` mechanism fails to catch `:has()` with arguments not supported
		// natively like `:has(:contains("Foo"))`. Where supported & spec-compliant,
		// we now use `CSS.supports("selector(:is(SELECTOR_TO_BE_TESTED))")`, but
		// outside that we mark `:has` as buggy.
		rbuggyQSA.push( ":has" );
	}

	rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) );
	rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) );

	/* Contains
	---------------------------------------------------------------------- */
	hasCompare = rnative.test( docElem.compareDocumentPosition );

	// Element contains another
	// Purposefully self-exclusive
	// As in, an element does not contain itself
	contains = hasCompare || rnative.test( docElem.contains ) ?
		function( a, b ) {

			// Support: IE <9 only
			// IE doesn't have `contains` on `document` so we need to check for
			// `documentElement` presence.
			// We need to fall back to `a` when `documentElement` is missing
			// as `ownerDocument` of elements within `