kibana/x-pack/plugins/enterprise_search
Scotty Bollinger 62833a35df
[Workplace Search] Add AddSourceLogic tests (#86334)
* Remove missed action calls

These were missed in the PR that split apart add_source_logic from source_logic. These 2 mthods aren’t even in this file. My mistake

* Change order of method calls

For some reason the test would not pass with the order of the methods the way they were. Changing the order to where the error callback is called first somehow made the test pass

* Fix bug where query params never set

Uncovered a bug while writing this test. After moving from ent-search to Kibana, it was discovered that the Kibana server did not work well with an empty question mark in the URL. The fix attempted to use lodash’s isEmpty metthod. The problem is that the URLSearchParams class instance created is not an object but has getter/setter functionality so isEmpty always returned true. This fixes it to actually work.

* Remove throw blocks

In ent-search we had to account for edge cases where the error state wasn’t bubbling up. One of these has been covered with global flash messages. The other will be tested at later date. A tech-debt item has been created.

Reference PRs:
https://github.com/elastic/ent-search/pull/394
https://github.com/elastic/ent-search/pull/701

* Export interfaces for use in tests

* Add tests for add_source_logic

* Remove weird import

I guess the IDE autocompleted that. Should not have been there

* Remove redundant test

This test was added before this comit when trying to get coverage for the throw blocks
7ca9c2b244

* Lint fixes
2020-12-18 10:32:13 -06:00
..
common
public [Workplace Search] Add AddSourceLogic tests (#86334) 2020-12-18 10:32:13 -06:00
server [Workplace Search] Migrate Sources Schema tree (#84847) 2020-12-03 10:13:22 -06:00
jest.config.js [Enterprise Search] Jest config & handy Jest script (#84839) 2020-12-17 08:19:33 -08:00
jest.sh [Enterprise Search] Jest config & handy Jest script (#84839) 2020-12-17 08:19:33 -08:00
kibana.json
README.md [Enterprise Search] Jest config & handy Jest script (#84839) 2020-12-17 08:19:33 -08:00

Enterprise Search

Overview

This plugin's goal is to provide a Kibana user interface to the Enterprise Search solution's products (App Search and Workplace Search). In it's current MVP state, the plugin provides the following with the goal of gathering user feedback and raising product awareness:

  • App Search: A basic engines overview with links into the product.
  • Workplace Search: A simple app overview with basic statistics, links to the sources, users (if standard auth), and product settings.

Development

  1. When developing locally, Enterprise Search should be running locally alongside Kibana on localhost:3002.
  2. Update config/kibana.dev.yml with enterpriseSearch.host: 'http://localhost:3002'
  3. For faster QA/development, run Enterprise Search on elasticsearch-native auth and log in as the elastic superuser on Kibana.

Kea

Enterprise Search uses Kea.js to manage our React/Redux state for us. Kea state is handled in our *Logic files and exposes values and actions for our components to get and set state with.

Advanced Kea usage

For the most part, we stick to the functionality described in Kea's core concepts. However, in some files, we also take advantage of props and events, as well as manually mounting some shared logic files on plugin init outside of React.

Debugging Kea

To debug Kea state in-browser, Kea recommends Redux Devtools. To facilitate debugging, we use the path key with snake_cased paths. The path key should always end with the logic filename (e.g. ['enterprise_search', 'some_logic']) to make it easy for devs to quickly find/jump to files via IDE tooling.

Testing

Unit tests

Documentation: https://www.elastic.co/guide/en/kibana/current/development-tests.html#_unit_testing

Jest tests can be run directly from the x-pack/plugins/enterprise_search folder. This also works for any subfolders or subcomponents.

yarn test:jest
yarn test:jest --watch

Unfortunately coverage collection does not work as automatically, and requires using our handy jest.sh script if you want to run tests on a specific folder and only get coverage numbers for that folder:

# Running the jest.sh script from the `x-pack/plugins/enterprise_search` folder (vs. kibana root)
# will save you time and allow you to Tab to complete folder dir names
sh jest.sh {YOUR_COMPONENT_DIR}
sh jest.sh public/applications/shared/kibana
sh jest.sh server/routes/app_search

E2E tests

See our functional test runner README.