Skip to main content

Django wrapper for pydoc

Project description


Read Python Documentation within a Django Project.

So you're happily going along in development and you want to quickly view documentation in a module. For python modules this is a piece of cake.

However, when you try to find out more information about a Django app, you may have come across an error like this...


Or like this...


And you may have done this...


But after installing djydoc now you can do this:


Djydoc aims to be a simple drop-in replacement as a command for pydoc so that you can view Python documentation without having to specify DJANGO_SETTINGS_MODULE or run django.setup(). Djydoc does that for you.


Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.


  • Django 2.2.4+
  • Poetry (optional, to help easily install)


Option 1 : PIP

$ pip install djydoc

Option 2: Development install via poetry

$ git clone <git_url>
$ cd djydoc
$ poetry install

Option 3: use as a Django app

Just follow option 2, but don't install with poetry

Options 1, 2, or 3: Setup

Add 'djydoc' to INSTALLED_APPS in settings:



Once installed djydoc should be available via the ./ command.

The intention is for this to be a drop-in replacement for pydoc, so all the commands should work the same (currently -w is not implemented):

$ ./ djydoc django.contrib.auth.models.User

[ documentation shown ]

$ ./ djydoc -p 8080
Server ready at
Server commands: [b]rowser, [q]uit

Running the tests

Testing TBD.


Follow common sense django deployment practices.

Built With


Please read for details on our code of conduct, and the process for submitting pull requests to us.


We use SemVer for versioning. For the versions available, see the tags on this repository.


  • Jordan H. - Code Author - SrcRr


This project is licensed under MIT.



Project details

Download files

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

Source Distribution

djydoc-0.1.3.dev0.tar.gz (4.2 kB view hashes)

Uploaded Source

Built Distribution

djydoc-0.1.3.dev0-py2.py3-none-any.whl (4.1 kB view hashes)

Uploaded Python 2 Python 3

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