Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adobe/reactor-sync
A repository for syncing a local directory with a property in Adobe Experience Platform Tags.
https://github.com/adobe/reactor-sync
Last synced: 4 months ago
JSON representation
A repository for syncing a local directory with a property in Adobe Experience Platform Tags.
- Host: GitHub
- URL: https://github.com/adobe/reactor-sync
- Owner: adobe
- License: apache-2.0
- Archived: true
- Created: 2019-09-19T19:52:52.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-08T17:27:25.000Z (10 months ago)
- Last Synced: 2024-04-15T03:27:19.115Z (10 months ago)
- Language: JavaScript
- Homepage:
- Size: 42 KB
- Stars: 11
- Watchers: 16
- Forks: 10
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-adobe-launch - reactor-sync - A command line tool for syncing data to and from Adobe Launch to a local directory. (Using Launch)
- awesome-adobe-launch - reactor-sync - A command line tool for syncing data to and from Adobe Launch to a local directory. (Using Launch)
README
# reactor-sync
:warning: **This repo is no longer maintained** Due to time constraints, I am no longer maintaining this repository any longer. I'm archiving it and leaving it read-only so that you can use it as an example of how you might implement something like this on your own. Feel free to fork and modify it to your needs.
Command line tool for syncing data to and from Adobe Launch to a local directory.
## Usage
Before running the sync tool, you must first have [Node.js](https://nodejs.org/en/) installed on your computer. Your npm version (npm comes bundled with Node.js) will need to be at least 10.15.0. You can check the installed version by running the following command from a command line:
```
npm -v
```
You will also need to be authorized to use the Launch APIs. This is done by first creating an integration through Adobe I/O. Please see the [Access Tokens Guide](https://developer.adobelaunch.com/api/guides/access_tokens/) for detailed steps on creating an integration and procuring api access rights.
Finally, you must first have created a property in Adobe Launch to sync with and have a settings file that has all of your integration and environment settings.
Once you have a property ready to sync, have a settings file, and have an integraton created through Adobe I/O that can access the Adobe Launch APIs, you can use the bootstrapper tool in either a question-answer format or by passing information through command line arguments.
### Command Line commands
There are 2 different commands that this tool comes with:
#### sync
The first command is `sync`. You can use it as follows:
```
npx @adobe/reactor-sync sync
```
This is the default command so you can also run this tool without specifying the sync command:
```
npx @adobe/reactor-sync
```
This command will first run a diff of what you have on your local machine and then what is in Launch. It will calculate what it needs to push and what it needs to pull to your local machine. Then it will performs those operations on your behalf and get them in sync.
#### diff
The second command is `diff`. You can use it as follows:
```
npx @adobe/reactor-sync diff
```
This command will only run the diff and give you an output of what is different between your local machine and what is in Launch. It will also give you a better idea of what will happen if you run `sync` before you do so.
### Command Line Arguments
The named parameters are as follows:
##### --settings-path
The location to save the settings. The file name should end in ".json". (defaults to ./reactor-settings.json)
## Suggested Uses
This tool can be used in many ways, but here are a few suggested uses:
- If you are already storing the code that goes into Launch in repositories, this tool will be your best friend.
- Set up a git hook whenever you commit or push code to run reactor-sync.
- Set up a git app that keeps thins in sync both to and from your repo using this tool.
- Setup a workflow of pushing code into Launch without having to copy and past manually
- Run automated tests to ensure that your code doesn't have any obvious errors.
- Run transpiles on your code automatically and then automatically sync it into Launch.
- Run linters or code style enforcement tools to ensure that your code is always clean and you can always point to who is writing code in Launch that doesn't stay to standards.
If you have other use cases, let me know and I can update this list.
### Contributing
Contributions are welcomed! Read the [Contributing Guide](CONTRIBUTING.md) for more information.
## Licensing
This project is licensed under the Apache V2 License. See [LICENSE](LICENSE.md) for more information.