# sfdx-profiles-splitter

> sfdx-profiles-splitter ==

Latest version **0.1.0** (published 2018-10-27) · MIT license · 0 weekly downloads

## Install

```sh
npm install sfdx-profiles-splitter
pnpm add sfdx-profiles-splitter
yarn add sfdx-profiles-splitter
bun add sfdx-profiles-splitter
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 0.1.0 |
| Published | 2018-10-27 |
| First published | 2018-10-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8.0.0 |
| Dependencies | 8 |
| Unpacked size | 195.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 20 |
| Author | Amir Hafeez @lodossDev |
| Maintainers | lodoss118 |
| Keywords | sfdx-plugin |

## Links

- npm: https://www.npmjs.com/package/sfdx-profiles-splitter
- Repository: https://github.com/lodossDev/sfdx-profiles-splitter
- Issues: https://github.com/lodossDev/sfdx-profiles-splitter/issues
- npm.io page: https://npm.io/package/sfdx-profiles-splitter

## Dependencies (8)

- [tslib](https://npm.io/package/tslib.md) 1
- [xml-js](https://npm.io/package/xml-js.md) ^1.6.8
- [@oclif/config](https://npm.io/package/@oclif/config.md) 1
- [@oclif/errors](https://npm.io/package/@oclif/errors.md) 1
- [@types/xml-js](https://npm.io/package/@types/xml-js.md) ^1.0.0
- [@oclif/command](https://npm.io/package/@oclif/command.md) 1
- [@types/fs-extra](https://npm.io/package/@types/fs-extra.md) ^5.0.4
- [@salesforce/command](https://npm.io/package/@salesforce/command.md) 0.1.6

## Recent versions

- 0.1.0 (latest) — 2018-10-27

## README

sfdx-profiles-splitter
==

A plugin for splitting and merging Salesforce profiles.

## Setup

### Install from source

1. Install the SDFX CLI.

2. Clone the repository: `git clone git@github.com:lodossDev/sfdx-profiles-splitter.git`

3. (Yarn)Install npm modules: `yarn install`

4. Link the plugin: `sfdx plugins:link .`

### Install as plugin

1. Install plugin: `sfdx plugins:install sfdx-profiles-splitter`

## Usage
<!-- usage -->
```sh-session
$ npm install -g sfdx-profiles-splitter
$ sfdx COMMAND
running command...
$ sfdx (-v|--version|version)
sfdx-profiles-splitter/0.1.0 darwin-x64 node-v8.12.0
$ sfdx --help [COMMAND]
USAGE
  $ sfdx COMMAND
...
```
<!-- usagestop -->

<!-- commands -->
* [`sfdx metadata:profiles:convert`](#sfdx-metadataprofilesconvert)
* [`sfdx metadata:profiles:merge`](#sfdx-metadataprofilesmerge)
* [`sfdx metadata:profiles:split`](#sfdx-metadataprofilessplit)

## `sfdx metadata:profiles:convert`

Converts full profiles into json or xml format.

```
USAGE
  $ sfdx metadata:profiles:convert

OPTIONS
  -d, --delete                                    Delete the profiles once converted?
  -f, --format=format                             (required) the output format i.e. json|xml.

  -i, --input=input                               (required) [default: force-app/main/default/profiles] the input
                                                  directory.

  -o, --output=output                             (required) [default: force-app/main/default/profiles] the output
                                                  directory.

  --json                                          format output as json

  --loglevel=(trace|debug|info|warn|error|fatal)  logging level for this command invocation

EXAMPLE

           sfdx metadata:profiles:convert -f json -i force-app/main/default/profiles -o force-app/main/default/test
           //Converts full profiles into json or xml, !!!! does not split !!!!.
```

_See code: [src/commands/metadata/profiles/convert.ts](https://github.com/lodossDev/sfdx-profiles-splitter/blob/v0.1.0/src/commands/metadata/profiles/convert.ts)_

## `sfdx metadata:profiles:merge`

Merge profiles that were split.

```
USAGE
  $ sfdx metadata:profiles:merge

OPTIONS
  -d, --delete                                    Delete the splitted profiles once merged?

  -i, --input=input                               (required) [default: force-app/main/default/profiles] the input
                                                  directory where the splitted profiles exist.

  -o, --output=output                             (required) [default: force-app/main/default/profiles] the output
                                                  directory to store the full profiles.

  --json                                          format output as json

  --loglevel=(trace|debug|info|warn|error|fatal)  logging level for this command invocation

EXAMPLE

           sfdx metadata:profiles:merge -i force-app/main/default/profiles -o force-app/main/default/test
           //Merges profiles located in specified input dir and copies them into the output dir.
```

_See code: [src/commands/metadata/profiles/merge.ts](https://github.com/lodossDev/sfdx-profiles-splitter/blob/v0.1.0/src/commands/metadata/profiles/merge.ts)_

## `sfdx metadata:profiles:split`

Split profiles into smaller parts.

```
USAGE
  $ sfdx metadata:profiles:split

OPTIONS
  -d, --delete                                    Delete the existing profiles once converted?

  -i, --input=input                               (required) [default: force-app/main/default/profiles] the input
                                                  directory where the full profiles exist.

  -o, --output=output                             (required) [default: force-app/main/default/profiles] the output
                                                  directory to store the chunked profiles.

  --json                                          format output as json

  --loglevel=(trace|debug|info|warn|error|fatal)  logging level for this command invocation

EXAMPLE

           sfdx metadata:profiles:split -i force-app/main/default/profiles -o force-app/main/default/test
           //Splits profiles located in specified input dir and copies them into the output dir.
```

_See code: [src/commands/metadata/profiles/split.ts](https://github.com/lodossDev/sfdx-profiles-splitter/blob/v0.1.0/src/commands/metadata/profiles/split.ts)_
<!-- commandsstop -->

---
_Source: https://npm.io/package/sfdx-profiles-splitter · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
