[[PageOutline(2-5,Contents,pullout)]] = Provides a feature like Biff for file in repository == Description This plugin provides a feature like [wikipedia:Biff] for a file in a Trac repository, a mail notification system for UNIX. This plugin is useful to query or monitor certain files in the repository when someone updates it. Set Biff value automatically when a user committed into the repository: [[Image(trac-plugin-changefilebiff-ticket1.png, border=2)]] The ticket thread then shows the subsequent Biff values: [[Image(trac-plugin-changefilebiff-ticket2.png, border=2)]] To integrate TracMultiSelectBoxPlugin is good practice for ticket maintenance like this: [[Image(trac-plugin-changefilebiff-ticket-with-msb1.png)]] '''Note''': TracChangeFileBiffPlugin requires Trac 1.0 or higher, since it uses the `list` format of text type. See [t:TracTicketsCustomFields]. == Bugs/Feature Requests Existing bugs and feature requests for TracChangeFileBiffPlugin are [https://bitbucket.org/t2y/trac.plugins.changefilebiff/issues here]. If you have any issues, create a [https://bitbucket.org/t2y/trac.plugins.changefilebiff/issues/new new ticket]. == Download Download the archived source from [pypi:TracChangeFileBiffPlugin here]. == Source You can clone TracChangeFileBiffPlugin from [https://bitbucket.org/t2y/trac.plugins.changefilebiff/ here] using Mercurial, or [https://bitbucket.org/t2y/trac.plugins.changefilebiff/src browse the source]. == Configuration 1. Enable TracChangeFileBiffPlugin in the Plugins page of the web administration menu. 2. Access to File Biff admin panel: The option of `ticket-custom` section would be added when you access to File Biff admin page like this: {{{#!ini [ticket-custom] filebiff = text filebiff.format = list filebiff.label = Biff ; change file label as you like filebiff.multiple = true ; this option is used by TracMultiSelectBoxPlugin filebiff.options = ; will be set when you configure File Biff settings filebiff.size = 3 ; this option is used by TracMultiSelectBoxPlugin filebiff.matching_pattern = fnmatch ; glob matching pattern (fnmatch or gitignore) }}} 3. Configure File Biff settings: [[Image(trac-plugin-changefilebiff-admin1.png, border=2)]] Specification: - White-space is not allowed in the Name. - Cc and Filename are configured as multiple values separated by comma. - The glob pattern for Filename is allowed. - The glob pattern is configurable in `filebiff.matching_pattern` of `[ticket-custom]`. The possible values are: - `fnmatch` (default): standard glob pattern by [https://docs.python.org/2/library/fnmatch.html "fnmatch module"]. - `gitignore`: gitignore style pattern by [pypi:pathspec pathspec library]. Add a `[changefilebiff]` section after you configured File Biff settings like this: {{{#!ini [changefilebiff] biff.2e320ca20d1aed6a.cc = user1 biff.2e320ca20d1aed6a.filename = *.txt, *.text biff.2e320ca20d1aed6a.name = text-files biff.319ddde3cb437ffc.cc = user2, guest1 biff.319ddde3cb437ffc.filename = *.properties biff.319ddde3cb437ffc.name = property-files biff.dd487b83e5e76d08.cc = user1, user2 biff.dd487b83e5e76d08.filename = *.gif, *.png, *.jpg biff.dd487b83e5e76d08.name = Image-files biff_keys = dd487b83e5e76d08, 319ddde3cb437ffc, 2e320ca20d1aed6a }}} == Recent Changes See https://bitbucket.org/t2y/trac.plugins.changefilebiff/commits. == Author/Contributors '''Author:''' [wiki:t2y] [[BR]] '''Maintainer:''' [wiki:t2y] [[BR]] '''Contributors:'''