revamp pkg API

[sckott]

e.g,

• get metadata: sp_<data source>_meta (e.g., sp_bhl_meta)
• fetch full text: sp_<data source>_fetch (e.g., sp_bhl_fetch)
• save full text: sp_<data source>_save (e.g., sp_bhl_save)

perhaps simplify to:

• get metadata: sp_meta w/ S3 dispatch (e.g., sp_meta.bhl, sp_meta.plos, etc.)
• fetch full text: sp_fetch (e.g., sp_fetch)
• save full text: sp_save (e.g., sp_save)

eg.:

geom <- 'POLYGON((-124.07 41.48,-119.99 41.48,-119.99 35.57,-124.07 35.57,-124.07 41.48))'
sp_occ(geometry = geom, from = "idigbio") %>% 
  ~~sp_list()~~ # should get rid of sp_list probably, just pull out taxon list internally
  sp_meta() %>% 
  sp_fetch()

pseuocode

get occurrence data %>% 
    assert what you want to search on from occ. data %>% 
    search literature source, get metadata %>% 
    fetch full text %>% 

a) 
    save text to disk %>% 

b) 
    extract text %>% 
    tidy data %>% 
    plot/analyze