Skip to main content

A human-readable alternative to dir

Project description

An alternative to Python’s dir function. Easy to type; easy to read! For humans only.

Requirements

Python 2.4+ or 3.0

License

BSD (see the LICENSE file)

Contributions are welcome. See the CHANGELOG.md and AUTHORS.md files.

Install

To install see, run:

$ pip install --upgrade see

Alternatively, to install from source:

$ python setup.py install

Usage

see is designed for the interactive Python interpreter. Import the see function like so:

>>> from see import see

Call see() without arguments to see all objects in the global scope.

>>> foo = 'bar'
>>> see()
    foo      see()

Call see(an_object) to see what you can do with an_object.

>>> number = 1
>>> see(number)
    +             -             *             /             //            %
    **            <<            >>            &             ^             |
    +obj          -obj          ~             <             <=            ==
    !=            >             >=            abs()         bool()
    divmod()      float()       hash()        help()        hex()
    int()         long()        oct()         repr()        str()
    .bit_length()               .conjugate()  .denominator  .imag
    .numerator    .real

Startup

You can use a Python startup file to ensure that see is available every time you run Python. The following example uses a startup file named .pythonrc.py in the user’s home directory:

  1. Create the Python startup file, if it does not already exist:

    touch ~/.pythonrc.py
  2. Open this file in your preferred editor. Add the following line:

    from see import see
  3. Set the following environment variable (e.g. in ~/.bashrc for Bash):

    export PYTHONSTARTUP="$HOME/.pythonrc.py"

Now you can use see immediately after running python, without having to manually import it.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

see-1.2.0.zip (8.9 kB view hashes)

Uploaded Source

see-1.2.0.tar.gz (7.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page