atandon0 / omnicalc

Omnicalc

The goal of this project is to get more practice with writing Ruby programs. You will execute the code simply by visiting a particular URL in your browser. Your visit will trigger the execution of the Ruby code, and the output will appear in your browser window.

Target

Ultimately, you will build this application:

http://omnicalc-target.herokuapp.com/

It is a collection of calculators that do various things; count the number of words in a block of text, the monthly payment for a loan, etc. Over time, we may add more and more calculators if we feel like it (if you have a suggestion for a calculator you think we should add, please let us know).

Setup

1. First, FORK THIS REPO TO YOUR OWN ACCOUNT.

2. Then clone your fork (Open in Desktop) to download it to your computer.

3. Navigate to the folder you downloaded in Terminal.

4. Open up the entire folder in Atom.

5. In Terminal,

   bundle install
   

6. If you receive an error on the bundle install, let us know right away.

7. Once that is complete,

   rails server
   

8. If the server doesn't start up successfully, you probably have an old app running somewhere. Find the old window or tab and close it. Then try rails server from within the omnicalc folder again.

9. Once the server has successfully started up, in Chrome, go to http://localhost:3000.

10. If all went well, you should see the New Word Count form. If not, let us know right away.

11. Type in some text and submit the form.

12. On the results page, you will currently see just a bunch of placeholders.

13. In Atom, find the /app/controllers/calculations_controller.rb file.

14. Locate the part of the file that looks like this:

    def word_count
      @text = params[:user_text]
      @special_word = params[:user_word]
    
      # ================================================================================
      # Your code goes below.
      # The text the user input is in the string @text.
      # The special word the user input is in the string @special_word.
      # ================================================================================
    
    
      @character_count_with_spaces = "Replace this string with your answer."
    
      @character_count_without_spaces = "Replace this string with your answer."
    
      @word_count = "Replace this string with your answer."
    
      @occurrences = "Replace this string with your answer."
    end
    

15. The code between the def word_count and end is the program that gets executed. I have already written some code that retrieves the inputs from the form and places them into variables for you to use, @text and @special_word.

16. Your job is to write code below the comments and, ultimately, store the correct values in the variables I created at the bottom of the method. For example, to solve the first part, call .length on the user's input, @text, and assign the result to @character_count_with_spaces.

    @character_count_with_spaces = @text.length
    

17. You have to figure out how to calculate the correct value for the rest: @character_count_without_spaces, @word_count, and @occurrences. Don't change the names of these variables; if you do, your results won't appear in the browser in the end.

18. Refresh the results page in your browser to re-run your code and see new output.

19. You can write as much or as little code as it takes to produce the correct answer; create intermediate variables if you want, or do anything else that you learned about from class. It's all just the same Ruby as before.

20. To see how you are doing and to submit your work, open a new Terminal window and navigate back to the same folder. (Leave your rails server running in the original window.) Then run the command rails grade. The first time you run this command, it will ask you for your personal access token, which you need to copy from the assignment page in Canvas.

21. You should see a progress report pop open.

22. Next, work on the Loan Payment calculator. You'll again be working in the same file, /app/controllers/calculations_controller.rb. This time, scroll down to the method def loan_payment and write your code in there as indicated by the comments.

23. Some tasks are easier, some are much harder. For example, in the Descriptive Statistics calculator, finding the mode (the number that occurs most frequently in a list of numbers) is surprisingly hard. Do your best, but don't get discouraged if you can't quite solve it.

24. For the mode calculation, just worry about the simplest case; when there's one number that occurs most frequently, that should be shown as the mode. I won't be testing the case that there's a tie.

25. Commit and sync your work often in the GitHub Desktop app (I usually do so when I finish a task, so that I can embark on the next task freely and know that if I mess things up I can just go back to the previous snapshot.)

26. Run rails grade as often as you like to see how you are doing, and at the end to get your final score into Canvas.

27. Ask lots of questions!