Note that there are some explanatory texts on larger screens.

plurals
  1. PO
    primarykey
    data
    text
    <blockquote> <p>name the directory something related to your project. When you do releases, you should include a version number suffix: Twisted-2.5.</p> </blockquote> <p>Not sure why this is unclear. It seems obvious. It all has to be in one directory. </p> <p>Why do things have to be in one directory? Because everyone says so, that's why.</p> <blockquote> <p>create a directory Twisted/bin and put your executables there.</p> </blockquote> <p>This is the way Linux works. Executables are in a <code>bin</code> directory. It makes it easy to put this specific directory in your <code>PATH</code> environment variable.</p> <blockquote> <p>If your project is expressable as a single Python source file, then put it into the directory and name it something related to your project. For example, Twisted/twisted.py.</p> </blockquote> <p>Right. You have /Twisted, /Twisted/bin and /Twisted/twisted.py with your actual, running code in it. Where else would you put it?</p> <p>There's no "why" to this. Where else could you possibly put it?</p> <blockquote> <p>If you need multiple source files, create a package instead (Twisted/twisted/, with an empty Twisted/twisted/<strong>init</strong>.py) and place your source files in it. For example, Twisted/twisted/internet.py.</p> </blockquote> <p>This is just the way Python packages work. They're directories with <code>__init__.py</code> files. The tutorial is pretty clear on this. </p> <blockquote> <p>put your unit tests in a sub-package of your package Twisted/twisted/test/. </p> </blockquote> <p>Where else would you put your tests? Seriously. There's no "why?" to this. There's no sensible alternative.</p> <blockquote> <p>add Twisted/README and Twisted/setup.py to explain and install your software, respectively</p> </blockquote> <p>Right. Where else would you put them? Again. There's no "why?" They go in the top directory because -- well -- that's what a directory is for. It contains files.</p>
    singulars
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. VO
      singulars
      1. This table or related slice is empty.
    2. VO
      singulars
      1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload