Metadata-Version: 2.1
Name: avro-byte-counter
Version: 0.1.0
Summary: Count number of bytes per field
License: MIT
Author: Louis Fruleux
Author-email: louis.fruleux1@gmail.com
Requires-Python: >=3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: avro (>=1.11.1,<2.0.0)
Description-Content-Type: text/markdown

# Getting started

Install with `pip install avro-byte-counter`
And run the following script.

```python3
from avro.io import *
import io

from avro_byte_counter.avro_byte_counter import AvroByteCounter

schema = avro.schema.parse("""{
    "type": "record",
    "name": "Person",
    "fields": [
        {"name": "userName",       "type": "string"},
        {"name": "favoriteNumber", "type": ["null", "long"], "default": null},
        {"name": "interests",      "type": {"type": "array", "items": "string"}}
    ]
}
""")

# Write bytes
writer = DatumWriter(schema)
bytes_writer = io.BytesIO()
writer.write(
    {"userName": "Martin", "favoriteNumber": 1337, "interests": ["hacking", "daydreaming"]},
    BinaryEncoder(bytes_writer)
)

# Count bytes per field
raw_bytes = bytes_writer.getvalue()
avro_byte_counter = AvroByteCounter(schema)
byte_count_per_field = avro_byte_counter.count_byte_per_field(raw_bytes)
print(byte_count_per_field)
```

For flamegraph compatible format, run:

```python
from avro_byte_counter.utils import count_to_flamegraph_format
print(*count_to_flamegraph_format(byte_count_per_field), sep='\n')
```

## Generate flamegraph

You can combine the python file created  in `getting started` with the `flamegraph.pl` script to generate a flamegraph.

```shell
curl https://raw.githubusercontent.com/brendangregg/FlameGraph/d9fcc272b6a08c3e3e5b7919040f0ab5f8952d65/flamegraph.pl # any version is fine
chmod +x flamegraph.pl
python run myscript.py | ./flamegraph.pl --countname bytes > profiles/flamegraph.svg 
```

## Installation troubleshoot

Some users might need to add some flags to the `pip` command, such as `--user` or `--no-build-isolation`.
You can also try to install by cloning this repo and install with `poetry` directly.
If you still have issues or identified ones, don't hesitate to open an issue or a PR and ping me on it.

## Feedbacks
I gladly take feedbacks you have regarding the API, the usefulness of the project or anything :)


