awk/gigasecond: download exercise

awk/gigasecond/.exercism/config.json

@@ -0,0 +1,19 @@
+{
+  "authors": [
+    "glennj"
+  ],
+  "files": {
+    "solution": [
+      "gigasecond.awk"
+    ],
+    "test": [
+      "test-gigasecond.bats"
+    ],
+    "example": [
+      ".meta/example.awk"
+    ]
+  },
+  "blurb": "Given a moment, determine the moment that would be after a gigasecond has passed.",
+  "source": "Chapter 9 in Chris Pine's online Learn to Program tutorial.",
+  "source_url": "https://pine.fm/LearnToProgram/?Chapter=09"
+}

awk/gigasecond/.exercism/metadata.json

@@ -0,0 +1 @@
+{"track":"awk","exercise":"gigasecond","id":"15ebf667ca9143cba77122c6c2b47b91","url":"https://exercism.org/tracks/awk/exercises/gigasecond","handle":"vpayno","is_requester":true,"auto_approve":false}

awk/gigasecond/HELP.md

@@ -0,0 +1,99 @@
+# Help
+
+## Running the tests
+
+Each exercise contains a test file.
+Run the tests using the `bats` program.
+```bash
+bats test-hello-world.bats
+```
+
+`bats` will need to be installed.
+See the [Testing on the Bash track][bash] page for instructions to install `bats` for your system.
+
+### bats is implemented in bash
+
+The bats file is a bash script, with some special functions recognized by the `bats` command.
+You'll see some tests that look like
+```sh
+gawk -f some-exercise.awk <<< "some,input,here"
+```
+That `<<<` syntax is a bash [Here String][here-string].
+It sends the string on the right-hand side into the standard input of the program on the left-hand side.
+It is ([approximately][so]) the same as
+```sh
+echo "some,input,here" | gawk -f some-exercise.awk
+```
+
+## Help for assert functions
+
+The tests use functions from the [bats-assert][bats-assert] library.
+Help for the various `assert*` functions can be found there.
+
+## Skipped tests
+
+Solving an exercise means making all its tests pass.
+By default, only one test (the first one) is executed when you run the tests.
+This is intentional, as it allows you to focus on just making that one test pass.
+Once it passes, you can enable the next test by commenting out or removing the
+
+    [[ $BATS_RUN_SKIPPED == true ]] || skip
+
+annotations prepending other tests.
+
+## Overriding skips
+
+To run all tests, including the ones with `skip` annotations, you can run:
+```bash
+BATS_RUN_SKIPPED=true bats test-some-exercise.bats
+```
+
+It can be convenient to use a wrapper function to save on typing: in `bash` you can do:
+```bash
+bats() {
+    BATS_RUN_SKIPPED=true command bats *.bats
+}
+```
+Then run tests with just:
+```bash
+bats
+```
+
+[bash]: https://exercism.org/docs/tracks/bash/tests
+[bats-assert]: https://github.com/bats-core/bats-assert
+[here-string]: https://www.gnu.org/software/bash/manual/bash.html#Here-Strings
+[so]: https://unix.stackexchange.com/a/80372/4667
+
+## Submitting your solution
+
+You can submit your solution using the `exercism submit gigasecond.awk` command.
+This command will upload your solution to the Exercism website and print the solution page's URL.
+
+It's possible to submit an incomplete solution which allows you to:
+
+- See how others have completed the exercise
+- Request help from a mentor
+
+## Need to get help?
+
+If you'd like help solving the exercise, check the following pages:
+
+- The [AWK track's documentation](https://exercism.org/docs/tracks/awk)
+- [Exercism's programming category on the forum](https://forum.exercism.org/c/programming/5)
+- The [Frequently Asked Questions](https://exercism.org/docs/using/faqs)
+
+Should those resources not suffice, you could submit your (incomplete) solution to request mentoring.
+
+Places to look for help for AWK questions:
+
+* [Stack Overflow `awk` tag][so].
+* check the Resources section of the [Stack Overflow `awk` tag into page][so-info].
+* raise an issue at the [exercism/awk][github] Github repository.
+* IRC: `irc://irc.liberachat.net/#awk`, `irc://irc.liberachat.net/#exercism`
+    * see [Libera.chat][libera] if you're unfamiliar with IRC.
+
+
+[so]: https://stackoverflow.com/tags/awk
+[so-info]: https://stackoverflow.com/tags/awk/info
+[github]: https://github.com/exercism/awk
+[libera]: https://libera.chat

awk/gigasecond/README.md

@@ -0,0 +1,56 @@
+# Gigasecond
+
+Welcome to Gigasecond on Exercism's AWK Track.
+If you need help running the tests or submitting your code, check out `HELP.md`.
+
+## Introduction
+
+The way we measure time is kind of messy.
+We have 60 seconds in a minute, and 60 minutes in an hour.
+This comes from ancient Babylon, where they used 60 as the basis for their number system.
+We have 24 hours in a day, 7 days in a week, and how many days in a month?
+Well, for days in a month it depends not only on which month it is, but also on what type of calendar is used in the country you live in.
+
+What if, instead, we only use seconds to express time intervals?
+Then we can use metric system prefixes for writing large numbers of seconds in more easily comprehensible quantities.
+
+- A food recipe might explain that you need to let the brownies cook in the oven for two kiloseconds (that's two thousand seconds).
+- Perhaps you and your family would travel to somewhere exotic for two megaseconds (that's two million seconds).
+- And if you and your spouse were married for _a thousand million_ seconds, you would celebrate your one gigasecond anniversary.
+
+~~~~exercism/note
+If we ever colonize Mars or some other planet, measuring time is going to get even messier.
+If someone says "year" do they mean a year on Earth or a year on Mars?
+
+The idea for this exercise came from the science fiction novel ["A Deepness in the Sky"][vinge-novel] by author Vernor Vinge.
+In it the author uses the metric system as the basis for time measurements.
+
+[vinge-novel]: https://www.tor.com/2017/08/03/science-fiction-with-something-for-everyone-a-deepness-in-the-sky-by-vernor-vinge/
+~~~~
+
+## Instructions
+
+Your task is to determine the date and time one gigasecond after a certain date.
+
+A gigasecond is one thousand million seconds.
+That is a one with nine zeros after it.
+
+If you were born on _January 24th, 2015 at 22:00 (10:00:00pm)_, then you would be a gigasecond old on _October 2nd, 2046 at 23:46:40 (11:46:40pm)_.
+
+## Time functions
+
+This exercise requires using GNU awk's [Time Functions][time-func].
+
+For the datetime parsing and formatting functions, be sure to set the UTC flag.
+
+[time-func]: https://www.gnu.org/software/gawk/manual/html_node/Time-Functions.html
+
+## Source
+
+### Created by
+
+- @glennj
+
+### Based on
+
+Chapter 9 in Chris Pine's online Learn to Program tutorial. - https://pine.fm/LearnToProgram/?Chapter=09