10/14/23, 10:18 PM Project: 0x0C.

Python - Almost a circle | Addis Ababa Intranet

You have a captain's log due before 2023-10-15 (in about 23 hours)! Log it now!
(/captain_logs/4174757/edit)

(/)

(/plann

(/projec
0x0C. Python - Almost a circle
(/corre
Python OOP

?(/dashb
 By: Guillaume

 Weight: 1

 Project will start Oct 12, 2023 6:00 AM, must end by Oct 17, 2023 6:00 AM
(/dash
 Checker will be released at Oct 16, 2023 6:00 PM

(/conce
 Manual QA review must be done (request it when you are done with the project)

 An auto review will be launched at the deadline

(/dash

(/serve
Background Context
(https://alx-
 The AirBnB project is a big part of the Higher level curriculum. This project will help you be ready for it.
(/user_
students.slack.com)
In this project, you will review everything about Python:


(https://discord.com/app)
(/dash Import
Exceptions
Class
(/users/my_profile)

Private attribute
(/user
https://intranet.alxswe.com/projects/331 1/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

Getter/Setter
Class method
Static method
(/) Inheritance
Unittest
Read/Write file

You will also learn about:

args and kwargs

Serialization/Deserialization
JSON

(https://alx-
students.slack.com)

Resources
(https://discord.com/app)
Read or watch:

args/kwargs (/rltoken/7gc6UzxSL81HcuAwklUbuQ)
(/users/my_profile)

JSON encoder and decoder (/rltoken/rGVU9mt57rVURGnjK6n4_Q)
https://intranet.alxswe.com/projects/331 2/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

unittest module (/rltoken/soictNXCPE18ASL3INoeew)

Python test cheatsheet (/rltoken/uI9iskBCcNo5pc7j9Vy86A)

(/)
Learning Objectives
At the end of this project, you are expected to be able to explain to anyone (/rltoken/SBdRhGGBuqzWcwcuKyapSQ),
without the help of Google:

General
What is Unit testing and how to implement it in a large project
How to serialize and deserialize a Class
How to write and read a JSON file
What is *args and how to use it
What is **kwargs and how to use it
How to handle named arguments in a function

Copyright - Plagiarism
You are tasked to come up with solutions for the tasks below yourself to meet with the above learning objectives.
You will not be able to meet the objectives of this or any following project by copying and pasting someone else’s
work.
You are not allowed to publish any content of this project.
Any form of plagiarism is strictly forbidden and will result in removal from the program.

Requirements
Python Scripts
(https://alx-
Allowed editors: vi , vim , emacs
students.slack.com)
All your files will be interpreted/compiled on Ubuntu 20.04 LTS using python3 (version 3.8.5)
All your files should end with a new line
 (https://discord.com/app)
The first line of all your files should be exactly #!/usr/bin/python3
A README.md file, at the root of the folder of the project, is mandatory
Your code should use the pycodestyle (version 2.8.* )
(/users/my_profile)

All your files must be executable

https://intranet.alxswe.com/projects/331 3/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

The length of your files will be tested using wc

All your modules should be documented: python3 -c 'print(__import__("my_module").__doc__)'
All your classes should be documented: python3 -c 'print(__import__("my_module").MyClass.__doc__)'
(/) All your functions (inside and outside a class) should be documented: python3 -c
'print(__import__("my_module").my_function.__doc__)' and python3 -c
'print(__import__("my_module").MyClass.my_function.__doc__)'
A documentation is not a simple word, it’s a real sentence explaining what’s the purpose of the module, class or
method (the length of it will be verified)

Python Unit Tests

Allowed editors: vi , vim , emacs
All your files should end with a new line
All your test files should be inside a folder tests
You have to use the unittest module (/rltoken/soictNXCPE18ASL3INoeew)
All your test files should be python files (extension: .py )
All your test files and folders should start with test_
Your file organization in the tests folder should be the same as your project: ex: for models/base.py , unit tests must
be in: tests/test_models/test_base.py
All your tests should be executed by using this command: python3 -m unittest discover tests
You can also test file by file by using this command: python3 -m unittest tests/test_models/test_base.py
We strongly encourage you to work together on test cases so that you don’t miss any edge case

Tasks
0. If it's not tested it doesn't work mandatory
(https://alx-
students.slack.com)
All your files, classes and methods must be unit tested and be PEP 8 validated.

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 4/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ python3 -m unittest discover tests

...................................................................................
...................................................................................
(/) .......................
----------------------------------------------------------------------
Ran 189 tests in 13.135s

OK
guillaume@ubuntu:~/$

Note that this is just an example. The number of tests you create can be different from the above example.

Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: tests/

 Done? Help  Get a sandbox

1. Base class mandatory

Write the first class Base :

Create a folder named models with an empty file __init__.py inside - with this file, the folder will become a Python
package

Create a file named models/base.py :

(https://alx-
Class Base :
students.slack.com)
private class attribute __nb_objects = 0
class constructor: def __init__(self, id=None): :
 (https://discord.com/app)if id is not None , assign the public instance attribute id with this argument value - you can assume
id is an integer and you don’t need to test the type of it

(/users/my_profile)
otherwise, increment __nb_objects and assign the new value to the public instance attribute id 
https://intranet.alxswe.com/projects/331 5/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

This class will be the “base” of all other classes in this project. The goal of it is to manage id attribute in all your future
classes and to avoid duplicating the same code (by extension, same bugs)

(/) guillaume@ubuntu:~/$ cat 0-main.py

#!/usr/bin/python3
""" 0-main """
from models.base import Base

if __name__ == "__main__":

b1 = Base()
print(b1.id)

b2 = Base()
print(b2.id)

b3 = Base()
print(b3.id)

b4 = Base(12)
print(b4.id)

b5 = Base()
print(b5.id)

guillaume@ubuntu:~/$ ./0-main.py
1
2
3
12
4
(https://alx-
guillaume@ubuntu:~/$
students.slack.com)

(https://discord.com/app)
Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
(/users/my_profile)

https://intranet.alxswe.com/projects/331 6/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

File: models/base.py, models/__init__.py

(/)  Done? Help  Get a sandbox

2. First Rectangle mandatory

Write the class Rectangle that inherits from Base :

In the file models/rectangle.py

Class Rectangle inherits from Base
Private instance attributes, each with its own public getter and setter:
__width -> width
__height -> height
__x -> x
__y -> y
Class constructor: def __init__(self, width, height, x=0, y=0, id=None) :
Call the super class with id - this super call with use the logic of the __init__ of the Base class
Assign each argument width , height , x and y to the right attribute

Why private attributes with getter/setter? Why not directly public attribute?

Because we want to protect attributes of our class. With a setter, you are able to validate what a developer is trying to
assign to a variable. So after, in your class you can “trust” these attributes.

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 7/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 1-main.py

#!/usr/bin/python3
""" 1-main """
(/) from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(10, 2)
print(r1.id)

r2 = Rectangle(2, 10)
print(r2.id)

r3 = Rectangle(10, 2, 0, 0, 12)
print(r3.id)

guillaume@ubuntu:~/$ ./1-main.py
1
2
12
guillaume@ubuntu:~/$

Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/rectangle.py

(https://alx-
 Done? Help
students.slack.com)
3. Validate attributes mandatory

(https://discord.com/app)
Update the class Rectangle by adding validation of all setter methods and instantiation ( id excluded):

If the input is not an integer, raise the TypeError exception with the message: <name of the attribute> must be
(/users/my_profile)

an integer . Example: width must be an integer

https://intranet.alxswe.com/projects/331 8/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

If width or height is under or equals 0, raise the ValueError exception with the message: <name of the
attribute> must be > 0 . Example: width must be > 0
If x or y is under 0, raise the ValueError exception with the message: <name of the attribute> must be >= 0 .
(/) Example: x must be >= 0

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 9/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 2-main.py

#!/usr/bin/python3
""" 2-main """
(/) from models.rectangle import Rectangle

if __name__ == "__main__":

try:
Rectangle(10, "2")
except Exception as e:
print("[{}] {}".format(e.__class__.__name__, e))

try:
r = Rectangle(10, 2)
r.width = -10
except Exception as e:
print("[{}] {}".format(e.__class__.__name__, e))

try:
r = Rectangle(10, 2)
r.x = {}
except Exception as e:
print("[{}] {}".format(e.__class__.__name__, e))

try:
Rectangle(10, 2, 3, -1)
except Exception as e:
print("[{}] {}".format(e.__class__.__name__, e))

guillaume@ubuntu:~/$ ./2-main.py
[TypeError] height must be an integer
(https://alx-
[ValueError] width must be > 0
students.slack.com)
[TypeError] x must be an integer
[ValueError] y must be >= 0
 guillaume@ubuntu:~/$
(https://discord.com/app)

(/users/my_profile)

Repo:

https://intranet.alxswe.com/projects/331 10/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/rectangle.py
(/)

 Done? Help

4. Area first mandatory

Update the class Rectangle by adding the public method def area(self): that returns the area value of the Rectangle
instance.

guillaume@ubuntu:~/$ cat 3-main.py

#!/usr/bin/python3
""" 3-main """
from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(3, 2)
print(r1.area())

r2 = Rectangle(2, 10)
print(r2.area())

r3 = Rectangle(8, 7, 0, 0, 12)
print(r3.area())

guillaume@ubuntu:~/$ ./3-main.py
6
(https://alx-
20
students.slack.com)
56
guillaume@ubuntu:~/$
(https://discord.com/app)

Repo:
(/users/my_profile)

GitHub repository: alx-higher_level_programming

https://intranet.alxswe.com/projects/331 11/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

Directory: 0x0C-python-almost_a_circle
File: models/rectangle.py

(/)
 Done? Help

5. Display #0 mandatory

Update the class Rectangle by adding the public method def display(self): that prints in stdout the Rectangle
instance with the character # - you don’t need to handle x and y here.

guillaume@ubuntu:~/$ cat 4-main.py

#!/usr/bin/python3
""" 4-main """
from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(4, 6)
r1.display()

print("---")

r1 = Rectangle(2, 2)
r1.display()

guillaume@ubuntu:~/$ ./4-main.py
####
####
####
(https://alx-
####
students.slack.com)
####
####
---
(https://discord.com/app)
##
##
guillaume@ubuntu:~/$
(/users/my_profile)

https://intranet.alxswe.com/projects/331 12/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

Repo:

(/) GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/rectangle.py

 Done? Help

6. __str__ mandatory

Update the class Rectangle by overriding the __str__ method so that it returns [Rectangle] (<id>) <x>/<y> -
<width>/<height>

guillaume@ubuntu:~/$ cat 5-main.py

#!/usr/bin/python3
""" 5-main """
from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(4, 6, 2, 1, 12)
print(r1)

r2 = Rectangle(5, 5, 1)
print(r2)

guillaume@ubuntu:~/$ ./5-main.py
[Rectangle] (12) 2/1 - 4/6
(https://alx-
[Rectangle] (1) 1/0 - 5/5
students.slack.com)
guillaume@ubuntu:~/$

(https://discord.com/app)
Repo:

GitHub repository: alx-higher_level_programming

(/users/my_profile)

Directory: 0x0C-python-almost_a_circle
https://intranet.alxswe.com/projects/331 13/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

File: models/rectangle.py

(/)  Done? Help

7. Display #1 mandatory

Update the class Rectangle by improving the public method def display(self): to print in stdout the Rectangle
instance with the character # by taking care of x and y

guillaume@ubuntu:~/$ cat 6-main.py

#!/usr/bin/python3
""" 6-main """
from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(2, 3, 2, 2)
r1.display()

print("---")

r2 = Rectangle(3, 2, 1, 0)
r2.display()

guillaume@ubuntu:~/$ ./6-main.py | cat -e

$
$
##$
##$
(https://alx-
##$
students.slack.com)
---$
###$
###$
(https://discord.com/app)
guillaume@ubuntu:~/$

(/users/my_profile)

Repo:
https://intranet.alxswe.com/projects/331 14/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/rectangle.py
(/)

 Done? Help

8. Update #0 mandatory

Update the class Rectangle by adding the public method def update(self, *args): that assigns an argument to each
attribute:

1st argument should be the id attribute

2nd argument should be the width attribute
3rd argument should be the height attribute
4th argument should be the x attribute
5th argument should be the y attribute

This type of argument is called a “no-keyword argument” - Argument order is super important.

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 15/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 7-main.py

#!/usr/bin/python3
""" Doc """
(/) from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(10, 10, 10, 10)

print(r1)

r1.update(89)
print(r1)

r1.update(89, 2)
print(r1)

r1.update(89, 2, 3)
print(r1)

r1.update(89, 2, 3, 4)
print(r1)

r1.update(89, 2, 3, 4, 5)
print(r1)

guillaume@ubuntu:~/$ ./7-main.py
[Rectangle] (1) 10/10 - 10/10
[Rectangle] (89) 10/10 - 10/10
[Rectangle] (89) 10/10 - 2/10
[Rectangle] (89) 10/10 - 2/3
[Rectangle] (89) 4/10 - 2/3
(https://alx-
[Rectangle] (89) 4/5 - 2/3
students.slack.com)
guillaume@ubuntu:~/$

(https://discord.com/app)
Repo:
(/users/my_profile)
GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
https://intranet.alxswe.com/projects/331 16/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

File: models/rectangle.py

(/)  Done? Help

9. Update #1 mandatory

Update the class Rectangle by updating the public method def update(self, *args): by changing the prototype to
update(self, *args, **kwargs) that assigns a key/value argument to attributes:

**kwargs can be thought of as a double pointer to a dictionary: key/value

As Python doesn’t have pointers, **kwargs is not literally a double pointer – describing it as such is just a
way of explaining its behavior in terms you’re already familiar with
**kwargs must be skipped if *args exists and is not empty
Each key in this dictionary represents an attribute to the instance

This type of argument is called a “key-worded argument”. Argument order is not important.

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 17/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 8-main.py

#!/usr/bin/python3
""" 8-main """
(/) from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(10, 10, 10, 10)

print(r1)

r1.update(height=1)
print(r1)

r1.update(width=1, x=2)
print(r1)

r1.update(y=1, width=2, x=3, id=89)

print(r1)

r1.update(x=1, height=2, y=3, width=4)

print(r1)

guillaume@ubuntu:~/$ ./8-main.py
[Rectangle] (1) 10/10 - 10/10
[Rectangle] (1) 10/10 - 10/1
[Rectangle] (1) 2/10 - 1/1
[Rectangle] (89) 3/1 - 2/1
[Rectangle] (89) 1/3 - 4/2
guillaume@ubuntu:~/$

(https://alx-
students.slack.com)
Repo:

GitHub repository: alx-higher_level_programming

 (https://discord.com/app)
Directory: 0x0C-python-almost_a_circle
File: models/rectangle.py

(/users/my_profile)

https://intranet.alxswe.com/projects/331 18/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

 Done? Help

(/) 10. And now, the Square! mandatory

Write the class Square that inherits from Rectangle :

In the file models/square.py

Class Square inherits from Rectangle
Class constructor: def __init__(self, size, x=0, y=0, id=None): :
Call the super class with id , x , y , width and height - this super call will use the logic of the __init__ of
the Rectangle class. The width and height must be assigned to the value of size
You must not create new attributes for this class, use all attributes of Rectangle - As reminder: a Square is a
Rectangle with the same width and height
All width , height , x and y validation must inherit from Rectangle - same behavior in case of wrong data
The overloading __str__ method should return [Square] (<id>) <x>/<y> - <size> - in our case, width or
height

As you know, a Square is a special Rectangle, so it makes sense this class Square inherits from Rectangle. Now you have a
Square class who has the same attributes and same methods.

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 19/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 9-main.py

#!/usr/bin/python3
""" 9-main """
(/) from models.square import Square

if __name__ == "__main__":

s1 = Square(5)
print(s1)
print(s1.area())
s1.display()

print("---")

s2 = Square(2, 2)
print(s2)
print(s2.area())
s2.display()

print("---")

s3 = Square(3, 1, 3)
print(s3)
print(s3.area())
s3.display()

guillaume@ubuntu:~/$ ./9-main.py
[Square] (1) 0/0 - 5
25
#####
#####
(https://alx-
#####
students.slack.com)
#####
#####
 ---
(https://discord.com/app)
[Square] (2) 2/0 - 2
4
(/users/my_profile)
##

##

https://intranet.alxswe.com/projects/331 20/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet
---
[Square] (3) 1/3 - 3
9
(/)

###
###
###
guillaume@ubuntu:~/$

Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/square.py

 Done? Help

11. Square size mandatory

Update the class Square by adding the public getter and setter size

The setter should assign (in this order) the width and the height - with the same value
The setter should have the same value validation as the Rectangle for width and height - No need to change the
exception error message (It should be the one from width )

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 21/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 10-main.py

#!/usr/bin/python3
""" 10-main """
(/) from models.square import Square

if __name__ == "__main__":

s1 = Square(5)
print(s1)
print(s1.size)
s1.size = 10
print(s1)

try:
s1.size = "9"
except Exception as e:
print("[{}] {}".format(e.__class__.__name__, e))

guillaume@ubuntu:~/$ ./10-main.py
[Square] (1) 0/0 - 5
5
[Square] (1) 0/0 - 10
[TypeError] width must be an integer
guillaume@ubuntu:~/$

Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
(https://alx-
File: models/square.py
students.slack.com)

 Done? Help
(https://discord.com/app)
12. Square update
(/users/my_profile)
mandatory

Update the class Square by adding the public method def update(self, *args, **kwargs) that assigns attributes:
https://intranet.alxswe.com/projects/331 22/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

*args is the list of arguments - no-keyworded arguments

1st argument should be the id attribute
2nd argument should be the size attribute
(/) 3rd argument should be the x attribute
4th argument should be the y attribute
**kwargs can be thought of as a double pointer to a dictionary: key/value (keyworded arguments)
**kwargs must be skipped if *args exists and is not empty
Each key in this dictionary represents an attribute to the instance

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 23/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 11-main.py

#!/usr/bin/python3
""" 11-main """
(/) from models.square import Square

if __name__ == "__main__":

s1 = Square(5)
print(s1)

s1.update(10)
print(s1)

s1.update(1, 2)
print(s1)

s1.update(1, 2, 3)
print(s1)

s1.update(1, 2, 3, 4)
print(s1)

s1.update(x=12)
print(s1)

s1.update(size=7, y=1)
print(s1)

s1.update(size=7, id=89, y=1)

print(s1)
(https://alx-
guillaume@ubuntu:~/$ ./11-main.py
students.slack.com)
[Square] (1) 0/0 - 5
[Square] (10) 0/0 - 5
 [Square] (1) 0/0 - 2
(https://discord.com/app)
[Square] (1) 3/0 - 2
[Square] (1) 3/4 - 2
(/users/my_profile)
[Square] (1) 12/4 - 2

[Square] (1) 12/1 - 7

https://intranet.alxswe.com/projects/331 24/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet
[Square] (89) 12/1 - 7
guillaume@ubuntu:~/$

(/)
Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/square.py

 Done? Help

13. Rectangle instance to dictionary representation mandatory

Update the class Rectangle by adding the public method def to_dictionary(self): that returns the dictionary
representation of a Rectangle :

This dictionary must contain:

id
width
height
x
y

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 25/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 12-main.py

#!/usr/bin/python3
""" 12-main """
(/) from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(10, 2, 1, 9)
print(r1)
r1_dictionary = r1.to_dictionary()
print(r1_dictionary)
print(type(r1_dictionary))

r2 = Rectangle(1, 1)
print(r2)
r2.update(**r1_dictionary)
print(r2)
print(r1 == r2)

guillaume@ubuntu:~/$ ./12-main.py
[Rectangle] (1) 1/9 - 10/2
{'x': 1, 'y': 9, 'id': 1, 'height': 2, 'width': 10}
<class 'dict'>
[Rectangle] (2) 0/0 - 1/1
[Rectangle] (1) 1/9 - 10/2
False
guillaume@ubuntu:~/$

Repo:
(https://alx-
GitHub repository: alx-higher_level_programming
students.slack.com)
Directory: 0x0C-python-almost_a_circle
File: models/rectangle.py
(https://discord.com/app)

 Done?
(/users/my_profile)
Help 
https://intranet.alxswe.com/projects/331 26/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

14. Square instance to dictionary representation mandatory

(/) Update the class Square by adding the public method def to_dictionary(self): that returns the dictionary
representation of a Square :

This dictionary must contain:

id
size
x
y

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 27/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 13-main.py

#!/usr/bin/python3
""" 13-main """
(/) from models.square import Square

if __name__ == "__main__":

s1 = Square(10, 2, 1)
print(s1)
s1_dictionary = s1.to_dictionary()
print(s1_dictionary)
print(type(s1_dictionary))

s2 = Square(1, 1)
print(s2)
s2.update(**s1_dictionary)
print(s2)
print(s1 == s2)

guillaume@ubuntu:~/$ ./13-main.py
[Square] (1) 2/1 - 10
{'id': 1, 'x': 2, 'size': 10, 'y': 1}
<class 'dict'>
[Square] (2) 1/0 - 1
[Square] (1) 2/1 - 10
False
guillaume@ubuntu:~/$

Repo:
(https://alx-
GitHub repository: alx-higher_level_programming
students.slack.com)
Directory: 0x0C-python-almost_a_circle
File: models/square.py
(https://discord.com/app)

 Done?
(/users/my_profile)
Help 
https://intranet.alxswe.com/projects/331 28/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

15. Dictionary to JSON string mandatory

(/) JSON is one of the standard formats for sharing data representation.
Update the class Base by adding the static method def to_json_string(list_dictionaries): that returns the JSON
string representation of list_dictionaries :

list_dictionaries is a list of dictionaries

If list_dictionaries is None or empty, return the string: "[]"
Otherwise, return the JSON string representation of list_dictionaries

guillaume@ubuntu:~/$ cat 14-main.py

#!/usr/bin/python3
""" 14-main """
from models.base import Base
from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(10, 7, 2, 8)
dictionary = r1.to_dictionary()
json_dictionary = Base.to_json_string([dictionary])
print(dictionary)
print(type(dictionary))
print(json_dictionary)
print(type(json_dictionary))

guillaume@ubuntu:~/$ ./14-main.py
{'x': 2, 'width': 10, 'id': 1, 'height': 7, 'y': 8}
<class 'dict'>
[{"x": 2, "width": 10, "id": 1, "height": 7, "y": 8}]
(https://alx-
<class 'str'>
students.slack.com)
guillaume@ubuntu:~/$

(https://discord.com/app)
Repo:
(/users/my_profile)
GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
https://intranet.alxswe.com/projects/331 29/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

File: models/base.py

(/)  Done? Help

16. JSON string to file mandatory

Update the class Base by adding the class method def save_to_file(cls, list_objs): that writes the JSON string
representation of list_objs to a file:

list_objs is a list of instances who inherits of Base - example: list of Rectangle or list of Square instances
If list_objs is None , save an empty list
The filename must be: <Class name>.json - example: Rectangle.json
You must use the static method to_json_string (created before)
You must overwrite the file if it already exists

guillaume@ubuntu:~/$ cat 15-main.py

#!/usr/bin/python3
""" 15-main """
from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(10, 7, 2, 8)
r2 = Rectangle(2, 4)
Rectangle.save_to_file([r1, r2])

with open("Rectangle.json", "r") as file:

print(file.read())

(https://alx-
guillaume@ubuntu:~/$ ./15-main.py
students.slack.com)
[{"y": 8, "x": 2, "id": 1, "width": 10, "height": 7}, {"y": 0, "x": 0, "id": 2, "width": 2, "height":
4}]
guillaume@ubuntu:~/$
(https://discord.com/app)

(/users/my_profile)
Repo:

https://intranet.alxswe.com/projects/331 30/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/base.py
(/)

 Done? Help

17. JSON string to dictionary mandatory

Update the class Base by adding the static method def from_json_string(json_string): that returns the list of the
JSON string representation json_string :

json_string is a string representing a list of dictionaries

If json_string is None or empty, return an empty list
Otherwise, return the list represented by json_string

guillaume@ubuntu:~/$ cat 16-main.py

#!/usr/bin/python3
""" 16-main """
from models.rectangle import Rectangle

if __name__ == "__main__":

list_input = [
{'id': 89, 'width': 10, 'height': 4},
{'id': 7, 'width': 1, 'height': 7}
]
json_list_input = Rectangle.to_json_string(list_input)
list_output = Rectangle.from_json_string(json_list_input)
print("[{}] {}".format(type(list_input), list_input))
(https://alx-
print("[{}] {}".format(type(json_list_input), json_list_input))
students.slack.com)
print("[{}] {}".format(type(list_output), list_output))

guillaume@ubuntu:~/$ ./16-main.py
(https://discord.com/app)
[<class 'list'>] [{'height': 4, 'width': 10, 'id': 89}, {'height': 7, 'width': 1, 'id': 7}]
[<class 'str'>] [{"height": 4, "width": 10, "id": 89}, {"height": 7, "width": 1, "id": 7}]
[<class 'list'>] [{'height': 4, 'width': 10, 'id': 89}, {'height': 7, 'width': 1, 'id': 7}]
(/users/my_profile)

guillaume@ubuntu:~/$

https://intranet.alxswe.com/projects/331 31/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

Repo:

(/) GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/base.py

 Done? Help

18. Dictionary to Instance mandatory

Update the class Base by adding the class method def create(cls, **dictionary): that returns an instance with all
attributes already set:

**dictionary can be thought of as a double pointer to a dictionary

To use the update method to assign all attributes, you must create a “dummy” instance before:
Create a Rectangle or Square instance with “dummy” mandatory attributes (width, height, size, etc.)
Call update instance method to this “dummy” instance to apply your real values
You must use the method def update(self, *args, **kwargs)
**dictionary must be used as **kwargs of the method update
You are not allowed to use eval

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 32/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 17-main.py

#!/usr/bin/python3
""" 17-main """
(/) from models.rectangle import Rectangle

if __name__ == "__main__":

r1 = Rectangle(3, 5, 1)
r1_dictionary = r1.to_dictionary()
r2 = Rectangle.create(**r1_dictionary)
print(r1)
print(r2)
print(r1 is r2)
print(r1 == r2)

guillaume@ubuntu:~/$ ./17-main.py
[Rectangle] (1) 1/0 - 3/5
[Rectangle] (1) 1/0 - 3/5
False
False
guillaume@ubuntu:~/$

Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/base.py

(https://alx-
 Done? Help
students.slack.com)
19. File to instances mandatory

(https://discord.com/app)
Update the class Base by adding the class method def load_from_file(cls): that returns a list of instances:

The filename must be: <Class name>.json - example: Rectangle.json

(/users/my_profile)

If the file doesn’t exist, return an empty list

https://intranet.alxswe.com/projects/331 33/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

Otherwise, return a list of instances - the type of these instances depends on cls (current class using this method)
You must use the from_json_string and create methods (implemented previously)

(/)

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 34/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

guillaume@ubuntu:~/$ cat 18-main.py

#!/usr/bin/python3
""" 18-main """
(/) from models.rectangle import Rectangle
from models.square import Square

if __name__ == "__main__":

r1 = Rectangle(10, 7, 2, 8)
r2 = Rectangle(2, 4)
list_rectangles_input = [r1, r2]

Rectangle.save_to_file(list_rectangles_input)

list_rectangles_output = Rectangle.load_from_file()

for rect in list_rectangles_input:

print("[{}] {}".format(id(rect), rect))

print("---")

for rect in list_rectangles_output:

print("[{}] {}".format(id(rect), rect))

print("---")
print("---")

s1 = Square(5)
s2 = Square(7, 9, 1)
list_squares_input = [s1, s2]

(https://alx-
Square.save_to_file(list_squares_input)
students.slack.com)
list_squares_output = Square.load_from_file()
(https://discord.com/app)
for square in list_squares_input:
print("[{}] {}".format(id(square), square))
(/users/my_profile)

print("---")

https://intranet.alxswe.com/projects/331 35/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

for square in list_squares_output:

print("[{}] {}".format(id(square), square))
(/)
guillaume@ubuntu:~/$ ./18-main.py
[139785912033120] [Rectangle] (1) 2/8 - 10/7
[139785912033176] [Rectangle] (2) 0/0 - 2/4
---
[139785911764752] [Rectangle] (1) 2/8 - 10/7
[139785911764808] [Rectangle] (2) 0/0 - 2/4
---
---
[139785912058040] [Square] (5) 0/0 - 5
[139785912061848] [Square] (6) 9/1 - 7
---
[139785911764976] [Square] (5) 0/0 - 5
[139785911765032] [Square] (6) 9/1 - 7
guillaume@ubuntu:~/$

Repo:

GitHub repository: alx-higher_level_programming

Directory: 0x0C-python-almost_a_circle
File: models/base.py

 Done? Help

(https://alx-
students.slack.com)

(https://discord.com/app) Done with the mandatory tasks? Unlock 2 advanced tasks now!

(/users/my_profile)

https://intranet.alxswe.com/projects/331 36/37
10/14/23, 10:18 PM Project: 0x0C. Python - Almost a circle | Addis Ababa Intranet

Ready for a manual review

(/)

Copyright © 2023 ALX, All rights reserved.

(https://alx-
students.slack.com)

(https://discord.com/app)

(/users/my_profile)

https://intranet.alxswe.com/projects/331 37/37