julimath

Name	julimath JSON
Version	0.1.0 JSON
	download
home_page	None
Summary	A simple & friendly math library for beginners with auto-input, shortcuts, and helpful logs.
upload_time	2025-08-21 16:25:40
maintainer	None
docs_url	None
author	None
requires_python	>=3.7
license	MIT
keywords	math beginner library julimath
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # JuliMath 🧮

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

## 📋 Daftar Isi

- [Instalasi](#instalasi)
- [Cara Penggunaan](#cara-penggunaan)
- [Fungsi-Fungsi Tersedia](#fungsi-fungsi-tersedia)
  - [Operasi Dasar](#operasi-dasar)
  - [Operasi Lanjutan](#operasi-lanjutan)
  - [Geometri](#geometri)
  - [Statistik](#statistik)
  - [Kombinatorik](#kombinatorik)
- [Fitur Khusus](#fitur-khusus)
- [Contoh Penggunaan](#contoh-penggunaan)

## 🚀 Instalasi

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

```python
import julimath as jm
```

## 📖 Cara Penggunaan

JuliMath memiliki dua cara penggunaan yang fleksibel:

### 1. Dengan Parameter Langsung
```python
import julimath as jm

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

### 2. Input Otomatis
```python
import julimath as jm

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

### 3. Bantuan
```python
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
```python
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
```python
import julimath as jm

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

### Contoh 3: Perhitungan Geometri
```python
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
```python
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
```python
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! 🎉

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "julimath",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "math, beginner, library, julimath",
    "author": null,
    "author_email": "Galih Julian <membventra@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/f5/1a/5ceec70c4527ea2684a9cfe499d9d2bee2109c2c203bbb33279c74ebe851/julimath-0.1.0.tar.gz",
    "platform": null,
    "description": "# JuliMath \ud83e\uddee\r\n\r\nLibrary matematika sederhana dalam Python yang dirancang khusus untuk memudahkan perhitungan matematika dengan antarmuka yang ramah pengguna.\r\n\r\n## \ud83d\udccb Daftar Isi\r\n\r\n- [Instalasi](#instalasi)\r\n- [Cara Penggunaan](#cara-penggunaan)\r\n- [Fungsi-Fungsi Tersedia](#fungsi-fungsi-tersedia)\r\n  - [Operasi Dasar](#operasi-dasar)\r\n  - [Operasi Lanjutan](#operasi-lanjutan)\r\n  - [Geometri](#geometri)\r\n  - [Statistik](#statistik)\r\n  - [Kombinatorik](#kombinatorik)\r\n- [Fitur Khusus](#fitur-khusus)\r\n- [Contoh Penggunaan](#contoh-penggunaan)\r\n\r\n## \ud83d\ude80 Instalasi\r\n\r\n1. Clone atau download repository ini\r\n2. Import library ke dalam project Python Anda:\r\n\r\n```python\r\nimport julimath as jm\r\n```\r\n\r\n## \ud83d\udcd6 Cara Penggunaan\r\n\r\nJuliMath memiliki dua cara penggunaan yang fleksibel:\r\n\r\n### 1. Dengan Parameter Langsung\r\n```python\r\nimport julimath as jm\r\n\r\n# Langsung berikan nilai\r\nhasil = jm.tambah(5, 3)  # Output: 8\r\n```\r\n\r\n### 2. Input Otomatis\r\n```python\r\nimport julimath as jm\r\n\r\n# Tanpa parameter - akan meminta input otomatis\r\njm.tambah()  # Akan meminta input: \"Masukkan a: \" dan \"Masukkan b: \"\r\n```\r\n\r\n### 3. Bantuan\r\n```python\r\nimport julimath as jm\r\n\r\n# Tampilkan menu bantuan\r\njm.jm_help()\r\n```\r\n\r\n## \ud83d\udd27 Fungsi-Fungsi Tersedia\r\n\r\n### Operasi Dasar\r\n\r\n| Fungsi | Alias | Deskripsi | Contoh |\r\n|--------|-------|-----------|---------|\r\n| `tambah(a, b)` | `add(a, b)` | Penjumlahan | `jm.tambah(5, 3)` \u2192 8 |\r\n| `kurang(a, b)` | `sub(a, b)` | Pengurangan | `jm.kurang(10, 4)` \u2192 6 |\r\n| `kali(a, b)` | `mul(a, b)` | Perkalian | `jm.kali(6, 7)` \u2192 42 |\r\n| `bagi(a, b)` | `div(a, b)` | Pembagian | `jm.bagi(15, 3)` \u2192 5.0 |\r\n\r\n### Operasi Lanjutan\r\n\r\n| Fungsi | Deskripsi | Contoh |\r\n|--------|-----------|---------|\r\n| `pangkat(a, b)` | Perpangkatan (a^b) | `jm.pangkat(2, 3)` \u2192 8 |\r\n| `akar(x)` | Akar kuadrat | `jm.akar(16)` \u2192 4.0 |\r\n| `modulus(a, b)` | Sisa pembagian | `jm.modulus(17, 5)` \u2192 2 |\r\n| `faktorial(n)` | Faktorial (n!) | `jm.faktorial(5)` \u2192 120 |\r\n| `kuadrat(x)` | Kuadrat (x\u00b2) | `jm.kuadrat(4)` \u2192 16 |\r\n| `kubik(x)` | Kubik (x\u00b3) | `jm.kubik(3)` \u2192 27 |\r\n\r\n### Geometri\r\n\r\n| Fungsi | Deskripsi | Contoh |\r\n|--------|-----------|---------|\r\n| `luas_lingkaran(r)` | Luas lingkaran | `jm.luas_lingkaran(7)` \u2192 153.86 |\r\n| `volume_tabung(r, t)` | Volume tabung | `jm.volume_tabung(3, 10)` \u2192 282.6 |\r\n| `keliling_persegi(sisi)` | Keliling persegi | `jm.keliling_persegi(5)` \u2192 20 |\r\n| `luas_persegi(sisi)` | Luas persegi | `jm.luas_persegi(4)` \u2192 16 |\r\n\r\n### Statistik\r\n\r\n| Fungsi | Deskripsi | Contoh |\r\n|--------|-----------|---------|\r\n| `rata_rata(data)` | Rata-rata dari list | `jm.rata_rata([1,2,3,4,5])` \u2192 3.0 |\r\n| `persen(bagian, total)` | Persentase | `jm.persen(25, 100)` \u2192 25.0 |\r\n\r\n### Kombinatorik\r\n\r\n| Fungsi | Deskripsi | Contoh |\r\n|--------|-----------|---------|\r\n| `kombinasi(n, r)` | Kombinasi C(n,r) | `jm.kombinasi(5, 2)` \u2192 10 |\r\n| `permutasi(n, r)` | Permutasi P(n,r) | `jm.permutasi(5, 2)` \u2192 20 |\r\n| `fpb(a, b)` | Faktor Persekutuan Besar | `jm.fpb(12, 18)` \u2192 6 |\r\n| `kpk(a, b)` | Kelipatan Persekutuan Kecil | `jm.kpk(12, 18)` \u2192 36 |\r\n\r\n## \u2728 Fitur Khusus\r\n\r\n### 1. Auto-Print\r\nSemua fungsi secara otomatis mencetak hasil ke layar, sehingga Anda tidak perlu menggunakan `print()`.\r\n\r\n### 2. Input Otomatis\r\nJika Anda memanggil fungsi tanpa parameter, library akan secara otomatis meminta input dari pengguna.\r\n\r\n### 3. Error Handling\r\nLibrary menangani error dengan pesan yang jelas dan berwarna:\r\n- \u2705 Hijau untuk informasi\r\n- \u274c Merah untuk error\r\n\r\n### 4. Validasi Input\r\n- `need()` - Meminta input bilangan bulat dengan validasi\r\n- `need_float()` - Meminta input bilangan desimal dengan validasi\r\n\r\n## \ud83d\udcdd Contoh Penggunaan\r\n\r\n### Contoh 1: Perhitungan Sederhana\r\n```python\r\nimport julimath as jm\r\n\r\n# Penjumlahan langsung\r\njm.tambah(10, 5)  # Output: 15\r\n\r\n# Menggunakan alias\r\njm.add(7, 3)      # Output: 10\r\n\r\n# Pembagian dengan penanganan error\r\njm.bagi(10, 0)    # Output: Error message\r\n```\r\n\r\n### Contoh 2: Input Interaktif\r\n```python\r\nimport julimath as jm\r\n\r\n# Akan meminta input dari pengguna\r\njm.kali()  # Meminta: \"Masukkan a: \" dan \"Masukkan b: \"\r\n```\r\n\r\n### Contoh 3: Perhitungan Geometri\r\n```python\r\nimport julimath as jm\r\n\r\n# Menghitung luas lingkaran\r\njm.luas_lingkaran(7)     # Output: 153.86\r\n\r\n# Menghitung volume tabung\r\njm.volume_tabung(3, 10)  # Output: 282.6\r\n\r\n# Dengan rumus (opsional)\r\njm.luas_persegi(5, show_formula=True)  # Output: Rumus: 5 * 5 = 25\r\n```\r\n\r\n### Contoh 4: Statistik dan Kombinatorik\r\n```python\r\nimport julimath as jm\r\n\r\n# Rata-rata\r\ndata = [85, 90, 78, 92, 88]\r\njm.rata_rata(data)       # Output: 86.6\r\n\r\n# Kombinasi dan permutasi\r\njm.kombinasi(10, 3)      # Output: 120\r\njm.permutasi(10, 3)      # Output: 720\r\n\r\n# FPB dan KPK\r\njm.fpb(48, 18)           # Output: 6\r\njm.kpk(48, 18)           # Output: 144\r\n```\r\n\r\n### Contoh 5: Menggunakan Helper Functions\r\n```python\r\nimport julimath as jm\r\n\r\n# Meminta input dengan validasi\r\nangka = jm.need(\"Masukkan angka favorit Anda: \")\r\ndesimal = jm.need_float(\"Masukkan nilai desimal: \")\r\n\r\n# Menampilkan bantuan\r\njm.jm_help()\r\n```\r\n\r\n## \ud83c\udfaf Tips Penggunaan\r\n\r\n1. **Gunakan alias** untuk kode yang lebih pendek: `add`, `sub`, `mul`, `div`\r\n2. **Manfaatkan auto-input** untuk program interaktif\r\n3. **Periksa error handling** - library akan memberikan pesan error yang jelas\r\n4. **Gunakan `jm_help()`** untuk melihat semua fungsi yang tersedia\r\n\r\n## \ud83e\udd1d Kontribusi\r\n\r\nJika Anda ingin berkontribusi pada pengembangan JuliMath, silakan:\r\n1. Fork repository ini\r\n2. Buat branch baru untuk fitur Anda\r\n3. Commit perubahan Anda\r\n4. Push ke branch\r\n5. Buat Pull Request\r\n\r\n## \ud83d\udcc4 Lisensi\r\n\r\nProject ini bersifat open source dan dapat digunakan secara bebas untuk keperluan edukasi dan pengembangan.\r\n\r\n---\r\n\r\n**JuliMath** - Membuat matematika menjadi lebih mudah dan menyenangkan! \ud83c\udf89\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A simple & friendly math library for beginners with auto-input, shortcuts, and helpful logs.",
    "version": "0.1.0",
    "project_urls": {
        "Homepage": "https://github.com/Enex-kblm/julimath"
    },
    "split_keywords": [
        "math",
        " beginner",
        " library",
        " julimath"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "16f41a08f2d37a54baf1b59cd4cbea93279647fe5de1c90edeb8b5a22bff1fbc",
                "md5": "1c750a5e17088301a12bad3e207d9447",
                "sha256": "889f2c4f6fb7d5ed06a142c75ff57d31f22574a5d45d4ff47c2953250afe6e60"
            },
            "downloads": -1,
            "filename": "julimath-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1c750a5e17088301a12bad3e207d9447",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 7011,
            "upload_time": "2025-08-21T16:25:39",
            "upload_time_iso_8601": "2025-08-21T16:25:39.367341Z",
            "url": "https://files.pythonhosted.org/packages/16/f4/1a08f2d37a54baf1b59cd4cbea93279647fe5de1c90edeb8b5a22bff1fbc/julimath-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f51a5ceec70c4527ea2684a9cfe499d9d2bee2109c2c203bbb33279c74ebe851",
                "md5": "b0d246899a1a5aab55da09ff2f7a5a2f",
                "sha256": "49edfe2eba882d5fcc83e17fe62f49e4999b85771314e1d78e4e9be54a1cef1a"
            },
            "downloads": -1,
            "filename": "julimath-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "b0d246899a1a5aab55da09ff2f7a5a2f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 6327,
            "upload_time": "2025-08-21T16:25:40",
            "upload_time_iso_8601": "2025-08-21T16:25:40.850911Z",
            "url": "https://files.pythonhosted.org/packages/f5/1a/5ceec70c4527ea2684a9cfe499d9d2bee2109c2c203bbb33279c74ebe851/julimath-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-21 16:25:40",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Enex-kblm",
    "github_project": "julimath",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "julimath"
}