FOCUS (FinOps Open Source Cost and Usage Specification) Validator

Validator resource for checking datasets against the FOCUS specification.

Overview

tbd

Environment Setup

Prerequisites

• Python 3.9+
• Poetry (Package & Dependency Manager)

Installation

1. Install Poetry

If you haven't installed Poetry yet, you can do it by running:

curl -sSL https://install.python-poetry.org | python3 -

For alternative installation methods or more information about Poetry, please refer to the official documentation.

2. Clone the repository

git clone https://github.com/finopsfoundation/focus-spec-validator.git
cd focus-spec-validator

3. Install dependencies

Using Poetry, you can install the project's dependencies with:

poetry install

Usage

Activate the virtual environment:

poetry shell

Validations can be run using cli application focus-validator.

For help and more options:

focus-validator --help

Running Tests

If you have tests for your project, you can run them with:

poetry run pytest

Ensure you have pytest defined as a development dependency in your pyproject.toml.

If running on legacy CPUs and the tests crash on the polars library, run the following locally only:

poetry add polars-lts-cpu

This will align the polars execution with your system hardware. It should NOT be committed back into the repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.