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.1.0 Jcr Exchange - easy download and upload files to and from JCR

USAGE: je [FLAGS]

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

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

bash cargo install 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 = []

[instance] addr = "http://localhost:4502" user = "admin" pass = "admin" ```

Customize

ignore_properties - tell je which properties of .content.xml should be removed after downloading the content

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, you can omit this option if you don't need logs
  • you can add -d to set debug mode in which temporary packages uploaded to AEM won't be deleted to allow validation during debugging
  • for more options run je in command line
  • 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.