• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Std
    • Proof-automation
    • Macro-libraries
    • ACL2
    • Interfacing-tools
    • Hardware-verification
    • Software-verification
      • Kestrel-books
        • Crypto-hdwallet
        • Apt
        • Error-checking
        • Fty-extensions
        • Isar
        • Kestrel-utilities
        • Set
        • Soft
        • C
          • Syntax-for-tools
          • Atc
            • Atc-implementation
              • Atc-abstract-syntax
              • Atc-pretty-printer
                • Pprint-expressions
                • Pprint-expr
                • Expr-grade
                • Pprint-obj-declor
                • Expr-grade-<=
                • Binop-expected-grades
                • Pprint-obj-declon
                • Expr->grade
                • Pprint-tyspecseq
                • Pprint-tag-declon
                • Pprint-struct-declon-list
                • Pprint-fun-declor
                • Pprint-file
                  • Pprint-stmt
                  • Pprint-struct-declon
                  • Pprint-obj-adeclor
                  • Pprint-initer
                  • Pprint-fun-declon
                  • Pprint-indent
                  • Pprint-hex-const
                  • Pprint-fileset
                  • Pprint-dec-const
                  • Pprinted-lines-to-file
                  • Pprint-tyname
                  • Pprint-param-declon-list
                  • Pprint-oct-const
                  • Pprint-iconst-length
                  • Pprint-iconst
                  • Pprint-const
                  • Expr-grade-index
                  • Pprint-param-declon
                  • Pprint-label
                  • Pprint-ident-list
                  • Pprint-binop
                  • Pprint-fundef
                  • Pprint-file-to-filesystem
                  • Pprint-ext-declon-list
                  • Pprint-unop
                  • Pprint-line
                  • Pprint-ident
                  • Pprint-ext-declon
                  • Pprint-comma-sep
                  • Pprint-transunit
                  • Pprint-one-line
                  • Pprinted-lines-to-channel
                  • Pprint-one-line-blank
                  • Pprint-line-blank
                • Atc-event-and-code-generation
                • Fty-pseudo-term-utilities
                • Atc-term-recognizers
                • Atc-input-processing
                • Atc-shallow-embedding
                • Atc-process-inputs-and-gen-everything
                • Atc-table
                • Atc-fn
                • Atc-pretty-printing-options
                • Atc-types
                • Atc-macro-definition
              • Atc-tutorial
            • Language
            • Representation
            • Transformation-tools
            • Insertion-sort
            • Pack
          • Bv
          • Imp-language
          • Event-macros
          • Java
          • Bitcoin
          • Ethereum
          • Yul
          • Zcash
          • ACL2-programming-language
          • Prime-fields
          • Json
          • Syntheto
          • File-io-light
          • Cryptography
          • Number-theory
          • Lists-light
          • Axe
          • Builtins
          • Solidity
          • Helpers
          • Htclient
          • Typed-lists-light
          • Arithmetic-light
        • X86isa
        • Axe
        • Execloader
      • Math
      • Testing-utilities
    • Atc-pretty-printer

    Pprint-file

    Pretty-print a file.

    Signature
    (pprint-file file include options) → lines
    Arguments
    file — Guard (filep file).
    include — Guard (maybe-stringp include).
    options — Guard (pprint-options-p options).
    Returns
    lines — Type (msg-listp lines).

    We start with a line comment saying that the file is generated by ATC.

    The include parameter of this pretty-printing ACL2 function says whether we should generate (when non-nil, an #include directive with double quotes and the file name specified by the string. Note that our abstract syntax does not yet have a representation of #include directives; instead, since for now we only generate very simple such directives, we generate them in this ad hoc fashion for now.

    Definitions and Theorems

    Function: pprint-file

    (defun pprint-file (file include options)
      (declare (xargs :guard (and (filep file)
                                  (maybe-stringp include)
                                  (pprint-options-p options))))
      (let ((__function__ 'pprint-file))
        (declare (ignorable __function__))
        (b* (((file file) file))
          (append (list "// This file is generated by ATC.~%")
                  (and include
                       (list (str::cat "~%#include \"" include "\"~%")))
                  (pprint-ext-declon-list file.declons options)))))

    Theorem: msg-listp-of-pprint-file

    (defthm msg-listp-of-pprint-file
      (b* ((lines (pprint-file file include options)))
        (msg-listp lines))
      :rule-classes :rewrite)