Skip to main content

count source lines of code (SLOC) using pygments

Project description

PyPI Python Versions Build Status Test Coverage Black License

pygount

Pygount is a command line tool to scan folders for source code files and count the number of source code lines in it. It is similar to tools like sloccount and cloc but uses the pygments package to analyze the source code and consequently can analyze any programming language supported by pygments.

The name is a combination of pygments and count.

Pygount is open source and distributed under the BSD license. The source code is available from https://github.com/roskakori/pygount.

Quickstart

For installation run

$ pip install pygount

or use uv to run it directly, for example:

$ uvx pygount --version

To get a list of line counts for a projects stored in a certain folder:

$ pygount ~/projects/example

To limit the analysis to certain file types identified by their suffix:

$ pygount --suffix=cfg,py,yml ~/projects/example

To get a summary of each programming language with sum counts and percentage:

$ pygount --format=summary ~/projects/example

To analyze a remote git repository directly without having to clone it first:

$ pygount --format=summary https://github.com/roskakori/pygount.git

You can pass a specific revision at the end of the remote URL:

$ pygount --format=summary https://github.com/roskakori/pygount.git/v1.5.1

This example results in the following summary output:

┏━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━━━━┳━━━━━━┓
┃ Language         ┃ Files ┃     % ┃ Code ┃    % ┃ Comment ┃    % ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━━━━╇━━━━━━┩
│ Python           │    18 │  47.4 │ 2132 │ 63.6 │     418 │ 12.5 │
│ TOML             │     2 │   5.3 │ 1204 │ 82.7 │       1 │  0.1 │
│ Batchfile        │     1 │   2.6 │   24 │ 68.6 │       1 │  2.9 │
│ Bash             │     2 │   5.3 │   12 │ 80.0 │       3 │ 20.0 │
│ Makefile         │     1 │   2.6 │    9 │ 45.0 │       7 │ 35.0 │
│ reStructuredText │     9 │  23.7 │    0 │  0.0 │     438 │ 50.2 │
│ Markdown         │     3 │   7.9 │    0 │  0.0 │      53 │ 49.1 │
│ Text only        │     2 │   5.3 │    0 │  0.0 │      24 │ 82.8 │
├──────────────────┼───────┼───────┼──────┼──────┼─────────┼──────┤
│ Sum              │    38 │ 100.0 │ 3381 │ 57.4 │     945 │ 16.1 │
└──────────────────┴───────┴───────┴──────┴──────┴─────────┴──────┘

Plenty of tools can post process SLOC information, for example the SLOCCount plug-in for the Jenkins continuous integration server.

A popular format for such tools is the XML format used by cloc, which pygount also supports and can store in an output file:

$ pygount --format=cloc-xml --out=cloc.xml ~/projects/example

To get a short description of all available command line options use:

$ pygount --help

For more information and examples read the documentation chapter on Usage.

Contributions

To report bugs, visit the issue tracker.

In case you want to play with the source code or contribute improvements, see CONTRIBUTING.

Version history

See CHANGES.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pygount-3.1.0.tar.gz (102.9 kB view details)

Uploaded Source

Built Distribution

pygount-3.1.0-py3-none-any.whl (30.7 kB view details)

Uploaded Python 3

File details

Details for the file pygount-3.1.0.tar.gz.

File metadata

  • Download URL: pygount-3.1.0.tar.gz
  • Upload date:
  • Size: 102.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.2

File hashes

Hashes for pygount-3.1.0.tar.gz
Algorithm Hash digest
SHA256 2f4b064ac1689ba43bdf84bef244e7a45f27e315feae6fb19d1209c56a580361
MD5 3cf305b113176093967974fcf74a8881
BLAKE2b-256 f6d9e7ca1348bdb7525644a386e2732c3935868f66dbc5079cb33ae4f095d293

See more details on using hashes here.

File details

Details for the file pygount-3.1.0-py3-none-any.whl.

File metadata

  • Download URL: pygount-3.1.0-py3-none-any.whl
  • Upload date:
  • Size: 30.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.2

File hashes

Hashes for pygount-3.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 974aaf7a77d7f93aefc220639a897364cdd88a77e5a102d7063f73f8b7100955
MD5 fbd9d4488cf2251861ca29fc69b75e5b
BLAKE2b-256 6bdd51696e3b7f669782a7ff785111081323f1ff10817ec0d84f2efb7aabd367

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page