Skip to content

Commit

Permalink
post-publish-automatic
Browse files Browse the repository at this point in the history
  • Loading branch information
bhagyas committed Oct 28, 2018
1 parent a2a8032 commit 903aed5
Show file tree
Hide file tree
Showing 2 changed files with 146 additions and 1 deletion.
143 changes: 143 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,143 @@
# Alfresco CLI - Command line interface for Alfresco

> Interact with the Alfresco repository with an interactive command line.
## Target Audience

- Alfresco Developers and Architects

## Installation

### From NPM

- Run `npm install -g alfresco-cli`

### From GitHub

- Clone the repository

- Install using `npm install -g && npm link`

## Features

- Performs Alfresco operations from the terminal.

- Autocompletes node names for valid operations.

- Performs glob pattern matching for filename related operations.

- Maintains a session with a valid token, automatically persists within terminal sessions.

- Maintains a local command history

## Usage

- Call `alfresco-cli` from your terminal.

### Logging in

Type `login --help` to read the help on logging in to the system and fetch an authentication token for the CLI.

### Changing into a node

Use `cd <nodeId>`, where nodeId is the node ID of the nodeRef you want to change to.

### Listing contents (chldren) within a node

Use `ls` or `ls <nodeId>` to list contents within a node.

### Uploading files

Use `upload <filePath> [destinationNodeId]` to upload new files to Alfresco.

### Search for contents

Use `search <query> [language]` to search for contents.

### Commands and Operations

- Login

- Logout

- List files

- List sites

- Upload files

- Download files \[TBD\]

- View Metadata

### Aliases Reference

You can use the following aliases within commands.

- `.` - current folder/content

- `..` - parent folder/content

## License

MIT License

## Author

- Bhagya Nirmaan Silva (about.me/bhagyas)

## Development Sponsors

- [Loftux AB](http://loftux.com)

## Privacy Policy

There are no analytics gathered upon the use of the tool. However, the author reserves the right to add analytics on a later release to improve features provided by the tool.

## Contributors

None

## Version History

- 1.3 - 20181028

- **Major:** Improved `login` command.

- 1.2.3 - 20181026

- Added search results auto completion in the results history.

- Added `alias set|clear` commands for adding aliases for search queries.

- Added glob pattern matching for `list` and `delete` commands.

- 1.2.2 - 20181026

- Added better `delete` function with confirmation prompt.

- Added `undo delete` to restore last deleted node.

- 1.2.1 - 20181025

- Added `list versions` command.

- 1.2 - 20181025

- **Major:** Adding folder name auto completion

- Added `delete` command with support for deleting child nodes.

- 1.1 - 20181024

- Converted the code to Typescript

- Added support for node name as an alias for nodeId when referred from a valid context.

- Added `create user`, `create site`, `cd-site`, `search` commands.

- Added support for `.` and `..` aliases.

- 1.0 - 20181023

- Initial release
4 changes: 3 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,9 @@
"test": "echo \"Error: no test specified\" && exit 1",
"prepublishOnly": "npm run build && sh md-gen.sh",
"version": "npm run build && git add -A",
"postversion": "git push && git push --tags"
"postversion": "git push && git push --tags",
"commit": "git add -A && git commit -m 'post-publish-automatic' && npm run postversion",
"postpublish" : "npm run commit"
},
"author": "Bhagya Nirmaan Silva",
"license": "MIT",
Expand Down

0 comments on commit 903aed5

Please sign in to comment.