8.8.3 ptopu unit

The source of the PtoP program is conveniently split in two les: One is a unit containing an object that does the actual beautifying of the source, the other is a shell built around this object so it can be used from the command line. This design makes it possible to include the object in some program (e.g. an IDE) and use its features to format code.

The object resided in the PtoPU unit, and is declared as follows

  TPrettyPrinter=Object(TObject)
      Indent : Integer;    { How many characters to indent ? }
      InS    : PStream;
      OutS   : PStream;
      DiagS  : PStream;
      CfgS : PStream;
      Constructor Create;
      Function PrettyPrint : Boolean;
    end;

Using this object is very simple. The procedure is as follows:

Create the object, using its constructor.
Set the Ins stream. This is an open stream, from which pascal source will be read. This is a mandatory step.
Set the OutS stream. This is an open stream, to which the beautied pascal source will be written. This is a mandatory step.
Set the DiagS stream. Any diagnostics will be written to this stream. This step is optional. If you don't set this, no diagnostics are written.
Set the Cfgs stream. A conguration is read from this stream. (see the previous section for more information about conguration). This step is optional. If you don't set this, a default conguration is used.
Set the Indent variable. This is the number of spaces to use when indenting. Tab characters are not used in the program. This step is optional. The indent variable is initialized to 2.
Call PrettyPrint. This will pretty-print the source in Ins and write the result to OutS. The function returns True if no errors occurred, False otherwise.

So, a minimal procedure would be:

Procedure CleanUpCode;

var
  Ins,OutS : PBufStream;
  PPRinter : TPrettyPrinter;

begin
  Ins:=New(PBufStream,Init('ugly.pp',StopenRead,TheBufSize));
  OutS:=New(PBufStream,Init('beauty.pp',StCreate,TheBufSize));
  PPrinter.Create;
  PPrinter.Ins:=Ins;
  PPrinter.outS:=OutS;
  PPrinter.PrettyPrint;
end;

Using memory streams allows very fast formatting of code, and is perfectly suitable for editors.

[prev] [prev-tail] [front] [up]