CHANGELOG

   1 Changes in version 0.10.1 - 2020-05-27
   2
   3     * FIXES https://bugs.torproject.org/33945
   4     This patch fixes a bug that caused the email autoresponder to fail after
   5     a while.
   6
   7     * FIXES https://bugs.torproject.org/34154
   8     Add new fields to the SQLite table BlockedBridges in preparation for taking
   9     into account OONI's bridge measurement results.
  10
  11     * FIXES https://bugs.torproject.org/31528
  12     BridgeDB's UI uses a bunch of obscure "chatspeak" references in its UI.  One
  13     example is that it responds with "Uh oh, spaghettios!" if there are
  14     currently no bridges available.  While funny to some, this is difficult to
  15     translate and shouldn't be part of software that's used by an international
  16     audience.  This patch removes such references.
  17
  18     * FIXES https://bugs.torproject.org/12802
  19     Add a script that sends a bridge request over email, and then checks if it
  20     received a response from BridgeDB.  We use this script as part of our nagios
  21     setup, so we notice when our autoresponder breaks.
  22
  23     * FIXES https://bugs.torproject.org/17548
  24     This patch removes PGP support.  BridgeDB's signing key expired on
  25     2015-09-11.  Nobody ever complained and maintaining the bits and pieces
  26     necessary to sign emails isn't worth the effort, so this patch removes that
  27     feature.
  28
  29     * FIXES https://bugs.torproject.org/30941
  30     Make our email responder more usable.  This patch removes the concept of
  31     "valid" email commands and returns bridges (obfs4, for now) no matter what
  32     the user sends.  BridgeDB still supports email commands in case the user
  33     needs a vanilla or IPv6 bridge.
  34
  35     * FIXES https://bugs.torproject.org/29686
  36     Rename files that contain "Bridges" to "bridgerings", to eliminate headache
  37     on file systems that are case insensitive.
  38
  39 Changes in version 0.10.0 - 2020-04-01
  40
  41     * FIXES https://bugs.torproject.org/30317
  42     Update our "howto" box, which explains how one adds bridges to Tor Browser.
  43     In addition to updating the instructions, this patch also links to
  44     instructions for Android.
  45
  46     * FIXES https://bugs.torproject.org/33631
  47     So far, BridgeDB remembered only the first distribution mechanism it ever
  48     learned for a given bridge.  That means that if a bridge would change its
  49     mind and re-configure its distribution mechanism using BridgeDistribution,
  50     BridgeDB would ignore it.  This patch changes this behavior, so bridges can
  51     actually change their distribution mechanism.
  52
  53     * FIXES https://bugs.torproject.org/31967
  54     Use a CSPRNG for selecting cached CAPTCHAs.
  55
  56     * FIXES https://bugs.torproject.org/33008
  57     Add an info page, available at bridges.torproject.org/info.  Relay Search
  58     links to this info page to explain to bridge operators what their bridge
  59     distribution mechanism means.
  60
  61 Changes in version 0.9.4 - 2020-02-19
  62
  63     * FIXES https://bugs.torproject.org/30946
  64     This patch ports BridgeDB to Python 3.  Python 2 is no longer supported
  65     since Jan 1, 2020.
  66
  67 Changes in version 0.9.3 - 2020-02-18
  68
  69     * FIXES <https://bugs.torproject.org/33299>
  70     This patch disables the distribution of FTE, ScrambleSuit, and obfs3.
  71
  72 Changes in version 0.9.2 - 2020-02-04
  73
  74     * FIXES <https://bugs.torproject.org/31427>
  75     This patch updates the AUTHORS file, HACKING.md, contact information, the
  76     Trac URL to report bugs, our instructions on BridgeDB's landing page, and it
  77     fixes a small bug in descriptor generation.
  78
  79 Changes in version 0.9.1 - 2019-10-29
  80
  81     * FIXES https://bugs.torproject.org/32203
  82     The metrics code used to weed out vanilla bridges, so they did not show up
  83     in our metrics.  This patch fixes this issue.
  84
  85     * FIXES https://bugs.torproject.org/32134
  86     While implementing our language switcher (#26543), we added a new string,
  87     "Language", that requires translations.  This patch adds a new translation
  88     request and also updates our instructions on how to request new
  89     translations.
  90
  91     * FIXES https://bugs.torproject.org/32105
  92     Mention an undocumented OS-level dependency: python3-dkim.
  93
  94 Changes in version 0.9.0 - 2019-10-16
  95
  96     * FIXES https://bugs.torproject.org/26543
  97     Implement a language switcher that allows users to override the locale that
  98     BridgeDB automatically selects by inspecting the client's request headers.
  99
 100 Changes in version 0.8.3 - 2019-10-03
 101
 102     * FIXES https://bugs.torproject.org/31903
 103     Update existing translations and request new translations.  Thanks to all
 104     volunteers who helped translate BridgeDB!
 105
 106     * FIXES https://bugs.torproject.org/31780
 107     We implemented BridgeDB's metrics in #9316 but haven't specified its format
 108     until now.  In addition to adding a specification, this patch also makes our
 109     implementation consistent with our (slightly updated) specification.
 110
 111     * FIXES https://bugs.torproject.org/29484
 112     Update BridgeDB's requirements to the latest respective versions.  Among
 113     others, this patch set updates Twisted to 19.7.0, pyOpenSSL to 19.0.0, and
 114     replaces (the abandoned) PyCrypto with PyCryptodome, which fixes security
 115     vulnerabilities.
 116
 117 Changes in version 0.8.2 - 2019-09-20
 118
 119     Updated translations for the following languages:
 120     bn, da, eo, fa, it, ko, nl, pt_BR, pt_PT, sr, zh_CN.
 121
 122 Changes in version 0.8.1 - 2019-09-11
 123
 124     * FIXES https://bugs.torproject.org/17626
 125     BridgeDB gets confused when users reply to a "get help" email.  The issue is
 126     that BridgeDB interprets commands anywhere in the email body, even if it's
 127     in quoted text.  To fix this issue, we are ignoring commands whose email
 128     body line starts with a '>' character, which is typically used for email
 129     quotes.
 130
 131     * FIXES https://bugs.torproject.org/28533
 132     The frontdesk is seeing plenty of empty bogus emails.  This fix removes the
 133     email links and instead encourages users to take a look at the Tor Browser
 134     Manual and at our Support Portal.
 135
 136 Changes in version 0.8.0 - 2019-08-20
 137
 138     * FIXES https://bugs.torproject.org/9316
 139     Make BridgeDB export usage metrics every 24 hours.  At the end of each
 140     24-hour measurement interval, BridgeDB will append usage metrics to the file
 141     METRICS_FILE, which is configured in bridgedb.conf.  Our metrics keep track
 142     of the number of (un)successful requests per transport type per country code
 143     (or email provider) per distribution method.  This way, we get to learn
 144     that, say, over the last 24 hours there were 31-40 users in Iran who
 145     successfully requested an obfs4 bridge over Moat.
 146
 147     * FIXES #26542 https://bugs.torproject.org/26542
 148     Make BridgeDB distribute vanilla IPv6 bridges again.
 149
 150     * FIXES #22755 https://bugs.torproject.org/22755
 151     Use stem instead of leekspin to create test descriptors.  We now don't need
 152     to depend on leekspin anymore.
 153
 154     * FIXES #31252 https://bugs.torproject.org/31252
 155     Add an anti-bot mechanism that allows us to detect bots by matching HTTP
 156     request headers for blacklisted patterns.  For example, bots may have their
 157     Accept-Language set to "Klingon".  Blacklisted patterns are configured in
 158     BLACKLISTED_REQUEST_HEADERS_FILE.  When BridgeDB detects a bot request, we
 159     can answer their request with a decoy bridge that's only handed out to bots.
 160     Decoy bridges are configured in DECOY_BRIDGES_FILE.
 161
 162 Changes in version 0.7.1 - 2019-06-07
 163
 164     * FIXES #28496 https://bugs.torproject.org/28496
 165     Remove Yahoo from the list of allowed email domains.  Yahoo allows you to
 166     create up to 500 disposable email addresses, which BridgeDB interprets as
 167     unique:
 168     https://bugs.torproject.org/28496#comment:8
 169     We could address this issue in BridgeDB but at this point we seem better off
 170     dropping support for Yahoo because the provider likely also fell behind in
 171     Sybil protection.
 172
 173 Changes in version 0.7.0 - 2019-06-07
 174
 175     * FIXES #28655 https://bugs.torproject.org/28655
 176     When a bridge supports an active probing-resistant transport, it should not
 177     give out flavors that are vulnerable to active probing.  For example, if a
 178     bridge supports obfs4 and obfs3, it should only give out obfs4.
 179
 180     * FIXES #30706 https://bugs.torproject.org/30706
 181     Do some simple BridgeDB housekeeping: Add missing CHANGELOG entries, add
 182     Philipp's contact info to the support section, fix a broken Trac URL, and
 183     turn HTTP link into HTTPS.
 184
 185     * FIXES #30157: https://bugs.torproject.org/30157
 186     Update BridgeDB translations.  This ticket both adds new translations and
 187     updates existing ones.
 188
 189 Changes in version 0.6.9 - 2018-11-20
 190
 191     * FIXES #23894 https://bugs.torproject.org/23894
 192     Really change the contact address, in the correct place this time.
 193
 194 Changes in version 0.6.8 - 2018-11-19
 195
 196     * FIXES #28528 https://bugs.torproject.org/28528
 197     Change maintainer info.
 198
 199     * FIXES #23894 https://bugs.torproject.org/23894
 200     Change contact email address.
 201
 202 Changes in version 0.6.7 - 2018-05-21
 203
 204     Print fingerprints in hex thank you very much.
 205
 206 Changes in version 0.6.6 - 2018-05-21
 207
 208     * FIXES #26150 https://bugs.torproject.org/26150
 209     Hotfix for strange bridges missing address fields.
 210
 211 Changes in version 0.6.5 - 2018-05-04
 212
 213     * FIXES #26023 https://bugs.torproject.org/26023
 214     There's few bridges whose ed25519 certificates contain the year 491869,
 215     which the datetime module (called from Stem) believes "out of range". So
 216     instead we'll parse the descriptors one at a time and catch the errors as we
 217     go.
 218
 219     * FIXES #25246 https://bugs.torproject.org/25246
 220     Add script for assigning unallocated bridges to another distributor.
 221
 222 Changes in version 0.6.4 - 2018-02-13
 223
 224     * FIXES #24432 https://bugs.torproject.org/24432
 225     Add config option to skip loopback addresses in X-Forwarded-For parsing.
 226
 227 Changes in version 0.6.3 - 2018-01-23
 228
 229     * FIXES #24432 https://bugs.torproject.org/24432
 230     The production moat server had issues related to redirecting to resources
 231     properly, which are now fixed.
 232
 233     * FIXES #24701 https://bugs.torproject.org/24701
 234     Adds a special surprise for the special someone who has been automatedly
 235     requesting bridges not through driving a browser, but through a script which
 236     is so thoroughly stupid that it doesn't even send the URL parameters for the
 237     CAPTCHA challenge and solution.  Their script will now be delayed for quite
 238     some time and then rickrolled.  Mess with the best, die like the rest.
 239
 240     * FIXES #24704 https://bugs.torproject.org/24704
 241     Bridges returned to a single request are now filtered such that there will
 242     never be two bridges from the same IPv4 /16 or IPv6 /64.
 243
 244 And includes the following general changes:
 245
 246     * ADDS unittests for the legacy code in bridgedb/Bridges.py,
 247     bringing the total test coverage above 90% for the first time.
 248
 249 Changes in version 0.6.2 - 2017-12-20
 250
 251     * FIXES #24636 https://bugs.torproject.org/24636
 252     The moat API specification included an extra response type which could be
 253     sent if there was no overlap between transports the client supported and
 254     those which the server supported.  This has been removed from the
 255     specification, which now describes the behaviour moat has always exhibited:
 256     if there is no overlap, the server responds with a CAPTCHA image response
 257     which includes the list of transports it does support.
 258
 259     * FIXES #24637 https://bugs.torproject.org/24637
 260     The moat server did not respond correctly with the specified JSON API error
 261     type when there were no bridges available.  It now responds correctly with a
 262     404 error whose details describe why the request could not be fulfilled.
 263     The moat server also now logs messages if there were not the configured
 264     MOAT_BRIDGES_PER_RESPONSE number of bridges available.
 265
 266 Changes in version 0.6.1 - 2017-12-13
 267
 268     * ADDS a shell script, scripts/test-moat, for testing either a
 269     locally-running moat server, or a remote one through a meek tunnel.  Thanks
 270     to David Fifield for his work on meek, assistance setting it up, and
 271     providing the first version of this script.
 272
 273     * FIXES #24433 https://bugs.torproject.org/24433
 274     The test-moat script wasn't sending an X-Forwarded-For header, which
 275     triggered a bug in the moat server, since the CAPTCHA solution includes an
 276     HMAC based on the client's IP (forwarded through all the several layers of
 277     tunnels/proxies).
 278
 279     * FIXES #24443 https://bugs.torproject.org/24443
 280     Due to a difference between how booleans are parsed by Python's json library
 281     and normal Python booleans, the moat server was generating and returning
 282     QRCodes… regardless of whether the remote client application asked for one.
 283     This is now fixed.
 284
 285     * FIXES #24460 https://bugs.torproject.org/24460
 286     There was an unhandled error when sending certain (what appears to be
 287     possibly malicious? but in a very strange way) requests to BridgeDB's HTTPS
 288     distributor.  The robots making the requests were attempting to request
 289     bridges, but were presenting a CAPTCHA solution without the correct HTML
 290     form field parameters present, which isn't possible through normal usage of
 291     the web interface.  Whoever or whatever is doing this is now going to be
 292     endlessly redirected so that they may forever spiral in their own private
 293     internet hell.  I reserve the right come up with a worse fate for them
 294     later, should I get bored.
 295
 296     * FIXES #3015 https://bugs.torproject.org/3015
 297     BridgeDB has had a partially-implemented concept of "buckets" since the age
 298     of the dinosaurs: write some of the unallocated bridges to a file which
 299     should (somehow) be manually distributed.  In addition to be unused and
 300     untested, there were several issues with the buckets, the most significant
 301     of which were the inability to request pluggable transports in a bucket and
 302     the fact that buckets were not persistent in any way (e.g. if i request a
 303     bucket of 50 bridges for Gomez and another with 50 for Morticia, they might
 304     end up with some of the same bridges, further, tomorrow they'll end up with
 305     50 possibly different bridges than those they received today).  All of this
 306     code is now removed.
 307
 308 And includes the following general changes:
 309
 310     * FIXES issues with JSON quote syntax and a mistaken JSON API
 311     "type" parameter in the specification of the moat server (in the README).
 312     Thanks to Mark Smith and Kathy Brade for pointing out the issues.
 313
 314 Changes in version 0.6.0 - 2017-11-15
 315
 316     * ADDS a new JSON API distributor called "moat", which is intended
 317     for use for Tor Launcher to use to build an in-browser UI for retrieving
 318     bridges.
 319
 320     * CHANGES the organisation of code to add a new
 321     bridgedb.distributors package as well as a bridgedb.distributors.common
 322     package for code shared between multiple distributors.
 323
 324 Changes in version 0.5.0 - 2017-10-28
 325
 326     * FIXES #23957 https://bugs.torproject.org/23957
 327     BridgeDB now supports bridge operators choosing how their bridge will be
 328     distributed.  See the "BridgeDistribution" torrc option in tor's manpage for
 329     details.
 330
 331     * FIXES #16650 https://bugs.torproject.org/16650
 332     BridgeDB is now accessible via select remote user interfaces through a meek
 333     tunnel.
 334
 335     * FIXES #22998 https://bugs.torproject.org/23033
 336     * FIXES #23033 https://bugs.torproject.org/23033
 337     * FIXES #23034 https://bugs.torproject.org/23034
 338     Upgrades BridgeDB to newer versions of Twisted and PyOpenSSL, and fixes
 339     several issues due to non-backwards compatible changes within those
 340     libraries.
 341
 342 Changes in version 0.4.0 - 2017-01-09
 343
 344     * FIXES #21162 https://bugs.torproject.org/21162
 345     BridgeDB now supports arbitrarily blacklisting suspected bad bridges from
 346     being distributed to clients.  This is in response to a suspected sybil
 347     attack by an unknown party.  For more details, see:
 348     https://lists.torproject.org/pipermail/tor-project/2016-December/000851.html
 349
 350 Changes in version 0.3.8 - 2016-09-22
 351
 352     * FIXES #20088 https://bugs.torproject.org/20088
 353     BridgeDB now supports receiving descriptors from multiple Bridge
 354     Authorities.  See also #19690.
 355
 356     * FIXES #20087 https://bugs.torproject.org/20087
 357     BridgeDB's version of Stem now supports parsing transport lines in bridge
 358     extrainfo descriptors which contain IPv6 addresses contained within square
 359     brackets.
 360
 361 Changes in version 0.3.7 - 2016-08-04
 362
 363     * FIXES #19691 https://bugs.torproject.org
 364     BridgeDB (as running on Tor Project infrastructure) is now invocated with a
 365     redirection of stdout and stderr to the flog utility, in order to ensure
 366     that file handles are properly closed and reopened when BridgeDB receives a
 367     SIGHUP.
 368
 369 And includes the following general changes:
 370
 371     * ADDS some files which were missing from BridgeDB PyPI packages
 372     to the MANIFEST.in, so that they are now included.
 373
 374 Changes in version 0.3.6 - 2016-07-28
 375
 376     * FIXES #18237 https://bugs.torproject.org/18237
 377     During descriptor parsing, BridgeDB saves copies of descriptor files which
 378     couldn't be parsed, for later debugging purposes.  To avoid filing up the
 379     runtime directory with these files, we now delete files older than 24 hours,
 380     every 24 hours.
 381
 382     * FIXES #18949 https://bugs.torproject.org/18949
 383     Since we've upgraded the host machine which runs The Tor Project's BridgeDB
 384     instance to Debian Jessie, this patch updates the testing configurations and
 385     continuous integration infrastructure to run tests on versions of Python
 386     dependencies in Debian Jessie and Stretch.
 387
 388 Changes in version 0.3.4 - 0.3.5 - 2015-11-30
 389
 390     * FIXES #14685 https://bugs.torproject.org/14685
 391     This disables distribution of obfs2 bridges.  This pluggable transport has
 392     known distiguishers which allow adversaries to identify client connections
 393     to obfs2 bridges, which in turn allows these connections to be
 394     blocked/censored.  With numerous obfs3 and obfs4 bridges both readily
 395     available, users should not be presented with an easily-configurable choice
 396     that is known to be unsafe for the majority of users.
 397
 398 And includes the following general changes:
 399
 400     * ADDS error pages to BridgeDB's web interface, to provide
 401     friendlier explanations for downtime, missing pages, and internal server
 402     errors.  For example: https://bridges.torproject.org/404
 403
 404 Changes in version 0.3.3 - 2015-10-25
 405
 406     * FIXES #12029 https://bugs.torproject.org/12029
 407     BridgeDB now has an API for creating Bridge Distributors.  See the
 408     bridgedb.distribute module, or its developer documentation at
 409     https://pythonhosted.org/bridgedb/bridgedb.distribute.html.
 410
 411     * FIXES PART OF #12506  https://bugs.torproject.org/12506
 412     BridgeDB's two Distributors (HTTPS and Email) are now entirely modularised
 413     and self-contained within separate subdirectories in the source code.  This
 414     is the first step to redesigning these Distributors into their own separate
 415     processes, which will allow the Distributors to remain functional while
 416     BridgeDB is reparsing bridge descriptors.
 417
 418     * FIXES #15968 https://bugs.torproject.org/15968
 419     BridgeDB now sends a Content-Security-Policy header which explicitly allows
 420     Javascript, images, CSS, and fonts, from https://bridges.torproject.org.
 421     All other types of content are forbidden, including:
 422       - embedding https://bridges.torproject.org within
 423         <iframe>, <embed>, or <object>, and attempting to source
 424         additional resources into its embedded context
 425       - inline Javascript, including Javascript within SVG files
 426       - inline CSS
 427       - externally hosted fonts
 428       - inline SVG, e.g. via the HTML5 <svg> tag
 429       - any and all connections made via Javascript XMLHttpRequests,
 430         WebSockets, sendBeacon(), and Web Workers
 431       - plugins
 432       - applets
 433     BridgeDB's Content-Security-Policy does not yet make use of certain newer,
 434     lesser supported, Content-Security-Policy v2.0 directives, such as
 435     "reflected-xss" and "frame-ancestors", but may someday.
 436
 437     * FIXES #16273 https://bugs.torproject.org/16273
 438     Several links to Tor Project gitweb URLs within the developer documentation
 439     were outdated in that they still used the old gitweb URL format.  These are
 440     now updated.  Thanks to David Fifield for the bug report and patches.
 441
 442     * FIXES #16330 https://bugs.torproject.org/16330
 443     BridgeDB can now handle bridge-server-descriptors with extra-info-digest
 444     fields which have two values, as well as both bridge-server-descriptors and
 445     bridge-extrainfo descriptors which contain Ed25519 key material and
 446     signatures.  See Tor proposals #220 and #228 for more information on the
 447     changes to these descriptors.  Note that BridgeDB can now parse this
 448     information, but does not yet make use of any Ed25519 cryptographic material
 449     within bridge descriptors.
 450     https://gitweb.torproject.org/torspec.git/tree/proposals/220-ecc-id-keys.txt
 451     https://gitweb.torproject.org/torspec.git/tree/proposals/228-cross-certification-onionkeys.txt
 452     Thanks to Atagar for patching Stem.
 453
 454     * FIXES #16616 https://bugs.torproject.org/16616
 455     The HSDir flag can now be included within bridge-networkstatus documents.
 456     BridgeDB now has unittests which guarantee that its parsers safely ignore
 457     this flag, as well as any flags unknown to BridgeDB which may appear in the
 458     future.  Thanks to Roger Dingledine for alerting me about the change.
 459
 460     * FIXES #16649 https://bugs.torproject.org/16649
 461     Mobile users, and other users with small screen pixel ratios, will find that
 462     the UI of BridgeDB's HTTPS Distributor has greatly increased in usability
 463     and readability.
 464
 465 And includes the following general changes:
 466
 467     * FIXES an error when requesting the non-HTML version of the
 468     bridges page (e.g. https://bridges.torproject.org/bridges?format=plain)
 469
 470     * REMOVES the `bridgedb test` commandline option.
 471     BridgeDB's tests can be run via `python setup.py test` or `make test` (or
 472     `make coverage` for generating HTML test coverage statistics).
 473
 474     * CHANGES the HTTPS Distributor to HTML-encode Bridge Lines.
 475     Previously, a malicious Pluggable Transport Bridge could include in its PT
 476     arguments something like "evil=<script>[…]</script>" and if such a Bridge
 477     were to be distributed to a user, that user's web browser would execute the
 478     script (if Javacript was enabled).  Other characters, including non-ASCII,
 479     control characters, double quotes, and backslashes, are also sanitised from
 480     Bridge Lines.  Thanks to Robert Ransom for the patches.
 481
 482     * CHANGES BridgeDB's module/package version numbers to be compliant with
 483     PEP440.
 484
 485     * CHANGES the layout of BridgeDB's source code directories.
 486     Rather than storing BridgeDB's source in "lib/bridgedb/", it is now kept in
 487     "bridgedb/".  Similarly, the directory containing BridgeDB's tests has been
 488     moved from "lib/bridgedb/test/" to "test/", which means that the tests are
 489     no longer installed when running `python setup.py install` or `make
 490     install`.
 491
 492     * ADDS several improvements to the developer documentation at
 493     https://pythonhosted.org/bridgedb.
 494
 495     * UPDATE English (en_US) translations.
 496
 497     * UPDATE English (en) translations.
 498
 499     * ADD Serbian (sr) translations.
 500       Thanks to obj.petit.a, Ivan Radeljic, and Milenko Doder.
 501
 502     * UPDATE Arabic (ar) translations.
 503       Thanks to  A. Hassan, debo debo, KACIMI LAMINE, and Nudroid A.
 504
 505     * UPDATE Catalan (ca) translations.
 506       Thanks to laia_.
 507
 508     * UPDATE Czech (cs) translations.
 509       Thanks to Tomas Palik and Vlastimil Burián.
 510
 511     * UPDATE Danish (da) translations.
 512       Thanks to Mogelbjerg.
 513
 514     * UPDATE German (de) translations.
 515       Thanks to jschfr, Junge Limba, and Toralf Förster.
 516
 517     * UPDATE English (en_GB) translations.
 518       Thanks to Andi Chandler.
 519
 520     * UPDATE Farsi (fa) translations.
 521       Thanks to some awesome anonymous person for helping out.
 522
 523     * UPDATE Finish (fi) translations.
 524       Thanks to Riku Viitanen.
 525
 526     * UPDATE French (fr) translations.
 527       Thanks to elouann, Trans-fr, and Towinet.
 528
 529     * UPDATE French (fr_CA) translations.
 530       Thanks to Trans-fr.
 531
 532     * UPDATE Croatian (hr_HR) translations.
 533       Thanks to some awesome anonymous person for helping out.
 534
 535     * UPDATE Hungarian (hu) translations.
 536       Thanks to some awesome anonymous person for helping out.
 537
 538     * UPDATE Indonesian (id) translations.
 539       Thanks to Anthony Santana, Astryd Viandila Dahlan, cholif yulian,
 540       constantius damar wicaksono, Dwi Cahyono, L1Nus, km242saya, and Zamani
 541       Karmana.
 542
 543     * UPDATE Italian (it) translations.
 544       Thanks to Random_R.
 545
 546     * UPDATE Japanese (ja) translations.
 547       Thanks to ABE Tsunehiko.
 548
 549     * UPDATE Latvian (lv) translations.
 550       Thanks to Ojārs Balcers.
 551
 552     * UPDATE Norwegian Bokmål (nb) translations.
 553       Thanks to Erik Matson and Kristian Andre Henriksen.
 554
 555     * UPDATE Dutch (nl) translations.
 556       Thanks to Mart3000.
 557
 558     * UPDATE Polish (pl) translations.
 559       Thanks to Karol Obartuch.
 560
 561     * UPDATE Portuguese (pt) translations.
 562       Thanks to Bruno D. Rodrigues and MMSRS.
 563
 564     * UPDATE Brazillian Portuguese (pt_BR) translations.
 565       Thanks to Communia.
 566
 567     * UPDATE Romanian (ro) translations.
 568       Thanks to  Ana, axel_89, and Di N.
 569
 570     * UPDATE Russian (ru) translations.
 571       Thanks to Ivan.
 572
 573     * UPDATE Slovak (sk_SK) translations.
 574       Thanks to StefanH.
 575
 576     * UPDATE Albanian (sq) translations.
 577       Thanks to  some awesome unknown anonymous person who didn't add their name
 578       to the list of translators.
 579
 580     * UPDATE Swedish (sv) translations.
 581       Thanks to Peter Michanek.
 582
 583     * UPDATE Turkish (tr) translations.
 584       Thanks to Bullgeschichte and Fomas.
 585
 586     * UPDATE Ukranian (uk) translations.
 587       Thanks to Yasha.
 588
 589     * UPDATE Chinese Mandarin (zh_CN) translations.
 590       Thanks to khi.
 591
 592     * UPDATE Taiwanese Mandarin (zh_TW) translations.
 593       Thanks to x4r.
 594
 595 Changes in version 0.3.2 - 2015-05-01
 596
 597     * FIXES a problem with the calculation of Levenshtein distances
 598     between blacklisted email addresses and those on incoming email. This fixes
 599     a problem with the fuzzy matching implemented in #9385:
 600     https://bugs.torproject.org/9385.
 601
 602     * FIXES #1839 https://bugs.torproject.org/1839
 603     BridgeDB's distributors now rotate their hashrings at configurable scheduled
 604     intervals.
 605
 606     * FIXES #4771 https://bugs.torproject.org/4771
 607     BridgeDB now records which of the HTTPS Distributor's sub-hashrings are used
 608     for clients coming from Tor Exit nodes and other known proxies.
 609
 610     * FIXES #12504 https://bugs.torproject.org/12504
 611     Which Pluggable Transports BridgeDB distributes is now easily configurable
 612     via the bridgedb.conf configuration file.
 613
 614     * FIXES #13202 https://bugs.torproject.org/13202
 615     Old bridges running Tor-0.2.4.x with Pluggable Transports like scramblesuit
 616     and obfs4proxy have a bug which causes them to not include the PT arguments
 617     in the `transport` line they submit to the BridgeAuthority in their
 618     extrainfo descriptors.  This causes BridgeDB to have broken bridge lines for
 619     these bridges.  For example, scramblesuit requires a `password=` in the
 620     `ClientTransportPlugin` for clients to connect to it.  If BridgeDB receives
 621     a line in that bridge's extrainfo which says `transport scramblesuit
 622     1.2.3.4:1234` (without a password), then when BridgeDB gives clients a
 623     bridge line for that bridge, it'll look like "Bridge scramblesuit
 624     1.2.3.4:1234" - meaning that it won't work.  This fixes the issue by
 625     excluding broken transports from being distributed to clients.
 626
 627     * FIXES #15517 https://bugs.torproject.org/15517
 628     For all clients who are coming from IPv6 addresses and are not using Tor,
 629     who go to https://bridges.torproject.org, BridgeDB now groups these clients
 630     together by /32.  This "grouping" causes all IPv6 clients within the same
 631     IPv6 /32 to get the same bridges.  Previously, BridgeDB grouped IPv6 clients
 632     by /64 (which is ridiculously small, considering standard IPv6 allocation
 633     sizes).
 634
 635     For all clients who are coming from IPv4 addresses and are not using Tor,
 636     BridgeDB now groups these clients together by /16.  Previously, BridgeDB
 637     grouped IPv4 clients by /24.  (This latter change was technically made as
 638     part of #4771.)
 639
 640     * FIXES #15464 https://bugs.torproject.org/15464
 641     The setup procedure for creating a BridgeDB Continuous Integration build
 642     machine is now simplified and generalised to include build environments like
 643     Jenkins, not just TravisCI.
 644
 645     * FIXES #15866 https://bugs.torproject.org/15866
 646     BridgeDB now ignores nearly all the information in the networkstatus-bridges
 647     file created by the BridgeAuthority.
 648
 649     * ADDS benchmark tests to BridgeDB's test suite, and some of
 650     BridgeDB's algorithms have been revised to improve their speed.
 651
 652 Changes in version 0.3.1 - 2015-03-24
 653
 654     * FIXES #14065 https://bugs.torproject.org/14065
 655     When requesting vanilla IPv6 bridges from https://bridges.torproject.org,
 656     BridgeDB would respond with IPv4 addresses.  It now correctly responds with
 657     IPv6 addresses.
 658
 659 And includes the following general changes:
 660
 661     * FIXES an issue with the filtering of hashrings while answering
 662     requests for Pluggable Transports. (commit 3ef37df6)
 663
 664     * FIXES the return value from the GnuPG interface initialization
 665     function (bridgedb.crypto.initializeGnuPG) when creating a test signature
 666     has failed.
 667
 668     * CHANGES the way BridgeDB handles the case where it parses to
 669     duplicate extrainfo descriptors (for the same Bridge) which also have
 670     identical timestamps.  Before, we assumed this wasn't possible.  It turns
 671     out that it not only is possible, but that usually every batch of
 672     descriptors has at least one Bridge with such a set of perfectly identical
 673     extrainfo descriptors.  Even stranger, it appears that only Bridges started
 674     for the first time quite recently (within the last eight hours) display this
 675     behaviour.  BridgeDB now logs these errors, rather than leaving them
 676     unhandled.  (commit a27d7905)
 677
 678     * ADDS an environment variable check to setup.py which controls
 679     whether the setup.py script tries to install the dependencies listed in the
 680     requirements.txt file with easy_install.  If the environment variable
 681     BRIDGEDB_INSTALL_DEPENDENCIES=0, then setup.py will not use easy_install.
 682     When BridgeDB is installed via `make install` the default is to not use
 683     easy_install; however, when installed via `python setup.py install`, the
 684     default is to use easy_install to check for, find, and install dependencies.
 685     (NOTE: the latter is *not* recommended.) (commit d035fe64)
 686
 687 Changes in version 0.3.0 - 2015-03-21
 688
 689     * FIXES #2895 https://bugs.torproject.org/2895
 690     BridgeDB no longer assumes that any extrainfo descriptor files are in
 691     chronological order.
 692
 693     * FIXES #4405 https://bugs.torproject.org/4405
 694     BridgeDB now has a built-in timer mechanism for scheduling cronjobesque
 695     events. This is now used to routinely download and parse the list of Tor
 696     exit relays in a completely asynchronous manner.
 697
 698     * FIXES #9380 https://bugs.torproject.org/9380
 699     BridgeDB now uses Stem (https://stem.torproject.org) for its parsers, and
 700     has better classes for parsing and storing information on Bridges and their
 701     Pluggable Transports.  Additionally, all of BridgeDB's parses and the new
 702     Bridge/PluggableTransport classes all have 100% unittest and integration
 703     test coverage.
 704
 705     * FIXES #10385 https://bugs.torproject.org/10385
 706     BridgeDB now uses python-gnupg (https://pypi.python.org/gnupg) instead of
 707     GPGME (libgpgme11 and pygpgme). Previously, when using GPGME, BridgeDB was
 708     unable to sign emails with a subkey whose master private key was not
 709     present, causing all signing to be broken. Additionally, GPGME tried to
 710     access and modify the BridgeDB users $HOME directory, and GPGME would also
 711     try to create signatures with encryption-only subkeys, and try to
 712     encrypt/decrypt with signing-only subkeys. All of these issues are no more,
 713     because the writhing tangled mass of bugs known ad GPGME is gone for good.
 714
 715     * FIXES #11216 https://bugs.torproject.org/11216
 716     BridgeDB no longer parses any extrainfo descriptor files cumulatively.
 717     Before, a Bridge which had a descriptor in cached-extrainfo and in
 718     cached-extrainfo.new and supported obfs3, obfs4, and scramblesuit transports
 719     would be parsed twice, resulting in the Bridge having six transports. This
 720     is no longer the case.
 721
 722     * HOTFIXES an issue with non-deterministic unittest failures in
 723     the Mechanize-based integrations tests in lib/bridgedb/test/test_https.py.
 724     hotfix/0.2.4-mechanize-tags
 725
 726     * FIXES part of #12507 https://bugs.torproject.org/12507
 727     BridgeDB now has semi-automated developer documentation builds at
 728     https://pythonhosted.org/bridgedb/.
 729
 730     * FIXES #12805 https://bugs.torproject.org/12805
 731     BridgeDB is now packaged on PyPI, in the hopes that someday other
 732     organisations will be able to run their own BridgeDBs.
 733
 734     * FIXES #12843 https://bugs.torproject.org/12843
 735     BridgeDB will no longer distribute bridges which it believes are located in
 736     Iran or Syria.
 737
 738     * FIXES #12872 https://bugs.torproject.org/12872
 739     BridgeDB now has geolocational information for Bridges, telling it which
 740     country each Bridge's primary ORAddress is within, as well as geolocational
 741     information for each PluggableTransport address.  Thanks to Alden S. Page
 742     for the patches.
 743
 744     * FIXES #15155 https://bugs.torproject.org/15155
 745     The instructions for obtaining a copy of Tor Browser should now be more
 746     clear.  Thanks to Jens Kubieziel, Nick Mathewson, and Peter Palfrader.
 747
 748 And includes the following general changes:
 749     * CHANGES BridgeDB's continuous integration infrastructure to run
 750     tests for:
 751             - Twisted-13.2.0 (Debian Wheezy version),
 752             - Twisted-14.0.2 (Debian Jessie version), and
 753             - Twisted-15.0.0 (latest and greatest)
 754     As well as testing both:
 755             - pyOpenSSL-0.13.1 (Debian Wheezy version), and
 756             - pyOpenSSL-0.14 (Debian Jessie version).
 757     See https://travis-ci.org/isislovecruft/bridgedb/builds
 758
 759     * FIXES an issue with the $PYTHON_EGG_CACHE directory being group
 760     writable on Travis-CI build machines.
 761
 762     * UPDATE English (en_US) translations.
 763
 764     * UPDATE English (en) translations.
 765
 766     * ADD Tamil (ta) translations.
 767       Thanks to git12a.
 768
 769     * ADD Albanian (sq) translations.
 770       Thanks to Bujar Tafili.
 771
 772     * ADD Slovenian (sl_SI) translations.
 773       Thanks to Dušan, marko, and Nwolfy.
 774
 775     * ADD Slovak (sk_SK) translations.
 776       Thanks to once.
 777
 778     * ADD Esperanto (eo) translations.
 779       Thanks to identity, Rico Chan, and trio.
 780
 781     * ADD Bulgarian (bg) translations.
 782       Thanks to aramaic.
 783
 784     * ADD Azerbaijani (az) translations.
 785       Thanks to E.
 786
 787     * UPDATE Chinese (zh_TW) translations.
 788       Thanks to LNDDYL.
 789
 790     * UPDATE Chinese (zh_CN) translations.
 791       Thanks to Wu Ming Shi and YF.
 792
 793     * UPDATE Ukranian (uk) translations.
 794       Thanks to Eugene ghostishev, LinuxChata, Oleksii Golub, and
 795       Андрій Бандура.
 796
 797     * UPDATE Turkish (tr) translations.
 798       Thanks to eromytsatiffird, Emir Sarı, Idil Yuksel, ozkansib,
 799       Volkan Gezer, and zeki.
 800
 801     * UPDATE Swedish (sv) translations.
 802       Thanks to Anders Jensen-Urstad, Emil Johansson, GabSeb, ph AA, phst,
 803       and leveebreaks.
 804
 805     * UPDATE Slovak (sk) translations.
 806       Thanks to elo, FooBar, Michal Slovák, Roman 'Kaktuxista' Benji, and
 807       StefanH.
 808
 809     * UPDATE Russian (ru) translations.
 810       Thanks to Andrey Yoker Ogurchikov, Evgrafov Denis, foo,
 811       joshuaridney, Oleg, Sergey Briskin, Valid Olov, and Vitaliy Grishenko.
 812
 813     * UPDATE Romanian (ro) translations.
 814       Thanks to Isus Satanescu, laura berindei, and clopotel.
 815
 816     * UPDATE Portuguese (pt_BR) translations.
 817       Thanks to João Paulo S.S.
 818
 819     * UPDATE Portuguese (pt) translations.
 820       Thanks to alfalb.as, André Monteiro, kagazz, Manuela Silva,
 821       alfalb_mansil, Andrew_Melim, Pedro Albuquerque, Sérgio Marques, and
 822       TiagoJMMC.
 823
 824     * UPDATE Polish (pl) translations.
 825       Thanks to Aron, JerBen, bogdrozd, Dawid, Rikson, Krzysztof Łojowski,
 826       oirpos, and seb.
 827
 828     * UPDATE Dutch (nl) translations.
 829       Thanks to Adriaan Callaerts, Ann Boen, Cleveridge, Dick,
 830       Johann Behrens, Shondoit Walker, Marco Brohet, guryman, Marco
 831       Brohet, Tom Becht, Tonko Mulder, math1985, and BBLN.
 832
 833     * UPDATE Norwegian Bokmål (nb) translations.
 834       Thanks to Allan Nordhøy, Harald, lateralus, Per Thorsheim,
 835       and thor574.
 836
 837     * UPDATE Latvian (lv) translations.
 838       Thanks to Ojārs Balcers and ThePirateDuck.
 839
 840     * UPDATE Khmer (km) translations.
 841       Thanks to Seng Sutha, Sokhem Khoem, and Sok Sophea.
 842
 843     * UPDATE Japanese (ja) translations.
 844       Thanks to brt, ABE Tsunehiko, タカハシ, Masaki Saito, and
 845       藤前　甲.
 846
 847     * UPDATE Italian (it) translations.
 848       Thanks to fetidyoo, Francesca Ciceri, HostFat, ironbishop, and
 849       Jacob Appelbaum.
 850
 851     * UPDATE Hungarian (hu) translations.
 852       Thanks to Blackywantscookies, Lajos Pasztor, Cerbo, and vargaviktor.
 853
 854     * UPDATE Croatian (hr) translations.
 855       Thanks to Ana B, Armando Vega, skiddiep, Tomislav Siroglavić,
 856       and gogo.
 857
 858     * UPDATE French (fr_CA) translations.
 859       Thanks to Lunar, mehditaileb, Onizuka, and yahoe.001.
 860
 861     * UPDATE French (fr) translations.
 862       Thanks to apaddlingduck, fayçal fatihi, Boubou, Cryptie,
 863       Frisson Reynald, hpatte, Lucas Leroy, Lunar, Onizuka, and mehditaileb.
 864
 865     * UPDATE Finnish (fi) translations.
 866       Thanks to Jorma Karvonen, Spacha, Ossi Kallunki, Sami Kuusisto,
 867       viljaminojonen, and Finland355.
 868
 869     * UPDATE Farsi (fa) translations.
 870       Thanks to arashaalaei, signal89, ardeshir, Gilberto, johnholzer,
 871       Mohammad Hossein, perspolis, and Setareh.
 872
 873     * UPDATE Spanish (es) translations.
 874       Thanks to dark_yoshi, toypurina, BL, NinjaTuna, Noel Torres,
 875       Paola Falcon, strel, and Jonis.
 876
 877     * UPDATE English (en_GB) translations.
 878       Thanks to Andi Chandler, Richard Shaylor, and ronnietse.
 879
 880     * UPDATE Greek (el) translations.
 881       Thanks to Adrian Pappas, andromeas, oahanx, isv31, and kotkotkot.
 882
 883     * UPDATE German (de) translations.
 884       Thanks to trantor, Ettore Atalan, unknwon_anonymous, konstibae,
 885       Locke, Tobias Bannert, qbi, Sebastian, and debakel.
 886
 887     * UPDATE Danish (da) translations.
 888       Thanks to Christian Villum, David Nielsen, OliverMller, torebjornson,
 889       Thomas Pryds, and Tore Bjørnson.
 890
 891     * UPDATE Czech (cs) translations.
 892       Thanks to A5h8d0wf0x, Adam Slovacek, Elisa, Sanky, Jiří Vírava,
 893       mxsedlacek, and Radek Bensch.
 894
 895     * UPDATE Catalan (ca) translations.
 896       Thanks to Albert, Assumpta Anglada, Eloi García i Fargas, Humbert,
 897       and laia_.
 898
 899     * UPDATE Arabic (ar) translations.
 900       Thanks to Ash and Valetudinarian.
 901
 902 Changes in version 0.2.4 - 2015-02-03
 903
 904     * HOTFIXES a UnicodeDecodeError resulting from patches for #12627.
 905     https://bugs.torproject.org/12627
 906
 907     * FIXES #9874 https://bugs.torproject.org/9874
 908     BridgeDB now has integration tests for all bridge distributors.  Thanks to
 909     trygve for the patches.
 910
 911     * FIXES #12871 https://bugs.torproject.org/12871
 912     Bridge Buckets now work, even if the code for calculating Bridge stability
 913     is disabled.  Thanks to Matt Finkel for the patches.
 914
 915     * FIXES part of #12029 https://bugs.torproject.org/12029
 916     Major sections of the bridgedb.Bridges module, which holds BridgeDB's main
 917     data structures for storing and parsing Bridges, have been refactored in
 918     preparation for upcoming changes to use Stem's parsers (see #9380
 919     https://bugs.torproject.org/9380)
 920
 921     * FIXES #12932 https://bugs.torproject.org/12932
 922     Arguments for Pluggable Transports in the bridge lines which BridgeDB
 923     distributes to users are now properly space-separated. This issue was
 924     affecting the deployment of the obfs4 PT (see #12130
 925     https://bugs.torproject.org/12130).
 926
 927     * FIXES #13123 https://bugs.torproject.org/13123
 928     Previously, there were two additional whitespace characters at the beginning
 929     of bridge lines handed out by BridgeDB's HTTPS distributor, which would be
 930     annoyingly copy+pasted into TorLauncher and torrcs, etc.  These are now
 931     gone.
 932
 933     * FIXES #12664 https://bugs.torproject.org/12664
 934     Previously, for the bridge lines handed out by BridgeDB's HTTPS distributor,
 935     the newlines were not properly pasted when a user would copy+paste the
 936     lines. This is now fixed. Additionally, there is now a "Select All" button
 937     (JS must be enabled) to select all text for the bridge lines, to attempt to
 938     reduce user copy+paste errors.  If the display area which contains the
 939     bridge lines is clicked, and JS is enabled, it has the same effect as
 940     clicking the "Select All" button.
 941
 942     * FIXES #14064 https://bugs.torproject.org/14064
 943     The bridge lines handed out by BridgeDB's HTTPS distributor are now
 944     displayed with a horizontal scrollbar if they are too long to fit into the
 945     display area.
 946
 947     * FIXES #11345 https://bugs.torproject.org/11345
 948     BridgeDB now supports giving users QRCodes for their bridge lines, to
 949     facilitate getting bridges into Tails and onto mobile devices.
 950
 951     * FIXES #12130 https://bugs.torproject.org/12130
 952     BridgeDB's distributors now have options to distribute obfs4 bridges.
 953
 954 And includes the following general changes:
 955     * CHANGES the integration tests based on Mechanize to only run on
 956     CI servers, not locally on developers laptops, since it requires the running
 957     BridgeDB test/staging instance to offer a plaintext HTTP interface. See
 958     commit 24acf6a72.
 959     https://gitweb.torproject.org/bridgedb.git/commit/?id=24acf6a72931c602631c97dbbeb582c22cf446cb
 960
 961     * ADDS better installation instructions in README.rst for
 962     developers who wish to test their changes to BridgeDB.  Thanks to Alden Page
 963     for the patch.
 964
 965 Changes in version 0.2.3 - 2014-07-26
 966
 967     * FIXES #5463 https://bugs.torproject.org/5463
 968     BridgeDB can now OpenPGP sign outgoing emails.
 969
 970     * FIXES #9385 https://bugs.torproject.org/9385
 971     BridgeDB now has the ability to blacklist email addresses, and configurable
 972     options to fuzzy match and block addresses which are similar enough to those
 973     in the blacklist.
 974
 975     * FIXES #11139 https://bugs.torproject.org/11139
 976     You can now email BridgeDB from Riseup email addresses!
 977
 978     * FIXES #12147 https://bugs.torproject.org/12147
 979     An additional issue with BridgeDB's code for scheduling actions was
 980     identified by Robert Ransom, who also provided a unittest to demonstrate the
 981     issue and test for future regressions. The issue pointed out has also been
 982     fixed.
 983
 984     * FIXES #12635 https://bugs.torproject.org/12635
 985     The links in BridgeDB's email and HTTPS distributor UIs have been changed
 986     from the obsolete
 987     https://www.torproject.org/projects/torbrowser.html.en#downloads-beta
 988     to
 989     https://www.torproject.org/projects/torbrowser.html.
 990
 991     * FIXES #12650 https://bugs.torproject.org/12650
 992     BridgeDB's translation files sometimes take a little while to update because
 993     real live human volunteers need to go to Transifex.org and convert the
 994     strings between languages. Then I need to import the strings, check all of
 995     them by hand to make sure there's no funny business which could harm users
 996     in them, and then commit all the diffs. Sadly, there isn't much more we can
 997     do to speed up this process, so sometimes BridgeDB's UI falls back to
 998         English when it doesn't have new enough translations files. Sorry!
 999
1000 And includes the following general changes:
1001
1002     * UPDATE translation: Chinese - Taiwan (zh_TW)
1003             THANKS TO danfong.
1004     * UPDATE translation: Chinese - China (zh_CN)
1005             THANKS TO Meng3, leungsookfan, and Wu Ming Shi.
1006     * UPDATE translation: Turkish (tr)
1007             THANKS TO eromytsatiffird, Emre, Idil Yuksel, ozkansib,
1008             Volkan Gezer, and zeki.
1009     * UPDATE translation: Swedish (sv)
1010             THANKS TO Anders Jensen-Urstad, GabSeb, and phst.
1011     * UPDATE translation: Russian (ru)
1012             THANKS TO Evgrafov Denis, Eugene, foo, Sergey Briskin,
1013             Valid Olov, and Vitaliy Grishenko.
1014     * UPDATE translation: Brazilian Portuguese (pt_BR)
1015             THANKS TO Isabel Ferreira, and Rodrigo Emmanuel Santana
1016             Borges.
1017     * UPDATE translation: Portuguese (pt)
1018             THANKS TO André Monteiro, kagazz, Manuela Silva,
1019             Andrew_Melim, and Sérgio Marques.
1020     * UPDATE translation: Polish (pl)
1021             THANKS TO Aron, Dawid, Krzysztof Łojowski, and seb.
1022     * UPDATE translation: Norwegian Bokmål (nb)
1023             THANKS TO Allan Nordhøy, Harald, and thor574.
1024     * UPDATE translation: Malay (ms_MY)
1025             THANKS TO shahril.
1026     * UPDATE translation: Latvian (lv)
1027             THANKS TO Ojārs Balcers.
1028     * UPDATE translation: Khmer (km)
1029             THANKS TO Seng Sutha, Sokhem Khoem, and Sok Sophea.
1030     * UPDATE translation: Hungarian (hu)
1031             THANKS TO Blackywantscookies, and Cerbo.
1032     * UPDATE translation: Croatian (hr_HR)
1033             THANKS TO Ana B.
1034     * UPDATE translation: Hebrew (he)
1035             THANKS TO Elifelet.
1036     * UPDATE translation: Canadian French (fr_CA)
1037             THANKS TO yahoe.001.
1038     * UPDATE translation: French (fr)
1039             THANKS TO fayçal fatihi, Frisson Reynald, hpatte, Lunar,
1040             Onizuka, themen, Towinet, and Yannick Heintz.
1041     * UPDATE translation: Finish (fi)
1042             THANKS TO viljaminojonen, and Finland355.
1043     * UPDATE translation: Farsi (fa)
1044             THANKS TO Mohammad Hossein.
1045     * UPDATE translation: Spanish - Chile (es_CL)
1046             THANKS TO Pablo Lezaeta.
1047     * UPDATE translation: Spanish (es)
1048             THANKS TO Paola Falcon.
1049     * UPDATE translation: British English (en_GB)
1050             THANKS TO richardshaylor.
1051     * UPDATE translation: Greek (el)
1052             THANKS TO Adrian Pappas, andromeas, isv31, and Wasilis
1053             Mandratzis.
1054     * UPDATE translation: German (de)
1055             THANKS TO Tobias Bannert.
1056     * UPDATE translation: Danish (da)
1057             THANKS TO autofunk78.
1058     * UPDATE translation: Arabic (ar)
1059             THANKS TO Ahmad Gharbeia, Mohamed El-Feky, AnonymousLady,
1060             0xidz, Sherief Alaa , and محيي الدين.
1061
1062 Changes in version 0.2.2 - 2014-06-06
1063
1064     * FIXES #9874 https://bugs.torproject.org/9874
1065     BridgeDB's email and HTTPS distributors were written in a manner that makes
1066     them largely impossible to write unittests for. Since the recent rewrite of
1067     BridgeDB's email distributor server backends for version 0.2.1, BridgeDB
1068     email distributor is now testable and has near 100% code coverage, see
1069     https://coveralls.io/r/isislovecruft/bridgedb
1070
1071     * FIXES #12086 https://bugs.torproject.org/12086
1072     BridgeDB was found to accept incoming emails sent to any email address whose
1073     local part included the word bridges, e.g. emails sent to
1074     'givemebridges@serious.ly' would be responded to as if they were destined
1075     for BridgeDB's real email address.
1076       - BridgeDB now strictly checks that the local part of the email address
1077         that an incoming email was sent to (after removing plus aliases, i.e.
1078         '+es_ES', '+fa', etc.) exactly matches BridgeDB configured email address
1079         username.
1080       - BridgeDB now checks that the domain name portion of the email address
1081         that an incoming email was sent to either matches the domain name
1082         portion of BridgeDB's configured email address, or is a subdomain of
1083         that domain.
1084
1085     * FIXES #12089 https://bugs.torproject.org/12089
1086     There has been a bug for quite some time now where BridgeDB could be used to
1087     email arbitrary email addresses (as long as these addresses were ones which
1088     BridgeDB allows, i.e. Gmail or Yahoo email addresses). This was due to
1089     BridgeDB not checking that the email address used in the SMTP 'MAIL FROM:'
1090     command on an incoming message matched the one used in that email's 'From:'
1091     header.
1092       - BridgeDB now checks that the email addresses in the SMTP 'MAIL FROM:'
1093         and the 'From:' header on that incoming email match, in addition to the
1094         previous checks that the email address' domain is in the set of allowed
1095         domains.
1096
1097     * FIXES #12090 https://bugs.torproject.org/12090
1098     BridgeDB has been replying with an empty email. I don't actually know for
1099     sure if this one is fixed. Before deploying version 0.2.1, the continuous
1100     integration tests showed email responses being correctly generated, and I
1101     was also able to receive correctly formed email responses from BridgeDB on a
1102     local testing instance on my laptop. It appears that this bug occurs only on
1103     the deployment server at ponticum.torproject.org, possibly due to the
1104     outdated Python version in Debian Wheezy. I have not been able to reproduce
1105     this bug on any other machine.
1106
1107     * FIXES #12091 https://bugs.torproject.org/12091
1108     BridgeDB wasn't properly ignoring emails whose DKIM signature verification
1109     header read "X-DKIM-Authentication-Results: dunno".
1110       - Bridgedb now marks incoming emails which have a
1111         "X-DKIM-Authentication-Results: dunno" header as invalid and ignores
1112         them.
1113
1114     * FIXES #12147 https://bugs.torproject.org/12147
1115     If a user refreshed https://bridges.torproject.org/bridges after
1116     successfully solving a CAPTCHA, BridgeDB would reply with a new set of
1117     bridges for each page refresh. This was due to the use of `getInterval()` in
1118     `IPBasedDistributor.getBridgesForIP()`.  The correct function to use is
1119     `getIntervalStart()`.  This had been noted in a "XXX FIXME" comment above
1120     the call for quite some time, however, when the `bridgedb.schedule`
1121     (previously called `bridgedb.Time`) module was revised to support CAPTCHA
1122     timeouts (#11215), the call to `getInterval()` was mistakenly not replaced
1123     with the correct function.
1124       - BridgeDB CAPTCHAs must be solved within 10 minutes.
1125       - Hashring rotation for bridges in BridgeDB HTTPS distributor occurs every
1126         3 hours. Refreshing the page with bridges on it will return these same
1127         bridges for that time period, and afterwards redirect back to the
1128         CAPTCHA page.  THANKS TO francisco on IRC and arma for reporting the
1129         bug.
1130
1131     * FIXES #12212 https://bugs.torproject.org/12122
1132     TRANSLATOR comments are now properly extracted into the gettext PO template
1133     file.
1134
1135 And include the following general changes:
1136     * FIXES an issue where, when verifying GnuPG signatures made by
1137     BridgeDB's email distributor, GnuPG would error, saying, "invalid armor
1138     header".
1139
1140     * ADD Korean (ko) translations.
1141       Thanks to ilbe123, cwt96, Dr.what, and pCsOrI.
1142
1143     * UPDATE Ukranian (uk) translations.
1144       Thanks to LinuxChata and ghostishev.
1145
1146     * UPDATE Turkish (tr) translations.
1147       Thanks to volkangezer.
1148
1149     * UPDATE Brazilian Portuguese (pt_BR) translations.
1150       Thanks to Communia, Humberto Sartini, Anastasia01, and recognitium.
1151
1152     * UPDATE Polish (pl) translations.
1153       Thanks to hoek, yodaa, maxxx, and sebx.
1154
1155     * UPDATE Dutch (nl) translations.
1156       Thanks to Ann Boen, erwindelaat, guryman, and BBLN.
1157       You guys are extra awesome for translating the phrase:
1158           "Uh oh, spaghettios!"
1159       into the Dutch:
1160           "Helaas pindakaas!"
1161       which, in English, literally means:
1162           "Unfortunately, peanut butter!"
1163       You guys totally just made my day. Thanks.
1164
1165     * UPDATE Japanese (ja) translations.
1166       Thanks to plazmism, who is extra awesome for translating the phrase:
1167           "Uh oh, spaghettios!"
1168       into the Japanese:
1169           "おっとスパゲッティ！"
1170       which apparently the literal English translation is:
1171           "Husband spaghetti!"
1172
1173     * UPDATE Italian (it) translations.
1174       Thanks to Random_R.
1175
1176     * UPDATE Canadian French (fr_CA) translations.
1177       Thanks to Lunar.
1178
1179     * UPDATE Spanish (es) translations.
1180       Thanks to dark_yoshi and strel.
1181
1182     * UPDATE Greek (el) translations.
1183       Thanks to pappasadrian.
1184
1185     * UPDATE German (de) translations.
1186       Thanks to trantor and unknwon_anonymous.
1187
1188     * UPDATE Danish (da) translations.
1189       Thanks to autofunk78 and DavidNielsen.
1190
1191 Changes in version 0.2.1 - 2014-05-16
1192     * FIXES #5463 https://bugs.torproject.org/5463
1193     Emails sent from BridgeDB's email distributor should now be signed.
1194       - BridgeDB's emails will be signed with its online GnuPG keypair. The
1195         public key has the following fingerprint:
1196             DF81 1109 E17C 8BF1 34B5  EEB6 8DC4 3A28 4882 1E32
1197         The online keypair rotates (a new one is placed on the server once per
1198         year), and it will ALWAYS be signed with BridgeDB's offline keypair.
1199       - The online keypair above contains two subkeys. The signing subkey has
1200         the fingerprint:
1201             9FE3 9D1A 7438 9223 3B3F  66F2 21B5 54E9 5938 F4D0
1202       - BridgeDB's offline keypair has the following fingerprint:
1203             7B78 4370 15E6 3DF4 7BB1  270A CBD9 7AA2 4E8E 472E
1204     All of BridgeDB's keys may be found on the public keyservers, as well as at
1205     https://bridges.torproject.org/keys
1206
1207     * FIXES #7547 https://bugs.torproject.org/7547
1208     BridgeDB's email distributor will now send you a message explaining how to
1209     use it, including valid commands and the list of Pluggable Transport TYPES
1210     currently supported. To receive help with the email distributor, simply send
1211     an email to mailto:bridges@torproject.org.
1212       - Any emails which do not contain a valid command will receive the help
1213         text in response.
1214       - Otherwise, to specifically request the help text, just say "get help" in
1215         the body of your email.
1216
1217     * FIXES #7550 https://bugs.torproject.org/7550
1218     BridgeDB's email responder is now interactive, as described in the above
1219     entry for ticket #7547.
1220
1221     * FIXES #8241 https://bugs.torproject.org/8241
1222     BridgeDB's HTTP distributor won't tell you how to get obfs3 bridges through
1223     email, although a blank email, or an email containing "get help" will.
1224
1225     * CLOSES #9678 https://bugs.torproject.org/9678
1226     A "Select Language" button was requested for the HTTP distributor on
1227     https://bridges.torproject.org. Instead, translated pages are distributed
1228     automatically (via detecting the "Accept-Language" header which can be set
1229     in the Settings panel of all modern browers).
1230       - To request a specific translation, the "lang=LOCALE" argument can be
1231         added to the URL of any page. For example:
1232         https://bridges.torproject.org/options?lang=ar will provide the bridge
1233         options selection page in Arabic.
1234
1235     * FIXES #11215 https://bugs.torproject.org/11215
1236     BridgeDB's usage of gimp-captcha, which creates a local cache of CAPTCHA for
1237     use on the HTTP distributor, now supports timeouts. If a CAPTCHA is not
1238     solved within 30 minutes of being served to a client, the solution is
1239     invalid regardless of its correctness.
1240
1241     * FIXES #11475 https://bugs.torproject.org/11475
1242     BridgeDB's email responder, up until this point, explained how to use
1243     bridges with Vidalia. It now uses the same help text as found at
1244     https://bridges.torproject.org/howto which explains how to enter bridges
1245     into TorLauncher (used by Tor Browser and Tails).
1246
1247     * FIXES #11522 https://bugs.torproject.org/11522
1248     There were several errors and bugs in BridgeDB's email distributor. The
1249     entire system of server supporting BridgeDB's email distribution system was
1250     rewritten.
1251
1252     * FIXES #11664 https://bugs.torproject.org/11664
1253     Due to changes in the Python language builtin `buffer` in Python3, which
1254     were backported to Python 2.7.6, but neither backported to Python 2.6.x nor
1255     to Python <= 2.7.5, BridgeDB's use of `io.StringIO` and `io.BytesIO`
1256     combined with buffers had to be revised to support both the new and old
1257     Python `buffer` APIs.
1258
1259     * FIXES #11753 https://bugs.torproject.org/11753
1260     BridgeDB's emails should now be translated.
1261       - The translations system for BridgeDB, as well as the template system for
1262         emails, was completely rewritten.  By default, email responses are in
1263         English. To receive an alternate translation, send an email to
1264         bridges+LOCALE@torproject.org, where "LOCALE" is a locale specifier.
1265       - For example, to receive BridgeDB emails translated into Chinese, use
1266         mailto:bridges+zh_CN@torproject.org.
1267       - Or for Farsi translations, use mailto:bridges+fa@torproject.org.
1268       - For the full list of currently supported LOCALE codes, see
1269         https://gitweb.torproject.org/user/isis/bridgedb.git/tree/HEAD:/lib/bridgedb/i18n/
1270
1271 And includes the following general changes:
1272     * UPDATES the Italian (it) gettext file.
1273       Thanks to Francesca Ciceri.
1274     * ADD Welsh (cy) translations.
1275       Thanks to huwwaters and littlegreykida.
1276     * ADD Slovak (sk) translations.
1277       Thanks to Michelozzo and Svistwarrior273.
1278     * UPDATES the bridgedb.pot translation template file. All the new
1279     strings in the email and HTTP user interfaces will now need
1280     translation! To help out with translations, please see:
1281     https://www.transifex.com/projects/p/torproject/resource/2-bridgedb-bridgedb-pot/
1282     * FIXES several typos in the BridgeDB's code documentation.
1283     * ADDS code documentation for several previously undocumented modules.
1284
1285 Changes in version 0.2.0 - 2014-04-19
1286     * FIXES #5232 Perform long running and blocking transactions in
1287             background threads. Primarily this moves bridge descriptor reparsing
1288             into another thread, which significantly increases the availability
1289             of BridgeDB.
1290     * FIXES #9119 BridgeDB's logger now automatically sanitises all email
1291             and IP addresses when the SAFELOGGING config option is enabled.
1292     * FIXES #9875 BridgeDB logger now has 100% unittest coverage.  FIXES #10803
1293     * Vidalia is no longer mentioned on
1294             https://bridges.torproject.org, and instead there are new
1295             instructions on how to enter bridges into TBB>=3.5 (with
1296             TorLauncher).
1297     * FIXES #11346 The web interface now has a homepage link. By clicking
1298             "BridgeDB" in the upper left corner, users can go back to the start
1299             of TBB downloading and bridge selection instructions at
1300             https://bridges.torproject.org.
1301     * FIXES #11370 We were using an old (and deprecated) module when we
1302             created our email responses. Now we use the newer version.
1303     * FIXES #11377 CAPTCHAs on BridgeDB's HTTPS interface are now
1304             case-insensitive.  Thanks to Kostas Jakeliunas for the patch.
1305     * FIXES #11522 fixes several issues with encodings and exception
1306             handling in the email distributor.
1307
1308 And includes the following general changes:
1309     * NEW interface design for https://bridges.torproject.org, including
1310             updated CSS stylesheets, fonts, and HTML templates. In particular,
1311             the https://bridges.torproject.org/options page has been redesigned
1312             completely.  Thanks to Xengi for providing a modified design of the
1313             "roots" Tor Project logo, which is used to link to
1314             https://www.torproject.org.
1315     * CHANGES the TBB download link on the main web interface page to link
1316             to the new TBB-3.6.x-beta bundles, which include patches by David
1317             Fifield to unify TBB and PTTBB into one browser, so that Pluggable
1318             Transports (PTs) are only enabled when the user includes a bridge
1319             line which uses that PT.
1320     * FIXES plaintext responses on https://bridges.torproject.org,
1321             these can be requested by using the 'format' HTTP parameter, like
1322             so: https://bridges.torproject.org/bridges?format=plain
1323     * FIXES the logging of all lines of (including headers!) of incoming
1324             emails.
1325     * FIXES logfile rotation so that the files are only reable/writable
1326             by the running process owner, and no other user.
1327     * CHANGES the data format used for encrypted-then-HMACed CAPTCHAs
1328             to assume that the HMAC is the first 20 bytes. Before we assumed
1329             that the HMAC was separated from the encrypted data with a ';'
1330             character, which causes intermittent issues with some encoding and
1331             CAPTCHA solution values.
1332     * REFACTORS some of the translations handling code, so that soon emails
1333             will be translated (see #7550), and https://bridges.torproject.org
1334             should have a "Select Language" button (see #9678).
1335     * BUMPS leekspin version to 0.1.3.
1336
1337 Changes in version 0.1.6 - 2014-03-26
1338 BridgeDB 0.1.6 includes fixes for the following bugs:
1339     * FIXES #11196 BridgeDB should use leekspin
1340     * FIXES #11218 ReCaptchaProtectedResource.checkSolution()
1341             doesn't expect a deferred
1342     * FIXES #11219 BridgeDB's twisted version doesn´t have a
1343             `t.w.client.HTTPConnectionPool` class
1344     * FIXES #11231 BridgeDB's txrecaptcha returns the "No bridges
1345             available!" page if 'captcha_response_field' is blank
1346
1347 And includes the following general changes:
1348     * ADDS several new translations languages.
1349
1350 Changes in version 0.1.5 - 2014-02-27
1351 BridgeDB 0.1.5 includes fixes for the following bugs:
1352     * FIXES #9264 Problem with transport lines in BridgeDB's bridge
1353             pool assignment files
1354     * FIXES #10809 reCAPTCHA on bridges.torproject.org are impossible
1355             to solve for humans
1356     * FIXES #10834 Configurable reCAPTCHA remoteip
1357     * FIXES #11127 reCaptcha verification is hardcoded to use
1358             plaintext HTTP
1359
1360 And includes the following general changes:
1361     * CHANGES the way the client's IP address is reported to the
1362     reCaptcha API server. Previously, for each client request, a completely
1363     random IP address was generated, and BridgeDB lied to the reCaptcha server
1364     by sending this random IP and saying that it was the client's IP. With these
1365     changes, BridgeDB can be configured to report a static IP address (it's own
1366     IP) as the client's IP, in the hopes that the IP whitelisting used by
1367     reCaptcha makes the returned CAPTCHAs less impossible to solve.
1368     * ADDS the ability to use a local cache of CAPTCHAs created by
1369     scripting Gimp with Python. See:
1370     https://github.com/isislovecruft/gimp-captcha
1371     * USES TLS during CAPTCHA solution verification when using
1372     reCaptcha.
1373
1374 Changes in version 0.1.4 - 2014-02-21
1375 BridgeDB 0.1.4 includes fixes for the following bugs:
1376     * FIXES an RTL encoding issue in the "Step 2" text on index.html
1377             of the HTTPS distributor.
1378
1379 Changes in version 0.1.3 - 2014-02-21
1380 BridgeDB 0.1.3 includes fixes for the following bugs:
1381     * FIXES #9264 Problem with transport lines in BridgeDB's bridge
1382             pool assignment files
1383     * FIXES a bug caused by attempts to convert descriptor digests
1384             which could not be parsed into hexadecimal.
1385     * FIXES a unicode decoding error within the bridgedb.persistent
1386             module.
1387     * REMOVES continuous integration testing for Python 2.6.
1388
1389 Including the following general changes:
1390     * ADD volunteer page text for GSoC 2014 applications.
1391
1392 Changes in version 0.1.2 - 2014-02-05
1393 BridgeDB 0.1.2 includes fixes for the following bugs:
1394     * FIXES #10811 BridgeDB's assignments.log files are not being updated
1395
1396 Changes in version 0.1.1 - 2014-02-03
1397 BridgeDB 0.1.1 includes fixes for the following bugs:
1398     * FIXES #9127 Users can't ask for ipv6 bridges with the new bridgedb
1399             interface
1400     * FIXES #9988 Refactor BridgeDB's use of `sha` module to use `hashlib`
1401     * FIXES #10724 Most of the time spent in testing, as well as most
1402             of the time spent when "BridgeDB is down" (i.e. when I reply
1403             with "BridgeDB is single-threaded (see #5232) and is parsing
1404             millions of descriptors"), is within the same
1405             `bridgedb.Stability.addOrUpdateBridgeHistory()` function (see
1406             #10724). This function is pretty brutal on CPU and memory, is
1407             blocking, and it needs to runs thousands and thousands of
1408             times whenever BridgeDB is restarted (every half hour). The
1409             algorithm within that function has a time complexity increasing
1410             linearithmically relative to the number of bridges and timestamps
1411             already within the database. [0]
1412             This patch adds a config option to disable/enable running
1413             the `addOrUpdateBridgeHistory()` function.
1414             [0]: https://en.wikipedia.org/wiki/Time_complexity#Linearithmic_time
1415     * FIXES #10737 POST arguments to bridges.torproject.org are dropped if
1416             entering a CAPTCHA fails
1417
1418 Including the following general changes:
1419     * ADDS A general simple error page to display rather than
1420             webserver tracebacks. See #6127.
1421     * MOVES The recently added BridgeDB specification file
1422             ('doc/bridge-db-spec.txt') to the torspec repo:
1423             https://gitweb.torproject.org/torspec.git
1424     * FIXES template caching for the web interface.
1425
1426 Changes in version 0.1.0 - 2014-01-14
1427 BridgeDB 0.1.0 includes fixes for the following bugs:
1428     * FIXES #1606 Write a BridgeDB spec
1429     * FIXES #3573 bridges.torproject.org doesn't have a robots.txt
1430     * FIXES #6127 bridges.tpo runs in development mode
1431     * FIXES #9013 BridgeDB should pass pluggable transport
1432             shared-secrets to clients
1433     * FIXES #9157 Persian and Arabic should be right aligned on bridges.tpo
1434     * FIXES #9462 BridgeDB netstatus descriptor parsers need refactoring
1435     * FIXES #9959 BridgeDB seems to be missing English translations
1436     * FIXES #9865 Add automated code coverage report generation
1437     * FIXES #9872 Create a test runner for BridgeDB unittests
1438     * FIXES #9873 Convert BridgeDB's old unittests to use twisted.trial
1439     * FIXES #9937 Create fake non-sanitised bridge descriptors for
1440             BridgeDB testing purposes
1441     * FIXES #10333 Indexing list-like objects by 0L in
1442             Bridges.getConfigLine
1443     * FIXES #10446 BridgeDB is/was using a GeoIP module which is
1444             incompatible with virtualenvs
1445     * FIXES #10559 BridgeDB writes `keyid=` before fingerprints
1446
1447 Including the following general changes:
1448     * ADD Numerous unittests and automated continuous integration testing.
1449     * ADD Patches by sysrqb to correctly render right-to-left languages.
1450     * FIXES fallback languages for translations.
1451     * ADD Sphinx makefiles, substantial amounts of documentation.
1452     * ADD Documentations builds (currently at
1453           https://para.noid.cat/bridgedb)
1454
1455 Changes in version 0.0.1 - 2013-08-20
1456 BridgeDB 0.0.1 includes fixes for the following bugs:
1457     * FIXES #5332 Update BridgeDB documentation with deployment
1458             instructions
1459     * FIXES #9156 BridgeDB: Users try to add obfsbridges to their
1460             normal TBB
1461     These commits were added to fix a compatibility issue with
1462     Vidalia, though they may be reverted to switch back to the old
1463     behaviour of returning bridge lines in the form:
1464       Bridge [transport_method] address:port [keyid=fingerprint] [K=v] […]
1465     in order to work with torrc files and the new TBB-3.x packages
1466     which use TorLauncher instead of Vidalia.
1467     * PARTIAL FIX #9264 Problem with transport lines in BridgeDB's
1468               bridge pool assignment files.
1469     * FIXES #9425 Create and document a better BridgeDB (re)deployment
1470             strategy
1471
1472 Including the following general changes:
1473     * UPDATE translations files with finished files from Transifex for
1474     the strings for the newly-refactored web interface created by
1475     gsathya.
1476     * ADD an automatic version-numbering system as part of developing
1477     a better deployment strategy.
1478     * CHANGE setup.py script to automatically install Python-based
1479     dependencies from requirements.txt.
1480     * REMOVE MANIFEST.in and put equivalent 'include' directives into
1481     setup.py (the less places we have for manually keeping track of
1482     files, the better).
1483     * REMOVE the "bridge " prefix from the lines returned on the web
1484     interface.