R package to use the Noun Project API
np_credentials(your_appname, your_key, your_secret) # This function puts the NounProject details into your enviroment variables. # Equivalent of that would be to set up and export values for the following variables: # NOUNS_API_APPNAME, NOUNS_API_KEY, NOUNS_API_SECRET
To display a single icon that you know the index of, use the
That will open the RStudio Viewer and present you icon number
To display many icons based on your query, use
display_many_icons("car") # by default there are 4 icons displayed in loop display_many_icons("car", 6) # displays 6 first icons from the nounproject database
Instead of visiting the Noun Project website all the time, you can use this RStudio addin which will help you to find the icon you are particulalry interested in. By default addin displays 20 most relevant searches for icons with public domain license only.
TO run it, simply go to
Addins > Noun Project in your RStudio.
For more advanced usecases, have a look at some examples below.
# this should download and show the icon of a plane res <- get_nouns_api("icon/609") get_png(res) # this should download and show the icon of four dogs # make the url url <- nounprojectR::make_term_endpoint("dog", num_of_imgs = 4) # hit the Noun Project server res <- get_nouns_api(url) # extract the JSON file result <- httr::content(res) # show the images get_pngs_and_show(result)
Issues and contributions
Please raise issues if you need help or would like to make comments.
We welcome new contributions! Please read our Code of Conduct first.
This project was inspired by the Hacktoberfest 2018. Check out Hacktoberfest GitHub blog and support the event in the following editions.