قارورة قطع الكعكة
قالب قارورة لقطع الكعكة. (يدعم بايثون ≥ 3.8)
راجع هذا الريبو للحصول على مثال لمشروع تم إنشاؤه من أحدث إصدار من القالب.
استخدمه الآن
Docker (هذه هي الطريقة المفضلة لإنشاء مشروع جديد)
$ git clone https://github.com/cookiecutter-flask/cookiecutter-flask.git
$ cd cookiecutter-flask
# Basic usage (You will be prompted to provide basic information about your application)
$ ./cookiecutter-docker.sh
full_name [Steven Loria]:
...
# The repository for your flask app will be created in a directory with the name
# chosen in "package import name" question (default ./my_flask_app/)
# Additional arguments are available
$ ./cookiecutter-docker.sh --help
Usage: ./cookiecutter-docker.sh [OPTIONS]
Options:
-b, --build Build Docker image before running cookiecutter
-h, --help Show this message and exit
معيار
في حالة استخدام التعليمات القياسية، يلزم وجود Python ≥ 3.8. يوصى باستخدام بيئة افتراضية (مثل virtualenv
).
pip3 install cookiecutter
cookiecutter https://github.com/cookiecutter-flask/cookiecutter-flask.git
سيتم سؤالك عن معلوماتك الأساسية (الاسم، اسم المشروع، اسم التطبيق، وما إلى ذلك). سيتم استخدام هذه المعلومات في مشروعك الجديد.
تكوين وتشغيل
بعد إنشاء رمز المشروع، يجب اتخاذ بعض الخطوات الإضافية قبل تشغيل تطبيقك الجديد. يوضح لك الملف التمهيدي الخاص بالمشروع الذي تم إنشاؤه كيفية تكوين التطبيق وتشغيله. (يمكنك رؤية النموذج التمهيدي هنا).
سمات
- Bootstrap 5 وFont Awesome 6 مع قوالب البدء
- Flask-SQLAlchemy مع نموذج المستخدم الأساسي
- عمليات ترحيل قاعدة البيانات بسهولة باستخدام Flask-Migrate
- التكوين في متغيرات البيئة، وفقًا لتطبيق Twelve-Factor
- Flask-WTForms مع نماذج تسجيل الدخول والتسجيل
- قارورة تسجيل الدخول للمصادقة
- Flask-Bcrypt لتجزئة كلمة المرور
- ملف تعريف للنشر إلى PaaS (مثل Heroku)
- pytest وFactory-Boy للاختبار (تشمل الاختبارات النموذجية)
- تم تكوين Flask's Click CLI بأوامر بسيطة
- تصغير CSS وJS باستخدام حزمة الويب
- دعم npm لإدارة حزم الواجهة الأمامية
- التخزين المؤقت باستخدام Flask-Cache
- شريط أدوات تصحيح مفيد
- يستخدم أفضل الممارسات: المخططات وأنماط مصنع التطبيقات
لقطات الشاشة
إلهام
- هيكلة تطبيقات القارورة
- مؤسسة القارورة بواسطةJackStouffer
- عظام القارورة بواسطةcburmeister
- التسجيل الأساسي للقارورة بواسطة @mjhea0
- قارورة الوثائق الرسمية
رخصة
معهد ماساتشوستس للتكنولوجيا مرخص.
سجل التغيير
غير منشور
- قم بتحديث كافة تبعيات العقدة إلى أحدث الإصدارات
- قم بالتبديل إلى استخدام Github Actions لقالب CI
- إزالة الدعم لـ Node 10 كخيار Cookiecutter
- صورة Docker مُعاد تشكيلها لاستخدام بنيات متعددة المراحل بشكل أكثر كفاءة
- تستخدم المشاريع التي تم إنشاؤها باستخدام القالب إجراءات Github لـ CI
- ترقية Webpack إلى 5.x
- تم إسقاط دعم Python 3.6 و3.7 و3.8
- تمت إضافة دعم Python 3.9 و3.10 و3.11 و3.12
- تمت إضافة العقدة 18 و20 LTS
- تمت إزالة العقدة 12 و14 و16 LTS
18.0.0 (09/09/2018)
- استخدم كالفير (
YY.MINOR.MICRO
). - قم بالترقية إلى Bootstrap 4. شكرًا @adawalli و@Hiyorim.
- استخدم متغيرات البيئة للتكوين.
- إضافة دعم لـ Pipenv.
- ترقية تبعيات بايثون والعقدة.
0.13.0 (25/06/2017)
- استخدم حزمة الويب لبناء أصول الواجهة الأمامية. يتم تثبيت تبعيات الواجهة الأمامية باستخدام NPM. قم بإزالة Flask-Assets وbower.json. شكرا @روبرتس.
0.12.0 (2016/11/06)
0.11.1 (2016/11/06)
- قم بتمرير المعلمة الأولى إلى
Flask
بشكل صحيح وفقًا لمستندات 0.11. شكرا @aliavni. - قم بإزالة أدوات الإعداد والعجلة كتبعيات لإصلاح النشر على Heroku. شكرا @ كاباليست.
- اجعل User.password حقلاً ثنائيًا للتوافق مع الإصدارات الجديدة من bcrypt. شكرا مرة أخرىCabalist.
0.11.0 (2016/09/10)
- استخدم متغير بيئة النظام FLASK_DEBUG، بدلاً من MYFLASKAPP_ENV، للتحكم في التكوينات المختلفة لبيئات التطوير والإنتاج
0.10.1 (28/08/2016)
0.10.0 (28/08/2016)
- التحديث إلى قارورة 0.11.
- استخدم النقر بدلاً من Flask-Script لأوامر CLI.
0.9.0 (03/06/2016)
- تحديث المتطلبات التي لا معنى لها.
- إضافة حماية CSRF.
- قم بتشغيل أمر
lint
على إصدارات Travis. - اختبار ضد بايثون 3.5.
0.8.0 (2015/09/11)
- تحديث المتطلبات التي لا معنى لها.
- أضف أوامر إدارة
lint
clean
وعناوين urls
. - أضف إيزرت.
شكرًا @andreoliw على هذه المساهمات.
0.7.0 (14/04/2015)
- قم بتحديث نمط استيراد الامتداد إلى flask_* وفقًا لـ mitsuhiko/flask#1135.
- تحديث المتطلبات القديمة (Werkzeug، Flask-WTF، WTForms، Flask-Bcrypt، Flask-DebugToolbar، Flask-Migrate، Bootstrap، jQuery). شكرًا @bsmithgall لإعلامي بالتصحيح المهم لبرنامج Flask-Migrate.
0.6.0 (12/01/2014)
- اختبر قاطعة الكعك على ترافيس. شكرا @ جوش فريند.
- تحديث المتطلبات القديمة (Flask-WTF، Flask-Migrate، Flask-DebugToolbar)
0.5.0 (29/09/2014)
- إصلاح .travis.yml.
- تحديث المتطلبات القديمة (Flask-WTF، WTForms، Flask-SQLAlchemy، jquery، Bootstrap)
0.4.3 (27/07/2014)
- أضف فئة
BaseFactory
. - أضف وحدة compat.py.
- تمر الاختبارات على بايثون 3.
0.4.2 (27/07/2014)
- قم بتحديث المصانع إلى صيغة المصنع >= 2.4.0.
- تحديث المتطلبات التي لا معنى لها.
0.4.1 (07/06/2014)
- تحديث المتطلبات القديمة (Werkzeug 0.9.6، WTForms 2.0)
- إصلاح علامة div التي لا مثيل لها في home.html (شكرًا @level09)
0.4.0 (19/04/2014)
- أضف ReferenceCol لأعمدة المفاتيح الخارجية الأقل تفصيلًا.
- أضف مزيج SurrogatePK لإضافة مفتاح أساسي صحيح إلى النموذج.
- أضف فئة النموذج الأساسية التي تحتوي على أساليب ملائمة CRUD.
- إصلاح إعداد تعقيد تشفير BCrypt. الاختبارات أسرع بكثير.
- أضف نموذج الدور لإظهار استخدام ReferenceCol.
- قم بالتبديل إلى بيتيست.
- ترقية جميع المتطلبات القديمة.
- المزيد من الأمثلة الاختبارية.
- قم بإزالة "السنة" من cookiecutter.json (فقط قم بتغيير الترخيص إذا لزم الأمر).
0.3.2 (26/02/2014)
0.3.1 (20/02/2014)
- قم بتحديث السنة الافتراضية في ملف cookiecutter.json. شكرا @ أوميريل
- الاختبار الصحيح لعمليات إعادة التوجيه في اختبارات الويب. شكرا @Widdershin
- إصلاح إجراء POST في نموذج التنقل. شكرا @Widdershin.
- تحديث Bootstrap (3.1.1) وjQuery (2.1.0)
- دعم اختياري للكوخ.
- لا يتم استخدام الأصول المصغرة في بيئة التطوير.
0.3.0 (12/08/2013)
- مزيد من التنظيم المعياري: يحتوي كل مخطط على طريقة العرض والنماذج والنماذج الخاصة به في الدليل. لا يزال هناك دليل واحد للقوالب والأصول الثابتة.
- استخدم Flask-Bcrypt لتجزئة كلمة المرور.
- قارورة تسجيل الدخول للمصادقة.
- إعداد اختبار بسيط. فقط قم بإنشاء فئة فرعية من
DbTestCase
. - دعم اختبار القارورة.
- استخدم Factory-Boy لمصانع الاختبار.
- استخدم WebTest للاختبار الوظيفي.
- إضافة Flask-Debugtoolbar.
- عمليات الترحيل باستخدام Flask-Migrate.
- التخزين المؤقت باستخدام Flask-Cache.
- إضافة قوالب صفحة الخطأ (404، 401، 500)
- إضافة Font Awesome 4.0.3 للأيقونات.
0.2.0 (21/09/2013)
- أضف البرنامج النصي Manage.py
- أضف Flask-Assets لتجميع CSS وJS + التصغير
- استخدم تكوينات مختلفة لبيئات التطوير والإنتاج، التي يتم التحكم فيها بواسطة متغير بيئة النظام MYFLASKAPP_ENV
- استخدم المخططات ونمط مصنع التطبيقات. الفرع
simple
لا يستخدم هذه.
0.1.0 (20/08/2013)
- التكرار الأول
- بوتستراب 3 النهائي
- نموذج المستخدم العامل والتسجيل