julimath 0.1.0

A simple & friendly math library for beginners with auto-input, shortcuts, and helpful logs.

JuliMath 🧮

Library matematika sederhana dalam Python yang dirancang khusus untuk memudahkan perhitungan matematika dengan antarmuka yang ramah pengguna.

📋 Daftar Isi

• Instalasi
• Cara Penggunaan
• Fungsi-Fungsi Tersedia
  • Operasi Dasar
  • Operasi Lanjutan
  • Geometri
  • Statistik
  • Kombinatorik
• Fitur Khusus
• Contoh Penggunaan

🚀 Instalasi

1. Clone atau download repository ini
2. Import library ke dalam project Python Anda:

import julimath as jm

📖 Cara Penggunaan

JuliMath memiliki dua cara penggunaan yang fleksibel:

1. Dengan Parameter Langsung

import julimath as jm

# Langsung berikan nilai
hasil = jm.tambah(5, 3)  # Output: 8

2. Input Otomatis

import julimath as jm

# Tanpa parameter - akan meminta input otomatis
jm.tambah()  # Akan meminta input: "Masukkan a: " dan "Masukkan b: "

3. Bantuan

import julimath as jm

# Tampilkan menu bantuan
jm.jm_help()

🔧 Fungsi-Fungsi Tersedia

Operasi Dasar

Fungsi	Alias	Deskripsi	Contoh
tambah(a, b)	add(a, b)	Penjumlahan	jm.tambah(5, 3) → 8
kurang(a, b)	sub(a, b)	Pengurangan	jm.kurang(10, 4) → 6
kali(a, b)	mul(a, b)	Perkalian	jm.kali(6, 7) → 42
bagi(a, b)	div(a, b)	Pembagian	jm.bagi(15, 3) → 5.0

Operasi Lanjutan

Fungsi	Deskripsi	Contoh
pangkat(a, b)	Perpangkatan (a^b)	jm.pangkat(2, 3) → 8
akar(x)	Akar kuadrat	jm.akar(16) → 4.0
modulus(a, b)	Sisa pembagian	jm.modulus(17, 5) → 2
faktorial(n)	Faktorial (n!)	jm.faktorial(5) → 120
kuadrat(x)	Kuadrat (x²)	jm.kuadrat(4) → 16
kubik(x)	Kubik (x³)	jm.kubik(3) → 27

Geometri

Fungsi	Deskripsi	Contoh
luas_lingkaran(r)	Luas lingkaran	jm.luas_lingkaran(7) → 153.86
volume_tabung(r, t)	Volume tabung	jm.volume_tabung(3, 10) → 282.6
keliling_persegi(sisi)	Keliling persegi	jm.keliling_persegi(5) → 20
luas_persegi(sisi)	Luas persegi	jm.luas_persegi(4) → 16

Statistik

Fungsi	Deskripsi	Contoh
rata_rata(data)	Rata-rata dari list	jm.rata_rata([1,2,3,4,5]) → 3.0
persen(bagian, total)	Persentase	jm.persen(25, 100) → 25.0

Kombinatorik

Fungsi	Deskripsi	Contoh
kombinasi(n, r)	Kombinasi C(n,r)	jm.kombinasi(5, 2) → 10
permutasi(n, r)	Permutasi P(n,r)	jm.permutasi(5, 2) → 20
fpb(a, b)	Faktor Persekutuan Besar	jm.fpb(12, 18) → 6
kpk(a, b)	Kelipatan Persekutuan Kecil	jm.kpk(12, 18) → 36

✨ Fitur Khusus

1. Auto-Print

Semua fungsi secara otomatis mencetak hasil ke layar, sehingga Anda tidak perlu menggunakan print().

2. Input Otomatis

Jika Anda memanggil fungsi tanpa parameter, library akan secara otomatis meminta input dari pengguna.

3. Error Handling

Library menangani error dengan pesan yang jelas dan berwarna:

• ✅ Hijau untuk informasi
• ❌ Merah untuk error

4. Validasi Input

• need() - Meminta input bilangan bulat dengan validasi
• need_float() - Meminta input bilangan desimal dengan validasi

📝 Contoh Penggunaan

Contoh 1: Perhitungan Sederhana

import julimath as jm

# Penjumlahan langsung
jm.tambah(10, 5)  # Output: 15

# Menggunakan alias
jm.add(7, 3)      # Output: 10

# Pembagian dengan penanganan error
jm.bagi(10, 0)    # Output: Error message

Contoh 2: Input Interaktif

import julimath as jm

# Akan meminta input dari pengguna
jm.kali()  # Meminta: "Masukkan a: " dan "Masukkan b: "

Contoh 3: Perhitungan Geometri

import julimath as jm

# Menghitung luas lingkaran
jm.luas_lingkaran(7)     # Output: 153.86

# Menghitung volume tabung
jm.volume_tabung(3, 10)  # Output: 282.6

# Dengan rumus (opsional)
jm.luas_persegi(5, show_formula=True)  # Output: Rumus: 5 * 5 = 25

Contoh 4: Statistik dan Kombinatorik

import julimath as jm

# Rata-rata
data = [85, 90, 78, 92, 88]
jm.rata_rata(data)       # Output: 86.6

# Kombinasi dan permutasi
jm.kombinasi(10, 3)      # Output: 120
jm.permutasi(10, 3)      # Output: 720

# FPB dan KPK
jm.fpb(48, 18)           # Output: 6
jm.kpk(48, 18)           # Output: 144

Contoh 5: Menggunakan Helper Functions

import julimath as jm

# Meminta input dengan validasi
angka = jm.need("Masukkan angka favorit Anda: ")
desimal = jm.need_float("Masukkan nilai desimal: ")

# Menampilkan bantuan
jm.jm_help()

🎯 Tips Penggunaan

1. Gunakan alias untuk kode yang lebih pendek: add, sub, mul, div
2. Manfaatkan auto-input untuk program interaktif
3. Periksa error handling - library akan memberikan pesan error yang jelas
4. Gunakan jm_help() untuk melihat semua fungsi yang tersedia

🤝 Kontribusi

Jika Anda ingin berkontribusi pada pengembangan JuliMath, silakan:

1. Fork repository ini
2. Buat branch baru untuk fitur Anda
3. Commit perubahan Anda
4. Push ke branch
5. Buat Pull Request

📄 Lisensi

Project ini bersifat open source dan dapat digunakan secara bebas untuk keperluan edukasi dan pengembangan.

---

JuliMath - Membuat matematika menjadi lebih mudah dan menyenangkan! 🎉