This is the NHS Digital (NHSD) National Disease Registers (NDR) Import ETL ruby gem, providing:
Add this line to your application's Gemfile:
gem 'ndr_import'
And then execute:
$ bundle
Or install it yourself by cloning the project, then executing:
$ gem install ndr_import.gem
Below is an example that extracts data from a PDF and transforms it into to a collection of records defined by their "klasses" and "fields":
require 'ndr_import/non_tabular/table'
require 'ndr_import/file/registry'
unzip_path = SafePath.new(...)
source_file = SafePath.new(...).join(...)
options = { 'unzip_path' => unzip_path }
table = NdrImport::NonTabular::Table.new(...)
# Use the Registry to enumerate over the files and their tables
files = NdrImport::File::Registry.files(source_file, options)
files.each do |filename|
tables = NdrImport::File::Registry.tables(filename, nil, options)
tables.each do |_tablename, table_content|
# Use the NonTabular::Table to tabulate the table_content
table.transform(table_content).each do |_klass, _fields, _index|
# Your code goes here
end
end
end
See test/readme_test.rb
for a more complete working example.
More information on the workings of the mapper are available in the wiki.
After checking out the repo, run bin/setup
to install dependencies. Then, run rake test
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.
git checkout -b my-new-feature
)git commit -am 'Add some feature'
)git push origin my-new-feature
)Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
All test data in this repository is fictitious. Any resemblance to real persons, living or dead, is purely coincidental although Mighty Boosh references have been used in some tests.
Note: Real codes exist in the tests, postcodes for example, but bear no relation to real patient data. Please ensure that you always only ever commit dummy data when contributing to this project.