Metadata-Version: 2.4
Name: cloc-python
Version: 0.1.0
Summary: UVX-friendly wrapper for cloc (Count Lines of Code) binary executable
Project-URL: Homepage, https://github.com/YOUR_USERNAME/cloc-python
Project-URL: Repository, https://github.com/YOUR_USERNAME/cloc-python
Project-URL: Issues, https://github.com/YOUR_USERNAME/cloc-python/issues
License: MIT
License-File: LICENSE
Keywords: cloc,code counter,lines of code,loc,sloc
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# cloc-python

A Python CLI wrapper for [cloc](https://github.com/AlDanial/cloc) (Count Lines of Code) that can be executed via `uvx` without needing to install cloc on your system.

## Install

No installation required! Just run via `uvx`:

```bash
uvx cloc-python [options]
```

## Requirements

- **Windows**: No dependencies! The bundled `cloc.exe` is standalone.
- **Linux/macOS**: Perl is required (usually pre-installed)
  - Ubuntu/Debian: `sudo apt install perl`
  - CentOS/RHEL: `sudo yum install perl`
  - Arch Linux: `sudo pacman -S perl`
  - macOS: Usually pre-installed, or `brew install perl`
  - Docker: `docker run --rm -v $(pwd):/workdir miquella/cloc`

> **Note**: Most Linux distributions and macOS come with Perl pre-installed. You only need to install it if you're using a minimal container (like Alpine) or a custom system.

## Usage

This wrapper passes all arguments directly to the underlying cloc binary:

```bash
# Count lines in current directory
uvx cloc-python .

# Count lines in specific files
uvx cloc-python file1.py file2.py

# Exclude certain directories
uvx cloc-python --exclude-dir=vendor,node_modules .

# JSON output
uvx cloc-python --json .

# See all cloc options
uvx cloc-python --help
```

More options available on the [cloc's repository README](https://github.com/AlDanial/cloc/blob/master/README.md).


## cloc version

This package includes cloc v2.08.
