Programming Language Detector

Overview

This Actor detects the programming language of a given code snippet or file. It analyzes source code or a file URL and returns the identified language with a confidence score. It supports over 100 languages and is built for integration into automation workflows, code analysis, or repository indexing.

Key Features

• Accurate Detection: Uses pattern matching and heuristics to identify languages, even in ambiguous or mixed-language files (e.g., HTML with CSS and JavaScript).
• Fast Performance: Optimized with techniques like dynamic sampling and early stopping to handle large files efficiently.
• Flexible Input: Accepts either raw source code text or a publicly accessible file URL.
• Detailed Output: Provides the primary detected language, a confidence score, a list of candidate languages, and a brief analysis.

How to Use

Provide the Actor with an input containing either a sourceCode string or a fileUrl. If both are provided, sourceCode takes precedence.

Input Requirements

The input must be a JSON object with at least one of these fields:
* sourceCode: A string containing the raw code to analyze.
* fileUrl: A publicly accessible URL to a file (e.g., a GitHub raw file URL).

Input Examples

Using raw source code:

{
  "sourceCode": "def hello():\n    print('Hello, world!')"
}

Using a file URL:

{
  "fileUrl": "https://example.com/sample.cr"
}

Input/Output

Output Format

The Actor returns a JSON object with these fields:
* language: The detected primary programming language.
* extension: The common file extension for that language.
* confidence: A score from 0 to 1 indicating detection certainty.
* candidates: An object listing all considered languages and their confidence scores.
* analysis: A short textual summary of the detection.

Output Example

For a Python code input, the output might look like:

{
  "language": "python",
  "extension": ".py",
  "confidence": 0.92,
  "candidates": {
    "python": 0.92,
    "ruby": 0.15
  },
  "analysis": "High confidence detection: python"
}

Error Handling

If no valid input is provided, the Actor fails with the message:
No input provided. Please provide either 'sourceCode' or 'fileUrl'.

Supported Languages

The detector supports a wide range of languages and formats, including (but not limited to): Python, JavaScript, TypeScript, HTML, CSS, Java, C, C++, C#, PHP, Ruby, Rust, Go, Swift, SQL, Bash, PowerShell, Kotlin, Scala, and Markdown.