This directory contains third-party software components used in the SLOCCount web application.

WebPerl is a WebAssembly port of Perl 5, allowing Perl code to run in web browsers.

• Author: Hauke Dämpfling (haukex@zero-g.net)
• Institution: Leibniz Institute of Freshwater Ecology and Inland Fisheries (IGB), Berlin, Germany
• Copyright: © 2018 Hauke Dämpfling
• Source: https://github.com/haukex/webperl
• Website: http://webperl.zero-g.net
• Version: v0.09-beta (prebuilt release from March 3, 2019)

WebPerl is dual-licensed under the same terms as Perl 5 itself:

• GNU General Public License (GPL) version 1 or later, OR
• Artistic License (which comes with Perl 5)

You may choose either license. See webperl/LICENSE_gpl.txt and webperl/LICENSE_artistic.txt for full license texts.

• webperl.js - Main WebPerl loader
• emperl.js - Emscripten-compiled Perl JavaScript
• emperl.wasm - WebAssembly Perl binary
• emperl.data - Perl runtime data files
• LICENSE_artistic.txt - Artistic License text
• LICENSE_gpl.txt - GNU GPL text

SLOCCount (Source Lines of Code Count) is a suite of programs for counting physical source lines of code (SLOC) in large software systems.

• Original Author: David A. Wheeler (dwheeler@dwheeler.com)
• Maintainer: Jeff Licquia
• Copyright: © 2001-2004 David A. Wheeler
• Source: https://github.com/licquia/sloccount
• Commit Used: 7220ff627334a8f646617fe0fa542d401fb5287e

SLOCCount is licensed under the GNU General Public License version 2 (GPL-2.0).

• sloccount-perl.zip - Archive containing the Perl scripts from SLOCCount that implement the actual line counting algorithms

The zip file includes various language-specific counting scripts (e.g., python_count, c_count, perl_count) and supporting utilities.

Many of the original SLOCCount language counters are C programs that need to be compiled. To run these in the browser, they have been compiled to WebAssembly using Emscripten.

Compiled Programs (in lib/wasm/):

• c_count.js / c_count.wasm - Main C/C++/JavaScript/Java counter
• php_count.js / php_count.wasm - PHP counter
• ml_count.js / ml_count.wasm - ML/OCaml counter
• pig_count.js / pig_count.wasm - Pig Latin counter
• lexcount1.js / lexcount1.wasm - Lex counter

Compilation Process:

The C source files were extracted from the SLOCCount repository and compiled using Emscripten v4.0.17:

# Extract C source files from the repository
unzip -j lib/sloccount-perl.zip "*.c" -d sloccount-c/

# Compile each C program to WebAssembly
cd sloccount-c
emcc c_count.c -o c_count.js \
  -s WASM=1 \
  -s EXPORTED_RUNTIME_METHODS='["callMain","FS"]' \
  -s ALLOW_MEMORY_GROWTH=1 \
  -s FORCE_FILESYSTEM=1 \
  -s MODULARIZE=1 \
  -s EXPORT_NAME=createCCountModule

# Repeat for other C programs (php_count, ml_count, pig_count, lexcount1)

Configuration Options:

• EXPORTED_RUNTIME_METHODS - Allows calling main() and accessing the virtual filesystem
• ALLOW_MEMORY_GROWTH - Enables dynamic memory allocation
• FORCE_FILESYSTEM - Includes filesystem support for reading files
• MODULARIZE - Creates a module factory function
• EXPORT_NAME - Sets the module constructor name

The WASM modules are loaded dynamically and configured to:

• Write input files to the virtual filesystem at /tmp/
• Execute via callMain() with file paths as arguments
• Capture output via custom print handlers
• Disable stdin prompts to prevent browser dialogs

Usage in Application:

The main application detects file extensions and routes them to either:

• Perl counter scripts (for Python, Ruby, Perl, SQL, etc.) - run via WebPerl eval
• WASM counters (for JavaScript, C, C++, Java, PHP, etc.) - run via compiled binaries

This hybrid approach uses the original SLOCCount algorithms without modification, running both Perl and C programs entirely in the browser via WebAssembly.

This SLOCCount web application makes use of:

1. WebPerl for running Perl in the browser via WebAssembly
2. SLOCCount Perl scripts for accurate source line counting with comment filtering

Both projects are used in accordance with their respective open-source licenses. No modifications have been made to the WebPerl runtime or SLOCCount scripts themselves.

• WebPerl runtime files are distributed as-is from the official prebuilt v0.09-beta release
• SLOCCount scripts are loaded from the official repository commit 7220ff6
• License files are preserved in their original locations
• This application is a web interface that uses these tools, not a modification of them

• WebPerl Documentation: http://webperl.zero-g.net/using.html
• SLOCCount Documentation: https://github.com/licquia/sloccount/blob/master/README
• COCOMO Cost Model: The cost estimation feature uses the Basic COCOMO model as implemented in the original SLOCCount tool