← 1.1 | 1.3 →

Release Notes for Trac 1.2 Hermes Release

Trac 1.2 is the current stable version of Trac.
These notes reflect the final status.

Highlights

• Extensible notification system (#3517)
• Notification preference panel (#4056)
• Usernames replaced with full names (#7339)
• Restyled ticket changelog (#11835)
• Workflow controls on the New Ticket page (#2045)
• Editable wiki page version comments (#6573)
• Datetime custom fields (#1942)

Maintenance Releases

Overview

1.2.1	33 / 33

Tickets with release notes

Milestone: 1.2.6 (2 matches)

Ticket	Release Notes
#13209	Modified text of error message when permission not granted because user with PERMISSION_GRANT doesn't possess the permission.
#13298	Fixed ticket autopreview triggering without a form change.
Milestone: 1.2.5 (3 matches)
Ticket	Release Notes
#13178	Fix unit-test failing with non en_US locale.
#13192	Fixed KeyError in log file due to invalid query filter request.
#11002	List owner, reporter and updater of the ticket in To header, when [notification] use_public_cc option is enabled.
Milestone: 1.2.4 (8 matches)
Ticket	Release Notes
#13121	Fixed TracError exception and preserve log level and log file options when the log type is changed to none.
#13061	Improved error message when environment is incorrect version.
#13062	Modified trac-pre-commit-hook to use Trac 1.0 database API.
#13063	TracStandalone checks for existence of environment and authorization file paths. Fixed absolute path not used for pidfile.
#13078	Fix an error raised when custom field of type time is constrained by range on PostgreSQL.
#13079	Do not translate custom field's labels.
#13114	Fixed margins around quoted lines containing bullet points.
#12946	Fixed instance of empty comment block in timeline.
Milestone: 1.2.3 (22 matches)
Ticket	Release Notes
#6613	Added a notification subscriber for new tickets.
#11841	Fixed poor layout of Basic Settings admin page.
#11846	A module in the plugins directory that raises SystemExit exception will no longer disable the Trac instance.
#12029	Query system returns None for time field being NULL rather than an empty string and fix query system crashing when time and/or changetime columns are NULL and saved query exists in the user's session.
#12158	Components that failed to load due to missing required dependencies would still show on the plugin admin page.
#12641	Empty configuration sections are listed in command completion output of trac-admin interactive mode.
#12803	LF is always used as separator when generating HTML rather than using platform-dependent line separator.
#12829	Fixed failure to save default version from admin panel when trac.ini was not writable.
#12838	Use public schema by default for the Postgres database.
#12855	Workflow action is not shown for set_owner_to_self operation when ticket status is equal to the new state and ticket owner is the logged-in user.
#12864	Fix incorrect None bytes in repository browser when Node.content_length is None.
#12875	Fixed wiki formatting hint not visible for ticket description when wiki toolbars disabled.
#12890	Removed unintended fieldset around ticket description field.
#12892	The Release field on the Version edit page is no longer populated with the current datetime when the version release date is not set.
#12913	Fixed incorrect logging of negated permission as invalid in AuthzPolicy.
#12916	Fixed incorrect rendering of TracError message containing a div.
#12938	Fixed some actions not available on batch modify page.
#12962	The 'summary' metadata is read for single file plugins.
#12964	Request headers are configurable through the [http-headers] section of trac.ini.
#12989	The psycopg2-binary package satisfies requirements for using the PostgreSQL database backend.
#13015	Fix ProgrammingError raised on postgresql when query sorting by custom time field.
#13041	Fixed incorrect rendering of child preference panels.
Milestone: 1.2.2 (19 matches)
Ticket	Release Notes
#8790	Invalid logging configuration can no longer disable the Trac instance when saving the configuration through the WebAdmin. Invalid configuration changes are not saved and a warning is displayed with the exception message.
#11949	The ticket author is used in the notification from field when [notification] smtp_from_author = enabled, rather than the ticket reporter. This changes the behavior for users with TICKET_ADMIN, since they are allowed to edit the Reporter field.
#12218	Filename, module or package can be passed to make pylint.
#12688	Updated TracQuery documentation to clarify the results returned by querying a modified date range.
#12724	Fixed incorrect CC field when full name but not email set in preferences.
#12737	Message is printed to console when synchronizing a non-cached repository using trac-admin.
#12744	Extra entries and comments in htpasswd and htdigest files are ignored.
#12759	Fix a regression of #12658, ticket notification not sending for authenticated users without email.
#12761	Render message in place of diff when changeset is not rendered due to exceeding [changeset] max_diff_bytes or [changeset] max_diff_files.
#12764	Fix [notification] use_short_addr and smtp_default_domain options being ignored for subscriptions without email address.
#12775	Fix signature lines in notification mails.
#12797	Error message differs for Git control files not found vs path does not exist.
#12818	The post_process_request method can redirect during exception handling from an exception raised in process_request (fix for regression in r14604).
#12823	Workflow hint is not added in transition to *, which restores the behavior prior to Trac 1.2. The behavior is utilized by the ​AdvancedTicketWorkflowPlugin's triage operation.
#12834	The positional arguments of the initenv trac-admin command are optional when using the --config switch.
#12837	Fixed poor error message when resource id is empty or None.
#12841	Fixed missing report heading in first group when value is empty
#12762	Fix incorrectly stripping [ and ] characters from the filename given to Image macro.
#12779	Fixed [logging] log_level and log_type were incorrectly case-sensitive after Trac 1.1.3.
Milestone: 1.2.1 (29 matches)
Ticket	Release Notes
#10316	Fixed recursive directory copies with the trac-admin deploy command. The target directory cannot be equal to or below any of the source directories (e.g. $env/htdocs is not allowed as a target).
#11928	Fix unable to save notification format with no subscription rules in prefs/notification. Add Default format in prefs/notification. Add [notification] default_format.email option.
#12597	Fixed recursion in permission policy checks.
#12608	Fixed ValueError when version or old_version argument to WikiModule not an int.
#12617	Fix ValueError from datetime with local timezone when the offset isn't a whole number of minutes.
#12633	Add section and option named arguments which do glob matching to [[TracIni]] macro.
#12637	A ConfigurationError exception is raised when there is an error parsing the authz file for AuthzSourcePolicy, or if the file can't be found.
#12638	Fix invalid xhtml being generated for definition list after paragraph.
#12654	AuthzPolicy will only raise a ConfigurationError if it's in the list of permission_policies.
#12658	Fix email address not resolving for user without email.
#12660	EmailDistributor.resolvers returns only configured resolvers.
#12668	The TracAdmin upgrade command documentation specifies that the backup location is governed by [trac] backup_dir.
#12669	Replaced use of deprecated encrypt method from passlib library with hash.
#12671	Improve usability of Reply and Edit buttons associated with ticket comments
#12676	Fixed regression from r14208 for Pygments < 1.4.
#12691	Reduce logging level from error to warning for TracError: Session ID must be alphanumeric.
#12697	Error message is displayed rather than traceback when QuerySyntaxError is raised in TicketQuery macro.
#12700	Fixed failure to add always_notify_updater = TicketUpdaterSubscriber and always_notify_previous_updater = TicketPreviousUpdatersSubscriber to [notification-subscribers] in trac.ini when the default value of always_notify_updater was not present in trac.ini.
#12701	Added wikitext class to input fields that accept wiki markup.
#12707	Added shortcut for modifying state of Column checkboxes on Custom Query page.
#12708	VersionConflict and ImportError exceptions from single file plugins are logged at ERROR level. Previously a traceback would result.
#12709	Buttons in report view are available even when no query.
#12718	Improved logging for classes inheriting from EmailDistributor.
#12720	Milestone that exists but user does not have permission to view is not rendered in the missing style.
#12727	Directory listing in the Browser and Revision Log views label the date column as Date when Time format is Absolute. The column is labeled as Age when Time format is Relative.
#12730	Fixed missing ticket field change conflict markers (regression).
#12734	Invalid actions in authz file are logged at warning level.
#12748	Fixed error when calling Image macro with no arguments: [[Image(,)]].
#9401	Added an anchor to each option and highlight the corresponding entry in [[TracIni]] macro.

Trac 1.2: Detailed User Visible Changes

Component: admin/console (2 matches)

Ticket	Release Notes
#11333	The TracAdmin initenv command accepts an optional parameter --config, the path to a file containing a configuration to be used when creating the environment.
#11938	Improved error message when adding and removing an invalid action with TracAdmin.
Component: admin/web (2 matches)
Ticket	Release Notes
#11682	Enum tables on the Ticket Admin pages can be reordered by drag and drop. The ordering is also dynamically updated when changing the Select boxes.
#12248	Repository admin page is hidden if there are no repository connectors enabled. Synchronization is skipped for repository with an invalid connector.
Component: database backend (1 match)
Ticket	Release Notes
#11872
Component: general (13 matches)
Ticket	Release Notes
#7339	Usernames are replaced with full names when [trac] show_full_names is true and the full name has been set in the user's preferences.
#11019	Third party JavaScript libraries have been upgraded: jQuery-UI to 1.11.4 jQuery to 1.11.3 jQuery UI Timepicker to 1.5.5
#11506	Replaced suite function in test modules with test_suite.
#12120
#12131	Fixed transitive import in trac/web/main.py and added direct import of io module, replacing use of StringIO with io.BytesIO.
#12220	Corrected display of UTC timezone when format is ISO8601 (regression with upgrade to jQuery UI Timepicker 1.5.5 in #11019).
#12224	Datetime format hints are hidden when JavaScript is enabled.
#12226	Permission cannot be granted if it differs from a defined action by case only.
#12228	Autocomplete is disabled for text fields with a datepicker or datetimepicker.
#12239	Replaced fcrypt dependency with passlib.
#12260	Fixed regression in Show property changes preference on ticket page, after upgrade to jQuery 1.11.3 (#11019).
#12352	An EnvironmentError is raised when processing a request if the Python interpreter optimization level is nonzero. An error code is returned and a message printed to the terminal when calling trac-admin in a Python process that has a nonzero optimization level.
#12561	Fixed regression in r14707 that resulted in AttributeError: 'FakeSession' object has no attribute 'as_int'.
Component: i18n (1 match)
Ticket	Release Notes
#12222	Fixed incorrect entries in pot (translation) file due to string interpolation in option description.
Component: notification (4 matches)
Ticket	Release Notes
#11990	Subscription rules preferences are hidden if no rules are available.
#12186	Fixed regression in notification subject when ticket summary was changed: old summary was not included in the subject.
#12206	Notification emails use the author's full name when [trac] show_full_names is True.
#12209	Fix not working notification preference panel with PostgreSQL.
Component: plugin/git (1 match)
Ticket	Release Notes
#12480	Gitweb repository configuration is moved from the [git] section to the [gitweb-repositories] section.
Component: query system (3 matches)
Ticket	Release Notes
#11970	Added shortcuts for modifying the state of TracQuery checkbox filters.
#12112	Fix conflicted priority_value with the same named custom field in ticket query.
#12593	Fixed author not formatted when query filter added (related to #7339).
Component: rendering (2 matches)
Ticket	Release Notes
#5654	Pygments lexer options can be specified as WikiProcessor arguments and defaults can be set in the environment configuration.
#12141	Renamed INSTALL to INSTALL.rst and UPGRADE to UPGRADE.rst. Modified the default value of [mimeviewer] mime_map_patterns so that INSTALL.rst isn't matched by the regular expression for the text/plain mime type. INSTALL.rst and UPGRADE.rst should now be rendered to HTML when docutils is installed, even when viewing the files in a Git repository (or any other VCS that doesn't allow the mimetype to be set as a repository property, like Subversion does).
Component: report system (1 match)
Ticket	Release Notes
#12219
Component: roadmap (2 matches)
Ticket	Release Notes
#10462	[milestone] default_group_by specifies the default field for grouping tickets in the grouped progress bar.
#12126	On the milestone edit page the retargeting elements are only shown when there are open tickets associated with the milestone.
Component: search system (2 matches)
Ticket	Release Notes
#4309	Add a notice when quick-jumping from the search box to a resource.
#12376	Pressing the modifier key while selecting a search filter will unselect all other search filters.
Component: ticket system (15 matches)
Ticket	Release Notes
#11677	Deleting the default Component, Milestone, Version or Enum clears the complementary default value (e.g. [ticket] default_component).
#11704	User with TICKET_ADMIN can batch modify the reporter field.
#11857	The ticket owner is shown in the ticket properties box during preview when the value is < default >. <default> is allowed as an alias for < default > in the [ticket] default_owner setting.
#11858	The ticket owner change was not shown in the ticket preview for the special case of the owner being set to the component owner on component change.
#11980	Added ticket number to ticket TracLink title. Added ticket number and description to ticket comment TracLink title.
#12140	Refactored modules in ticket package to use item accessors rather than manipulating ticket.values directly.
#12192	issue can be used as ticket TracLink, in addition to bug and ticket (e.g. issue:1). Comment TracLinks also support issue and bug as aliases for ticket: comment:1:bug:1 and comment:1:issue:1.
#12249	Fixed regression in which author was not always obfuscated in a quoted ticket comment reply.
#12252	Tickets created before a custom field was added default to using the default value provided in the custom field definition.
#12266	Query is used in place of Report when a query is being created or edited.
#12271	Fixed regression in which full name was not used, when available, in a quoted ticket comment reply.
#12338	Fix missing datetime import and crashing with invalid datetime string for time custom fields.
#12343	Fix incorrect time field with date/datetime format in ticket box.
#12344	Fix not working datetime picker for time field with relative format.
#12615	Fixed wrong groupby parameter of query in milestones admin panel.
Component: timeline (1 match)
Ticket	Release Notes
#10144	The multirepository timeline filter has separate toggle all and tree expander functions.
Component: version control (2 matches)
Ticket	Release Notes
#12182	Repository.short_rev and Repository.display_rev always return a string or None.
#12194	Version control components are not required when there is a repository for the backend. This reverts behavior added in 1.1.2 ([12820]).
Component: version control/browser (1 match)
Ticket	Release Notes
#12314	Support jQuery v1.11.3.
Component: version control/changeset view (1 match)
Ticket	Release Notes
#12169	Replaced suggest.js with jQuery UI's autocomplete.
Component: web frontend (5 matches)
Ticket	Release Notes
#12172	Fixed 'AttributeError: FakeSession' object has no attribute 'authenticated' error, due to missing attributes on DetachedSession class.
#12251	The option [trac] auth_cookie_domain sets the domain attribute of the auth cookie, allowing cookies to be shared across subdomains.
#12278	Removed scripts in contrib/cgi-bin, which were equivalent to the scripts created by TracAdmin deploy.
#12426
#12446
Component: wiki system (2 matches)
Ticket	Release Notes
#12233	Added function wikisyntax_test_suite in trac.wiki.test, which plugins can use to create wiki syntax tests.
#12378	history_view.html uses ${resource.realm} rather than hard-coded ticket class for #content.

Caveats

• This release requires a database upgrade when upgrading from the 1.0.x series:

  trac-admin $TRAC_ENV upgrade
  

Developer-visible changes

A detailed view of the API changes since 1.0.x can be found in TracDev/ApiChanges/1.1.