AgentQ lets you automate your test driven relevancy cases via Quepid. Easily integrate testing your Solr or Elasticsearch search engine into your CI or Continuous Deployment pipeline. Be confident that you have highly relevant search results without the manual testing!
Run a Quepid case automatically from the command line by passing in a case number (4081
) and the score threshold for deciding if your search results pass or fail (10
):
> export QUEPID_PASSWORD=your_password
> agent_q 4081 10 [email protected] $QUEPID_PASSWORD http://app.quepid.com
Case o19s blog search (778) scored 10.0, which meets the threshold of 10
If the Q Score for the case meets the threshold, then AgentQ will return 0, otherwise it returns 1, which signifies to your CI system that there was a failure.
AgentQ is shipped as a simple Ruby gem that uses PhantomJS to programmatically interact with the rich web application hosted at Quepid.com. Start by installing PhantomJS. We use AgentQ to verify the search quality of our website. We added the gem to our Jekyll project:
# Support CI testing of search with Quepid
gem 'agent_q', '~> 0.0.10'
and then call AgentQ from CircleCI via this line in our circle.yml
file:
test:
override:
- bundle exec jekyll build
- bundle exec agent_q 4081 10 $QUEPID_USER $QUEPID_PASSWORD http://app.quepid.com
Just run the code locally via ./bin/agent_q
Read up on how to manage gems at https://guides.rubygems.org/make-your-own-gem/.
bundle install
gem build agent_q.gemspec
gem install ./agent_q-0.0.12.gem
agent_q 4081 10 [email protected] $QUEPID_PASSWORD http://app.quepid.com
To deploy to RubyGems:
gem push agent_q-0.0.12.gem