ExtractExifGps
extractexifgps
is an application to extract EXIF GPS data from all the images
in a given directory.
Installation
gem install extractexifgps
Example Usage
extractexifgps > images_in_current_directory.csv
extractexifgps /some/directory/ > images_in_some_directory.csv
# CSV format
extractexifgps csv ./
extractexifgps -C ./ # short alias
extractexifgps csv -r ./ # file images recursively
extractexifgps csv -o /path/to/output.csv ./ # write directly to a file
# HTML format
extractexifgps html ./
extractexifgps -H ./ # short alias
extractexifgps html -r ./ # file images recursively
extractexifgps html -o /path/to/output.html ./ # write directly to a file
extractexifgps html -t /path/to/template.erb ./ # use a custom ERB template
HTML Templates
extractexifgps
comes with a default template to generate a decent-looking
HTML table, but you can supply your own
ERB template to
generate any kind of HTML file you like. See the built-in
templates/basic.html.erb as an example template.
Command-line Help
You can get information about the command-line interface in general, or for specific commands:
extractexifgps help
extractexifgps help csv
extractexifgps help html
Development
Testing
A few Rake commands will help your testing:
-
rake test
: Run the test suite -
rake lint
: Run the code linters -
rake simplecov
: Run the code coverage reporter -
rake
: Run all tests, linters, and code coverage reporters
To facilitate development, consider running guard
in the background while you
work. Whenver a source file it changed, it will automatically run the relevent
tests. This will provide you immediate test feedback at all times.
Documentation
Generate code docs with:
rake doc
Contributing to ExtractExifGps
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
- Fork the project.
- Start a feature/bugfix branch.
- Commit and push until you are happy with your contribution.
- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
- Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.