issue wanted

Masalah yang diinginkan

issue-wanted adalah aplikasi web yang berfokus pada peningkatan komunitas Haskell open-source dengan memusatkan masalah github di banyak repositori Haskell menjadi satu lokasi. Tujuan dari issue-wanted adalah untuk memudahkan pemrogram dari semua tingkat keterampilan untuk menemukan proyek Haskell untuk berkontribusi, meningkatkan jumlah kontribusi untuk proyek Haskell open-source, dan mendorong lebih banyak pemrogram untuk menjadi bagian dari komunitas Haskell.

Deskripsi Arsitektur

Pekerjaan utama pada proyek ini dilakukan selama Google Summer of Code 2019. Bagi siapa pun yang tertarik dengan rincian bagaimana issue-wanted diimplementasikan dan mengapa pilihan desain tertentu dibuat, lihat posting blog ini:

• GSOC 2019 - Membangun Aplikasi Web dengan Haskell
• Panduan untuk mengimplementasikan efek monadik kustom di Wanted-Wanted
• GSOC 2019 - Evaluasi Akhir

Backend

Prasyarat (apa yang perlu Anda miliki secara lokal)

Anda harus menginstal sistem Anda di sistem Anda untuk membangun dan menguji issue-wanted . Klik tautan untuk mempelajari cara menginstal masing -masing:

1. GHC
2. Kabal atau Tumpukan
3. buruh pelabuhan
4. libpq-dev : Jalankan perintah sudo apt install libpq-dev untuk menginstal.

Dengan docker diinstal, buka terminal (pastikan Anda di direktori issue-wanted ) dan jalankan perintah make postgres . Ini akan mengatur database untuk Anda dan Anda harus siap untuk pergi!

Ikuti instruksi di bawah How to run server dan uji titik akhir untuk melihat apakah semuanya diatur dengan benar.

Lihat masalah #81 jika Anda masih mengalami masalah.

Cara membangun

Untuk membangun proyek, buka terminal di folder dasar dan jalankan

stack build

atau

cabal v2-build

Cara menghasilkan jenis elm

Jika ada jenis yang diubah, seseorang harus memperbarui tipe yang dihasilkan ke elm dengan menjalankan:

stack run generate-elm

atau

cabal v2-run generate-elm

Cara menjalankan server

Untuk menguji server issue-wanted ikuti langkah-langkah ini:

1. Buka terminal di folder dasar dan jalankan stack build
2. Jalankan stack exec issue-wanted

Server akan mulai berjalan di http://localhost:8080/ .

API

Tersedia titik akhir yang diwanting masalah:

Titik akhir	Keterangan
/issues	Mengembalikan semua masalah.
/issues/:id	Mengembalikan satu masalah dengan ID yang sesuai.
/issues?label=<label name>	Mengembalikan daftar masalah dengan label yang sesuai.

Kiat: Jika Anda berhenti menjalankan server dan kemudian mencoba memulai ulang, Anda mungkin perlu menjalankan perintah fuser -n tcp -k 8080 untuk membebaskan port.

Cara menjalankan tes otomatis secara lokal

1. Di terminal terpisah, run make postgres (perintah ini akan menjalankan database dalam wadah Docker)
2. Di terminal pertama stack test run atau cabal new-test

Cara menggunakan gambar docker baru untuk CI

Ketika stack snapshot diperbarui, Anda perlu memperbarui Dockerfile sesuai dan mendorong gambar Docker baru ke Docker Hub. Ini hanya dapat dilakukan jika Anda memiliki akses ke kredensial akun.

Lakukan perintah berikut:

 docker build . -t kowainik/haskell-ci
docker push kowainik/haskell-ci

Frontend

Saat ini, Frontend diimplementasikan menggunakan Elm .

Prasyarat (apa yang perlu Anda miliki secara lokal)

• elm
• npm
• create-elm-app : Untuk menginstal Run npm install -g [email protected]

Bagaimana menjalankan

Catatan: Semua tindakan harus dilakukan di folder frontend :

 cd frontend/

Pertama kali

• Dapatkan Modul Node: npm install
• Lanjutkan ke langkah -langkah selanjutnya

Setelah

• Dalam satu tab: elm-app start
• di tab lain: npm run-script watch-css

Frontend akan mulai berjalan di http://localhost:3000/ .