calorie tracker

Author: bowbahdoe

src/SUMMARY.md

@@ -47,6 +47,17 @@ battleship
 CLI Hangman
 Tic Tac Toe AI
 
+TODO App
+
+Task Description - data formats
+
+Approximate PI
+
+Pomodoro timer ()
+Terminal ANKI (might require threads)
+
+Simple REST API
+HTML
 -->
 
 # Modern Java
@@ -55,6 +66,7 @@ Tic Tac Toe AI
   - [Asking for Help](./prelude/asking_for_help.md)
   - [Toy Problems](./prelude/toy_problems.md)
   - [Lies](./prelude/lies.md)
+  - [AI](./prelude/ai.md)
 - [Getting Started](./getting_started.md)
 - [First Steps](./first_steps.md)
   - [Comments](./first_steps/comments.md)
@@ -168,11 +180,12 @@ Tic Tac Toe AI
   - [Challenges](./loops/challenges.md)
 
 # Concepts
-- [Software is an Interdisciplinary Field]()
 
 # Projects
 
-- [Calorie Tracker]()
+<!-- Software is an Interdisciplinary Field -->
+- [Prelude](./projects/prelude.md)
+- [Calorie Tracker](./projects/calorie_tracker.md)
 
 # Data Types II
 

src/prelude/ai.md

@@ -0,0 +1,13 @@
+# AI
+
+Do not use any form of AI when you are learning.
+
+I could go into exactly why or shadowbox against why you might think its a good idea,
+but instead I am just going to ask that you trust me.
+
+Don't do it.
+
+If you find it hard to resist the temptation, install something like [this](https://getcoldturkey.com/)
+on your machine to block yourself from accessing AI websites.
+
+When you get stuck reach out to a person for help.

src/projects/calorie_tracker.md

@@ -0,0 +1,51 @@
+# Calorie Tracker
+
+A calorie is the amount of energy needed to raise the temperature of 
+1 gram of water by 1 degree celcius. A kilo-calorie, often shortened to kcal,
+is one thousand calories.
+
+Food consumed by humans provides a certain amount of calories. Somewhat confusingly
+when people talk about "calories," as might be reported on food labels, they really mean
+kilo-calories.
+
+For most of the history of the human species food was not an abundant resource. As such
+when food is abundant our brains are predisposed to consuming as much of it as possible.
+This is a behavior likely evolved in order that one best withstand periods of famine.[^biology]
+
+The problem is that, while many places in the world still experience regular food shortages,
+many people have an extreme abundance of food available to them at all times. Not only that,
+the food they do have access to is often designed to be as addictive to consume as possible.
+
+As such many of these people gain extreme amounts of weight. 
+This, in turn, lead to many health problems.
+
+Whether someone gains or loses weight over a given period of time comes down to "CiCo" - Calories In, Calories Out.
+If someone eats more in calories than they burn they are at a calorie surplus and will gain weight.
+If someone eats fewer calories than they burn they are at a calorie deficit and will lose weight.
+
+There are also people out there in the world with the opposite problem. Not eating enough leads to starvation.
+Whether because of trauma, upbringing, or some other circumstance: some people will not naturally eat enough even
+when food is available to them.
+
+## Your Goal
+
+Your goal is to make a program that helps someone track the number of calories they have consumed
+in a given day.
+
+The intent is to help them be intentional about the number of calories they are consuming.
+
+We will count it as a success if the program you produce at least helps them track the total.
+
+## Future Goals
+
+When you learn enough to do the following, come back to this project and expand it.
+
+* Make it so that if the computer running the program is turned off they do not lose information
+* Expand the program to also help them record the macro-nutritional value of the food they ate
+* Expand the program to also let them track their weight over time
+* Make it so that they can track their progress over multiple days, months, or years
+* Anything else you can think of
+
+
+
+[^biology]: I am not an evolutionary biologist, but this is my understanding.

src/projects/prelude.md

@@ -0,0 +1,22 @@
+# Prelude
+
+Separate from the challenges at the end of each section I will be putting some projects
+sections throughout the book.
+
+While the purpose of the challenges is to make you practice what you just read,
+the purpose of the projects is for you to put that knowledge into action.
+
+This is for two reasons
+
+1. If you don't practice for real, it is very difficult to learn things.
+2. I want to drive home that software is an interdisciplinary field.
+
+The first reason means that, while be some early hand-holding, I largely expect
+you to put together projects on your own using what you have been shown.
+This means you will struggle. The hope is that in that struggle you are forced to learn,
+but you can always ask for help.
+
+By that second point I mean we make software to do things in the real world.
+To do this requires understanding who would use the software, why, and for what purpose.
+I am going to try my best to have projects that make you interact with the world outside
+of software construction.

src/standard_input/challenges.md

@@ -27,7 +27,7 @@ void main() {
     // 1. Call IO.readln to get their age
     // 2. Interpret their age as an int
     // 3. Add one to that age
-    // 2. Call IO.print/IO.println to say what age they will be next year
+    // 4. Call IO.print/IO.println to say what age they will be next year
 }
 ```
 
@@ -49,7 +49,7 @@ void main() {
 
 ## Challenge 4
 
-["Mad Libs"](https://en.wikipedia.org/wiki/Mad_Libs) are a word game where you ask people for nouns, verbs, and adjectives absent any context
+["Mad Libs"](https://en.wikipedia.org/wiki/Mad_Libs) are a word game where you ask people for nouns, verbs, adjectives, etc. absent any context
 and then fill them in to a template.
 
 For example
@@ -66,5 +66,5 @@ I saw a dog today and flew.
 Unfortunately the clown stopped me at the elephant.
 ```
 
-Make a program that asks a user for some nouns, verbs, etc. and produces
+Make a program that asks a user for some nouns, verbs, etc. and prints
 a Mad Lib using those words.

src/standard_input/characters.md

@@ -3,11 +3,11 @@
 If you expect someone to type a floating point value you can turn the `String`
 you get from `IO.readln` into a `double` using `Double.parseDouble`.
 
-```java,do_not_run
+```java,no_run
 void main() {
     String gpaString = IO.readln("What is your GPA? ");
     double gpa = Double.parseDouble(gpaString);
-    IO.println("You are " + age + " years old!");
+    IO.println("You're GPA is " + gpa);
 }
 ```
 

src/standard_input/floating_point_numbers.md

@@ -3,7 +3,7 @@
 If you expect someone to type an integer value you can turn the `String`
 you get from `IO.readln` into an `int` using `Integer.parseInt`.
 
-```java,do_not_run
+```java,no_run
 void main() {
     String ageString = IO.readln("How old are you? ");
     int age = Integer.parseInt(ageString);

src/standard_input/integers.md

@@ -3,7 +3,7 @@
 Just as you can turn a `String` into an `int` using `Integer.parseInt` and you can
 turn a `String` into a `double` using `Double.parseDouble`, you can use `Boolean.parseBoolean` to turn a `String` into a `boolean`.
 
-```java,do_not_run
+```java,no_run
 void main() {
     String happyString = IO.readln("Are you happy? ");
     boolean happy = Boolean.parseBoolean(happyString);
@@ -14,7 +14,7 @@ void main() {
 But lest you become too comfortable, know that there is no `Character.parseCharacter` to turn a `String` into a character.
 It is not always going to be the case that there is just one way to convert a `String` to any given type.
 
-```java,do_not_run,panics
+```java,no_run,panics
 void main() {
     String gradeString = IO.readln("What is your letter grade? ");
     // Does not exist!