Sign In
Sign In

Comprehensive Guide to Web Development with Python: From Flask to Django

Comprehensive Guide to Web Development with Python: From Flask to Django
Mohammad Waqas Shahid
Technical writer
Python
13.02.2024
Reading time: 14 min

Immense popularity has been gained by Python in web development because of its versatility and simplicity. This comprehensive guide will walk through the basics, covering Flask and Django frameworks, working with templates and views, database integration, handling forms, adding user authentication, and developing RESTful APIs. Following manual addresses towards steps on how to use Python for web development.

Flask and Django

Python has two frameworks for web development: Flask and Django. Both of these can be deployed on our app platform. Flask is a simple framework and is capable of making simple web apps as compared to Django which is more complex than Flask and also has more built-in features. Despite the differences, both frameworks are used by some of the most visited websites today. These sites include Netflix, Spotify, Uber, Zomato etc.

Getting started with Flask

Follow these steps to set up a basic Flask application:

  1. Install Flask using the following command:
pip install flask
  1. Create a new Python file, e.g., app.py, and add the following code:
from flask import Flask
app = Flask(__name__) 
@app.route('/')
def hello_world():
return 'Hello, Flask!'
  1. Run the application with:
flask run app.py

Afterwards, the terminal will output a link similar to http://127.0.0.1:5000/. By clicking this page, the app will appear in the user’s default browser with the instructions of “hello world” as was stated in the code.

Transitioning to Django

Django is a more robust framework that follows the Model-View-Controller (MVC) pattern. Install Django and create a project:

  1. Install Django using:
pip install django
  1. Create a new Django project:
django-admin startproject myproject
  1. Run the development server:  
python manage.py runserver

Afterwards, the terminal will output a link similar to http://127.0.0.1:8000/. By clicking this page, the app will appear in the user’s default browser.

Working with templates and views

In both Flask and Django, templates and views play a crucial role in rendering dynamic content. 

Create an HTML template in Flask

  1. Create a templates folder in Flask project folder.
  2. Add an HTML file, e.g., index.html, with your template.

Code for HTML is as follows: 

<!-- templates/index.html --> 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{ page_title }}</title>
</head>
<body>
    <header>
        <h1>{{ heading }}</h1>
    </header>
    <section>
        <p>{{ content }}</p>
    </section>
    <footer>
      <p>Your Flask App</p>
    </footer>
</body>
</html>

This HTML template includes placeholders (enclosed in double curly braces {{...}}) that Flask will replace with actual values during rendering.

Use templates in Flask

In the Flask application, the render_template function is used to render the HTML template with dynamic content. Below is an example:

# Example: Using templates in Flask
from flask import Flask, render_template app = Flask(__name__) @app.route('/') def home(): # Provide dynamic content to the template template_data = { 'page_title': 'Home Page', 'heading': 'Welcome to Flask!', 'content': 'This is a sample Flask web application.', } return render_template('index.html', **template_data) if __name__ == '__main__': app.run(debug=True)

In this example, the render_template function is used to render the index.html template with dynamic content provided by the template_data dictionary.

By incorporating this Flask-specific code, the HTML template is seamlessly integrated into the Flask application, allowing for the dynamic rendering of content.

Create an HTML template in Django

In order to create a view in Django, follow the stated guidelines:

  1. Define a view function in the views.py file.
from django.shortcuts import render
 
def index(request):
    context = {
        'page_title': 'Django Home',
        'heading': 'Welcome to Django!',
        'content': 'This is your Django app homepage.',
    }
    return render(request, 'your_app/index.html', context)

In this example, the index view function prepares a context dictionary with values for the placeholders in the HTML template. It then renders the index.html template using the render function.

  1. Map the view to a URL in urls.py.

Now, open the urls.py file in your app folder. Create a URL pattern that maps to the index view function.

from django.urls import path
from .views import index
 
urlpatterns = [
    path('', index, name='index'),
]

Database integration

Database integration is essential for dynamic web applications.

Connecting databases in Flask

  1. Add the following to your Flask app:
from flask_sqlalchemy import SQLAlchemy
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
db = SQLAlchemy(app)
  1. Define models for your database.

Once Flask-SQLAlchemy is integrated, proceed to define models for your database. Databases are tables which are represented by models. In the Python programming language, these are Python classes. Below is a simplified example:

from datetime import datetime
from flask_sqlalchemy import SQLAlchemy
 
db = SQLAlchemy()
 
class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(20), unique=True, nullable=False)
    email = db.Column(db.String(120), unique=True, nullable=False)
    date_joined = db.Column(db.DateTime, default=datetime.utcnow)
 
    def __repr__(self):
        return f"User('{self.username}', '{self.email}')"

Connecting databases in Django

In Django, configuring databases is handled through the settings.py file. Follow these steps to set up a PostgreSQL database or another supported database:

  1. Modify settings.py.

Open the settings.py file within your Django project folder. Locate the DATABASES configuration section, and modify the ENGINE, NAME, USER, and PASSWORD parameters accordingly.

# Example: Configuring a PostgreSQL database in Django
 
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_database_name',
        'USER': 'your_database_user',
        'PASSWORD': 'your_database_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

Replace the placeholder values with your specific database details.

  1. Run migrations:

After modifying the database configuration, run the following commands to apply the changes and create necessary tables:

python manage.py makemigrations
python manage.py migrate

These commands create database tables based on the defined models.

With these configurations, your Flask application is now connected to a SQLite database, and your Django application is set up with the specified database, allowing seamless integration for dynamic web functionalities.

Handling forms and user input

Forms play a pivotal role in facilitating user interaction on web applications. This section delineates the process of creating a simple form in Flask using the WTForms library and constructing a form in Django through Django forms, integrated seamlessly with a view.

Form handling in Flask

Forms are vital for user interaction. Create a simple form in Flask:

  1. Use the WTForms library:
pip install Flask-WTF 
  1. Define a form in your Flask app.

Below is a basic example illustrating how to create a registration form using Flask-WTF:

# Example: Defining a simple form in Flask using WTForms 
from flask import Flask, render_template from flask_wtf import FlaskForm from wtforms import StringField, PasswordField, SubmitField app = Flask(__name__) app.config['SECRET_KEY'] = 'your_secret_key' class RegistrationForm(FlaskForm): username = StringField('Username') password = PasswordField('Password') submit = SubmitField('Register') @app.route('/register', methods=['GET', 'POST']) def register(): form = RegistrationForm() if form.validate_on_submit(): # Process the form data (e.g., save to database) return 'Registration successful!' return render_template('register.html', form=form)

In this example, the RegistrationForm class is created, defining fields for username, password, and a submit button. The form is then integrated into a route (/register), and upon submission, the data can be processed as needed.

Handling a form in Django

In Django, form handling is seamlessly integrated using Django forms. Follow these steps to create and integrate a form within your Django app.

  1. Define a form using Django's form framework. Below is an example of a simple registration form in Django:
from django import forms

class RegistrationForm(forms.Form):
    username = forms.CharField(label='Username', max_length=100)
    password = forms.CharField(label='Password', widget=forms.PasswordInput)
  1. Integrate the form with your view.

Integrate the form into your Django view. Modify your existing view or create a new one to handle the form submission:

from django.shortcuts import render
from .forms import RegistrationForm

def register(request):
    form = RegistrationForm(request.POST or None)

    if form.is_valid():
        # Process the form data (e.g., save to database)
        return render(request, 'registration_success.html')

    return render(request, 'register.html', {'form': form})

This example assumes the existence of HTML templates (register.html and registration_success.html) for rendering the form and success messages.

With these implementations, both Flask and Django applications can seamlessly handle forms, enabling effective user input and interaction.

Adding user authentication

User authentication is crucial for most web applications.

Secure user authentication in Flask

Implement authentication in Flask:

  1. Use Flask-Login for session management:
pip install flask-login
  1. Implement login and logout routes.

After installing Flask-Login, integrate it into your Flask application. Below is a simplified example illustrating the implementation of login and logout routes:

from flask import Flask, render_template,redirect,url_for
from flask_login import LoginManager, UserMixin, login_user, login_required, logout_user, current_user

app = Flask(__name__)
app.config['SECRET_KEY'] = 'your_secret_key'

# Sample User class (replace with your user model)
class User(UserMixin):
    def __init__(self, user_id):
        self.id = user_id

login_manager = LoginManager(app)
login_manager.login_view = 'login'

@login_manager.user_loader
def load_user(user_id):
    return User(user_id)

@app.route('/login')
def login():
    # Implement your login logic here
    user = User(user_id=1)
    login_user(user)
    return 'Login successful!'

@app.route('/logout')
@login_required
def logout():
    logout_user()
    return 'Logout successful!'

Customize the user authentication logic within the login route as per your application's requirements.

Secure user authentication in Django

In Django, use the built-in authentication system.

  1. Include django.contrib.auth in the INSTALLED_APPS list.

Open the settings.py file within your Django project folder. Locate the INSTALLED_APPS list and include django.contrib.auth:

INSTALLED_APPS = [
    # ... other apps ...
    'django.contrib.auth',
    # ... other apps ...
]
  1. Run migrations to create necessary tables.

Execute the following commands to apply migrations and create the necessary tables for user authentication:

python manage.py makemigrations
python manage.py migrate

These commands create tables such as auth_user needed for storing user authentication information.

With these implementations, both Flask and Django applications are equipped with secure user authentication mechanisms. Flask utilizes Flask-Login for session management, while Django leverages its built-in authentication system, ensuring the confidentiality and integrity of user credentials.

RESTful API development

RESTful APIs play a pivotal role in facilitating communication between different components of a web application

API development in Flask

  1. Define a Flask app and API endpoint.

In your Flask application, define a route that serves as your API endpoint. Below is an example:

# Example: Creating a simple API endpoint in Flask

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/hello', methods=['GET'])
def hello_world():
    return jsonify({'message': 'Hello, World!'})

This example creates a Flask app and a route (/api/hello) that returns a JSON response with a simple greeting.

  1. Run the Flask app.

Start your Flask development server to test the API endpoint:

flask run
  1. Visit http://127.0.0.1:5000/api/hello in your browser or a tool like Postman to interact with the API.

RESTful API in Django

  1. Ensure Django and Django REST Framework are installed. Use the following commands:
pip install django djangorestframework
  1. Create a Django Project and App, if not done already. Follow the standard Django project creation steps.
  1. In the Django app, define API views and serializers. Below is an example:
# In views.py
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status

class HelloWorld(APIView):
    def get(self, request):
        return Response({'message': 'Hello, World!'}, status=status.HTTP_200_OK)

# In serializers.py
from rest_framework import serializers

class HelloWorldSerializer(serializers.Serializer):
    message = serializers.CharField(max_length=100)
  1. Configure URLs in your app's urls.py file:
# In urls.py
from django.urls import path
from .views import HelloWorld

urlpatterns = [
    path('hello/', HelloWorld.as_view(), name='hello-world'),
]

This sets up a Django project with an API endpoint at http://127.0.0.1:8000/hello/.

  1. Run migrations and start Django development server. Write the following in your terminal:
python manage.py migrate
python manage.py runserver
  1. Visit http://127.0.0.1:8000/hello/ to interact with the Django API endpoint.

With these implementations, you've created a simple API endpoint in both Flask and Django, enabling seamless communication within your web applications.

Middleware and extensions

Enhancing Flask with Flask-Migrate and custom middleware

  1. Install Flask-Migrate.

Begin by installing Flask-Migrate, a Flask extension for handling database migrations:

pip install Flask-Migrate
  1. Initialize and perform database migrations.

Initialize the migration environment and apply migrations to your database:

flask db init
flask db migrate
flask db upgrade

These commands set up the necessary migration files and apply them to the database.

  1. Implement middleware in Flask.

In Flask, middleware allows you to define functions that run before and after request handling. As an example, let's create a simple logging middleware:

# Example: Simple logging middleware in Flask

from flask import Flask, request

app = Flask(__name__)

@app.before_request
def log_request_info():
    app.logger.info(f'Received request: {request.method} {request.url}')

@app.after_request
def log_response_info(response):
    app.logger.info(f'Sent response: {response.status_code}')
    return response

if __name__ == '__main__':
    app.run(debug=True)

This middleware logs information about incoming requests and outgoing responses.

Django with middleware

  1. Configure middleware in Django.

In Django, middleware classes are employed to process requests and responses globally. Add middleware classes in the MIDDLEWARE setting within your Django project's settings.py. As an illustration, let's add Django's built-in CommonMiddleware:

# Example: Configuring middleware in Django settings.py

MIDDLEWARE = [
    # ... other middleware classes
    'django.middleware.common.CommonMiddleware',
    # ... other middleware classes
]

CommonMiddleware adds security and performance-related headers to your responses.

  1. Create custom middleware in Django:

You can create custom middleware by defining a class with methods like process_request or process_response. Use the following example Python code:

# Example: Creating a custom logging middleware in Django

# In myapp/middleware.py
class LoggingMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response

    def __call__(self, request):
        response = self.get_response(request)
        # Code to be executed for each response afte
        # the view is called.
        return response
  1. Add custom middleware to MIDDLEWARE:
# Example: Adding custom middleware to Django settings.py

MIDDLEWARE = [
    # ... other middleware classes
    'myapp.middleware.LoggingMiddleware',
    # ... other middleware classes
]

Ensure you replace myapp.middleware.LoggingMiddleware with the actual path to your middleware.

Conclusion

In conclusion, this comprehensive guide has equipped you with the fundamental knowledge of web development using Python. Whether you choose Flask for its simplicity or Django for its robust features, the skills learned here form a solid foundation for creating dynamic and powerful web applications. Now, go ahead and unleash the full potential of Python for web development.

Python
13.02.2024
Reading time: 14 min

Similar

Python

How to Delete Characters from a String in Python

When writing Python code, developers often need to modify string data. Common string modifications include: Removing specific characters from a sequence Replacing characters with others Changing letter case Joining substrings into a single sequence In this guide, we will focus on the first transformation—deleting characters from a string in Python. It’s important to note that strings in Python are immutable, meaning that any method or function that modifies a string will return a new string object with the changes applied. Methods for Deleting Characters from a String This section covers the main methods in Python used for deleting characters from a string. We will explore the following methods: replace() translate() re.sub() For each method, we will explain the syntax and provide practical examples. replace() The first Pyhton method we will discuss is replace(). It is used to replace specific characters in a string with others. Since strings are immutable, replace() returns a new string object with the modifications applied. Syntax: original_string.replace(old, new[, count]) Where: original_string – The string where modifications will take place old – The substring to be replaced new – The substring that will replace old count (optional) – The number of occurrences to replace (if omitted, all occurrences will be replaced) First, let’s remove all spaces from the string "H o s t m a n": example_str = "H o s t m a n" result_str = example_str.replace(" ", "") print(result_str) Output: Hostman We can also use the replace() method to remove newline characters (\n). example_str = "\nHostman\nVPS" print(f'Original string: {example_str}') result_str = example_str.replace("\n", " ") print(f'String after adjustments: {result_str}') Output: Original string: Hostman VPS String after adjustments: Hostman VPS The replace() method has an optional third argument, which specifies the number of replacements to perform. example_str = "Hostman VPS Hostman VPS Hostman VPS" print(f'Original string: {example_str}') result_str = example_str.replace("Hostman VPS", "", 2) print(f'String after adjustments: {result_str}') Output: Original string: Hostman VPS Hostman VPS Hostman VPS String after adjustments: Hostman VPS Here, only two occurrences of "Hostman VPS" were removed, while the third occurrence remained unchanged. We have now explored the replace() method and demonstrated its usage in different situations. Next, let’s see how we can delete and modify characters in a string using translate(). translate( The Python translate() method functions similarly to replace() but with additional flexibility. Instead of replacing characters one at a time, it allows mapping multiple characters using a dictionary or translation table. The method returns a new string object with the modifications applied. Syntax: original_string.translate(mapping_table) In the first example, let’s remove all occurrences of the $ symbol in a string and replace them with spaces: example_str = "Hostman$Cloud$—$Cloud$Service$Provider." print(f'Original string: {example_str}') result_str = example_str.translate({ord('$'): ' '}) print(f'String after adjustments: {result_str}') Output: Original string: Hostman$Cloud$—$Cloud$Service$Provider. String after adjustments: Hostman Cloud — Cloud Service Provider. To improve code readability, we can define the mapping table before calling translate(). This is useful when dealing with multiple replacements: example_str = "\nHostman%Cloud$—$Cloud$Service$Provider.\n" print(f'Original string: {example_str}') # Define translation table example_table = {ord('\n'): None, ord('$'): ' ', ord('%'): ' '} result_str = example_str.translate(example_table) print(f'String after adjustments: {result_str}') Output: Original string: Hostman%Cloud$—$Cloud$Service$Provider. String after adjustments: Hostman Cloud — Cloud Service Provider. re.sub() In addition to replace() and translate(), we can use regular expressions for more advanced character removal and replacement. Python's built-in re module provides the sub() method, which searches for a pattern in a string and replaces it. Syntax: re.sub(pattern, replacement, original_string [, count=0, flags=0]) pattern – The regular expression pattern to match replacement – The string or character that will replace the matched pattern original_string – The string where modifications will take place count (optional) – Limits the number of replacements (default is 0, meaning replace all occurrences) flags (optional) – Used to modify the behavior of the regex search Let's remove all whitespace characters (\s) using the sub() method from the re module: import re example_str = "H o s t m a n" print(f'Original string: {example_str}') result_str = re.sub('\s', '', example_str) print(f'String after adjustments: {result_str}') Output: Original string: H o s t m a nString after adjustments: Hostman Using Slices to Remove Characters In addition to using various methods to delete characters, Python also allows the use of slices. As we know, slices extract a sequence of characters from a string. To delete characters from a string by index in Python, we can use the following slice: example_str = "\nHostman \nVPS" print(f'Original string: {example_str}') result_str = example_str[1:9] + example_str[10:] print(f'String after adjustments: {result_str}') In this example, we used slices to remove newline characters. The output of the code: Original string:HostmanVPSString after adjustments: Hostman VPS Apart from using two slice parameters, you can also use a third one, which specifies the step size for index increments. For example, if we set the step to 2, it will remove every odd-indexed character in the string. Keep in mind that indexing starts at 0. Example: example_str = "Hostman Cloud" print(f'Original string: {example_str}') result_str = example_str[::2] print(f'String after adjustments: {result_str}') Output: Original string: Hostman CloudString after adjustments: HsmnCod Conclusion In this guide, we learned how to delete characters from a string in Python using different methods, including regular expressions and slices. The choice of method depends on the specific task. For example, the replace() method is suitable for simpler cases, while re.sub() is better for more complex situations.
23 August 2025 · 5 min to read
Python

Command-Line Option and Argument Parsing using argparse in Python

Command-line interfaces (CLIs) are one of the quickest and most effective means of interacting with software. They enable you to provide commands directly which leads to quicker execution and enhanced features. Developers often build CLIs using Python for several applications, utilities, and automation scripts, ensuring they can dynamically process user input. This is where the Python argparse module steps in. The argparse Python module streamlines the process of managing command-line inputs, enabling developers to create interactive and user-friendly utilities. As part of the standard library, it allows programmers to define, process, and validate inputs seamlessly without the need for complex logic. This article will discuss some of the most important concepts, useful examples, and advanced features of the argparse module so that you can start building solid command-line tools right away. How to Use Python argparse for Command-Line Interfaces This is how to use argparse in your Python script: Step 1: Import Module First import the module into your Python parser script: import argparse This inclusion enables parsing .py arg inputs from the command line. Step 2: Create an ArgumentParser Object The ArgumentParser class is the most minimal class of the Python argumentparser module's API. To use it, begin by creating an instance of the class: parser = argparse.ArgumentParser(description="A Hostman tutorial on Python argparse.") Here: description describes what the program does and will be displayed when someone runs --help. Step 3: Add Inputs and Options Define the parameters and features your program accepts via add_argument() function: parser.add_argument('filename', type=str, help="Name of the file to process") parser.add_argument('--verbose', action='store_true', help="Enable verbose mode") Here: filename is a mandatory option. --verbose is optional, to allow you to set the flag to make it verbose. Step 4: Parse User Inputs Process the user-provided inputs by invoking the parse_args() Python method: args = parser.parse_args() This stores the command-line values as attributes of the args object for further use in your Python script.  Step 5: Access Processed Data Access the inputs and options for further use in your program: For example: print(f"File to process: {args.filename}") if args.verbose:     print("Verbose mode enabled") else:     print("Verbose mode disabled") Example CLI Usage Here are some scenarios to run this script: File Processing Without Verbose Mode python3 file.py example.txt File Processing With Verbose Mode python3 file.py example.txt --verbose Display Help If you need to see what arguments the script accepts or their description, use the --help argument: python3 file.py --help Common Examples of argparse Usage Let's explore a few practical examples of the module. Example 1: Adding Default Values Sometimes, optional inputs in command-line interfaces need predefined values for smoother execution. With this module, you can set a default value that applies when someone doesn’t provide input. This script sets a default timeout of 30 seconds if you don’t specify the --timeout parameter. import argparse # Create the argument parser parser = argparse.ArgumentParser(description="Demonstrating default argument values.") # Pass an optional argument with a default value parser.add_argument('--timeout', type=int, default=30, help="Timeout in seconds (default: 30)") # Interpret the arguments args = parser.parse_args() # Retrieve and print the timeout value print(f"Timeout value: {args.timeout} seconds") Explanation Importing Module: Importing the argparse module. Creating the ArgumentParser Instance: An ArgumentParser object is created with a description so that a short description of the program purpose is provided. This description is displayed when the user runs the program via the --help option. Including --timeout: The --timeout option is not obligatory (indicated by the -- prefix). The type=int makes the argument for --timeout an integer. The default=30 is provided so that in case the user does not enter a value, then the timeout would be 30 seconds. The help parameter adds a description to the argument, and it will also appear in the help documentation. Parsing Process: The parse_args() function processes user inputs and makes them accessible as attributes of the args object. In our example, we access args.timeout and print out its value. Case 1: Default Value Used If the --timeout option is not specified, the default value of 30 seconds is used: python file.py Case 2: Custom Value Provided For a custom value for --timeout (e.g., 60 seconds), apply: python file.py --timeout 60 Example 2: Utilizing Choices The argparse choices parameter allows you to restrict an argument to a set of beforehand known valid values. This is useful if your program features some specific modes, options, or settings to check. Here, we will specify a --mode option with two default values: basic and advanced. import argparse # Creating argument parser parser = argparse.ArgumentParser(description="Demonstrating the use of choices in argparse.") # Adding the --mode argument with predefined choices parser.add_argument('--mode', choices=['basic', 'advanced'], help="Choose the mode of operation") # Parse the arguments args = parser.parse_args() # Access and display the selected mode if args.mode: print(f"Mode selected: {args.mode}") else: print("No mode selected. Please choose 'basic' or 'advanced'.") Adding --mode: The choices argument indicates that valid options for the --mode are basic and advanced. The application will fail when the user supplies an input other than in choices. Help Text: The help parameter gives valuable information when the --help command is executed. Case 1: Valid Input To specify a valid value for --mode, utilize: python3 file.py --mode basic Case 2: No Input Provided For running the program without specifying a mode: python3 file.py Case 3: Invalid Input If a value is provided that is not in the predefined choices: python3 file.py --mode intermediate Example 3: Handling Multiple Values The nargs option causes an argument to accept more than one input. This is useful whenever your program requires a list of values for processing, i.e., numbers, filenames, or options. Here we will show how to use nargs='+' to accept a --numbers option that can take multiple integers. import argparse # Create an ArgumentParser object parser = argparse.ArgumentParser(description="Demonstrating how to handle multiple values using argparse.") # Add the --numbers argument with nargs='+' parser.add_argument('--numbers', nargs='+', type=int, help="List of numbers to process") # Parse the arguments args = parser.parse_args() # Access and display the numbers if args.numbers: print(f"Numbers provided: {args.numbers}") print(f"Sum of numbers: {sum(args.numbers)}") else: print("No numbers provided. Please use --numbers followed by a list of integers.") Adding the --numbers Option: The user can provide a list of values as arguments for --numbers. type=int interprets the input as an integer. If a non-integer input is provided, the program raises an exception. The help parameter gives the information.  Parsing Phase: After parsing the arguments, the input to --numbers is stored in the form of a list in args.numbers. Utilizing the Input: You just need to iterate over the list, calculate statistics (e.g., sum, mean), or any other calculation on the input. Case 1: Providing Multiple Numbers To specify multiple integers for the --numbers parameter, execute: python3 file.py --numbers 10 20 30 Case 2: Providing a Single Number If just one integer is specified, run: python3 file.py --numbers 5 Case 3: No Input Provided If the script is run without --numbers: python3 file.py Case 4: Invalid Input In case of inputting a non-integer value: python3 file.py --numbers 10 abc 20 Example 4: Required Optional Arguments Optional arguments (those that begin with the --) are not mandatory by default. But there are times when you would like them to be mandatory for your script to work properly. You can achieve this by passing the required=True parameter when defining the argument. In this script, --config specifies a path to a configuration file. By leveraging required=True, the script enforces that a value for --config must be provided. If omitted, the program will throw an error. import argparse # Create an ArgumentParser object parser = argparse.ArgumentParser(description="Demonstrating required optional arguments in argparse.") # Add the --config argument parser.add_argument('--config', required=True, help="Path to the configuration file") # Parse the arguments args = parser.parse_args() # Access and display the provided configuration file path print(f"Configuration file path: {args.config}") Adding the --config Option: --config is considered optional since it starts with --. However, thanks to the required=True parameter, users must include it when they run the script. The help parameter clarifies what this parameter does, and you'll see this information in the help message when you use --help. Parsing: The parse_args() method takes care of processing the arguments. If someone forgets to include --config, the program will stop and show a clear error message. Accessing the Input: The value you provide for --config gets stored in args.config. You can then use this in your script to work with the configuration file. Case 1: Valid Input For providing a valid path to the configuration file, use: python3 file.py --config settings.json Case 2: Missing the Required Argument For running the script without specifying --config, apply: python3 file.py Advanced Features  While argparse excels at handling basic command-line arguments, it also provides advanced features that enhance the functionality and usability of your CLIs. These features ensure your scripts are scalable, readable, and easy to maintain. Below are some advanced capabilities you can leverage. Handling Boolean Flags Boolean flags allow toggling features (on/off) without requiring user input. Use the action='store_true' or action='store_false' parameters to implement these flags. parser.add_argument('--debug', action='store_true', help="Enable debugging mode") Including --debug enables debugging mode, useful for many Python argparse examples. Grouping Related Arguments Use add_argument_group() to organize related arguments, improving readability in complex CLIs. group = parser.add_argument_group('File Operations') group.add_argument('--input', type=str, help="Input file") group.add_argument('--output', type=str, help="Output file") Grouped arguments appear under their own section in the --help documentation. Mutually Exclusive Arguments To ensure users select only one of several conflicting options, use the add_mutually_exclusive_group() method. group = parser.add_mutually_exclusive_group() group.add_argument('--json', action='store_true', help="Output in JSON format") group.add_argument('--xml', action='store_true', help="Output in XML format") This ensures one can choose either JSON or XML, but not both. Conclusion The argparse Python module simplifies creating reliable CLIs for handling Python program command line arguments. From the most basic option of just providing an input to more complex ones like setting choices and nargs, developers can build user-friendly and robust CLIs. Following the best practices of giving proper names to arguments and writing good docstrings would help you in making your scripts user-friendly and easier to maintain.
21 July 2025 · 10 min to read
Python

How to Get the Length of a List in Python

Lists in Python are used almost everywhere. In this tutorial we will look at four ways to find the length of a Python list: by using built‑in functions, recursion, and a loop. Knowing the length of a list is most often required to iterate through it and perform various operations on it. len() function len() is a built‑in Python function for finding the length of a list. It takes one argument—the list itself—and returns an integer equal to the list’s length. The same function also works with other iterable objects, such as strings. Country_list = ["The United States of America", "Cyprus", "Netherlands", "Germany"] count = len(Country_list) print("There are", count, "countries") Output: There are 4 countries Finding the Length of a List with a Loop You can determine a list’s length in Python with a for loop. The idea is to traverse the entire list while incrementing a counter by  1 on each iteration. Let’s wrap this in a separate function: def list_length(list): counter = 0 for i in list: counter = counter + 1 return counter Country_list = ["The United States of America", "Cyprus", "Netherlands", "Germany", "Japan"] count = list_length(Country_list) print("There are", count, "countries") Output: There are 5 countries Finding the Length of a List with Recursion The same task can be solved with recursion: def list_length_recursive(list): if not list: return 0 return 1 + list_length_recursive(list[1:]) Country_list = ["The United States of America", "Cyprus", "Netherlands","Germany", "Japan", "Poland"] count = list_length_recursive(Country_list) print("There are", count, "countries") Output: There are 6 countries How it works. The function list_length_recursive() receives a list as input. If the list is empty, it returns 0—the length of an empty list. Otherwise it calls itself recursively with the argument list[1:], a slice of the original list starting from index 1 (i.e., the list without the element at index 0). The result of that call is added to 1. With each recursive step the returned value grows by one while the list shrinks by one element. length_hint() function The length_hint() function lives in the operator module. That module contains functions analogous to Python’s internal operators: addition, subtraction, comparison, and so on. length_hint() returns the length of iterable objects such as strings, tuples, dictionaries, and lists. It works similarly to len(): from operator import length_hint Country_list = ["The United States of America", "Cyprus", "Netherlands","Germany", "Japan", "Poland", "Sweden"] count = length_hint(Country_list) print("There are", count, "countries") Output: There are 7 countries Note that length_hint() must be imported before use. Conclusion In this guide we covered four ways to determine the length of a list in Python. Under equal conditions the most efficient method is len(). The other approaches are justified mainly when you are implementing custom classes similar to list.
17 July 2025 · 3 min to read

Do you have questions,
comments, or concerns?

Our professionals are available to assist you at any moment,
whether you need help or are just unsure of where to start.
Email us
Hostman's Support