https://github.com/meditans/preprocessor

Remove cpp annotations, to get the source ready for static analysis with a parsing library.
https://github.com/meditans/preprocessor

Last synced: 14 days ago
JSON representation

Remove cpp annotations, to get the source ready for static analysis with a parsing library.

• Host: GitHub
• URL: https://github.com/meditans/preprocessor
• Owner: meditans
• License: mit
• Created: 2016-07-15T19:28:09.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2016-10-05T11:06:10.000Z (over 8 years ago)
• Last Synced: 2024-11-28T14:08:44.216Z (2 months ago)
• Language: Haskell
• Homepage:
• Size: 56.6 KB
• Stars: 2
• Watchers: 2
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Awesome Lists containing this project

README

        
#+TITLE: Preprocessor

This library preprocesses the cpp directives in haskell source code (a task not

usually done by parsing libraries), to prepare it for static analysis, e.g. with

[[http://hackage.haskell.org/package/haskell-src-exts][haskell-src-exts]].

The design of the library is guided by two principles:

  * Line numbering with the original file should be preserved: if a line isn't

    related to cpp preprocessing, it conserves its position. This is done to

    make eventual failings with the parsing library easier to locate.

  * It should offer a very simple API, shielding the user from the

    understandings of how cabal options are passed around, and trying to

    automatically find all the required information in the project. The user is

    expected to use only the two functions in the module =Preprocessor=.

Currently this tool *requires* the library to have been built with stack (it

searches for some files generated in =.stack-work=). In the future I'll probably

lift this restriction (if you need it before, please open a ticket). The files

marked as internal are exported for documentation purposes only.

*NEWS* After talking with Duncan Coutts at Munihac, we decided that this task

could be better done by the cabal library itself with a =--only-configure= flag

that could be implemented. So I'm keeping this library as a support for my

=documentator= library, at least until I get around implementing that flag.

If you have any problem, or suggestion for the library, please open an issue :).