Metadata-Version: 2.4
Name: cscs-tools
Version: 0.0.1
Summary: Utilities library
Author: Csaba Cselko
Author-email: Csaba Cselko <lendoo73dev@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/lendoo73/cscs-tools
Project-URL: Repository, https://github.com/lendoo73/cscs-tools
Project-URL: Issues, https://github.com/lendoo73/cscs-tools/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# cscs

Utility library for managing and retrieving version information from a `version.json` file.

## 📦 Installation

Install from PyPI:

```bash
pip install cscs
```

## 🚀 Usage

Place a `version.json` in your project root:

```json
{
  "major": 0,
  "minor": 2,
  "patch": 1,
  "inherit": true
}
```

Then use it like this:

```python
from cscs.version.services.version_service import VersionService

service = VersionService()  # Automatically finds version.json upwards
version = service.get_version()
print(version.str_repr())
```

Or specify the file path manually:

```python
service = VersionService(file="path/to/my_ver.custom")
```

## 🧱 JSON Structure

The required structure of the `version.json` file is:

```json
{
  "major": 0,
  "minor": 2,
  "patch": 1,
  "inherit": true
}
```

## 📝 License

MIT © Csaba Cselko
