KeyValueChecker
key_value_checker
is a simple tool to check key value map.
For example, a value for a key has a value rule like number only.
Then create a rule and run a script to validate it.
Installation
Add this line to your application's Gemfile:
gem 'key_value_checker'
And then execute:
$ bundle
Or install it yourself as:
$ gem install key_value_checker
Usage
TODO: Write usage instructions here
Right now, exe/key_value_checker
in the package can help to use it.
- Prepare a rule file.
config:
compare_set:
separator: ','
rule_map:
a:
required: true
pattern:
- regex: '[0-9]+'
b:
required: false
pattern:
- equal: 1
c:
required: true
pattern:
- compare_set: '1,2,3'
Set key rule under rule_map. a
is a key. And if the key is not a required parameter,
then set required: false
, otherwise set required: true
. pattern
can accept several
rules. Right now, this tool can support, equal
, regex
, compare_set
.
-
equal
is to compare a value is the same or not using a string. -
regex
is to compare a value using regular expression. It is passed to Regexp. -
compare_set
is to compare split values. If1,2,3
is set, then compare key value data to check the value is match or not. This can help what value is not exist or not. The separator is set inconfig
values. Set like the above config.
Current support file format is like this:
a:123456
b:bar
c:2,3,4
Start a key text and then set a separator, :
. After that, set values.
- Run script
After preparing rule and param file, then run like this:
exe/key_value_checker -c rule.yaml -f params.txt
Right now, parameter rules can override. So, you can set several rules.
exe/key_value_checker -c rule.yaml,override_rule.yaml -f params.txt
From this, set a global rule and then each file depend rule can set.
Example output information is like this.
SUC: Regexp([0-9]+) match. key='a' 123456
ERR: Equal not match key='b'. 1
ERR: Not Equal set key='c'. rule_values - param_values = [1], param_values - rule_values: [4]
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/key_value_checker. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
The gem is available as open source under the terms of the MIT License.