#extends phd_pp_ru
#implements respond
#attr $Title = "Oleg Broytman's Python Software"
#attr $Description = "Broytman Python Software"
#attr $Copyright = 1994
##
#def body_html
<H1>Python Software</H1>

<p class="head">
   "The joy of coding Python should be in seeing short, concise, readable
classes that express a lot of action in a small amount of clear code --
not in reams of trivial code that bores the reader to death."  -- GvR
</p>

<p class="head">
   I am publishing here <A HREF="http://www.python.org/">Python</A>-related
software; mostly written by me. Unless otherwise noted, all software is
free for any use. Please, provide a reference to my name; don't blame me
for anything. Copyrighted by <A HREF="../../">Oleg Broytman</A> and
<A HREF="../">PhiloSoft Design</A>.
<p>
   Some pieces of software are not so free - they are protected by
<A HREF="http://www.gnu.org/copyleft/gpl.html">GNU GPL</A>.
</p>

<p class="head">
   All bits packed with
<A HREF="http://www.gnu.org/software/tar/tar.html">GNU tar</A>+
<A HREF="http://www.gnu.org/software/gzip/gzip.html">gz</A> or
<A HREF="http://www.bzip.org/">bz2</A>.
Install <A HREF="http://www.gnu.org/software/tar/tar.html">GNU tar</A> or at
least <A HREF="http://www.gnu.org/software/gzip/gzip.html">g(un)zip</A> to
extract files.
</p>

   There are the following <A HREF="\#libraries">Libraries</A>
here, awaiting you to download: <A HREF="\#m_lib">m_Lib</A>,
<A HREF="\#flad">flad</A>, <A HREF="\#pbar">pbar</A>.<BR>

   And <A HREF="\#programs">programs</A>: <A HREF="\#bookmarks_db">bookmarks_db</A>,
<A HREF="\#netscape_history">netscape-history</A>,
<A HREF="\#extract_mime">extract_mime</A>,
<A HREF="\#mimedecode">mimedecode</A>,
<A HREF="\#bdftogd">bdftogd</A>.<BR>

   Network-related libraries and programs ... not much yet:
<A HREF="socket-servers/">Python socket servers</A>.<BR>

   Some <A HREF="\#misc">miscellaneous</A> staff:
<A HREF="\#rgb_example">PyGreSQL example</A>,
<A HREF="\#py4dos">comparison of 3 Python-for-DOS interpreters</A>.
<br>
Kjbuckets module is no longer here. Finally it has found a permanent maintainer
and has been moved to <a href="http://gadfly.sourceforge.net/">gadfly.sf.net</a>.

<DL>
   <B>Legend:</B>

   <DT><B>Requires</B></DT>
   <DD>
      The piece of software would not work without other; download it
      as well. "<B>Requires:</B> nothing" means "requires only standard
      Python library", of course.
   </DD>

   <DT><B>Recommends</B></DT>
   <DD>
      Does not strictly require, but good to have it anyway.
   </DD>

   <DT><B>Suggests</B></DT>
   <DD>
      Even easier than "recommends".
   </DD>
</DL>

<A name="libraries"></A>
<H3>Libraries</H3>

<A name="m_lib"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2"><B>m_Lib</B> - Broytman's extensions for Python Library.
      (You can read <A HREF="../../why_phd.html">why</A> their names start with <I>m</I> :)
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="m_lib.tgz">m_lib.tgz</A></B><BR>
      <B>Requires:</B> nothing<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> nothing<BR>

      <DL>
         <B>Inside the archive:</B>

         <DT>opstring.py</DT>
         <DD>
            Some additional string handling/formatting functions.
         </DD>

         <DT>opdate.py</DT>
         <DD>
            Date/time manipulation functions. Not as object-oriented as
            <A HREF="http://starship.python.net/crew/lemburg/mxExtensions.html\#mxDateTime">mxDateTime</A>,
            but still convenient, powerful and useful.<BR>
            In this module Date is a number of days since 1/1/1600 (up to
            31 Dec 3999). I am not sure about how easy it might be to extend
            the modules beyond these bounds. Time is just a number of
            seconds since midnight. User can add/subtract dates and times,
            calculate diffs ("how many days, months and years passed since
            21 Dec 1967?") and so on. DateTime <==> UTC (GMT) conversion
            routines provided, too. This module required strptime.py for
            Russian month names.
         </DD>

         <DT>www_util.py</DT>
         <DD>
            Additional WWW-oriented functions that needs to be in standard
            module cgi but missing. Also base classes for all my HTML and
            XML parsers and filters.
         </DD>
      </DL>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <DT>m_shutil.py</DT>
         <DD>
            Few utilities useful in shell-like scripts - in addition to
            standard module shutil.
         </DD>

         <DT>flog.py</DT>
         <DD>Logging to file with custom logging formats.</DD>

         <DT>md5wrapper.py</DT>
         <DD>Small but convenient wrapper for md5 builtin module.</DD>

         <DT>mcrypt.py</DT>
         <DD>Defines a function gen_salt() for builtin module crypt.</DD>

         <DT>mkclock.py, tstclock.py</DT>
         <DD>
            mkclock.py will test your system and generate a module clock.py,
            which provides the only function, clock(), similar to
            time.clock() but its values always started with 0. On some
            systems time.clock() returns current time, so you need to
            remember when the program began and extract the value from
            current time(). clock() does this for you automatically!
            tstclock.py just test the generated module.
         </DD>

         <DT>tty_menu.py</DT>
         <DD>Simple tty menu.</DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="other_lib"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2"><B>other_Lib</B> - modules written by other
   people.</TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>License:</B> unknown<BR>
      <B>Download: <A HREF="other_lib.tgz">other_lib.tgz</A></B><BR>
      <B>Requires:</B> nothing<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> nothing<BR>

      <DL>
         <B>Inside the archive:</B>

         <DT>strptime.py</DT>
         <DD>
            This is rather old module that come before time.strptime()
            appeared in standard Python library (1.5.2). I extended it a
            bit and added Russian names for days, months, etc (both koi8-r
            and windows-1251 encodings).
         </DD>
      </DL>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <DT>html.py</DT>
         <DD>
            My version of
            <A HREF="http://starship.python.net/crew/neale/src/html.py">Neale Pickett's html.py</A> -
            object-oriented HTML generator.
         </DD>

         <DT>subproc.py</DT>
         <DD>
            My version of Ken Manheimer's subproc.py. It is now off the
            web, seems to be obsolete. There are other similar modules,
            look them up on <A HREF="http://www.vex.net/parnassus/">Parnasus</A>:
            <A HREF="http://www.vex.net/parnassus/apyllo.py/990075885">O/S Support</A>.
         </DD>

         <DT>timeoutsocket.py</DT>
         <DD>
            A copy of
            <A HREF="http://www.timo-tasi.org/python/timeoutsocket.py">timeoutsocket.py</A>.
         </DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2"><B>mCorrect</B> - Some patches I made for
      standard library. Now mostly obsolete.
      <A HREF="mcorrect.txt">Detailed description</A> available.
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="mcorrect.tgz">mcorrect.tgz</A></B><BR>
      <B>Requires:</B> nothing<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> nothing<BR>

      <DL>
         <B>Inside the archive:</B>

         <DT>tempfile.py, tempfile.diff</DT>
         <DD>
            DOS-related patches.
         </DD>
      </DL>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <DT>os.py, os.diff</DT>
         <DD>
            DJGPP-related patches.
         </DD>

         <DT>dospopen.py</DT>
         <DD>
            Low-level classes to help implement DOS version of popen().
            Actual implementation is in os.py.
         </DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="flad"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2"><B>FLAD</B> - Flat ASCII Database and
      configuration files modules.
      <A HREF="flad.txt">Detailed description</A> available.
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="flad.tgz">flad.tgz</A></B><BR>
      <B>Requires:</B> nothing<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> <A HREF="\#pbar">pbar</A> (for progress bars in examples)<BR>

      <DL>
         <B>Inside the archive:</B>

         <DT>lib/flad.py</DT>
         <DD>
            Root class. Simple Flat ASCII Database loading/storing.
         </DD>

         <DT>lib/fladm.py</DT>
         <DD>
            FLAD with "must-keys". You can define a set of keys that must
            be presented in every record. Moreover you can define "other keys"
            that do not required to be in every record.
         </DD>
      </DL>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <DT>lib/fladc.py</DT>
         <DD>
            Using FLAD to store/use configuration files.
         </DD>

         <DT>lib/fladw.py</DT>
         <DD>
            Using FLAD to store/use WINI.INI-like configuration files.
         </DD>

         <DT>test/test*.py</DT>
         <DD>
            Test programs and examples.
         </DD>

         <DT>test/test.txt, test/comment.txt, test/test.cfg</DT>
         <DD>
            Test files.
         </DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="pbar"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2"><B>pbar</B> - TTY progress bar.</TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="pbar.tgz">pbar.tgz</A></B><BR>
      <B>Requires:</B> nothing<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> nothing<BR>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <B>Inside the archive:</B>

         <DT>lib/tty_pbar.py</DT>
         <DD>
            Simple tty/console progress bar. Works on DOS/Windows/Unix
            consoles.
         </DD>

         <DT>test/*.py</DT>
         <DD>
            Test programs and examples.
         </DD>
      </DL>
   </TD>
</TR>
</TABLE>

<A name="programs"></A>
<H3>Programs</H3>

<A name="bookmarks_db"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2">
      <B>Bookmarks database and Internet robot</B> - a set of programs I
         use to manipulate my <A HREF="../../Bookmarks/">bookmarks</A>.
      <A HREF="bookmarks_db.txt">Detailed description</A> available.
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>License: GPL</B><BR>
      <B>Download: <A HREF="bookmarks_db-4.1.1.tar.gz">sources</A></B> and
         <A HREF="bookmarks_sh-4.1.1.tar.gz">example shell scripts</A></B><BR>
      <B>Requires:</B> <A HREF="\#m_lib">m_Lib</A>,
         <A HREF="\#other_lib">other_Lib</A>, <A HREF="\#flad">flad</A><BR>
      <B>Recommends:</B> <A HREF="\#pbar">pbar</A><BR>
      <B>Suggests:</B> nothing<BR>

      <DL>
         <B>Inside the archive:</B>

         <DT>bkmk_objects.py</DT>
         <DD>
            Low level objects (Bookmark, Folder, etc) and framework for
            managing bookmarks tree.
         </DD>

         <DT>bkmk_parser.py</DT>
         <DD>HTML parser, just it is.</DD>
      </DL>

      <DL>
         <B>Programs:</B>

         <DT>bkmk2db.py</DT>
         <DD>The program to convert bookmarks.html to a database.</DD>

         <DT>db2bkmk.py</DT>
         <DD>The program to convert the database back to bookmarks.html.</DD>
      </DL>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <DT>check_urls.py</DT>
         <DD>The program checks URLs in the DB by running a robot (plugin).</DD>

         <DT>convert_st.py</DT>
         <DD>The program converts the DB to a different format.</DD>

         <DT>sort_db.py</DT>
         <DD>The program sorts the DB by add_date, last_visit, last_modified
            or size.
         </DD>

         <DT>check_dups.py</DT>
         <DD>Prints a list of duplicate URLs in the database.
         </DD>
      </DL>

      <DL>
         <B>Plugins:</B>

         <DT>Storage</DT>
         <DD>Directory with storage managers (DB plugins).</DD>

         <DT>Writers</DT>
         <DD>Directory with writers (data dumpers) plugins.</DD>

         <DT>Robots</DT>
         <DD>Directory with robots (URL checkers) plugins</DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="netscape_history"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2">
      <B>Netscape history dump/load</B> - a pair of programs I use to
      manipulate browser's history.
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="netscape-history.tgz">netscape-history.tgz</A></B><BR>
      <B>Requires:</B> <A HREF="http://www.sleepycat.com/historic.html">Berkeley DB 1.85</A>
         and builtin module bsddb<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> nothing<BR>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <B>Inside the archive:</B>

         <DT>dump</DT>
         <DD>
            The program to dump history file to a text file. The program is
            based on Netscape history file lister by Hannu Krosing.
         </DD>

         <DT>load</DT>
         <DD>
            This is the opposite to dump - it loads the text file
            back to netscape history file.
         </DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="extract_mime"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2">
      <B>Extract MIME</B> - template programs that show how to write tools
         to extract MIME attachments from incoming mail messages.
      <A HREF="extract_mime.txt">Detailed description</A> available.
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="extract_mime.tgz">extract_mime.tgz</A></B><BR>
      <B>Requires:</B> nothing<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> nothing<BR>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <B>Inside the archive:</B>

         <DT>extract_mime.py</DT>
         <DD>The template program.</DD>

         <DT>extract_mime</DT>
         <DD>Shell wrapper to use extract_mime.py from /etc/aliases or such.</DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="mimedecode"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2">
      <B>MIME decode</B> - a program to decode MIME messages. Useful for
         multicharset mail lists archives and such.
      <A HREF="mimedecode.txt">Detailed description</A> available.
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="mimedecode-2.1.0.tar.gz">mimedecode.tar.gz</A></B><BR>
      <B>Requires:</B> nothing<BR>
      <B>Recommends:</B> nothing<BR>
      <B>Suggests:</B> nothing<BR>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <B>Inside the archive:</B>

         <DT>mimedecode.py</DT>
         <DD>The program.</DD>

         <DT>mimedecode.docbook</DT>
         <DD>Documentation source in DocBook format.</DD>

         <DT>mimedecode.html, mimedecode.man, mimedecode.txt</DT>
         <DD>Documentation in different formats.</DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="bdftogd"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2">
      <B>bdftogd.py</B> and <B>mk_gdfonts</B> - programs to convert BDF (XWindows)
      fonts to GD format.
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>Download: <A HREF="bdftogd.py.txt">bdftogd.py</A> and <A HREF="mk_gdfonts">mk_gdfonts</A></B><BR>
      <B>Requires:</B> <A HREF="\#m_lib">m_Lib</A><BR>
      <B>Recommends:</B> <A HREF="\#pbar">pbar</A><BR>
      <B>Suggests:</B> nothing<BR>
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <B>Description:</B>

         <DT>bdftogd.py</DT>
         <DD>
            Program to convert BDF (XWindows) fonts to GD format. Tested
            with <A HREF="../gd1_2.tgz">gd 1.2</A>.
         </DD>

         <DT>mk_gdfonts</DT>
         <DD>
            Shell script to generate all gd fonts in once.
         </DD>
      </DL>
   </TD>
</TR>

<TR>
   <TD width="100%" colspan="2">
      My good fellow and colleague <A HREF="http://www.ice.ru/~vitus/">Vitus Wagner</A>
maintains a page with <A HREF="http://www.ice.ru/~vitus/misc/\#gdfonts">Cyrillic fonts</A>,
converted from <A HREF="ftp://ftp.relcom.ru/pub/x11/cyrillic/fonts/xrus-2.2.0-src.tgz">fonts</A>
created by <A HREF="http://www.vak.ru/">Sergey Vakulenko</A>. Fonts tested
with <A HREF="../gd1_2.tgz">gd 1.2</A>.
   </TD>
</TR>
</TABLE>

<A name="misc"></A>
<H3>Miscellanea</H3>

<A name="rgb_example"></A>
<TABLE width="100%" border="2">
<TR>
   <TD width="100%" colspan="2">
      <B>rgb</B> - an example of how to use PyGreSQL (PostgreSQL<=>Python interface)
   </TD>
</TR>

<TR>
   <TD width="50%" valign="top">
      <B>License: GPL</B><BR>
      <B>Download: <A HREF="rgb.tgz">rgz.tgz</A></B><BR>
      <B>Requires:</B> <A HREF="http://PyGreSQL.org/">PyGreSQL</A>,
         <A HREF="http://www.postgresql.org/">running PostgreSQL</A>,
         <A HREF="http://www.apache.org/">running WWW server</A><BR>
      <B>Recommends:</B> rgb.txt from X11<BR>
      <B>Suggests:</B> nothing<BR>

      <!-- <p>
         There is <A HREF="http://sun.med.ru/cgi-bin/rgb.cgi?cube=1">a demo site</A>.
      </p> -->
   </TD>

   <TD width="50%" valign="top">
      <DL>
         <B>Inside the archive:</B>

         <DT>rgb_connect.py</DT>
         <DD>
            Module that hides connection details; later if you want
            move/rename your database or programs, or change user/password,
            you just need to edit one file.
         </DD>

         <DT>init_rgb.py</DT>
         <DD>
            Program that parses rgb.txt (from X11, not included here) and
            put table of colors into rgb database. The database must exists,
            so run "createdb rgb" before init_rgb.py.
         </DD>

         <DT>check_255.py</DT>
         <DD>
            Very simple program that checks whether color parts are (not)
            exceeds 255.
         </DD>

         <DT>init_rgb_checked.py</DT>
         <DD>
            The same as init_rgb.py, but it combined with check_255.py.
         </DD>

         <DT>rgb.cgi</DT>
         <DD>
            CGI script that draws colors from rgb database and generates
            HTML table full of colors. The program wants one parameter
            "cube=N", where N is integer 1..8 - these are just 8 subcubes
            of big color cube.
         </DD>
      </DL>
   </TD>
</TR>
</TABLE>

<BR>

<A name="py4dos"></A>
<p>
   I wrote now old and outdated <A HREF="py4dos.txt">comparison of 3 Python-for-DOS interpreters</A>.
</p>
#end def
$phd_pp_ru.respond(self)