[Checkins] [zopefoundation/ZODB] ed3651: Documentation on transactions and threading.

GitHub noreply at github.com
Mon Sep 12 19:16:41 CEST 2016


  Branch: refs/heads/master
  Home:   https://github.com/zopefoundation/ZODB
  Commit: ed365135732ddcfaac68ba9605c47bee22ecddfe
      https://github.com/zopefoundation/ZODB/commit/ed365135732ddcfaac68ba9605c47bee22ecddfe
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-09 (Fri, 09 Sep 2016)

  Changed paths:
    M CHANGES.rst
    M doc/articles/old-guide/prog-zodb.rst
    M doc/guide/index.rst
    M doc/guide/install-and-run.rst
    A doc/guide/transactions-and-threading.rst
    M doc/reference/index.rst
    A doc/reference/transaction.rst
    M doc/reference/zodb.rst
    M src/ZODB/Connection.py
    M src/ZODB/tests/testdocumentation.py

  Log Message:
  -----------
  Documentation on transactions and threading.

This adds documentatuon on transactions and threading concerns.

There are some topics, like application design and conflict resolution
that might want a deeper treatment, but would probably be better
handled through articles or dedicated topics. (I want to avoid
individual topics being too long or weedy to read, where practical.)

Writing this, I stumbled a bit over thread-local transaction managers.
For most applications, they don't add anything over accessing
transaction managers on connections and actually provide an
opportunity to fail. I'm convinced that it should be possible to do
most transaction management through connections and that the API
provided by transaction managers and the transaction package should be
reserved for distributed transactions.

I didn't mention gevent. I thik there should be a section on gevent,
but I think it should be written by someone who's used gevent with
ZODB. :)

Maybe there should also be a section or mention of using asyncio with
ZODB, pr maybe later.

Closes zopefoundation/zodbdocs#13
Closes zopefoundation/zodbdocs#16


  Commit: 67388dcd9bab50051510e72c76b8ed29a8773a9c
      https://github.com/zopefoundation/ZODB/commit/67388dcd9bab50051510e72c76b8ed29a8773a9c
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-09 (Fri, 09 Sep 2016)

  Changed paths:
    M doc/guide/transactions-and-threading.rst
    M src/ZODB/tests/testdocumentation.py

  Log Message:
  -----------
  Deal with some Py2/Py3 differences :(


  Commit: 811403fcc956fa2bae6dfa4dfc00dc4be85e357b
      https://github.com/zopefoundation/ZODB/commit/811403fcc956fa2bae6dfa4dfc00dc4be85e357b
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-12 (Mon, 12 Sep 2016)

  Changed paths:
    M doc/reference/transaction.rst

  Log Message:
  -----------
  Note that the transaction package is used outside of ZODB


  Commit: 8f33e101e0a4da88ffe4f35cd3ad419c6b4024c5
      https://github.com/zopefoundation/ZODB/commit/8f33e101e0a4da88ffe4f35cd3ad419c6b4024c5
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-12 (Mon, 12 Sep 2016)

  Changed paths:
    M doc/guide/transactions-and-threading.rst

  Log Message:
  -----------
  Many changes based on excellent PR comments.

More changes to come.


  Commit: f5bf3ed7b387976096ec6006e58d812e10cefe6c
      https://github.com/zopefoundation/ZODB/commit/f5bf3ed7b387976096ec6006e58d812e10cefe6c
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-12 (Mon, 12 Sep 2016)

  Changed paths:
    M doc/guide/transactions-and-threading.rst

  Log Message:
  -----------
  Added section on retrying transactions on conflicts

And other editorial changes.


  Commit: b4ad9d5ad864e306c73301966fe6f1c929810c59
      https://github.com/zopefoundation/ZODB/commit/b4ad9d5ad864e306c73301966fe6f1c929810c59
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-12 (Mon, 12 Sep 2016)

  Changed paths:
    M CHANGES.rst
    M doc/reference/storages.rst
    M src/ZODB/Connection.py
    M src/ZODB/DB.py

  Log Message:
  -----------
  Merge remote-tracking branch 'origin/master' into transactions-and-threading

Conflicts:
	CHANGES.rst


  Commit: d19cb4135dab54d8e7e464fbfa30b24fe259bde7
      https://github.com/zopefoundation/ZODB/commit/d19cb4135dab54d8e7e464fbfa30b24fe259bde7
  Author: Jim Fulton <jim at zope.com>
  Date:   2016-09-12 (Mon, 12 Sep 2016)

  Changed paths:
    M doc/guide/transactions-and-threading.rst

  Log Message:
  -----------
  more fixes based on review comments


  Commit: 7223554aebc81c7375b0501b668e93b5cd3ed4c0
      https://github.com/zopefoundation/ZODB/commit/7223554aebc81c7375b0501b668e93b5cd3ed4c0
  Author: Jim Fulton <jim at jimfulton.info>
  Date:   2016-09-12 (Mon, 12 Sep 2016)

  Changed paths:
    M CHANGES.rst
    M doc/articles/old-guide/prog-zodb.rst
    M doc/guide/index.rst
    M doc/guide/install-and-run.rst
    A doc/guide/transactions-and-threading.rst
    M doc/reference/index.rst
    A doc/reference/transaction.rst
    M doc/reference/zodb.rst
    M src/ZODB/Connection.py
    M src/ZODB/tests/testdocumentation.py

  Log Message:
  -----------
  Merge pull request #105 from zopefoundation/transactions-and-threading

Documentation on transactions and threading.


Compare: https://github.com/zopefoundation/ZODB/compare/09010439281f...7223554aebc8


More information about the checkins mailing list