tag: release dill.0.2.2

git-svn-id: svn+ssh://svn.mystic.cacr.caltech.edu/pathos/dill@724 8bfda07e-5b16-0410-ab1d-fd04ec2748df

MANIFEST

@@ -1,7 +1,10 @@
 LICENSE
+MANIFEST
 README
+README.md
 setup.cfg
 setup.py
+dill/__diff.py
 dill/__init__.py
 dill/_objects.py
 dill/detect.py
@@ -11,12 +14,19 @@ dill/objtypes.py
 dill/pointers.py
 dill/source.py
 dill/temp.py
+dill.egg-info/PKG-INFO
+dill.egg-info/SOURCES.txt
+dill.egg-info/dependency_links.txt
+dill.egg-info/not-zip-safe
+dill.egg-info/top_level.txt
 scripts/get_objgraph.py
 scripts/unpickle.py
 tests/dill_bugs.py
 tests/test_classdef.py
 tests/test_detect.py
+tests/test_diff.py
 tests/test_extendpickle.py
+tests/test_file.py
 tests/test_functors.py
 tests/test_mixins.py
 tests/test_module.py

README.md

@@ -26,11 +26,11 @@ secure against erroneously or maliciously constructed data. It is
 left to the user to decide whether the data they unpickle is from
 a trustworthy source.
 
-Dill is part of pathos, a python framework for heterogenous computing.
-Dill is in the early development stages, and any user feedback is
-highly appreciated. Contact Mike McKerns [mmckerns at caltech dot edu] with
-comments, suggestions, and any bugs you may find. A list of known issues
-is maintained at http://trac.mystic.cacr.caltech.edu/project/pathos/query.
+Dill is part of pathos, a python framework for heterogeneous computing.
+Dill is in active development, so any user feedback, bug reports, comments,
+or suggestions are highly appreciated.  A list of known issues is maintained
+at http://trac.mystic.cacr.caltech.edu/project/pathos/query, with a public
+ticket list at https://github.com/uqfoundation/dill/issues.
 
 
 Major Features
@@ -61,21 +61,49 @@ Dill also provides the capability to::
 * save and extract the source code from functions and classes
 * interactively diagnose pickling errors
 
+
 Current Release
 ---------------
-The latest released version of dill is available from::
-    http://dev.danse.us/trac/pathos
+The latest stable release of dill is available from::
+    http://trac.mystic.cacr.caltech.edu/project/pathos
+
+or::
+    https://github.com/uqfoundation/dill/releases
+
+or also::
+    https://pypi.python.org/pypi/dill
 
 Dill is distributed under a 3-clause BSD license.
 
-Development Release
--------------------
-You can get the latest development release with all the shiny new features at::
-    http://dev.danse.us/packages.
 
-or even better, fork us on our github mirror of the svn trunk::
+Development Version
+-------------------
+You can get the latest development version with all the shiny new features at::
     https://github.com/uqfoundation
 
+Feel free to fork the github mirror of our svn trunk.  If you have a new
+contribution, please submit a pull request.
+
+
+More Information
+----------------
+Probably the best way to get started is to look at the tests that are
+provide within dill. See `dill.tests` for a set of scripts that demonstrate
+dill's ability to serialize different python objects.  Since dill conforms
+to the 'pickle' interface, the examples and documentation at
+http://docs.python.org/library/pickle.html also apply to dill if one will
+`import dill as pickle`. The source code is also generally well documented,
+so further questions may be resolved by inspecting the code itself. Please
+also feel free to submit a ticket on github, or ask a question on
+stackoverflow (@Mike McKerns).
+
+Dill is an active research tool. There are a growing number of publications
+and presentations that discuss real-world examples and new features of dill
+in greater detail than presented in the user's guide.  If you would like to
+share how you use dill in your work, please post a link or send an email
+(to mmckerns at caltech dot edu).
+
+
 Citation
 --------
 If you use dill to do research that leads to publication, we ask that you
@@ -90,18 +118,6 @@ acknowledge use of dill by citing the following in your publication::
     "pathos: a framework for heterogeneous computing", 2010- ;
     http://dev.danse.us/trac/pathos
 
-More Information
-----------------
-Probably the best way to get started is to look at the tests
-that are provide within dill. See `dill.tests` for a set of scripts
-that test dill's ability to serialize different python objects.
-Since dill conforms to the 'pickle' interface, the examples and
-documentation at http://docs.python.org/library/pickle.html also
-apply to dill if one will `import dill as pickle`. Dill's source code is also generally well documented,
-so further questions may be resolved by inspecting the code itself, or through 
-browsing the reference manual. For those who like to leap before
-they look, you can jump right to the installation instructions. If the aforementioned documents do not adequately address your needs, please send us feedback.
-
-Dill is an active research tool. There are a growing number of publications and presentations that
-discuss real-world examples and new features of dill in greater detail than presented in the user's guide. 
-If you would like to share how you use dill in your work, please send us a link.
+Please see http://trac.mystic.cacr.caltech.edu/project/pathos or
+http://arxiv.org/pdf/1202.1056 for further information.
+

setup.cfg

@@ -1,4 +1,4 @@
 [egg_info]
-tag_build = .dev
+#tag_build = .dev
 #tag_svn_revision = yes
 #tag_date = yes

setup.py

@@ -9,9 +9,9 @@
 import os
 
 # set version numbers
-stable_version = '0.2.1'
+stable_version = '0.2.2'
 target_version = '0.2.2'
-is_release = False
+is_release = True
 
 # check if easy_install is available
 try:
@@ -47,9 +47,12 @@
 
 # generate the readme text
 long_description = \
-"""---------------------------------------------------
-dill: a utility for serialization of python objects
----------------------------------------------------
+"""-----------------------------
+dill: serialize all of python
+-----------------------------
+
+About Dill
+==========
 
 Dill extends python's 'pickle' module for serializing and de-serializing
 python objects to the majority of the built-in python types. Serialization
@@ -74,10 +77,10 @@
 a trustworthy source.
 
 Dill is part of pathos, a python framework for heterogeneous computing.
-Dill is in the early development stages, and any user feedback is
-highly appreciated. Contact Mike McKerns [mmckerns at caltech dot edu] with
-comments, suggestions, and any bugs you may find.  A list of known issues
-is maintained at http://trac.mystic.cacr.caltech.edu/project/pathos/query.
+Dill is in active development, so any user feedback, bug reports, comments,
+or suggestions are highly appreciated.  A list of known issues is maintained
+at http://trac.mystic.cacr.caltech.edu/project/pathos/query, with a public
+ticket list at https://github.com/uqfoundation/dill/issues.
 
 
 Major Features
@@ -113,25 +116,36 @@
 Current Release
 ===============
 
-This release version is dill-%(relver)s. You can download it here.
-The latest released version of dill is always available from::
+This version is dill-%(relver)s.
 
-    http://dev.danse.us/trac/pathos
+The latest stable version of dill is available from::
 
-Dill is distributed under a 3-clause BSD license.
+    http://trac.mystic.cacr.caltech.edu/project/pathos
 
+or::
 
-Development Release
-===================
+    https://github.com/uqfoundation/dill/releases
 
-You can get the latest development release with all the shiny new features at::
+or also::
 
-    http://dev.danse.us/packages
+    https://pypi.python.org/pypi/dill
 
-or even better, fork us on our github mirror of the svn trunk::
+Dill is distributed under a 3-clause BSD license.
+
+    >>> import dill
+    >>> print (dill.license())
+
+
+Development Version 
+===================
+
+You can get the latest development version with all the shiny new features at::
 
     https://github.com/uqfoundation
 
+Feel free to fork the github mirror of our svn trunk.  If you have a new
+contribution, please submit a pull request.
+
 
 Installation
 ============
@@ -148,10 +162,9 @@
 You will be warned of any missing dependencies and/or settings
 after you run the "build" step above. 
 
-Alternately, dill can be installed with easy_install or pip::
+Alternately, dill can be installed with pip or easy_install::
 
-    [download]
-    $ easy_install -f . dill
+    $ pip install dill
 
 
 Requirements
@@ -167,32 +180,31 @@
     - objgraph, version >= 1.7.2
 
 
-Usage Notes
-===========
-
-Probably the best way to get started is to look at the tests
-that are provide within dill. See `dill.tests` for a set of scripts
-that test dill's ability to serialize different python objects.
-Since dill conforms to the 'pickle' interface, the examples and
-documentation at http://docs.python.org/library/pickle.html also
-apply to dill if one will `import dill as pickle`.
-
-
-License
-=======
+More Information
+================
 
-Dill is distributed under a 3-clause BSD license.
+Probably the best way to get started is to look at the tests that are
+provided within dill. See `dill.tests` for a set of scripts that demonstrate
+dill's ability to serialize different python objects.  Since dill conforms
+to the 'pickle' interface, the examples and documentation at
+http://docs.python.org/library/pickle.html also apply to dill if one will
+`import dill as pickle`. The source code is also generally well
+documented, so further questions may be resolved by inspecting the code
+itself.  Please also feel free to submit a ticket on github, or ask a
+question on stackoverflow (@Mike McKerns).
 
-    >>> import dill
-    >>> print (dill.license())
+Dill is an active research tool. There are a growing number of publications
+and presentations that discuss real-world examples and new features of dill
+in greater detail than presented in the user's guide.  If you would like to
+share how you use dill in your work, please post a link or send an email
+(to mmckerns at caltech dot edu).
 
 
 Citation
 ========
 
-If you use dill to do research that leads to publication,
-we ask that you acknowledge use of dill by citing the
-following in your publication::
+If you use dill to do research that leads to publication, we ask that you
+acknowledge use of dill by citing the following in your publication::
 
     M.M. McKerns, L. Strand, T. Sullivan, A. Fang, M.A.G. Aivazis,
     "Building a framework for predictive science", Proceedings of
@@ -201,13 +213,10 @@
 
     Michael McKerns and Michael Aivazis,
     "pathos: a framework for heterogeneous computing", 2010- ;
-    http://dev.danse.us/trac/pathos
-
-
-More Information
-================
+    http://trac.mystic.cacr.caltech.edu/project/pathos
 
-Please see http://dev.danse.us/trac/pathos or http://arxiv.org/pdf/1202.1056 for further information.
+Please see http://trac.mystic.cacr.caltech.edu/project/pathos or
+http://arxiv.org/pdf/1202.1056 for further information.
 
 """ % {'relver' : stable_version, 'thisver' : this_version}