Improve the `cabal.project` parser

[srid]

Our cabal.project parser is rather primitive and in need of improvement.

It has the following known issues.

• cabal.project parse error due to leading comment #193
• cabal.project parser ignores the last package if it doesn't end in newline #186
• cabal.project may reference cabal files instead of directories #113