👋 Assignment 1 - Introduction to Python! ⛄⚡

Hi all, as we progress on the course, assignments needs to come, so there you go, your very first assignment!

As I said, this assignment won't be a full coverage on python, but rather it would be a warmer for you to get hands on experience to the stuff we need in the upcoming weeks of this course. Therefore, in this repository, we will use python to solve some basic tasks, work with jupyter notebooks, set an environment, in a proper way, using python standard environments.

How You Should Start to a Project!

By creating an environment!

Environments is a box for your project in order to keep a clean definition of what your project needs as dependencies, makes your project works safely by not messing up with your local packages, and so on. It is a good practice to use environments as you get yourself involved in more complicated projects!

Before talking about environments, I want to give you a brief description of how python works. You can install python through standard python distribution or other distributions such as Anaconda.

When you install it with Anaconda, it comes with additional packages in addition to standard python libraries. Therefore, when you launch anaconda, conda starts the base environment, which has all the additional packages in, and you will be able to use imports right in there.

If you choose to install the standard python, then you only get the standard python libraries, with no additional package.

Python or Anaconda lets you install packages using packages managers, pip and conda, and the packages will be downloaded and installed to your site-packages folder. The packages installed in your local system, will be accessible to all the projects, where you use your local python.

Now, lets assume that you are working on two projects, where you use a third party package that both of the projects depends on it. In one of your projects, you built so much using this third party package, and you don't want to upgrade the package for stability reasons. In this situation if you do pip install --upgrade dependency_package, both of your projects will use the upgraded version of this dependent package.

This is a common use case for environments. You keep your dependency packages fixed! Luckily, working with environments is very easy.

 Create an Environment

You can create an environment like this using standard python. For Anaconda, use managing environments documentation to create conda environments. For our class, you can create one environment to use for all future assignments!

python -m venv spu-bigdataanalytics-env

Installing package dependencies will be easy with a requirements.txt file.

python -m pip install -r requirements.txt

There are more commands of pip like pip list, pip freeze, and so on.

Use an Environment

To use an environment, you need to activate it. You can google all this stuff, but for assignments sake, I am putting it here. It changes based on your operating system.

For mac and linux, like following.

# mac/ linux
source path/to/your/envronment/bin/activate

For windows, as in below.

# windows
C:\Path\to\Your\Environment\Scripts\Activate.ps1

To deactivate, like in below for all operating systems.

deactivate

Very easy.

How to Use Jupyter Notebooks

Jupyter notebooks is a python package. You can install it like this. After installing, verify the installation by using the command jupyter --version to get the version.

python -m pip install jupyterlab

To run a jupyter notebook, you can use the following. You can use --generate-config to customize jupyter, or you can pass options during launching.

jupyter notebook --notebook-dir="path/to/your/project/"

For our class, the assignments won't have jupyter related packages! Therefore, you can install it to your environmnet seperately, or configure your environment to look for packages at your local, up to you.

How Assigments will be Evaluated?

Your assignments will be evaluated by the following list of things.

• How much checkboxes were you able to finish from your list for the assignment.
• Your repository organization.
• Your notebook readability and outputs.
• Your reproducibility of your assignment.

 Tasks

You should create a notebook to do the following tasks in below.

While working on your notebooks, you should also create headings, subsections for each task, under subsections, you must explain your code. Your code should also have comments, and you should save your result into a variable and in another cell, you should print your results. Check out the example notebook for your future reference.

• Task-01: Create a function to find nth number within the fibonacci series.
• Task-02: Use object-oriented programming logic and create two classes. The first class will represent animals, second class will represent dogs. Create features to both of your classes and illustrate object oriented logic by inheriting parent classes attributes in your child class.
• Task-03: Create a one-line function to calculate the nth power of given two inputs, a and b. Use your one-line function with real numbers and print your output.
• Task-04: Create a module with the following functions.
  • A function to concatenate given first and last name.
  • A function to calculate an age given the birth year.
  • A class to represent a person with following attributes: first_name, last_name, birth_year.
  • Import everything from your module and create an instance from your person class. Use the functions from your module to find the age, and the full name of the person instance you created.
• Task-05: Create a decorator function that prints before and after the execution of the function it is used with.
• Task-06: In this repository, there is a file called numbers.txt. This file has 100 lines of 50 digit long numbers. Calculate the sum of all 100 numbers and get the last 10 digit. Use map function of python while doing this task.
• Task-07: The series of 1^1 + 2^2 + 3^3 + ... + 10^10 equals to 10405071317. Find the last 10 digits of the following series: 1^1 + 2^2 + 3^3 + ... + 500^500. Use reduce function while doing this assignment.

What are All These Files?

Following table is will give it a meaning for each file.

File	Description
README.md	A descriptive file to give an introduction of current project/ assignment. Includes a todo list that you have to edit.
LICENCE	The licence of the file that every project should have.
.gitignore	The file to control which files should be ignored by Git.
.gitkeep	An empty file to keep folders under git.
requirements.txt	A list of python packages you may need for the assignment.
numbers.txt	Data file for task #06.
Tasks.ipynb	Sample notebook as a reference for how your notebooks should be organized.
*.ipynb	Assignment notebook with your code for the given tasks.

Your To-Do List for This Assignment 💵💶

• I create an environment and install the requirements to my environment.
• I completed task #01.
• I completed task #02.
• I completed task #03.
• I completed task #04.
• I completed task #05.
• I completed task #06.
• I completed task #07.
• My notebook(s) are well organized with headings, comments, that makes it visually appealing.
• My notebook(s) have the results of my execution.
• My notebook(s) are reproducible.
• I download the final version of my repository, and uploaded to the blackboard!