# {py:mod}`ovo.core.utils.formatting`

```{py:module} ovo.core.utils.formatting
```

```{autodoc2-docstring} ovo.core.utils.formatting
:allowtitles:
```

## Module Contents

### Functions

````{list-table}
:class: autosummary longtable
:align: left

* - {py:obj}`format_duration <ovo.core.utils.formatting.format_duration>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.format_duration
    :summary:
    ```
* - {py:obj}`generate_id <ovo.core.utils.formatting.generate_id>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.generate_id
    :summary:
    ```
* - {py:obj}`get_hash_of_bytes <ovo.core.utils.formatting.get_hash_of_bytes>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.get_hash_of_bytes
    :summary:
    ```
* - {py:obj}`get_hashed_path_for_bytes <ovo.core.utils.formatting.get_hashed_path_for_bytes>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.get_hashed_path_for_bytes
    :summary:
    ```
* - {py:obj}`safe_filename <ovo.core.utils.formatting.safe_filename>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.safe_filename
    :summary:
    ```
* - {py:obj}`parse_args <ovo.core.utils.formatting.parse_args>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.parse_args
    :summary:
    ```
* - {py:obj}`get_alphanumeric_sort_key <ovo.core.utils.formatting.get_alphanumeric_sort_key>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.get_alphanumeric_sort_key
    :summary:
    ```
* - {py:obj}`sorted_alphanumeric <ovo.core.utils.formatting.sorted_alphanumeric>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.sorted_alphanumeric
    :summary:
    ```
* - {py:obj}`truncated_list <ovo.core.utils.formatting.truncated_list>`
  - ```{autodoc2-docstring} ovo.core.utils.formatting.truncated_list
    :summary:
    ```
````

### API

````{py:function} format_duration(td)
:canonical: ovo.core.utils.formatting.format_duration

```{autodoc2-docstring} ovo.core.utils.formatting.format_duration
```
````

````{py:function} generate_id(previous_ids: typing.Collection[str]) -> str
:canonical: ovo.core.utils.formatting.generate_id

```{autodoc2-docstring} ovo.core.utils.formatting.generate_id
```
````

````{py:function} get_hash_of_bytes(value: bytes) -> str
:canonical: ovo.core.utils.formatting.get_hash_of_bytes

```{autodoc2-docstring} ovo.core.utils.formatting.get_hash_of_bytes
```
````

````{py:function} get_hashed_path_for_bytes(value: bytes) -> str
:canonical: ovo.core.utils.formatting.get_hashed_path_for_bytes

```{autodoc2-docstring} ovo.core.utils.formatting.get_hashed_path_for_bytes
```
````

````{py:function} safe_filename(filename)
:canonical: ovo.core.utils.formatting.safe_filename

```{autodoc2-docstring} ovo.core.utils.formatting.safe_filename
```
````

````{py:function} parse_args(argv: list[str]) -> dict
:canonical: ovo.core.utils.formatting.parse_args

```{autodoc2-docstring} ovo.core.utils.formatting.parse_args
```
````

````{py:function} get_alphanumeric_sort_key(value: str) -> tuple
:canonical: ovo.core.utils.formatting.get_alphanumeric_sort_key

```{autodoc2-docstring} ovo.core.utils.formatting.get_alphanumeric_sort_key
```
````

````{py:function} sorted_alphanumeric(values: typing.Collection[str]) -> list[str]
:canonical: ovo.core.utils.formatting.sorted_alphanumeric

```{autodoc2-docstring} ovo.core.utils.formatting.sorted_alphanumeric
```
````

````{py:function} truncated_list(items: typing.Collection[typing.Any], max_items: int, sep: str = ', ') -> str
:canonical: ovo.core.utils.formatting.truncated_list

```{autodoc2-docstring} ovo.core.utils.formatting.truncated_list
```
````