{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "from IPython.display import Image"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Class Standard Methods (Fitting in)\n",
    "\n",
    "Here are some things we know about encapsulation as we know it in classes:\n",
    "\n",
    "- classes allow us to hide details from a programmer\n",
    "- classes are modular/portable as they are self-contained\n",
    "- classes provide an *interface* for their use, the methods defined in the class\n",
    "\n",
    "To this list, we want to add the idea of consistency:\n",
    "\n",
    "- a new class should be consistent with the rules and syntax of the language\n",
    "- a new class should respond to standard methods."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "from Rational import *"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We are going to show you how a user could *use* a user-defined class, a Rational number (fraction) class. \n",
    "\n",
    "The phrase `from Rational import *` means we are going to import all the names in the `Rational` module to the main namespace. Basically we are being lazy, so we don't have to preceed names with `Rational`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Sum of 1/2 and 3/5 is 11/10\n",
      "Difference between 1/2 and 3/5 is -1/10\n",
      "Is 1/2 == 3/5? False\n"
     ]
    }
   ],
   "source": [
    "r1 = Rational(1,2)\n",
    "r2 = Rational(3,5)\n",
    "r_sum = r1 + r2\n",
    "r_diff = r1 - r2\n",
    "print(\"Sum of {:s} and {:s} is {:s}\".format(r1,r2,r_sum))\n",
    "print(\"Difference between {:s} and {:s} is {:s}\".format(r1,r2,r_diff))\n",
    "print(\"Is {:s} == {:s}? {}\".format(r1,r2,r1 == r2))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Whatever the `Rational` class looks like inside, it sure acts normally on the outside (the interface)! I can print an instance, I can add and subtract two instances, I can check the equality of two instances, all using normal, expected Python operations.\n",
    "\n",
    "The `Rational` class fits into what a user might expect when they use it. When we do a *standard* thing to a `Rational` instance, like `print` or `+`, it works as we expect. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Introspection\n",
    "Before we can make our class behave in a *standard* way, we have to review the concept of an **overloaded** operator. Remember this?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "3\n",
      "himom\n"
     ]
    }
   ],
   "source": [
    "print(1 + 2)\n",
    "print(\"hi\" + \"mom\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "When we add two integers, Python knows to select *addition*. When we add two strings, Python knows to selection *concatenation*. How does Python know? Python (and we as Python programmers) can inspect the types of the two sides of the plus operator to determine what to do: addition for integers, concatenation for strings.\n",
    "\n",
    "### type vs. isinstance\n",
    "Python provides two operators for determining the type associated with a variable: `type` or `isinstance`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<class 'str'>\n",
      "<class 'int'>\n",
      "True\n",
      "False\n"
     ]
    }
   ],
   "source": [
    "my_int = 123\n",
    "my_str = 'abc'\n",
    "print(type(my_str))\n",
    "print(type(my_int))\n",
    "print(isinstance(my_int, int))\n",
    "print(isinstance(my_str, int))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here is a simple function that we can use to decide what operation to perform based on type"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [],
   "source": [
    "def overloaded_fn(param1, param2):\n",
    "    ''' special division. Return tuple of integral and remainder for ints. If not an int, try\n",
    "        to convert to two floats. If so, return tuple float and None, else tuple None, None '''\n",
    "    if type(param1)==int and isinstance(param2, int):\n",
    "        return param1//param2, param1%param2\n",
    "    else:\n",
    "        try:\n",
    "            p1 = float(param1)\n",
    "            p2 = float(param2)\n",
    "            return param1/param2, None  # return tuple for consistency\n",
    "        except ValueError:\n",
    "            return None,None   # can't do division"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "(0, 1)\n",
      "(0.5, None)\n",
      "(None, None)\n"
     ]
    }
   ],
   "source": [
    "print(overloaded_fn(1,2))\n",
    "print(overloaded_fn(1,2.0))\n",
    "print(overloaded_fn('a', 'b'))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Before Python can select which operation to perform associated with the plus sign, it must determine the types. This is how Python does it, and we will need this later for our own classes."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Standard operators\n",
    "Python has two classes of standard operators:\n",
    "\n",
    "* math operations (+, -, *, /, etc.)\n",
    "* collection operations ([], iteration, etc.)\n",
    "\n",
    "It maps the symbols used (such as +) to a set of pre-defined methods. There are well over 60 such methods, but we can get the basic ideas with just a few\n",
    "\n",
    "How does Python map + to a method?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image at 0x1036e2bd0>"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "Image(filename='images/add_method.png')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "There are two important points in the above diagram:\n",
    "\n",
    "* every operator has an associated method as provided by Python. For example:\n",
    "    * `+:__add__`\n",
    "    * `-:__sub__`\n",
    "    * etc. All begin and end with two underlines.\n",
    "    * you can only connect an operator to one of the existing methods (you can't make them up)\n",
    "* in the calling sequence (as the figure shows), the *lhs* of the operator is used to call the method and the *rhs* is passed as an operator\n",
    "    * Python does this translation automatically\n",
    "    * both forms are **exactly** equivalent, but the binary operator form is more convenient."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## A Clock class\n",
    "\n",
    "Here is a `Clock` class. It represents hours and minutes in each minute:\n",
    "\n",
    "* no more than 59 minutes\n",
    "* no more than 23 hours\n",
    "\n",
    "We will be able initialize, add and print a clock:\n",
    "\n",
    "* the `__init__` method is for construction\n",
    "* the `__add__` allows adding via the `+` opertor\n",
    "* the `__str__` operator returns a string from an instance. When a `print` function is called, Python looks for a way to convert the instance to a string, the `___str__` method."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Clock(object):\n",
    "    def __init__(self, hours=0, minutes=0):\n",
    "        ''' do conversion to make hours<24 and minutes<60'''\n",
    "        self.minutes = minutes%60\n",
    "        self.hours = (hours + minutes//60)%24\n",
    "    def __add__(self, rhs_clock):\n",
    "        '''returns a new Clock. constructor deals with hour and minute limits'''\n",
    "        hours = self.hours + rhs_clock.hours\n",
    "        minutes = self.minutes + rhs_clock.minutes\n",
    "        return Clock(hours,minutes)\n",
    "    def __str__(self):\n",
    "        ''' return a string of the form hh:mm'''\n",
    "        return '{:02d}:{:02d}'.format(self.hours, self.minutes)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "01:00\n",
      "01:01\n",
      "02:01\n"
     ]
    }
   ],
   "source": [
    "c1 = Clock(24,60)  # should be 1 hour, 0 minutes\n",
    "print(c1)\n",
    "c2 = Clock(1,1)\n",
    "print(c2)\n",
    "c3 = c1 + c2\n",
    "print(c3)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<__main__.Clock at 0x1036eea10>"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "c1"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "01:00\n"
     ]
    }
   ],
   "source": [
    "print(c1)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "__main__.Clock"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "type(c3)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}
