# maci.dumpraw

dumping raw data to file

Dumps any data raw to a file. This is helpful to easily dump data without writing extra boilerplate code just to dump data raw to a file. Nothing is returned. Creates a new or overwrites an existing file by default (See [append parameter](https://docs.macilib.org/docs/maci/functions/maci.dumpraw#append-bool) to change mode).

*Basic Example of dumping to a file using default positional parameters*

```python
maci.dumpraw('my.data', data)
```

In this example, we simply dump any raw data to a file using the dumpraw function and pass a string of the filepath to the file as the first argument to the function, then pass any data as the second argument to the function to be written to the file.

### parameters & arguments

Describes all parameter functionality and accepted data types

<details>

<summary>filename:  str | Path</summary>

First required positional argument. Accepts strings and [Path objects](https://docs.python.org/3/library/pathlib.html)

Use this parameter to point to your filepath

</details>

<details>

<summary>*data:  Any</summary>

Second required positional argument. Accepts any data type.&#x20;

This parameter accepts any number of positional arguments but must supply at least 1 at a minimum.

</details>

<details>

<summary>append:  bool</summary>

Optional parameter. Accepts booleans. Default = False. File must already exist.

Use this parameter to enable appending mode to write by appending data to the file. Default is disabled which writes new or overwrites a file.

</details>

<details>

<summary>byte_data:  bool</summary>

Optional parameter. Accepts booleans. Default = False

Use this parameter to set dumping your data to the file as bytes. Default is disabled as dumping the string representation is more common, but enable it if you need the data written as bytes.

</details>

<details>

<summary>newline_sep:  bool</summary>

Optional parameter. Accepts booleans. Default = True

Use this parameter to enable/disable the newline separator character set between each piece of data when passing more than 1 positional argument to [data](https://docs.macilib.org/docs/maci/functions/maci.dumpraw#data-any) parameter.

Default is enabled to receive a more expected or desirable result in the file.

</details>

<details>

<summary>encoding:  str | None</summary>

Optional parameter. Accepts strings or None. Default = None

Use this parameter to dump the data with the desired codec of the data if needed. The default uses the default of python, so you don't have to use this, but you can if the data needs to be written with a specific codec.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.macilib.org/docs/maci/functions/maci.dumpraw.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.