The FOCUS Converter is a command-line utility to convert billing data files from popular public cloud providers, such as Amazon Web Services, Microsoft Azure, Google Cloud and Oracle Cloud, into the common schema known as FOCUS. You can read the specification at FinOps-Open-Cost-and-Usage-Spec/FOCUS_Spec.
The converter is optimized for:
- Ability to act on the large files and wire formats provided by cloud providers.
- Comprehensibility of the conversion process which encodes an understanding of the specification as-written.
- Best-effort conversion where the appropriate data for FOCUS does not exist in the provider's data file.
- Modularity so that new types of billing data can be supported.
Want to add your own? See CONTRIBUTING.md
The FOCUS converter supports Python 3.9 and above. If you meet these requirements, you can install with pip:
pip install focus_converterAfter this, you will have a script called focus-converter in your path.
focus-converter convert --provider aws --data-path path/to/aws/parquet/cur/ --data-format parquet --parquet-data-format dataset --export-path /tmp/output/Use focus-converter list-providers to see the other providers that are supported.
- Clone this repository.
- Install Poetry if you don't have it.
- Run the following shell snippet:
cd focus_converter_base/
poetry install --only main --no-rootFrom here, you can use python -m focus_converter.main as a substitute for running the pre-installed focus-converter script, and test any changes in your copy of the repository.
This project is licensed under the terms of the MIT license.
We're excited to work together. Please see CONTRIBUTING.md for information on how to get started.