labu pemotong kue
Templat Flask untuk pemotong kue. (Mendukung Python ≥ 3.8)
Lihat repo ini untuk contoh proyek yang dihasilkan dari templat versi terbaru.
Gunakan sekarang
Docker (Ini adalah metode pilihan untuk membuat proyek baru)
$ 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
Standar
Jika menggunakan instruksi standar, diperlukan Python ≥ 3.8. Lingkungan virtual disarankan (seperti virtualenv
).
pip3 install cookiecutter
cookiecutter https://github.com/cookiecutter-flask/cookiecutter-flask.git
Anda akan ditanya tentang info dasar Anda (nama, nama proyek, nama aplikasi, dll.). Info ini akan digunakan dalam proyek baru Anda.
Konfigurasikan dan Jalankan
Setelah Anda membuat kode proyek, beberapa langkah lagi harus diambil sebelum aplikasi baru Anda berjalan. README dari proyek yang dihasilkan menunjukkan kepada Anda cara mengkonfigurasi dan menjalankan aplikasi. (Anda dapat melihat template README di sini).
Fitur
- Bootstrap 5 dan Font Awesome 6 dengan templat pemula
- Flask-SQLAlchemy dengan model Pengguna dasar
- Migrasi basis data yang mudah dengan Flask-Migrate
- Konfigurasi dalam variabel lingkungan, sesuai dengan Aplikasi Dua Belas Faktor
- Flask-WTForms dengan formulir login dan registrasi
- Flask-Login untuk otentikasi
- Flask-Bcrypt untuk hashing kata sandi
- Procfile untuk diterapkan ke PaaS (misalnya Heroku)
- pytest dan Factory-Boy untuk pengujian (termasuk tes contoh)
- CLI Klik Flask dikonfigurasikan dengan perintah sederhana
- Minifikasi CSS dan JS menggunakan webpack
- dukungan npm untuk manajemen paket frontend
- Caching menggunakan Flask-Cache
- Toolbar debug yang berguna
- Memanfaatkan praktik terbaik: Cetak Biru dan pola Pabrik Aplikasi
Tangkapan layar
Inspirasi
- Penataan Aplikasi Flask
- Flask-Foundation oleh @JackStouffer
- labu-tulang oleh @cburmeister
- flask-basic-registrasi oleh @mjhea0
- Dokumentasi Resmi Labu
Lisensi
berlisensi MIT.
log perubahan
Belum dirilis
- Perbarui semua dependensi node ke versi terbaru
- Beralih menggunakan Tindakan Github untuk CI templat
- Hapus dukungan untuk Node 10 sebagai opsi Cookiecutter
- Image Docker yang difaktorkan ulang untuk menggunakan build multistage dengan lebih efisien
- Proyek yang dihasilkan dengan templat menggunakan tindakan Github untuk CI
- Tingkatkan Webpack ke 5.x
- Menghapus dukungan Python 3.6, 3.7, dan 3.8
- Menambahkan dukungan Python 3.9, 3.10, 3.11, dan 3.12
- Menambahkan Node 18 dan 20 LTS
- Menghapus Node 12, 14, dan 16 LTS
18.0.0 (09/09/2018)
- Gunakan CalVer (
YY.MINOR.MICRO
). - Tingkatkan ke Bootstrap 4. Terima kasih @adawalli dan @Hiyorim.
- Gunakan variabel lingkungan untuk konfigurasi.
- Tambahkan dukungan untuk Pipenv.
- Tingkatkan dependensi Python dan Node.
0.13.0 (25/06/2017)
- Gunakan webpack untuk membangun aset front-end. Ketergantungan front-end diinstal dengan NPM. Hapus Flask-Assets dan bower.json. Terima kasih @wroberts.
0.12.0 (11/06/2016)
- Perbarui dependensi Python.
0.11.1 (11/06/2016)
- Lewatkan parameter pertama ke
Flask
dengan benar sesuai dengan dokumen 0.11. Terima kasih @aliavni. - Hapus alat pengaturan dan roda sebagai dependensi untuk memperbaiki penerapan di Heroku. Terima kasih @Cabalist.
- Jadikan User.password sebagai bidang Biner untuk kompatibilitas dengan versi baru bcrypt. Sekali lagi terima kasih @Cabalist.
0.11.0 (09/10/2016)
- Gunakan variabel lingkungan sistem FLASK_DEBUG, bukan MYFLASKAPP_ENV, untuk mengontrol konfigurasi berbeda untuk lingkungan pengembangan dan produksi
0.10.1 (28/08/2016)
- Perbaiki perintah
invoke test
.
0.10.0 (28/08/2016)
- Perbarui ke Flask 0.11.
- Gunakan Click alih-alih Flask-Script untuk perintah CLI.
0.9.0 (03/06/2016)
- Perbarui persyaratan basi.
- Tambahkan perlindungan CSRF.
- Jalankan perintah
lint
pada build Travis. - Uji terhadap Python 3.5.
0.8.0 (11/09/2015)
- Perbarui persyaratan basi.
- Tambahkan perintah pengelolaan
lint
, clean
, dan urls
. - Tambahkan isort.
Terima kasih @andreoliw atas kontribusinya.
0.7.0 (14/04/2015)
- Perbarui gaya impor ekstensi ke flask_* sesuai mitsuhiko/flask#1135.
- Perbarui persyaratan lama (Werkzeug, Flask-WTF, WTForms, Flask-Bcrypt, Flask-DebugToolbar, Flask-Migrate, Bootstrap, jQuery). Terima kasih @bsmithgall telah memberi tahu saya tentang patch penting pada Flask-Migrate.
0.6.0 (12/01/2014)
- Uji pemotong kue di Travis. Terima kasih @joshfriend.
- Perbarui persyaratan lama (Flask-WTF, Flask-Migrate, Flask-DebugToolbar)
0.5.0 (29/09/2014)
- Perbaiki .travis.yml.
- Perbarui persyaratan basi (Flask-WTF, WTForms, Flask-SQLAlchemy, jquery, Bootstrap)
0.4.3 (27/07/2014)
- Tambahkan kelas
BaseFactory
. - Tambahkan modul compat.py.
- Tes lulus pada Python 3.
0.4.2 (27/07/2014)
- Perbarui sintaks pabrik ke factory-boy >= 2.4.0.
- Perbarui persyaratan basi.
0.4.1 (06/07/2014)
- Perbarui persyaratan basi (Werkzeug 0.9.6, WTForms 2.0)
- Perbaiki tag div yang tidak cocok di home.html (terima kasih @ level09)
0.4.0 (19/04/2014)
- Tambahkan ReferensiCol untuk kolom kunci asing yang tidak terlalu panjang.
- Tambahkan mixin SurrogatePK untuk menambahkan kunci utama bilangan bulat ke model.
- Tambahkan kelas Model dasar yang memiliki metode kenyamanan CRUD.
- Perbaiki pengaturan kompleksitas enkripsi BCrypt. Tes jauh lebih cepat.
- Tambahkan model Peran untuk memperlihatkan penggunaan ReferensiCol.
- Beralih ke pytest.
- Tingkatkan semua persyaratan yang sudah ketinggalan zaman.
- Contoh tes lainnya.
- Hapus "tahun" dari cookiecutter.json (ubah saja LICENSE jika perlu).
0.3.2 (26/02/2014)
0.3.1 (20/02/2014)
- Perbarui tahun default di cookiecutter.json. Terima kasih @Omeryl
- Pengujian pengalihan yang benar di webtests. Terima kasih @Widdershin
- Perbaiki tindakan POST dalam bentuk nav. Terima kasih @Widdershin.
- Perbarui Bootstrap (3.1.1) dan jQuery (2.1.0)
- Dukungan opsional untuk bower.
- Aset yang diperkecil tidak digunakan di lingkungan pengembang.
0.3.0 (12/08/2013)
- Organisasi yang lebih modular: setiap cetak biru berisi tampilan, model, dan formulirnya sendiri dalam sebuah direktori. Masih ada satu direktori untuk templat dan aset statis.
- Gunakan Flask-Bcrypt untuk hashing kata sandi.
- Flask-Login untuk otentikasi.
- Pengaturan pengujian sederhana. Cukup buat subkelas
DbTestCase
. - Dukungan Pengujian Labu.
- Gunakan Factory-Boy untuk menguji pabrik.
- Gunakan WebTest untuk pengujian fungsional.
- Tambahkan Flask-Debugtoolbar.
- Migrasi menggunakan Flask-Migrate.
- Caching menggunakan Flask-Cache.
- Tambahkan templat halaman kesalahan (404, 401, 500)
- Tambahkan Font Awesome 4.0.3 untuk ikon.
0.2.0 (21/09/2013)
- Tambahkan skrip kelola.py
- Tambahkan Flask-Assets untuk bundling+minifikasi CSS dan JS
- Gunakan konfigurasi berbeda untuk lingkungan pengembangan dan produksi, yang dikontrol oleh variabel lingkungan sistem MYFLASKAPP_ENV
- Gunakan Cetak Biru dan pola pabrik aplikasi. Cabang
simple
tidak menggunakan ini.
0.1.0 (20/08/2013)
- Iterasi pertama
- Bootstrap 3 terakhir
- Model dan registrasi Pengguna yang Bekerja