# Transformers

Transformers manipulate row data and either replace the existing values or add new columns to each row depending on the type of transformer and the configuration.

Currently supported transformers are :

- ToUpperCaseTransformer
- FakerTransformer

## FakerTransformer

### Options

| option  | description                                                  |
| ------- | ------------------------------------------------------------ |
| columns | Array of column transformations                              |
| locale  | See https://fakerjs.dev/guide/localization for valid locales |

### Usage

```js
FakerTransformer({
  columns: [
    {
      name: "column2",
      faker: "company.name",
    },
  ],
});
```

faker is a string value that can be any of the currently supported [apis](https://fakerjs.dev/api/)

e.g.

- finance.accountName
- person.firstName
- randomizer.next

To create UK post code

```js
FakerTransformer({
  columns: [
    {
      name: "column2",
      faker: "location.zipCode",
    },
  ],
  locale: "en_GB",
});
```

### Example

examples/csv-faker.js

## ToUpperCaseTransformer

### Options

| option | description                     |
| ------ | ------------------------------- |
| column | source column to be transformed |

### Usage

```js
ToUpperCaseTransformer({
  column: "column2",
});
```

### Example

examples/csv-to-upper-case.js

## StringReplaceTransformer

### Options

| option  | description                             |
| ------- | --------------------------------------- |
| column  | source column to be transformed         |
| find    | search string to be replaced            |
| replace | value to replace the search string with |

### Usage

```js
StringReplaceTransformer([
  {
    column: "column2",
    find: "'",
    replace: "''",
  },
]);
```

### Example

examples/csv-find-replace.js