diff --git a/packaging.html b/packaging.html index c309066..80dffca 100644 --- a/packaging.html +++ b/packaging.html @@ -123,7 +123,7 @@ This version requires Python 3 or later; a Python 2 version is available separat

The chardet directory looks slightly different. In addition to the README.txt file, it has HTML-formatted documentation in the docs/ directory. The docs/ directory contains several .html files and an images/ subdirectory, which contains several .png and .gif files. (This will be important later.) Also, in keeping with the convention for (L)GPL-licensed software, it has a separate file called COPYING which contains the complete text of the LGPL. -

+

 chardet/
 |
 +--COPYING
@@ -214,7 +214,7 @@ setup(
 

You should always include at least these four classifiers:

    -
  • Programming Language. In particular, you should include both "Programming Language :: Python" and "Programming Language :: Python :: 3". If you do not include these, your package will not show up in this list of Python 3-compatible libraries, which linked from the sidebar of every single page of pypi.python.org. +
  • Programming Language. In particular, you should include both "Programming Language :: Python" and "Programming Language :: Python :: 3". If you do not include these, your package will not show up in this list of Python 3-compatible libraries, which linked from the sidebar of every single page of pypi.python.org.
  • License. This is the absolute first thing I look for when I’m evaluating third-party libraries. Don’t make me hunt for this vital information. Don’t include more than one license classifier unless your software is explicitly available under multiple licenses (and don’t release software under multiple licenses unless you’re forced to do so).
  • Operating System. If your software only runs on Windows (or Mac OS X, or Linux), I want to know sooner rather than later. If your software runs anywhere without any platform-specific code, use the classifier "Operating System :: OS Independent". Multiple Operating System classifiers are only necessary if your software requires specific support for each platform. (This is not common.)
@@ -294,7 +294,9 @@ warning: check: missing required meta-data: version

Creating Source Distributions

- +
+archive formats?
+
 FIXME need to redo this now that we have a MANIFEST.in file
@@ -339,9 +341,13 @@ removing 'chardet-1.0.2' (and everything under it)
 
 

Creating Binary Distributions

- +
+python3 setup.py bdist --help-formats
+
- +
+http://docs.python.org/3.1/distutils/builtdist.html#creating-windows-installers
+

Building A Windows Installer

@@ -377,7 +383,7 @@ adding 'PURELIB\chardet\__init__.py' removing 'build\bdist.win32\wininst' (and everything under it) c:\Users\pilgrim\chardet> dir dist - Volume in drive C has no label. + Volume in drive C has no label. Volume Serial Number is DED5-B4F8 Directory of c:\Users\pilgrim\chardet\dist @@ -388,8 +394,13 @@ removing 'build\bdist.win32\wininst' (and everything under it) 2 File(s) 546,603 bytes 2 Dir(s) 62,235,119,616 bytes free
- - +
+works on non-Windows (as long as the package is pure-Python)
+
+ +
+UAC?
+

Building a Linux RPM Package

@@ -403,14 +414,14 @@ removing 'build\bdist.win32\wininst' (and everything under it)

Uploading New Versions

- +