35

I'm trying to debug a Python CLI I wrote that can take its arguments from stdin. A simple test case would have the output of

echo "test" | python mytool.py

be equivalent to the output of

python mytool.py test

I'd like to debug some issues with this tool, so I tried to run this:

echo "test" | pdb mytool.py

But I get this output, then pdb exits:

> /path/to/mytool.py(5)<module>()
-> '''
(Pdb) *** NameError: name 'test' is not defined
(Pdb)

The same thing occurs when I add -m python to the shebang, and if I run pdb.set_trace() inside the script.

What's going on here?

7
  • 2
    Can you change your script to accept input from a file other than stdin?
    – nmichaels
    Commented Jun 19, 2013 at 18:57
  • possible duplicate of Python CLI program unit testing Commented Feb 4, 2014 at 1:30
  • 1
    @user1901786 How do you access the stdin in the CLI script? Using sys.stdin? Also, do you just want to write a test for this or do you need to start the debugger within the script? If you need the debugger, at which point do you want it to engage the script? Sorry, the question is a bit unclear to me. Commented Mar 18, 2014 at 20:31
  • 1
    @Paul Sweatte. Not a duplicate. Commented Jul 26, 2014 at 7:50
  • 1
    What I would do is get PyCharm community edition and try debugging with that. Using standard local debugging should work if you are ok with manually entering or pasting your input. If you require debugging inputs from a pipe or redirect, you may have to use remote debugging which is slightly more complicated to set up. Commented Oct 22, 2014 at 12:37

4 Answers 4

20

Another option is to create you own Pdb object, and set there the stdin and stdout. My proof of concept involves 2 terminals, but for sure some work can be merged some kind of very unsecure network server.

  1. Create two fifos:

    mkfifo fifo_stdin
    mkfifo fifo_stdout
    
  2. In one terminal, open stdout on background, and write to stdin:

    cat fifo_stdout &
    cat > fifo_stdin
    
  3. In your python code/console create the pdb object, and use it:

    import pdb
    mypdb=pdb.Pdb(stdin=open('fifo_stdin','r'), stdout=open('fifo_stdout','w'))
    ...
    mypdb.set_trace()
    ...
    
  4. Profit!

You should be able to use pdb on the first console.

The only drawback is having to use your custom pdb, but some monkey patching at init (PYTHONSTARTUP or similar) can help:

import pdb
mypdb=pdb.Pdb(stdin=open('fifo_stdin','r'), stdout=open('fifo_stdout','w'))
pdb.set_trace=mypdb.set_trace
1
  • Handy, also for example if you want to debug Flask when using Pytest. Since Python 3.7 there is breakpoint(): breakpoint(stdin=open('fifo_stdin', 'r'), stdout=open('fifo_stdout', 'w'))
    – DZet
    Commented Sep 14, 2021 at 13:36
6

You can use another file descriptor. With bash you can create a new file descriptor with:

exec 3<> test.txt

And then on your python file have something like:

#!/usr/bin/python

# Use fd 3 as another stdin file.
import os
stdin=os.fdopen(3)

while True:
    s=stdin.readline()
    import pdb; pdb.set_trace()
    print len(s)

Just runing your script will use that test.txt as input, and you can use stdin on stdin. It can be used as well with pipes if you need.

1
  • 5
    I'd prefer a solution that doesn't require modifying the tool's code. Commented Nov 14, 2014 at 18:09
6

Your controlling TTY is still a terminal, right? Use this instead of pdb.set_trace.

def tty_pdb():
    from contextlib import (_RedirectStream,
                            redirect_stdout, redirect_stderr)
    class redirect_stdin(_RedirectStream):
        _stream = 'stdin'
    with open('/dev/tty', 'r') as new_stdin, \
         open('/dev/tty', 'w') as new_stdout, \
         open('/dev/tty', 'w') as new_stderr, \
         redirect_stdin(new_stdin), \
         redirect_stdout(new_stdout), redirect_stderr(new_stderr):
        __import__('pdb').set_trace()

Haven't gotten readline to autocomplete under these circumstances. Up arrow won't work either, or any other of the readline niceties.

1
  • This is pretty cool, but doing l shows that we stopped in the middle of tty_pdb() not the place where we called it. It's a bit of a problem if you need to inspect the state there.
    – ocodo
    Commented Sep 12, 2023 at 3:31
2

When you use pdb(or any other python debugger) it acquires stdin for debug commands, that's why you get NameError: name 'test' is not defined.

For example this command will quit debugger at the begging of a runtime and you wont get this error(nor interactive debugging) for one run:

(echo cont;echo "test") | python -m pdb mytool.py

2
  • 3
    While this explains what's going on, it doesn't provide an answer. Commented Nov 14, 2014 at 18:08
  • 2
    @whereswalden in fact, the 'answer' is that pdb is broken and stupid for taking input from stdin. :/
    – Otheus
    Commented Aug 24, 2018 at 10:10

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.