codever

⚡? ️ Bookmark dan Manajer Cuplikan untuk Pengembang & CO? ⚡️

Gunakan halaman howto kami untuk membuat Anda pergi dan mulai menghemat waktu dan saraf saat mengelola bookmark dan cuplikan kode Anda. Pembantu dan ekstensi berikut akan membantu Anda di sepanjang jalan:

Ekstensi

Bookmarklet	Ekstensi kromium	Addon Firefox	Plugin Intellij	Ekstensi VScode

Contoh Penggunaan Ekstensi Chrome - Simpan Cuplikan

Ekstensi lainnya berfungsi lebih atau kurang setelah prinsip yang sama

Bookmark publik

---

Bookmark publik yang layak diterbitkan secara berkala di Github di CodeverDotdev/Bookmarks.

---

Pengaturan (pengembangan atau hosting mandiri)

Instruksi ini akan memberi Anda salinan proyek dan berjalan di mesin lokal Anda untuk tujuan pengembangan dan pengujian.

Proyek ini dikembangkan dengan tumpukan rata -rata dan keycloak untuk otentikasi dan otorisasi:

Proyek ini berisi dua aplikasi

• codever-ui yang membentuk antarmuka pengguna. Ini digunakan dengan CLI sudut dan sudut.
• Codever-API yang merupakan API yang mendukung UI. Menggunakan ExpressJs dengan MongoDB dan Keycloak. Lihat spesifikasi OpenAPI

Prasyarat

Apa yang Anda butuhkan untuk menjalankan aplikasi ini:

• node dan npm (kami sarankan menggunakan NVM)
  • Pastikan Anda menjalankan node setidaknya ( v16.xx +) dan npm ( 8.xx +)
• nodemon - npm install -g nodemon
• Docker - kami sarankan menggunakan Docker Desktop

Docker dan Docker-Compose saat ini hanya digunakan untuk pengembangan lokal

Menginstal ( Pengaturan Pengembangan )

Mulai MongoDB dan Keycloak Server

️ Saat Anda menjalankan docker compose untuk pertama kalinya Uncomment yang berikut -Dkeycloak.migration.action=import Baris:

    # command: -Dkeycloak.migration.action=import -Dkeycloak.migration.provider=dir -Dkeycloak.migration.dir=/tmp/keycloak/export-import -Dkeycloak.migration.strategy=IGNORE_EXISTING

Dalam file compose Docker, sehingga pengaturan Keycloak awal (ranah dan pengguna) dimuat .

️ Untuk startup lebih lanjut dari Docker-Compose, Anda harus berkomentar kembali baris ini , karena dimulai lebih cepat

docker-compose up

Gunakan -d untuk menjalankannya di latar belakang

Instal dan Jalankan (Frontend & Backend)

Anda ingin API backend berjalan terlebih dahulu dengan perintah berikut:

 # install
nvm use   # only if you are using nvm
npm install

# run
npm run frontend # to run the frontend
npm run backend # to run the backend

# alternatively run in parallel
npm start

atau dalam satu baris nvm use; npm install; npm start

Ini dimulai

• API dengan nodemon di http: // localhost: 3000/API dan akan menonton perubahan kode di backend dan secara otomatis diputar ulang.
• Frontend tersedia di http: // localhost: 4200. Masuki mock/mock kata sandi yang dikonfigurasi untuk Anda di pengaturan Keycloak awal. Beberapa bookmark awalnya dimuat dengan akun Anda, sehingga Anda dapat mulai bermain dengan mereka.

Anda dapat membuat pengguna uji Anda sendiri, atau pengguna tambahan lainnya dengan mengikuti tangkapan layar di Tambahkan Pengguna Keycloak untuk membuatnya.

Untuk dapat secara otomatis menambahkan video YouTube tanggal dan durasi yang diterbitkan ke judul yang Anda butuhkan untuk membuat file nodemon.json berdasarkan backend/nodemon.json.example dan tambahkan tombol API YouTube Anda sendiri

Keycloak

Konsol Keycloak Admin dapat dijangkau di http: // localhost: 8080/auth dengan admin/Pa55w0rd (lihat file compose Docker)

Pengujian

Tes E2E (Integrasi) dengan Cypress

Keycloak dan MongoDB harus dimulai sebagaimana ditentukan di atas (perintah docker-compose up )

Jalankan tes integrasi dengan mengeluarkan perintah berikut.

 cd apps/codever-ui
npm run cy:run

Untuk membuka Cypress Anda dapat menjalankan tugas berikut npm run cy:open

API (backend)

Tes integrasi

Keycloak dan MongoDB harus dimulai sebagaimana ditentukan di atas (perintah docker-compose up )

Jalankan tes integrasi dengan mengeluarkan perintah berikut.

 cd apps/codever-api
npm run integration-tests

Laporan akan dihasilkan.

Debugging

Ui (frontend)

Alat pengembang di browser kromium

Anda dapat menggunakan alat pengembang di browser berbasis kromium (misalnya Chrome, Berani). Arahkan ke sumber dan file yang ingin Anda atur titik istirahat Anda, seperti dalam contoh berikut:

IntelliJ

Di IntelliJ Anda menambahkan konfigurasi JavaScript Debug seperti yang ditunjukkan di bawah ini:

Backend

Intellij / Webstorm (Plugin Node.js diperlukan)

npm run debug memulai nodemon dengan parameter --inspect sehingga Anda dapat melampirkan proses ini, dengan menggunakan konfigurasi berikut:

Kode Studio Visual

Lihat Debugging Node.js dalam VS Code dengan Nodemon

Blog

Posting blog terkait dengan fitur codever dan detail implementasi dapat ditemukan di codepedia.org dan dev.to

Berkontribusi

Harap baca Contributing.md untuk perincian tentang kode perilaku kami, dan proses untuk mengirimkan permintaan tarik kepada kami.

Versi

Kami menggunakan SEMVER untuk versi. Untuk versi yang tersedia, lihat tag di repositori ini.

Changelog

Changelog tersedia di Changelog.md

Untuk memperbarui changelog, jalankan perintah berikut:

nvm use
standard-changelog

Lisensi

Proyek ini dilisensikan di bawah lisensi MIT - lihat file lisensi untuk detailnya.

Semua materi media yang digunakan dalam proyek termasuk dalam undang -undang hak cipta