semvec/pypi-packages huggingface dataset:
llamasheets-cli 0.1.0
Add your description here
Requires Python: >=3.10

# LlamaSheets CLI

A command-line tool for parsing spreadsheet files using [LlamaSheets](https://developers.llamaindex.ai/python/cloud/llamasheets/getting_started/).  
Supports `.xls` and `.xlsx` files, with options for advanced extraction and metadata generation.

## Installation

```bash
pip install llamasheets-cli
```

Or, with uv, you can do directly:

```bash
uv tool install llamasheets-cli
```

## Usage

### 1. Authenticate

Before using the CLI, you must authenticate with your LlamaCloud API key.

```bash
sheets auth --token <YOUR_API_KEY>
```
Or, for more secure input:
```bash
sheets auth --stdin
```
You will be prompted to enter your API key securely.

> _If an API key is already configured, you will be warned and asked if you want to overwrite it._

### 2. Parse a Spreadsheet

Once authenticated, you can parse a spreadsheet:

```bash
sheets parse --file path/to/your.xlsx
```

**Options**

- `--file`, `-f` **(required)**: Path to the `.xls` or `.xlsx` file to process.
- `--sheet`, `-s`: Name of the sheet(s) to process. Can be used multiple times. Defaults to all sheets.
- `--include-hidden-cells/--no-include-hidden-cells`: Include hidden cells in extraction. Default: `--include-hidden-cells`
- `--extraction-range`: A1 notation of the range to extract (e.g., `A1:D20`). Default: entire sheet.
- `--generate-additional-metadata/--no-generate-additional-metadata`: Generate extra metadata (title, description) for each region. Default: `--generate-additional-metadata`
- `--use-experimental-processing/--no-use-experimental-processing`: Enable experimental processing. Default: `--no-use-experimental-processing`
- `--flatten-hierarchical-tables/--no-flatten-hierarchical-tables`: Flatten hierarchical tables. Default: `--no-flatten-hierarchical-tables`
- `--table-merge-sensitivity [strong|weak]`: How aggressively to merge similar regions. Default: `strong`
- `--save-csv/--no-save-csv`: Save results as CSV files in the `parsed/` folder. Default: `--save-csv`

**Example**

```bash
sheets parse -f data.xlsx -s Sheet1 -s Sheet2 --extraction-range A1:D20 --no-save-csv
```

**Output**

- Results are displayed in your terminal with markdown formatting.
- If `--save-csv` is enabled, CSV files are saved in the `parsed/` directory, named after the extracted region titles.


## License and Contributions

This project is distributed under the [MIT License](./LICENSE).

Contributions are welcome and encouraged, and should follow the guidelines in [CONTRIBUTING.md](./CONTRIBUTING.md).
celery-types 0.24.0
Type stubs for Celery and its related packages
Requires Python: <4,>=3.10
Keywords: celery, kombu, vine, amqp, billiard, django_celery_results, types, mypy, stubs

# celery-types [![PyPI](https://img.shields.io/pypi/v/celery-types.svg)](https://pypi.org/project/celery-types/)

Type stubs for celery related projects:

- [`celery`](https://github.com/celery/celery)
- [`django-celery-results`](https://github.com/celery/django-celery-results)
- [`amqp`](http://github.com/celery/py-amqp)
- [`kombu`](https://github.com/celery/kombu)
- [`billiard`](https://github.com/celery/billiard)
- [`vine`](https://github.com/celery/vine)
- [`ephem`](https://github.com/brandon-rhodes/pyephem)

## install

```shell
pip install celery-types
```

You'll also need to monkey patch `Task` so generic params can be provided:

```python
from celery.app.task import Task
Task.__class_getitem__ = classmethod(lambda cls, *args, **kwargs: cls) # type: ignore[attr-defined]
```

## dev

### initial setup

```shell
# install uv (https://docs.astral.sh/uv/)
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### regular development

```shell
uv sync
```
```shell
# run formatting, linting, and typechecking
s/lint
```
or
```shell
uv run ruff check --fix
uv run ruff format
uv run basedpyright typings tests
uv run mypy tests
```
```shell
# build and publish
uv build && uv publish
```

### pre-commit

The project uses [pre-commit](https://pre-commit.com/) for code quality checks:

```shell
# install pre-commit hooks
uv run prek install

# run all checks manually
uv run prek run --all-files
```

### tooling

- [ruff](https://docs.astral.sh/ruff/) — formatting and linting
- [basedpyright](https://docs.basedpyright.com/) — type checking
- [mypy](https://mypy.readthedocs.io/) — type checking

## related

- <https://github.com/sbdchd/django-types>
- <https://github.com/sbdchd/djangorestframework-types>
- <https://github.com/sbdchd/mongo-types>
- <https://github.com/sbdchd/msgpack-types>