Added simple descriptions to files missing descriptions (trekhleb#9)

Neil Lee · trekhleb · commit 96590be4758e · 2018-10-05T07:32:51.000+03:00
* Added simple descriptions to files missing descriptions at the top of the files.

Added simple descriptions/summary for test_class_objects.py, test_inheritance.py, test_method_objects.py, test_multiple_inheritance.py, test_file_methdos.py, test_file_reading.py, test_math.py

* removed trailing spaces
diff --git a/src/classes/test_class_objects.py b/src/classes/test_class_objects.py
@@ -1,6 +1,9 @@
 """Class Definition Syntax.
 
 @see: https://docs.python.org/3/tutorial/classes.html#class-objects
+
+After defining the class attributes to a class, the class object can be created by assigning the
+object to a variable. The created object would have instance attributes associated with it.
 """
 
 
diff --git a/src/classes/test_inheritance.py b/src/classes/test_inheritance.py
@@ -1,6 +1,9 @@
 """Inheritance
 
 @see: https://docs.python.org/3/tutorial/classes.html#inheritance
+
+Inheritance is one of the principles of object-oriented programming. Since classes may share a lot
+of the same code, inheritance allows a derived class to reuse the same code and modify accordingly
 """
 
 
diff --git a/src/classes/test_method_objects.py b/src/classes/test_method_objects.py
@@ -1,6 +1,9 @@
 """Class Definition Syntax.
 
 @see: https://docs.python.org/3/tutorial/classes.html#method-objects
+
+Classes can have two types of attribute references: data or methods. Class methods are called
+by [variable_name].[method_name]([parameters]) as opposed to class data which lacks the ().
 """
 
 
diff --git a/src/classes/test_multiple_inheritance.py b/src/classes/test_multiple_inheritance.py
@@ -1,6 +1,9 @@
 """Multiple Inheritance
 
 @see: https://docs.python.org/3/tutorial/classes.html#multiple-inheritance
+
+Some classes may derive from multiple classes. This means that the derived class would have
+its attributes, along with the attributes of all the classes that it was derived from.
 """
 
 
diff --git a/src/files/test_file_methdos.py b/src/files/test_file_methdos.py
@@ -1,6 +1,9 @@
 """Methods of File Objects
 
 @see: https://docs.python.org/3/tutorial/inputoutput.html#methods-of-file-objects
+
+Reading from a file does not always have to be sequential. There are methods to look for
+specific locations in the file, much like flipping to a page in a book.
 """
 
 
diff --git a/src/files/test_file_reading.py b/src/files/test_file_reading.py
@@ -1,6 +1,10 @@
 """Reading and Writing Files
 
 @see: https://docs.python.org/3/tutorial/inputoutput.html#reading-and-writing-files
+
+The process of reading and writing to a file is like finding a book and opening a book.
+First, the file is located, opened to the first page, then reading/writing begins until it reaches
+the end of the file.
 """
 
 
diff --git a/src/standard_libraries/test_math.py b/src/standard_libraries/test_math.py
@@ -1,6 +1,8 @@
 """Math.
 
 @see: https://docs.python.org/3/tutorial/stdlib.html#mathematics
+
+Math module is useful as many math functions are already implemented and optimized.
 """
 
 import math
