Metadata-Version: 2.4
Name: NotebookFusion
Version: 0.0.1
Summary: A Python package for  notebooks.
Home-page: https://github.com/foysalpranto121/NotebookFusion
Author: foysalpranto121
Author-email: foysalpranto2002@gmail.com
License: Apache-2.0
Project-URL: Bug Tracker, https://github.com/foysalpranto121/NotebookFusion/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ensure==1.0.2
Requires-Dist: py-youtube==1.1.7
Provides-Extra: testing
Requires-Dist: pytest>=7.4.0; extra == "testing"
Requires-Dist: mypy>=1.5.0; extra == "testing"
Requires-Dist: flake8>=6.1.0; extra == "testing"
Requires-Dist: tox>=4.11.0; extra == "testing"
Requires-Dist: tox-gh-actions>=3.1.0; extra == "testing"
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: summary

# NotebookFusion  🚀


![PyPI version](https://img.shields.io/pypi/v/NotebookFusion.svg)
![Python versions](https://img.shields.io/pypi/pyversions/NotebookFusion.svg)
![License](https://img.shields.io/pypi/l/NotebookFusion.svg)

NotebookFusion is a lightweight Python package that allows you to seamlessly render live websites and embed YouTube videos directly inside Jupyter Notebooks, JupyterLab, and Google Colab environments.

No more switching browser tabs while coding — view documentation, tutorials, dashboards, or videos right beside your notebook cells.

---

# ✨ Features

- 🌐 **Website Rendering**  
  Display live HTTPS websites directly inside notebook output cells.

- ▶️ **YouTube Video Embedding**  
  Automatically parse and embed YouTube videos from standard URLs.

- 📏 **Customizable Viewport**  
  Easily adjust width and height.

- ⚡ **Lightweight & Fast**  
  Built using standard IPython display utilities with minimal dependencies.

- 📓 **Notebook Friendly**
  - Jupyter Notebook
  - JupyterLab
  - Google Colab
  - VS Code Notebook

---

# 📦 Installation

Install via pip:

```bash
pip install NotebookFusion


```bash 
pip install -r requirements_dev.txt

---

# 🚀 Quick Start

## ▶️ Render a YouTube Video

```python
from NotebookFusion.youtube import render_youtube_video

render_youtube_video(
    "https://www.youtube.com/watch?v=h25pePMdoPA&t=712s"
)
```

---

## 🌐 Render a Website

```python
from NotebookFusion.site import render_site

render_site("https://www.google.com")
```

---

# ⚙️ Advanced Usage

## Custom Width & Height

```python
from NotebookFusion.site import render_site

render_site(
    "https://www.python.org",
    width="100%",
    height="600px"
)
```

---

## Embed YouTube with Custom Size

```python
from NotebookFusion.youtube import render_youtube_video

render_youtube_video(
    "https://www.youtube.com/watch?v=h25pePMdoPA",
    width="900",
    height="500"
)
```

---

# 🧠 Why NotebookFusion?

NotebookFusion helps Data Scientists, AI Engineers, Students, and Researchers by allowing them to:

- Read documentation without leaving notebooks
- Watch tutorials while coding
- Display dashboards or live web apps
- Improve notebook-based learning workflows
- Create interactive demo notebooks

---

# 🖥️ Supported Platforms

| Platform | Supported |
|----------|------------|
| Jupyter Notebook | ✅ |
| JupyterLab | ✅ |
| Google Colab | ✅ |
| VS Code Notebook | ✅ |

---

# 📂 Project Structure

```text
NotebookFusion/
│
├── NotebookFusion/
│   ├── __init__.py
│   ├── site.py
│   └── youtube.py
│
├── README.md
├── requirements.txt
├── setup.py
└── LICENSE
```

---

# 🛠️ Development Setup

Clone the repository:

```bash
git clone https://github.com/yourusername/NotebookFusion.git
```

Move into the project directory:

```bash
cd NotebookFusion
```

Create a virtual environment:

```bash
conda create -n notebookfusion_env python=3.10 -y
```

Activate the environment:

```bash
conda activate notebookfusion_env
```

Install development dependencies:

```bash
pip install -r requirements_dev.txt
```

---

# 🤝 Contributing

Contributions are welcome!

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

---

# 📄 License

This project is licensed under the MIT License.

---

# ⭐ Support

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