Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 97300 - epydoc fails to document some modules that modify os.path
Summary: epydoc fails to document some modules that modify os.path
Status: RESOLVED TEST-REQUEST
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Development (show other bugs)
Hardware: x86 Linux
: High normal (vote)
Assignee: Python Gentoo Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-06-28 06:19 UTC by Jakob Schiotz
Modified: 2007-06-09 22:45 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jakob Schiotz 2005-06-28 06:19:20 UTC
Some modules importing other modules which modify os.path are not documented
correctly.  In particular, modules importing Scientific.IO.NetCDF are not
documented correctly, if other submodules have imported other parts of Scientific.
The problem is that Scientific adds a directory to os.path when it is imported
the first time, but epydoc reverts to the previous os.path, and then
Scientific.IO.NetCDF fails.

The problem is apparently caused by these lines in
/usr/lib/python2.3/site-packages/epydoc/imports.py (lines 116-123):

    # Try importing it as a file name.
    if os.path.exists(name_or_filename):
        old_sys_path = sys.path[:]
        (basedir, name) = _find_module_from_filename(name_or_filename)
        sys.path.insert(0, basedir)
        try: return _import_module(name)
        finally: sys.path = old_sys_path

Note how os.path is manipulated, and finally restored.

The problem occurs both in version 2.0 and 2.1-r1 of epydoc, the lines above are
taken from 2.1-r1.


Reproducible: Always
Steps to Reproduce:
1.
2.
3.




emerge info
Portage 2.0.51.19 (default-linux/x86/2005.0, gcc-3.3.5-20050130,
glibc-2.3.4.20041102-r1, 2.6.11-gentoo-r11 i686)
=================================================================
System uname: 2.6.11-gentoo-r11 i686 Mobile Intel(R) Pentium(R) 4 - M CPU 2.00GHz
Gentoo Base System version 1.6.12
Python:              dev-lang/python-2.3.5 [2.3.5 (#1, May  2 2005, 11:20:28)]
dev-lang/python:     2.3.5
sys-apps/sandbox:    [Not Present]
sys-devel/autoconf:  2.13, 2.59-r6
sys-devel/automake:  1.4_p6, 1.5, 1.6.3, 1.7.9-r1, 1.8.5-r3, 1.9.5
sys-devel/binutils:  2.15.92.0.2-r10
sys-devel/libtool:   1.5.16
virtual/os-headers:  2.6.8.1-r2
ACCEPT_KEYWORDS="x86"
AUTOCLEAN="yes"
CFLAGS="-O2 -march=pentium4 -fomit-frame-pointer -pipe"
CHOST="i686-pc-linux-gnu"
CONFIG_PROTECT="/etc /usr/kde/2/share/config /usr/kde/3.3/env
/usr/kde/3.3/share/config /usr/kde/3.3/shutdown /usr/kde/3/share/config
/usr/lib/X11/xkb /usr/lib/mozilla/defaults/pref /usr/share/config
/usr/share/texmf/dvipdfm/config/ /usr/share/texmf/dvips/config/
/usr/share/texmf/tex/generic/config/ /usr/share/texmf/tex/platex/config/
/usr/share/texmf/xdvi/ /var/qmail/control"
CONFIG_PROTECT_MASK="/etc/gconf /etc/terminfo /etc/env.d"
CXXFLAGS="-O2 -march=pentium4 -fomit-frame-pointer -pipe"
DISTDIR="/var/portage/distfiles"
FEATURES="autoaddcvs autoconfig ccache distlocks sandbox sfperms strict"
GENTOO_MIRRORS="http://trumpetti.atm.tut.fi/gentoo/
ftp://trumpetti.atm.tut.fi/gentoo/ ftp://ftp.rhnet.is/pub/gentoo/
ftp://gd.tuwien.ac.at/opsys/linux/gentoo/"
LINGUAS="dk fr"
MAKEOPTS="-j2"
PKGDIR="/var/portage/packages"
PORTAGE_TMPDIR="/var/tmp"
PORTDIR="/usr/portage"
PORTDIR_OVERLAY="/usr/local/portage"
SYNC="rsync://rsync.europe.gentoo.org/gentoo-portage"
USE="x86 X Xaw3d acpi alsa arts atlas avi berkdb bitmap-fonts cdr crypt cups
curl dga dvd emacs emboss encode fam flac font-server foomaticdb fortran gdbm
gif gpm gtk gtk2 imagemagick imap imlib java jpeg kde kdeenablefinal libg++
libwww mad maildir mbox mikmod mime motif mozilla mp3 mpeg mule ncurses netcdf
nls nptl ogg oggvobis oggvorbis opengl oss pam pcmcia pdflib perl plotutils png
pnp ppds python qt quicktime readline real scanner sdl slang smime spell sse ssl
svga tcltk tcpd tetex tiff truetype truetype-fonts trusted type1-fonts usb
vorbis win32codecs wxwindows xine xml2 xmms xv xvid zlib linguas_dk linguas_fr
userland_GNU kernel_linux elibc_glibc"
Unset:  ASFLAGS, CBUILD, CTARGET, LANG, LC_ALL, LDFLAGS
Comment 1 Markus Ullmann (RETIRED) gentoo-dev 2007-06-09 22:45:14 UTC
hrm I just tried with the most recent version and it seems to work for me, please reopen if it doesn't work for you