actix realworld example app

Basis kode actix yang berisi contoh dunia nyata (crud, auth, pola canggih, dll) yang menganut spesifikasi dan API RealWorld.

❗ (2021/05/13) Basis kode ini saat ini tidak terawat, dan saya tidak tertarik untuk mempertahankannya. Ini bergantung pada versi lama Actix - pengembang yang ingin belajar Actix mungkin harus membaca dokumen terbaru di situs web Actix.

Basis kode ini dibuat untuk menunjukkan aplikasi fullstack yang sepenuhnya matang yang dibangun dengan Actix termasuk operasi CRUD, otentikasi, perutean, pagination, dan banyak lagi. CORS, bagaimanapun, belum ditambahkan.

Implementasi ini tidak ditinjau. Lihat bagian yang berkontribusi di bawah ini.

Untuk informasi lebih lanjut tentang bagaimana ini bekerja dengan frontend lain, pergilah ke repo RealWorld.

Cara kerjanya

Ini adalah aplikasi yang ditulis dalam karat yang menggunakan Actix untuk mengembangkan layanan web backend yang mendukung aplikasi RealWorld.

Anda dapat melihat daftar lengkap peti yang digunakan dalam kargo.toml, tetapi berikut adalah beberapa yang utama catatan:

• Actix - Kerangka kerja aktor yang kuat
• Chrono - Perpustakaan Tanggal dan Waktu untuk Karat
• Kegagalan - Suatu sistem untuk membuat dan mengelola kesalahan dalam karat
• Futures - Futures tanpa biaya di karat
• JSONWEBTOKen - Buat dan Parses JWT (JSON Web Tokens)
• Libreauth - Kumpulan alat untuk otentikasi pengguna
• Serde - Kerangka kerja untuk membuat serial dan deserialisasi struktur data karat secara efisien dan umumnya
• Uuid - menghasilkan dan menguraikan uuids
• Validator - Validasi sederhana untuk struct karat

Memulai

• Pasang karat
• Instal PostgreSQL jika Anda belum memilikinya.
• Instal diesel CLI dengan fitur postgres diaktifkan.
• Klone repo ini ke folder di komputer Anda.
• Salin ( cp ) .env.example to .env dalam direktori ini, dan ubah variabel lingkungan sesuai dengan sistem Anda.
• Mengatur database Anda dengan menjalankan diesel database setup . Pastikan itu telah berhasil selesai.
• Bangun proyek ini dengan cargo build . Anda dipersilakan untuk dikompilasi dengan --release jika Anda mau.
• Jalankan dengan cargo run .
• URL API akan menjadi apa pun nilai BIND_ADDRESS di .env dengan jalur /api termasuk misalnya https://127.0.0.1:3000/api . Atur seperti itu di klien istirahat Anda (tukang pos, insomnia, dll.), Impor koleksi tukang pos dan mulailah mengujinya!

Berkontribusi

Jangan ragu untuk melihat masalah saat ini dalam repo ini untuk apa pun yang saat ini perlu dikerjakan.

Anda juga dipersilakan untuk membuka masalah baru jika Anda melihat ada sesuatu yang hilang atau dapat ditingkatkan.