Merge pull request #3 from zopefoundation/2-deprecate-project

Deprecate project entirely.

.gitignore

@@ -11,3 +11,4 @@ dist/
 eggs/
 lib/
 parts/
+venv/

CHANGES.rst

@@ -0,0 +1,13 @@
+Changelog
+=========
+
+3.0.0 (unreleased)
+-------------------
+
+- Deprecate entire package:  ``os.initgroups`` is part of the standard
+  library as of Python 2.7.
+
+2.13.0 (2010-03-30)
+-------------------
+
+- Released as separate package.

README.rst

@@ -0,0 +1,10 @@
+Overview
+========
+
+.. warning::
+
+   This package is deprecated. ``os.initgroups`` is part of the standard
+   library as of Python 2.7.
+
+initgroups provides a convenience function to deal with user / group ids on
+Unix-style systems.

setup.py

@@ -12,26 +12,35 @@
 #
 ##############################################################################
 
-from os.path import join
-from setuptools import setup, find_packages, Extension
+from setuptools import setup
+from setuptools import find_packages
+
+with open('README.rst') as f:
+    README = f.read()
+
+with open('CHANGES.rst') as f:
+    CHANGES = f.read()
 
 setup(name='initgroups',
-      version = '2.14.0.dev0',
-      url='http://pypi.python.org/pypi/initgroups',
+      version = '3.0.dev0',
+      url='https://github.com/zopefoundation/initgroups',
       license='ZPL 2.1',
       description="Convenience uid/gid helper function used in Zope2.",
       author='Zope Corporation and Contributors',
       author_email='zope-dev@zope.org',
-      long_description=open('README.txt').read() + '\n' +
-                       open('CHANGES.txt').read(),
-
+      long_description=README + '\n' + CHANGES,
+      classifiers=[
+        "Development Status :: 7 - Inactive",
+        "Framework :: Zope2",
+        "License :: OSI Approved :: Zope Public License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: Implementation :: CPython",
+      ],
       packages=find_packages('src'),
       package_dir={'': 'src'},
-      ext_modules=[Extension(
-            name='initgroups._initgroups',
-            sources=[join('src', 'initgroups', '_initgroups.c')],
-            ),
-      ],
       include_package_data=True,
-      zip_safe=False,
-      )
+      zip_safe=True,
+)

src/initgroups/__init__.py

@@ -12,4 +12,15 @@
 #
 ##############################################################################
 
-from _initgroups import initgroups
+import os
+import warnings
+
+
+_MESSAGE =(
+    "The standalone 'initgroups.initgroups' functinon is deprecated.  "
+    "Use 'os.initgroups' instead.")
+
+warnings.warn(_MESSAGE, DeprecationWarning)
+
+def initgroups(username, gid):
+    return os.initgroups(username, gid)