Flask-WTF는 Flask 웹 프레임워크와 함께 사용되는 강력한 폼 구성 도구입니다. 중복된 값의 확인은 데이터 유효성 검사 중 가장 흔히 사용되는 작업 중 하나입니다. Flask-WTF를 사용하여 사용자가 입력한 값에 대한 중복 확인을 수행하는 방법에 대해 알아보겠습니다.

먼저, 중복 확인을 해야하는 필드가 있는 폼 클래스를 만듭니다. 예를 들어, 사용자 이름을 입력하는 폼에서 중복을 확인하려면 다음과 같이 작성할 수 있습니다.

from flask_wtf import FlaskForm
from wtforms import StringField, SubmitField
from wtforms.validators import DataRequired

from yourapp.models import User

class RegistrationForm(FlaskForm):
    username = StringField('사용자 이름', validators=[DataRequired()])
    submit = SubmitField('가입하기')

    def validate_username(self, field):
        user = User.query.filter_by(username=field.data).first()
        if user is not None:
            raise ValidationError('이 사용자 이름은 이미 사용 중입니다.')

위의 코드에서 RegistrationForm 클래스는 username 필드와 submit 버튼을 포함하고 있습니다. username 필드에는 DataRequired 유효성 검사기가 적용되어 필수 입력 항목임을 나타냅니다. validate_username 메서드는 사용자가 입력한 사용자 이름이 이미 데이터베이스에 있는지 확인합니다. 만약 이미 사용 중인 사용자 이름이라면 ValidationError을 발생시켜 중복된 것임을 알립니다.

또한, yourapp.models 모듈에는 User 모델이 있어야 합니다. 해당 모델은 데이터베이스의 사용자 테이블과 연결되며, 사용자 이름을 저장하는 열을 포함해야 합니다.

마지막으로, Flask 애플리케이션에서 위의 폼을 사용하고 중복 확인을 수행할 수 있습니다. Flask 라우트 함수에서 폼을 인스턴스화하고 유효성 검사를 수행하는 예제를 살펴보겠습니다.

from flask import Flask, render_template, redirect, url_for

from yourapp.forms import RegistrationForm

app = Flask(__name__)
app.config['SECRET_KEY'] = 'your-secret-key'

@app.route('/register', methods=['GET', 'POST'])
def register():
    form = RegistrationForm()

    if form.validate_on_submit():
        # 사용자 등록 로직을 수행합니다.

        return redirect(url_for('success'))

    return render_template('register.html', form=form)

@app.route('/success')
def success():
    return '가입이 완료되었습니다!'

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

위의 예제에서 /register 경로로 GET 또는 POST 요청을 받으면 RegistrationForm 폼을 인스턴스화합니다. form.validate_on_submit() 메서드는 폼이 유효하고 POST 요청일 경우 True를 반환하며, 이 경우에는 사용자 등록 로직을 수행하고 /success 경로로 리디렉션합니다. 폼이 유효하지 않은 경우 해당 폼을 사용하여 register.html 템플릿을 렌더링합니다.

이렇게 Flask-WTF를 사용하면 사용자가 입력한 값에 대한 중복 확인을 간단하게 수행할 수 있습니다. 이를 활용하여 복잡한 데이터 유효성 검사를 수행할 수도 있습니다.

참고: Flask-WTF는 WTForms 라이브러리에 기반하며, 데이터 유효성 검사 기능을 제공합니다. WTForms 문서를 참조하면 더 많은 유효성 검사기를 확인할 수 있습니다.