Awesome
This project is unmaintained!
Note: This project is discontinued and has a successor at https://github.com/spinscale/alfred-workflow-elastic-docs.cr. Please go with that project instead.
Elasticsearch documentation alfred workflow
An alfred workflow, that queries the Elastic documentation and allows you to open the documentation in a browser directly from Alfred.
Note: You will need the Alfred Powerpack to use this workflow - which is commercial software. Check out the Alfred app website.
Download
You can download the workflow from the packal alfred workflow repository, if you don't want to build it yourself.
Note: You need to have node.js installed to get up and running. You can check by executing node --version, as you need a node version >= 12.0 (LTS was 12.18.1, when writing this).
Usage
The keyword to trigger the search in Alfred is elastic by default.
You can search across the whole documentation, or you can limit by a product by using something like elastic b beat. These are the available product abbreviations:
| Letter | Product |
|---|---|
b | libbeat |
mb | Metricbeat |
pb | Packetbeat |
wb | Winlogbeat |
fb | Filebeat |
jb | Journalbeat |
fb | Functionbeat |
e | Elasticsearch |
es | Elasticsearch |
l | Logstash |
ls | Logstash |
k | Kibana |
c | Cloud |
ece | Elastic Cloud Enterprise |
i | Infrastructure |
cs | Clients |
sw | App Search/Site Search |
a | APM |
apm | APM |
In addition when specifying a product, you can also specify a version like elastic w 2.3 execute watch
Packaging
You need the zip binary installed. Run npm install and then just run npm run package and you will end up with a elastic.alfredworkflow that you can open (doubleclick or call open on the command line) and import. Again, if you just want to use this workflow, download it from the packal repository linked above.
Development
In order to test your workflow it is easier to create a new workflow in Alfred, that points to your development repository with an absolute path pointing to the index.js file.
Alternatively you can run the tests to ensure everything works and use the index-cli.js tool to check the output against the suggest endpoint, which does not require you to import any workflow in Alfred at all.
In order to run your tests, just execute npm run test - which will use babel to convert the code to node4 compatible javascript, before running the tests against the created code. As the tests use later node.js features, you need a recent node.js version to actually run the tests (I used 6.3.0 for development).
License
This is licensed under Apache2 license, because open source...!
Thanks
- Colin for testing, feedback, fixes and documentation improvements.
- Sindre Sorhus for code improvements