About

Small utility for uploading/downloading content to/from running AEM instance.

It's intended to be used as an external tool for IntelliJ IDEA to make content synchronization easier.

```bash ❯ je je 0.2.0 Jcr Exchange - easy download and upload files to and from JCR

USAGE: je [FLAGS] [OPTIONS]

FLAGS: -d, --debug If enabled, deployed to AEM packages are left intact (are not deleted) to allow investigation -h, --help Prints help information -V, --version Prints version information -v, --verbose Enables logs: -v - enables INFO log level -vv - enables DEBUG log level

OPTIONS: -p, --profile Profile selection

SUBCOMMANDS: get Downloads content to local file system help Prints this message or the help of the given subcommand(s) init Initializes configuration file put Uploads content to AEM instance ```

Installation

Standard installation

• go to releases page
• download the latest je archive for your OS
• extract it
• include path to je executable into your PATH variable

Rust programmers

Install

bash cargo install je

Upgrade

bash cargo install --force je

Configuration

Default

Configuration file is not required. Without it, je will use default configuration. However, you can still initialize config and change it. The default configuration is also the initial one:

``` ❯ je init ❯ cat .je ignore_properties = []

[[profile]] name = "author" addr = "http://localhost:4502" user = "admin" pass = "admin" ```

Customize

• general:

  • ignore_properties - tell je which properties of .content.xml should be removed after downloading the content; it uses contains method to match lines to be removed

• profile section - you can add multiple profiles, each with settings:

  • name - name of the profile, later it can be used with --profile option to specify which instance is the target; if not specified, the first profile from the config is used
  • addr - address of the instance, including port if domain is not available
  • user - user used to authenticate to AEM instance
  • pass - password used to authenticate to AEM instance

IntelliJ Setup

Add je commands:

1. Go to Settings -> Tools -> External Tools.
2. Add new external tool using + sign.
3. Configure the tool like on the screenshot below.

Similarly add and configure je put command:

Notes

• if you don't have je in PATH, you can set full path in Program input
• Arguments input:
  • -vv - sets verbose level, -vv means DEBUG log level, -v means INFO log level; it's optional
  • --profile - sets target profile; if not provided, first profile from config will be used
  • -d - sets debug mode in which temporary packages uploaded to AEM won't be deleted to allow validation during debugging; it's optional
  • subcommand (put or get)
  • $FilePath$ - IntelliJ variable which will be substituted during command execution, its absolute path to a file on which command is executed
• Working directory input:
  • set to $ProjectFileDir$ allows running je from the project root
  • keep in mind that je will try to read config file from the set working directory

License

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

See CONTRIBUTING.md for hints on how to contribute to je.