🧩 PYTHON TIPS FOR PRODUCTIVITY - Automate Your Python Project’s Initial Structure

📰 Edição #04 — PYTHON TIPS FOR PRODUCTIVITY - Automate Your Python Project’s Initial Structure

✨ Opening Quote

Starting a project from scratch can be repetitive — and you, developer or analyst, know how every second counts. So why not let Python do it for you?

✅ Purpose of the Tip

To help you automatically create the basic folder and file structure of a Python project, saving time, avoiding oversights, and encouraging good practices from the beginning.

📚 Technical Concept

When developing any system, modularization and organization are essential. Automating this structure:

• Ensures that all your projects follow the same standard;
• Keeps the repository clean with .gitignore;
• Provides initial documentation via README.md;
• Encourages separation of responsibilities (logic, tests, data, images).

💡 Python Representation

Scenario: You’re starting a new project called profitability_simulator. Instead of creating everything manually, run the script below and… it’s done!

import os
import sys

def create_structure(project_name):
    folders = [
        project_name,
        f"{project_name}/src",
        f"{project_name}/tests",
        f"{project_name}/data",
        f"{project_name}/docs",
        f"{project_name}/images"
    ]

    files = {
        f"{project_name}/README.md": f"# Project: {project_name}\n\nInitial project documentation.",
        f"{project_name}/.gitignore": "__pycache__/\n*.pyc\ndata/\n.env",
        f"{project_name}/src/__init__.py": "",
        f"{project_name}/tests/__init__.py": ""
    }

    for folder in folders:

        os.makedirs(folder, exist_ok=True)

    for path, content in files.items():
        with open(path, 'w') as file:
            file.write(content)

    print(f"\n     Structure successfully created for project: '{project_name}'\n")

# Terminal execution
if name == "__main__":
    if len(sys.argv) < 2:
        print("\nPlease provide the project name as an argument.")
        print("Example: python structure.py profitability_simulator\n")
    else:
        create_structure(sys.argv[1])        

📊 Practical Applications

• Standardize structures across teams and repositories
• Avoid repetitive manual work in new projects
• Create reusable starter templates
• Demonstrate professionalism in technical tests and portfolios

💬 EXTRA TIP

Customize your script to also create files like main.py, requirements.txt, or even starter structures for dashboards or APIs — tailored to your favorite project types!

📅 Closing with CTA

Did you enjoy this tip?

➡️ Follow my page on LinkedIn to receive the next posts with real examples and simulators for management and financial automation using Python.

🔗 Newsletter: Python Scripts for Productivity 🔗 GitHub: github.com/IOVASCON

Ponta Grossa – Paraná - Brasil

🏷️ Hashtags

#PythonProductivity #PythonAutomation #PythonProjects #DevEfficiency #BestPractices #Readme #GitIgnore #PythonForBusiness #Dashboards