Metadata-Version: 2.4
Name: ds-practicals-pvg
Version: 1.0.1
Summary: Retrieve DS practical assignment codes and problem statements by number (10 assignments)
Home-page: https://github.com/sanketdahotre/ds-practicals
Author: Sanket Dahotre
Author-email: sanket12dahotre@gmail.com
License: MIT
Keywords: data science,practicals,assignments,education,ds
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
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: Topic :: Education
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# ds-practicals

A zero-dependency Python package to retrieve **Data Science practical assignment** codes, titles, and problem statements by number (**10 assignments**).

## Installation

```bash
pip install ds-practicals-pvg
```

## Usage

You can use either the **Class API** or the **Module API**.

### 1. Class API (Recommended)

The `DSPracticals` class wraps all functions and adds the ability to export complete `.ipynb` files.

```python
from ds_practicals import DSPracticals

ds = DSPracticals()

# List all 10 assignments
for n, title in ds.list_assignments():
    print(n, title)

# Get the full problem statement for assignment 3
print(ds.get_statement(3))

# Get code for assignment 2
print(ds.get_code(2))

# Export an assignment as a standalone Jupyter Notebook file
ds.export_to_notebook(1)
# → creates 'practical_1.ipynb' in your current directory
```

### 2. Module API

```python
from ds_practicals import get_code, get_title, get_statement, get_assignment, list_assignments

# Get title for assignment 1
print(get_title(1))
# → "Data Wrangling I"

# Get title, statement, and code as a dict
a = get_assignment(1)
print(a["title"])
```


## Assignments

| # | Title |
|---|-------|
| 1 | Data Wrangling I |
| 2 | Data Wrangling II |
| 3 | Descriptive Statistics - Measures of Central Tendency and Variability |
| 4 | Data Analytics I - Linear Regression |
| 5 | Data Analytics II - Logistic Regression |
| 6 | Data Analytics III - Naive Bayes |
| 7 | Text Analytics |
| 8 | Data Visualization I |
| 9 | Data Visualization II |
| 10 | Data Visualization III |

## API Reference

| Function | Returns | Description |
|---|---|---|
| `list_assignments()` | `list[tuple[int, str]]` | All (number, title) pairs |
| `get_title(n)` | `str` | Title of practical *n* |
| `get_statement(n)` | `str` | Full problem statement for practical *n* |
| `get_code(n)` | `str` | All code cells from practical *n* concatenated |
| `get_assignment(n)` | `dict` | `{"title", "statement", "code"}` for practical *n* |

## License

MIT
