Tool to count lines of source code.
Latest commit 6f4f097 Nov 11, 2018
Permalink
Failed to load latest commit information.
CATS rearrange files Aug 26, 2018
DATS version bump Nov 11, 2018
SATS version bump Oct 2, 2018
bash version bump Oct 28, 2018
compleat usage Sep 27, 2018
include new files &c. Aug 26, 2018
man version bump Sep 2, 2018
src various things Sep 4, 2018
test fix typo; add some languages Oct 1, 2018
.atsfmt.toml releases Aug 5, 2018
.ctags faster though needs improvement soon. Jan 16, 2018
.gitattributes gitattributes Aug 4, 2018
.gitignore files Aug 7, 2018
.travis.yml ci Aug 29, 2018
.yamllint pre-release Dec 3, 2017
CHANGELOG.md version bump Oct 2, 2018
CONTRIBUTING.md fix contributing.md Feb 8, 2018
Justfile update benchmarks Oct 28, 2018
LANGUAGES.md version bump Nov 11, 2018
LICENSE license Jul 30, 2018
README.md for ci Oct 30, 2018
TODO.md version bump Oct 28, 2018
atspkg.dhall version bump Nov 11, 2018
gc.dhall diff Aug 5, 2018
mac.dhall no static? Aug 26, 2018
native.dhall diff Aug 5, 2018
no-gc.dhall diff Aug 5, 2018
screenshot.png data Feb 18, 2018

README.md

polyglot

Build Status

poly is a command-line tool that determines project contents. The goal is to able to point it to any directory and get an accurate, complete, and informative summary of its contents.

Screenshot of sample output

It also has the secondary goal of advancing the state-of-the art for ATS, by writing practical, distributable software and supporting tooling.

Pitch

Reasons to use polyglot:

  • Accurate: won't confuse Coq and Verilog
  • Fast: polyglot is faster than all other tools
  • Pretty: magenta output

Reasons not to use polyglot:

  • Written in ATS
  • Best on Linux
  • No regex-based exclusions
  • Doesn't count block comments

Benchmarks

On the Rust repo:

Tool Language Time
polyglot ATS 134.6 ms
loc Rust 139.6 ms
scc Go 225.4 ms
tokei Rust 262.6 ms
gocloc Go 923.9 ms
cloc Perl 5.610 s
enry Go 6.926 s
linguist Ruby 20.16 s

For more extensive benchmarks, see my blog post with some additional data.

Heuristics

Polyglot distinguishes itself from tokei, gocloc, scc, and loc by being able to disambiguate file names. Thus, poly will not confuse Happy for Yacc (for instance).

Installation

From a Script

The easiest way to install is to use the installation script, like so:

curl -sSl https://raw.githubusercontent.com/vmchale/polyglot/master/bash/install.sh | sh -s

You can optionally install compleat for shell completions as well.

Vim Plugin

There is a vim plugin available which can count lines of code in a project.

Documentation

You can view manpages for poly with

man poly

Building for Hacking

You can install ats-pkg with

curl -sSl https://raw.githubusercontent.com/vmchale/atspkg/master/bash/install.sh | sh -s

And then build poly with

git clone git@github.com:vmchale/polyglot.git
cd polyglot
atspkg build --pkg-args './gc.dhall'

This will put a binary at target/poly.

If you are on Mac, you may have to replace the last line with

atspkg build --pkg-args './mac.dhall'

Testing

To run the test suite

atspkg test --pkg-args './gc.dhall'

Languages

For languages already supported, see LANGUAGES.md

Contents

-------------------------------------------------------------------------------
 Language             Files       Lines         Code     Comments       Blanks
-------------------------------------------------------------------------------
 ATS                     16        3682         3524           39          119
 C                        1          24           22            0            2
 C Header                 1          43           35            0            8
 Dash                     5         133          106            1           26
 Dhall                    5          94           84            0           10
 Justfile                 1          24           21            1            2
 Markdown                 7         818          702            0          116
 TOML                     1           3            3            0            0
 YAML                     1          51           45            0            6
-------------------------------------------------------------------------------
 Total                   38        4872         4542           41          289
-------------------------------------------------------------------------------