Perjalanan Saya Mencipta Apl CLI Pengurusan Acara

Perjalanan Saya Mencipta Apl CLI Pengurusan Acara

pengenalan

Sebagai pemula dalam pembangunan perisian, salah satu tugas yang paling menarik dan menakutkan ialah mencipta projek penting pertama anda. Bagi saya, ini adalah aplikasi CLI Pengurusan Acara. Projek ini bukan sahaja membantu saya menyatukan pemahaman saya tentang Python tetapi juga memperkenalkan saya kepada SQLAlchemy ORM, perpustakaan CLI seperti Click, dan amalan terbaik umum pembangunan perisian. Mengimbas kembali perjalanan ini, saya menyedari betapa banyak yang telah saya pelajari dan bagaimana kemahiran ini telah membentuk keyakinan saya sebagai pembangun.

Permulaan: Mempelajari Asas Python

Sebelum menyelami projek ini, perjalanan saya bermula dengan asas Python. Mempelajari sintaks, struktur kawalan, jenis data dan fungsi Python adalah asas yang membolehkan projek ini ditangani. Saya masih ingat zaman menulis skrip mudah, ralat penyahpepijatan, dan kemenangan kecil yang datang dengan setiap larian yang berjaya. Memahami asas-asas ini adalah penting kerana ia membentuk asas kepada mana-mana projek Python.

Salah satu aspek paling berguna yang saya pelajari sejak awal ialah cara mengurus dan memanipulasi struktur data yang berbeza, terutamanya senarai, kamus dan tupel. Kemahiran ini penting apabila saya mula bekerja pada apl Pengurusan Acara CLI, di mana saya perlu menyimpan dan mengendalikan berbilang keping data dengan cekap.

Menyelam ke dalam Projek: Menyediakan Persekitaran

Langkah pertama dalam mencipta apl CLI Pengurusan Acara ialah menyediakan persekitaran. Menggunakan Pipenv untuk pengurusan persekitaran maya merupakan pengalaman baharu. Ia memperkemas proses mengurus kebergantungan dan memastikan persekitaran projek diasingkan daripada sistem saya yang lain.

Begini cara saya menyediakan persekitaran maya:

pipenv install
pipenv shell

Seterusnya, saya memulakan Alembic untuk pemindahan pangkalan data. Langkah ini adalah penting untuk mengurus perubahan skema pangkalan data dari semasa ke semasa.

alembic init migrations
alembic revision --autogenerate -m "Create Initial models"
alembic upgrade head

Membina Model

Inti aplikasi terletak pada modelnya. Menggunakan SQLAlchemy ORM, saya menentukan model untuk pengguna, acara, jadual dan peserta. Di sinilah pemahaman saya tentang kelas Python dan SQLAlchemy berkumpul. Berikut ialah coretan fail models.py:

from sqlalchemy import Column, Integer, String, ForeignKey, DateTime, create_engine
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import relationship, sessionmaker

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)
    username = Column(String, unique=True, nullable=False)

class Event(Base):
    __tablename__ = 'events'
    id = Column(Integer, primary_key=True)
    name = Column(String, nullable=False)
    description = Column(String)
    user_id = Column(Integer, ForeignKey('users.id'))

    user = relationship('User', back_populates='events')

class EventSchedule(Base):
    __tablename__ = 'event_schedules'
    id = Column(Integer, primary_key=True)
    event_id = Column(Integer, ForeignKey('events.id'))
    start_time = Column(DateTime, nullable=False)
    end_time = Column(DateTime, nullable=False)

    event = relationship('Event', back_populates='schedules')

class Attendee(Base):
    __tablename__ = 'attendees'
    id = Column(Integer, primary_key=True)
    name = Column(String, nullable=False)
    event_id = Column(Integer, ForeignKey('events.id'))

    event = relationship('Event', back_populates='attendees')

User.events = relationship('Event', order_by=Event.id, back_populates='user')
Event.schedules = relationship('EventSchedule', order_by=EventSchedule.id, back_populates='event')
Event.attendees = relationship('Attendee', order_by=Attendee.id, back_populates='event')

Aspek Teknikal Berguna: Hubungan dalam SQLAlchemy

Salah satu aspek teknikal yang paling berguna yang saya pelajari semasa projek ini ialah mengendalikan perhubungan dalam SQLAlchemy. Menentukan perhubungan antara jadual menggunakan ORM SQLAlchemy menjadikannya lebih mudah untuk mengurus data dan melaksanakan pertanyaan. Sebagai contoh, mewujudkan hubungan satu-dengan-banyak antara pengguna dan acara membolehkan saya menanyakan semua acara yang dibuat oleh pengguna tertentu dengan mudah.

Begini cara saya mentakrifkan hubungan antara Pengguna dan Acara:

class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)
    username = Column(String, unique=True, nullable=False)
    events = relationship('Event', order_by='Event.id', back_populates='user')

class Event(Base):
    __tablename__ = 'events'
    id = Column(Integer, primary_key=True)
    name = Column(String, nullable=False)
    description = Column(String)
    user_id = Column(Integer, ForeignKey('users.id'))
    user = relationship('User', back_populates='events')

Takrifan perhubungan ini membenarkan saya menanyakan acara pengguna dengan mudah:

def get_user_events(user_id):
    user = session.query(User).filter(User.id == user_id).first()
    return user.events

Melaksanakan CLI

Bahagian CLI aplikasi telah dilaksanakan menggunakan Klik. Pustaka ini menjadikannya mudah untuk mencipta antara muka baris arahan yang boleh mengendalikan pelbagai arahan dan pilihan. Berikut ialah coretan daripada fail cli.py:

import click
from models import User, Event, EventSchedule, Attendee
from db import session

@click.group()
def cli():
    pass

@click.command()
def create_event():
    name = click.prompt('Enter event name')
    description = click.prompt('Enter event description')
    user_id = click.prompt('Enter user ID', type=int)
    event = Event(name=name, description=description, user_id=user_id)
    session.add(event)
    session.commit()
    click.echo('Event created!')

cli.add_command(create_event)

if __name__ == '__main__':
    cli()

Memandang Belakang

Mengimbas kembali, projek ini telah menjadi peristiwa penting dalam perjalanan saya sebagai pembangun. Ia bermula dengan mempelajari asas Python, yang meletakkan asas untuk memahami konsep yang lebih kompleks. Projek apl CLI Pengurusan Acara ialah gabungan sempurna antara muka Python, SQL dan baris arahan, memberikan pengalaman pembelajaran yang komprehensif.

Salah satu manfaat terbesar daripada projek ini ialah kepentingan struktur dan organisasi dalam pengekodan. Menggunakan persekitaran maya, mengurus kebergantungan dan mengekalkan struktur projek yang bersih menjadikan proses pembangunan lebih lancar dan cekap.

Selain itu, pengalaman praktikal dengan SQLAlchemy ORM dan Click mengukuhkan pengetahuan teori yang saya perolehi. Memahami cara mentakrifkan perhubungan antara jadual, melaksanakan pemindahan pangkalan data dan mencipta CLI mesra pengguna merupakan kemahiran yang tidak ternilai.

Kesimpulan

Mencipta aplikasi CLI Pengurusan Acara merupakan satu pengalaman yang mencabar namun bermanfaat. Ia mengukuhkan pemahaman saya tentang Python dan SQLAlchemy, memperkenalkan saya kepada amalan terbaik dalam pembangunan perisian, dan meningkatkan kemahiran menyelesaikan masalah saya. Bagi mana-mana pemula yang ingin berkembang sebagai pembangun, saya sangat mengesyorkan menyelam ke dalam projek seperti ini. Ia merupakan cara terbaik untuk menggunakan perkara yang telah anda pelajari, menemui alatan dan teknik baharu serta membina sesuatu yang nyata yang boleh anda banggakan.

https://github.com/migsldev/event-management-app

Atas ialah kandungan terperinci Perjalanan Saya Mencipta Apl CLI Pengurusan Acara. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!