Metadata-Version: 2.4
Name: PyJget
Version: 0.1.2
Summary: PyJget — lightweight nested JSON and dict path extraction using dot notation.
Project-URL: Homepage, https://github.com/abeedalishaik1080-lab/PyJget
Project-URL: Documentation, https://github.com/abeedalishaik1080-lab/PyJget#readme
Project-URL: Repository, https://github.com/abeedalishaik1080-lab/PyJget
Project-URL: Issues, https://github.com/abeedalishaik1080-lab/PyJget/issues
Author: Shaik Abeedali
License-Expression: MIT
Keywords: PyJget,dict,dot-notation,jget,json,nested,path
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

<div align="center">

# 🚀 PyJget

### Simple • Fast • Lightweight JSON Path Extraction for Python

Extract nested values from dictionaries and JSON objects using clean dot notation.

<p>
  <img src="https://img.shields.io/pypi/v/PyJget?color=brightgreen&style=for-the-badge">
  <img src="https://img.shields.io/pypi/pyversions/PyJget?style=for-the-badge">
  <img src="https://img.shields.io/pypi/l/PyJget?style=for-the-badge">
</p>

### 📦 Install

```bash
pip install PyJget
```

⭐ If you find this project useful, consider giving it a star on GitHub!

</div>

---

# ✨ Features

- 🚀 Lightning-fast nested JSON access
- 🎯 Simple dot notation (`user.profile.name`)
- 📦 Zero dependencies
- 🐍 Pure Python
- 💡 Beginner-friendly API
- ⚡ Lightweight and efficient
- ✅ Safe default values
- 🔥 Clean and readable code

---

# 📖 Quick Example

### Input JSON

```python
data = {
    "user": {
        "profile": {
            "name": "Alice",
            "age": 22
        }
    }
}
```

### Python Code

```python
from pyjget import jget

name = jget(data, "user.profile.name")
age = jget(data, "user.profile.age")

print(name)
print(age)
```

### Output

```text
Alice
22
```

---

# 🛠 Installation

```bash
pip install PyJget
```

---

# 📚 More Examples

## Access Nested Values

```python
from pyjget import jget

data = {
    "company": {
        "employee": {
            "name": "John"
        }
    }
}

print(jget(data, "company.employee.name"))
```

Output

```text
John
```

---

## Default Value

```python
print(jget(data, "company.employee.salary", default=0))
```

Output

```text
0
```

---

## List Access

```python
data = {
    "students": [
        {"name": "Alice"},
        {"name": "Bob"}
    ]
}

print(jget(data, "students.1.name"))
```

Output

```text
Bob
```

---

# ⚡ Why PyJget?

Instead of writing:

```python
data["user"]["profile"]["name"]
```

or

```python
data.get("user", {}).get("profile", {}).get("name")
```

Simply write:

```python
jget(data, "user.profile.name")
```

Cleaner.

Safer.

More readable.

---

# 📦 API

```python
jget(data, path, default=None)
```

| Parameter | Description |
|-----------|-------------|
| data | Dictionary or JSON object |
| path | Dot notation path |
| default | Returned if path doesn't exist |

Returns:

- Value if found
- `default` otherwise

---

# 🚀 Roadmap

- [x] Nested dictionary support
- [x] List indexing
- [ ] Wildcard support (`*`)
- [ ] Recursive search
- [ ] JSONPath compatibility
- [ ] Better error messages
- [ ] Performance improvements

---

# 🤝 Contributing

Contributions are always welcome!

1. Fork the repository
2. Create a new branch
3. Commit your changes
4. Submit a Pull Request

---

# 📄 License

MIT License

---

# 🔗 Links

## GitHub

https://github.com/abeedalishaik1080-lab/PyJget

## PyPI

https://pypi.org/project/PyJget/

---

<div align="center">

### ⭐ If PyJget helps you, please give the project a GitHub Star!

Made with ❤️ in Python

</div>