Unduh omoide cache - Unduh Kode Sumber omoide cache

omoide cache

Kode Sumber AI

1.0.0

Unduh

Omoide Cache - Solusi cache dalam memori sederhana

Caching tidak perlu lagi sulit. Dengan hanya beberapa baris kode Cache Omoide akan langsung membawa layanan Python Anda ke tingkat berikutnya!

Perpustakaan yang Dirilis : PYPI

Kode Sumber : GitHub

Tutorial №1 : Blog atau medium saya

Keterangan

Ini adalah solusi cache dalam memori yang kuat, sangat merdu dan mudah diintegrasikan yang ditulis dalam ular python murni, tanpa ketergantungan.

Ini dirancang untuk menjadi cache level metode, membungkus metode kelas tunggal, menggunakan argumen panggilan metode sebagai kunci cache dan menyimpan nilai pengembaliannya.

Dapat disesuaikan agar sesuai dengan kasus penggunaan spesifik Anda, menyediakan berbagai opsi kedaluwarsa dan refresh.

Sangat ramah pengguna, super mudah diintegrasikan dengan dekorator sederhana (yaitu anotasi, bagi mereka yang berasal dari java), tidak perlu menambahkan logika rumit ke dalam kode Anda, cukup gunakan @omoide_cache() di atas metode apa pun dalam layanan Anda. Ini akan menghasilkan cache secara otomatis untuk metode Anda dengan pengaturan default. Anda dapat menyesuaikan pengaturan ini lebih lanjut melalui parameter dekorator.

Kapan harus digunakan?

Anda mendapat panggilan berat ke sumber data, di mana data dibaca lebih sering daripada diperbarui.
Anda memiliki logika komputasi intensif CPU, yang membutuhkan beberapa detik untuk diselesaikan, tetapi dapat sering dipanggil dengan parameter input yang sama.

Kapan tidak menggunakan?

Pada metode yang tidak diharapkan sering dipanggil dengan argumen yang sama (misalnya model pemrosesan gambar / OCR / mL dengan input gambar)
Pada metode yang mengembalikan nilai -nilai baru setiap kali dipanggil, bahkan dengan argumen yang sama.
Saat Anda mengharapkan objek argumen atau objek yang mengembalikan untuk mengambil banyak memori. Cache akan dengan cepat memakan ram Anda jika Anda tidak mengatur mode kedaluwarsa dengan benar.
Fungsi yang dinyatakan di luar kelas tidak perlu pergi.

Peringatan yang Adil - Proyek ini berada pada tahap paling awal dari siklus hidupnya, akan ada banyak perbaikan dan perbaikan bug di masa depan. Semua saran dan laporan bug sangat diterima!

Instalasi

Instalasi normal

pip install omoide-cache

Instalasi Pengembangan

git clone https://github.com/jpleorx/omoide-cache.git
cd omoide-cache
pip install --editable .

Contoh

1 - Contoh Penggunaan Dasar

 import time
from omoide_cache import omoide_cache


# A class where cache was added to a simulated long running method
class ExampleService :
    @ omoide_cache ()
    def time_consuming_method ( self , x : int ) -> int :
        time . sleep ( 2.0 )
        return x * x


service = ExampleService ()

# The first call will execute real logic and store the result in cache
service . time_consuming_method ( 1 )

# The second call will get results from cache
service . time_consuming_method ( 1 )

2 - Contoh dengan batas ukuran

Di sini kami menambahkan cache yang akan menjatuhkan barang yang paling tidak sering diakses ketika cache menjadi terlalu besar.

 import time
from omoide_cache import omoide_cache , ExpireMode


class ExampleService :
    @ omoide_cache ( max_allowed_size = 10 , size_expire_mode = ExpireMode . ACCESS_COUNT_BASED )
    def time_consuming_method ( self , x : int ) -> int :
        time . sleep ( 2.0 )
        return x * x

3 - Contoh dengan kedaluwarsa waktunya

Di sini cache akan secara otomatis menghapus item yang terakhir diakses lebih dari 2 menit yang lalu.

 import time
from omoide_cache import omoide_cache


class ExampleService :
    @ omoide_cache ( expire_by_access_duration_s = 120 )
    def time_consuming_method ( self , x : int ) -> int :
        time . sleep ( 2.0 )
        return x * x

Atau kami dapat menghapus item yang dihitung lebih dari 2 menit yang lalu.

 import time
from omoide_cache import omoide_cache


class ExampleService :
    @ omoide_cache ( expire_by_computed_duration_s = 120 )
    def time_consuming_method ( self , x : int ) -> int :
        time . sleep ( 2.0 )
        return x * x

4 - Contoh dengan penyegaran async

Di sini cache akan menyegarkan item secara tidak sinkron yang dihitung lebih dari 2 menit yang lalu. Upaya untuk menyegarkan akan dilakukan setiap 10 detik.

 import time
from omoide_cache import omoide_cache , RefreshMode


class ExampleService :
    @ omoide_cache ( refresh_duration_s = 120 , refresh_period_s = 10 , refresh_mode = RefreshMode . INDEPENDENT )
    def time_consuming_method ( self , x : int ) -> int :
        time . sleep ( 2.0 )
        return x * x

Bug yang dikenal

Anda perlu menggunakan dekorator dengan tanda kurung sepanjang waktu, bahkan ketika Anda tidak menentukan argumen apa pun, jadi gunakan @omoide_cache() , tetapi bukan @omoide_cache . Sejujurnya saya tidak tahu mengapa ada perilaku aneh di dekorator ini, akan melakukan yang terbaik untuk memperbaikinya di pembaruan mendatang.