Skip to content

Latest commit

 

History

History
128 lines (89 loc) · 3.93 KB

README_id.md

File metadata and controls

128 lines (89 loc) · 3.93 KB
Raw

hoyo-code

Indonesia | English

hoyo-code

Pengenalan

Proyek ini adalah alat Python 3 yang dirancang untuk mengumpulkan kode promosi atau redeem dari halaman Wiki Fandom untuk game Hoyoverse. Scraper ini mengambil kode redeem yang aktif dan kedaluwarsa, serta diotomatisasi untuk berjalan secara berkala menggunakan GitHub Actions, memastikan kode terbaru selalu tersedia.

Fitur

  • Pengumpulan Kode Otomatis: Mengambil kode promosi terbaru dari halaman Wiki Fandom.
  • Game yang Didukung: Genshin Impact, Honkai Star Rail, Honkai Impact 3rd.
  • Pembaruan Otomatis: Workflow GitHub Actions terjadwal untuk menjalankan scraper dan memperbarui daftar kode.
  • Mudah Digunakan: Mengambil dan menampilkan kode dalam format JSON & TXT untuk kemudahan penggunaan.

Fitur Mendatang

  • Game yang Didukung: Zenzenles Zone Zero.

Persyaratan

  • Python 3.12+

Penggunaan

1. Clone repositori:

git clone https://github.com/haiueom/hoyo-code.git
cd hoyo-code

2. Instal dependensi:

Dependensi yang digunakan dalam proyek ini:

  • requests untuk melakukan HTTP request
  • beautifulsoup4 untuk parsing HTML

Untuk menginstal semua dependensi pip yang dibutuhkan:

pip install -r requirements.txt

3. Jalankan Scraper

Untuk menjalankan scraper secara manual:

python main.py

Script ini akan mengambil kode redeem terbaru dan menyimpannya dalam file JSON & TXT.

Otomatisasi dengan GitHub Actions

Workflow GitHub Actions sudah disiapkan untuk mengotomatisasi proses pengumpulan kode dan memperbarui daftar kode secara berkala (misalnya, harian).

1. Mengaktifkan GitHub Actions

  1. Di repositori Anda, buka tab Actions.
  2. Pastikan Actions sudah diaktifkan.

2. Workflow GitHub Actions

File .github/workflows/scraper.yml sudah disertakan untuk mendefinisikan jadwal dan langkah-langkah otomatisasi. Anda dapat mengubah waktu cronjob sesuai keinginan.

[!PENTING] Frekuensi maksimum cronjob pada GitHub Actions adalah setiap 5 menit.

name: Hoyoverse Code Scraper

on:
    schedule:
        - cron: "0 0 * * *" # ini bisa di ubah
    workflow_dispatch:

scrape-codes:
    runs-on: ubuntu-latest
    permissions:
        contents: write
    steps:
        - name: checkout repository
          uses: actions/checkout@v4
        - name: setup python
          uses: actions/setup-python@v5
          with:
              python-version: 3.12.x
              cache: "pip"
        - name: install dependencies
          run: |
              python -m pip install --upgrade pip
              pip install -r requirements.txt
        - name: run the scraper
          run: |
              python main.py
        - name: commit and push changes
          run: |
              git config --local user.name "github-actions[bot]"
              git config --local user.email "github-actions[bot]@users.noreply.github.com"
              git add .

              # Check if there are changes
              if ! git diff-index --quiet HEAD; then
              git commit -m "update: $(date +'%Y-%m-%d')"
              git push
              else
              echo "No changes to commit"
              fi

Dukung Proyek Ini

Jika Anda merasa proyek ini bermanfaat dan ingin mendukung pengembangannya, pertimbangkan untuk:

  • Memberikan bintang pada repositori: Ini membantu orang lain menemukan proyek ini dan memberi tahu saya bahwa proyek ini bermanfaat.
  • Berkontribusi: Laporan bug, saran fitur, dan kontribusi kode sangat disambut baik!
  • Donasi: Jika Anda ingin mendukung saya secara langsung, Anda bisa membelikan saya kopi atau Saweria.

Teruntuk semua yang sudah berkenan membantu dalam pengembangan proyek ini, saya ucapkan terima kasih.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT.