whats-that-code 0.3.0

Guess programming language from a string or file.

whats_that_code

This is a programming language detection library.

It will detect programming language of source in pure python from an ensemble of classifiers. Use this when a quick and dirty first approximation is good enough. whats_that_code can currently identify 60%+ of samples without knowing the extension or tag.

I created this because I wanted

• a pure python programming language detector
• no machine learning dependencies

Tested on python 3.10 through 3.14.

Badges

Usage

from whats_that_code.election import guess_language_all_methods
code = "def yo():\n   print('hello')"
result = guess_language_all_methods(code, file_name="yo.py")
assert result == "python"  # returns a single language name (str), or None if unknown

Suppressing rare languages (opt-in)

Pass an Options to avoid guessing obscure languages unless there is strong evidence (a matching file extension, shebang, or tag). The default is unchanged — no suppression — so existing callers are unaffected.

from whats_that_code.election import guess_language_all_methods
from whats_that_code.options import Options

# "common" keeps only mainstream languages; "uncommon" also keeps established ones.
guess_language_all_methods(code, options=Options(min_tier="common"))

# A .zig file is still detected as Zig even though Zig is below "common":
guess_language_all_methods(code, file_name="x.zig", options=Options(min_tier="common"))  # -> "zig"

Speed

Regex marker matching (the hottest path) runs on Google's re2 — a normal dependency, installed automatically — which is linear-time and ~6× faster on large inputs, with identical results. If a platform has no re2 wheel it transparently falls back to stdlib re. Nothing to configure.

The parser trick (optional)

With Options(use_parsers=True) the code is actually parsed; a clean parse is strong evidence for that language. This uses stdlib parsers (Python/JSON/XML/TOML) out of the box, and adds ~26 tree-sitter grammars when the optional extra is installed:

pip install whats_that_code[fast]

On the eval corpus this lifts code-only accuracy from ~13% to ~21%. It is off by default, so existing callers are unaffected.

guess_language_all_methods(go_source, options=Options(use_parsers=True))  # -> "go"

How it Works

1. Inspects file extension if available.
2. Inspects shebang
3. Looks for keywords
4. Counts regexes for common patterns
5. Attempts to parse python, json, yaml
6. Inspects tags if available.

Each is imperfect and can error. The classifier then combines the results of each using a voting algorithm

This works best if you only use it for fallback, e.g. classifying code that can't already be classified by extension or tag, or when tag is ambiguous.

It was a tool that outgrew being a part of so_pip a StackOverflow code extraction tool I wrote.

Docs

• TODO
• LICENSE
• Prior Art Every similar project/tool, including defunct
• ChangeLog

Notable Similar Tools

• Guesslang - python and tensorflow driven solution. Reasonable results but slow startup and not pure python.
• pygments pure python, but sometimes lousy identification rates.

Project Links

• GitHub
• PyPI
• Bug Tracker
• Change Log