risnaberti-nanumber 0.1.1

Universal auto-number generator by Risna Berti (Nanumber)

📦 Risnaberti Nanumber

Universal auto-number generator library by Risna Berti (Nana)
Aman, fleksibel, dan mudah diintegrasikan ke FastAPI, Django, Flask, atau framework lainnya.

---

✨ Fitur Utama

✅ Format fleksibel: #SUP-{y}{number} → #SUP-250001
✅ Reset otomatis per tahun / bulan
✅ Thread-safe (aman dari race condition)
✅ Multi-storage (Memory, SQLite, PostgreSQL, MySQL)
✅ Siap integrasi ke FastAPI / Django
✅ Terinspirasi dari Laravel Nanamber

---

🧱 Instalasi

pip install risnaberti-nanumber

---

⚙️ Quick Start (Demo Mode)

🧩 Gunakan MemoryStorage untuk testing atau eksplorasi awal.
Data hanya disimpan sementara di RAM — akan hilang setelah program dihentikan.

from risnaberti.nanumber import NumberGenerator, MemoryStorage

# Gunakan penyimpanan in-memory (sementara)
storage = MemoryStorage()
gen = NumberGenerator(storage)

print(gen.generate("supplier", "#SUP-{y}{number}"))
# 👉 #SUP-250001

Cocok untuk demo atau unit test, bukan untuk produksi.

---

💾 Production Mode (Persistent Storage)

💾 Gunakan SQLAlchemyStorage untuk penyimpanan permanen di database.
Nanumber akan otomatis membuat tabel auto_numbers untuk menyimpan last_value.

from risnaberti.nanumber import NumberGenerator, SQLAlchemyStorage

# Gunakan SQLite (atau PostgreSQL/MySQL)
storage = SQLAlchemyStorage("sqlite:///nanumber.db")

gen = NumberGenerator(storage)
print(gen.generate("invoice", "INV-{Y}-{number:04d}"))
# 👉 INV-2025-0001

Setelah restart aplikasi, nomor akan berlanjut dari nilai terakhir di tabel database.

---

⚙️ Integrasi dengan FastAPI

1️⃣ Instal dependency

pip install fastapi[all] risnaberti-nanumber

2️⃣ Tambahkan endpoint

# app/main.py
from fastapi import FastAPI
from risnaberti.nanumber import NumberGenerator, SQLAlchemyStorage

app = FastAPI()

storage = SQLAlchemyStorage("sqlite:///nanumber.db")
gen = NumberGenerator(storage)

@app.get("/generate/{entity}")
def generate_number(entity: str):
    format_map = {
        "supplier": "#SUP-{y}{number:04d}",
        "invoice": "INV-{Y}-{number:05d}",
    }
    fmt = format_map.get(entity, "{Y}{number:04d}")
    return {"entity": entity, "number": gen.generate(entity, fmt)}

3️⃣ Jalankan server

uvicorn app.main:app --reload

Buka:

• 🔹 http://localhost:8000/generate/supplier
• 🔹 http://localhost:8000/generate/invoice

---

🧩 Integrasi dengan Django

# apps/supplier/signals.py
from django.db.models.signals import pre_save
from django.dispatch import receiver
from .models import Supplier
from risnaberti.nanumber import NumberGenerator, SQLAlchemyStorage

storage = SQLAlchemyStorage("sqlite:///db.sqlite3")
gen = NumberGenerator(storage)

@receiver(pre_save, sender=Supplier)
def generate_supplier_code(sender, instance, **kwargs):
    if not instance.code:
        instance.code = gen.generate("supplier", "#SUP-{y}{number}")

---

🔢 Contoh Format Nomor

Template	Hasil	Keterangan
#SUP-{y}{number}	#SUP-250001	Tahun 2 digit
INV-{Y}-{number:05d}	INV-2025-00001	Tahun penuh + padding
{m}{number:03d}	11001	Reset otomatis tiap tahun

---

🧠 Uji Multi-thread (Concurrency Test)

import threading
from risnaberti.nanumber import NumberGenerator, SQLAlchemyStorage

storage = SQLAlchemyStorage("sqlite:///test.db")
gen = NumberGenerator(storage)

def worker():
    print(gen.generate("supplier", "#SUP-{y}{number:04d}"))

threads = [threading.Thread(target=worker) for _ in range(10)]
for t in threads: t.start()
for t in threads: t.join()

Output:

#SUP-250001
#SUP-250002
#SUP-250003
...

Semua hasil unik — tidak ada duplikasi walaupun 10 thread berjalan bersamaan 🚀

---

📁 Struktur Package

risnaberti/
  nanumber/
    ├── core.py
    ├── exceptions.py
    ├── config.py
    └── storage/
        ├── base.py
        ├── memory.py
        ├── sqlite.py
        └── sqlalchemy_storage.py

---

📄 Lisensi

MIT © 2025 Risna Berti

---

💬 Kontribusi

Pull request selalu terbuka 🎉
Jika kamu menemukan bug atau ide fitur baru, silakan buat issue di GitHub:

👉 https://github.com/risnaberti/nanumber

---

🌟 Dukungan & Kontak

Jika kamu menggunakan library ini di project kamu, kasih bintang di GitHub ⭐

📧 Email: [e-mail] 🐙 GitHub: @risnaberti

---

✨ Made with ❤️ by Risna Berti

"Because numbering should be smart, safe, and beautiful."