Hansa

September 23, 2026 · View on GitHub

Detect the programming language based only on content.

Just content, no filename, no extension, nothing else. There are other tools for that.

This is a port of a piece of go-enry to Crystal, trained on the same Linguist corpus (go-enry v2.9.6).

Before the classifier runs, two content-only strategies from go-enry v2 are consulted, in this order:

  1. Editor modelines (# vim: set ft=ruby:, # -*- mode: python -*-) in the first or last 5 lines.
  2. Shebang lines, including /usr/bin/env indirection, with the interpreter mapped through Linguist's table. A shebang naming one language wins outright; ambiguous ones (perl → Perl/Pod) restrict the classifier to those candidates.

Paradoxically it will detect Crystal as Ruby but it's close enough ;-)

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
  hansa:
    github: ralsina/hansa

  2. Run shards install

Usage

require "hansa"

puts Hansa.classify(File.read(ARGV[0]))   # => "Ruby"

There is a "hansa" command line tool that can be used to classify files:

$ hansa src/hansa.cr
src/hansa.cr CoffeeScript

$ printf '#!/bin/bash\necho hi\n' | hansa -
- Shell

Run hansa --help for usage. Errors are reported on stderr with a non-zero exit code, and a file argument of - reads standard input.

Development

I don't expect to do much more development here.

Contributing

  1. Fork it (https://github.com/ralsina/hansa/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors