About the App
Downloading jquery using yarn or npm: Npm is the package which has registered jquery in it. These npm packages can be installed by making use of npm command on CLI. Npm install jquery. If you do not want to make use of npm package installer, you can also make use of yarn. Yarn add jquery. The second version helps you update code to run on jQuery 3.0 or higher, once you have used Migrate 1.x and upgraded to jQuery 1.9 or higher: Download the compressed, production jQuery Migrate 3.3.0. Download the uncompressed, development jQuery Migrate 3.3.0. Link Cross-Browser Testing with jQuery. I've saved my absolute favorite site for last. First, just look at that design, it's wonderfully unique and comforting. Using one of the most creative jQuery scripts I have ever seen, KM has a 'foliage-o-meter' slider where sliding it either increases or decreases the foliage and design of the theme, depending on the direction the slider is moved.
- App name: jq
- App description: Lightweight and flexible command-line JSON processor
- App website: https://stedolan.github.io/jq/
Install the App
- Press
Command+Space
and type Terminal and press enter/return key. - Run in Terminal app:
ruby -e '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)' < /dev/null 2> /dev/null
and press enter/return key.
If the screen prompts you to enter a password, please enter your Mac's user password to continue. When you type the password, it won't be displayed on screen, but the system would accept it. So just type your password and press ENTER/RETURN key. Then wait for the command to finish. - Run:
brew install jq
Done! You can now use jq
.
Similar Software for Mac
Most of the popular API and data services use the JSON data format, so we'll learn how it's used to serialize interesting information, and how to use the jq to parse it at the command-line.
JSON - a lightweight data format
JSON stands for JavaScript Object Notation and is nearly ubiquitous as a data format, for its lightweight nature and (relatively) ease of human-readability.
Using jq
jq is a program described as 'sed
for JSON data':
You can use it to slice and filter and map and transform structured data with the same ease that sed, awk, grep and friends let you play with text.
Installing jq
If you've haven't installed the pup HTML parsing tool, or any other tool which required you to edit your ~/.bashrc
's' PATH
and create the ~/bin_compciv
directory, then follow the instructions here: Installing programs for your personal Stanford account.
To install jq:
Check out the tutorial on jq here. The full manual can be found here.
JSON compared to CSV
JSON is more verbose, but easier to read than CSV.
CSV:
JSON:
Objects and attribute-value pairs
Inherent to the JSON data format is the ability to encapsulate data structures known as Objects consisting of attribute-value pairs
The object below has the attributes first_name
and last_name
, with the values of John
and Smith
, respectively:
JSON objects can also contain Arrays, which can be thought of as lists of elements. Below, the things_carried
attribute has an Array containing apples
, hat
, and harmonica
.
What makes JSON more flexible than flat data structures (such as CSV and other spreadsheet-type formats) is the ability to nest objects and arrays:
Sen. Joni Ernst as a JSON object
The unitedstates/congress-legislators Github repo contains a wealth of useful, serialized information about the U.S. Congress. From their current legislators file, I've extracted the entry for newly-elected Senator Joni Ernst and converted it to a JSON, which you can download here.
The formatted output:
Senator Ernst is new to Congress (and the first woman to represent Iowa in Congress), so her JSON-object representation is brief enough for now to read on one page. The object includes 4 nested objects, under the attributes, id
, name
, bio
, terms
.
Use jq to view each of these attributes separately, by prepending a dot to the desired attribute:
Nested objects
To access a nested attribute, for example, the first
part of the name
object, simply list the attributes in sequence:
Arrays
Think of an array as a list. In JSON, square brackets are used to enclose an array of objects or values. Below, the attribute fruits points to an array of string values, 'apples'
, 'oranges'
, 'pears'
:
In the case of the Congressmember JSON, each member has a terms
attribute, pointing to an array of objects that look like this:
Here, we use jq's notation to access Senator Ernst's terms
as an attribute: take care to notice the square brackets which denote the array that is contained in terms
:
Because Senator Ernst has so far served only one term, there is only one object in the .terms
array. However, trying to access the start
attribute, using just the dot notation for attributes, will result in an error:
Accessing objects in an array
Jq Mac Brew
The individual objects in an array are indexed by number, starting from zero. In other words, if we want to get the start attribute for Senator Ernst's 1st term, we tell jq that we want the 0th element, and we use the square bracket notation when accessing an array, in this case, the terms
array.
In the result below, take particular note of the lack of square brackets: by specifying a specific element in terms
, we get a single object in return:
Now try to retrieve the start
attribute:
Try accessing the 1st element in terms
; if Senator Ernst has only served one term, and that term is accessible via the 0th element, think to yourself what the 1st element in the terms
array will contain:
Rep. Nancy Pelosi as a JSON object
The terms
array for Sen. Ernst is still an array, even with one object. But let's see how an array of multiple objects works: we can use Rep. Nancy Pelosi as an example, as she's been in Congress for multiple terms:
How many terms has Pelosi served, exactly? There may be a specific filter in jq that returns a count, but let's just use the good ol' wc tool and pipe the result of jq into it:
All of Congress
You can continue to practice your JSON selectors. Or just move on to the entire Congress, because what we've learned so far should apply to all Congressmember objects.
With the JSON files for Rep. Pelosi and Sen. Ernst, we were dealing with single Congressmember objects. This legislators.json
contains an array of those Congressmember objects. So this query to find the name
attribute will fail:
So we have to use the array selector (the []
) to access individual objects. To find the name
object of the first Congressmember object (again, remember that elements in the array are numbered starting with 0
):
Keep playing with jq and check out its manual for more examples. We've just gone over some of the concepts on how JSON is structured. In later exercises, we'll use some of jq's more advanced features.
Testing the Github API
Just another example of JSON data to parse:
Status endpoint
Check out Github's status page, which has some nice visualizations about their current uptime and response speed.
Here's the API and JSON format that is behind that page: status.github.com/api
To get the current status as raw JSON:
Passing it through jq's parser, with the most basic option, will make it look nicer (with colors):
Jq For Mac Os
Do some basic selection:
Select both elements:
The jq tool outputs formatted text that looks nice, but often we just need it in a raw form that can be filtered into our other command-line tools – notice how the --raw-output
option removes the quotation marks from the output:
Commits endpoint
Mac Operating System Download
As per the jq tutorial, you can take a look at what Github records when you push your commits to your compciv
repo:
Jq For Mac Pro
If you're really that interested in Github's API and its other endpoints, check out the documentation here.