From 48c149c16a9bb06591c2eb0be4cca729b7feac3e Mon Sep 17 00:00:00 2001 From: Sebastian Thiel Date: Sun, 11 Sep 2016 20:42:33 +0200 Subject: doc(limitations): be very clear about known issues Fixes #508 --- README.md | 23 ++++++++++++++--------- doc/source/intro.rst | 16 ++++++++++++++++ git/ext/gitdb | 2 +- 3 files changed, 31 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index ad2aa4fc..c999dcaa 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,20 @@ git submodule update --init --recursive ./init-tests-after-clone.sh ``` +### Limitations + +#### Leakage of System Resources + +GitPython is not suited for long-running processes (like daemons) as it tends to +leak system resources. It was written in a time where destructors (as implemented +in the `__del__` method) still ran deterministically. + +In case you still want to use it in such a context, you will want to search the +codebase for `__del__` implementations and call these yourself when you see fit. + +Another way assure proper cleanup of resources is to factor out GitPython into a +separate process which can be dropped periodically. + ### RUNNING TESTS *Important*: Right after cloning this repository, please be sure to have executed the `init-tests-after-clone.sh` script in the repository root. Otherwise you will encounter test failures. @@ -59,13 +73,6 @@ For more fine-grained control, you can use `nose`. Please have a look at the [contributions file][contributing]. -### Live Coding - -You can watch me fix issues or implement new features [live on Twitch][twitch-channel], or have a look at [past recordings on youtube][youtube-playlist] - -* [Live on Twitch][twitch-channel] (just follow the channel to be notified when a session starts) -* [Archive on Youtube][youtube-playlist] - ### INFRASTRUCTURE * [User Documentation](http://gitpython.readthedocs.org) @@ -104,6 +111,4 @@ Now that there seems to be a massive user base, this should be motivation enough * no open pull requests * no open issues describing bugs -[twitch-channel]: http://www.twitch.tv/byronimo/profile -[youtube-playlist]: https://www.youtube.com/playlist?list=PLMHbQxe1e9MnoEcLhn6Yhv5KAvpWkJbL0 [contributing]: https://github.com/gitpython-developers/GitPython/blob/master/README.md diff --git a/doc/source/intro.rst b/doc/source/intro.rst index 6c4e50f5..1c1b0d1b 100644 --- a/doc/source/intro.rst +++ b/doc/source/intro.rst @@ -59,6 +59,22 @@ script: .. note:: In this case, you have to manually install `GitDB`_ as well. It would be recommended to use the :ref:`git source repository ` in that case. +Limitations +=========== + +Leakage of System Resources +--------------------------- + +GitPython is not suited for long-running processes (like daemons) as it tends to +leak system resources. It was written in a time where destructors (as implemented +in the `__del__` method) still ran deterministically. + +In case you still want to use it in such a context, you will want to search the +codebase for `__del__` implementations and call these yourself when you see fit. + +Another way assure proper cleanup of resources is to factor out GitPython into a +separate process which can be dropped periodically. + Getting Started =============== diff --git a/git/ext/gitdb b/git/ext/gitdb index 2389b752..97035c64 160000 --- a/git/ext/gitdb +++ b/git/ext/gitdb @@ -1 +1 @@ -Subproject commit 2389b75280efb1a63e6ea578eae7f897fd4beb1b +Subproject commit 97035c64f429c229629c25becc54ae44dd95e49d -- cgit v1.2.1