{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/software-development-documentation"}],"enrichment":{"capability":"Extracts comments from source code files across multiple programming languages, returning structured comment objects with text, line number, and multiline status.","skillfed_tags":["code-analysis","documentation-mining","polyglot-support"],"use_cases":["Extract all comments from a codebase to generate documentation or audit code quality.","Analyze comment density and patterns across multiple source files for code review.","Build tools that process or migrate comments when refactoring large projects.","Mine comments for compliance, security, or TODO tracking across polyglot codebases.","Generate comment-based reports for documentation or knowledge base extraction."],"what_it_does":"Comment Parser is a Python module that extracts comments from source code files in multiple programming languages. It provides two main entry points: extract_comments() for files and extract_comments_from_str() for code strings. Both return a list of Comment objects, each exposing the comment text, line number, and whether it spans multiple lines. The module auto-detects file MIME types or accepts them as optional parameters, supporting languages including C, C++, Java, Python, JavaScript, Go, Ruby, Shell, HTML, XML, and others.\n\nThe package is useful for documentation mining, code analysis, and automated comment extraction workflows. It handles both single-line and multiline comment syntax variations across different languages. The module depends on libmagic for file type detection and requires Python 3.13 or later.","worth_installing":"Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and solves a specific problem with low install friction. The Python 3.13 requirement is a constraint worth noting, but the package is stable (Production/Stable status) and suitable for comment extraction tasks across multiple languages."},"id":"comment-parser","links":{"html":"https://skillfed.io/packages/comment-parser","md":"https://skillfed.io/packages/comment-parser.md","pypi":"https://pypi.org/project/comment-parser/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2024-12-25","license_spdx":null,"license_treatment":"permissive","name":"comment-parser","python_support":"supports_current","summary":"Parse comments from various source files."},"popularity":{"monthly_downloads":174631,"position":10277,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"1.2.5"}