pl-viz


Namepl-viz JSON
Version 0.2.0 PyPI version JSON
download
home_pageNone
SummaryFetch and visualize data from PL.
upload_time2025-02-14 08:38:41
maintainerNone
docs_urlNone
authorBen Chen
requires_python>=3.10
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # prairielearn-viz

`pl_viz` is a Python package designed to simplify data extraction and visualization for courses on PrairieLearn. With its object-oriented design, `pl_viz` makes it easy to fetch data for courses, students, and assessments, and generate insightful visualizations to analyze student performance and assessment outcomes.

## Features
- **Object-Oriented Design**: Includes Course, Student, and Assessment classes for modular and intuitive data handling.
- **Data Extraction**: Fetch student lists, assessment details, and submission scores directly from the PrairieLearn API.
- **Data Visualization**:
    - Boxplots for score distributions across assessments.
    - Histograms to analyze score frequency.
- **Summary Statistics**: Compute mean, median, min, and max scores for assessments.

## Installation

To install the pl_viz package, use the following command:

```python
pip install pl_viz
```

## Usage

You will need a PrairieLearn API token to use this package. Store the token as an environment variable for security:

```bash
export PL_API_TOKEN="your_api_token_here"
```

## Classes Overview

1. `Course`

Represents a PrairieLearn course. Use it to:

- Fetch students and assessments.
- Display summary statistics.
- Generate visualizations.

2. `Student`

Represents an individual student, providing access to their user ID, name, and UID.

3. `Assessment`

Represents an assessment within a course. Fetch submissions and analyze score distributions.

## Contributing

Contributions are welcome! If you’d like to contribute to `pl_viz`, please open an issue or submit a pull request. Ensure you follow the coding standards and add tests for new features.

## License

This project is licensed under the MIT License. See the LICENSE file for details.



            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pl-viz",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": null,
    "author": "Ben Chen",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/1d/5d/1a747594e69c3588f5828540d96ddc0e63a280342e413e54dbe9501040ee/pl_viz-0.2.0.tar.gz",
    "platform": null,
    "description": "# prairielearn-viz\n\n`pl_viz` is a Python package designed to simplify data extraction and visualization for courses on PrairieLearn. With its object-oriented design, `pl_viz` makes it easy to fetch data for courses, students, and assessments, and generate insightful visualizations to analyze student performance and assessment outcomes.\n\n## Features\n- **Object-Oriented Design**: Includes Course, Student, and Assessment classes for modular and intuitive data handling.\n- **Data Extraction**: Fetch student lists, assessment details, and submission scores directly from the PrairieLearn API.\n- **Data Visualization**:\n    - Boxplots for score distributions across assessments.\n    - Histograms to analyze score frequency.\n- **Summary Statistics**: Compute mean, median, min, and max scores for assessments.\n\n## Installation\n\nTo install the pl_viz package, use the following command:\n\n```python\npip install pl_viz\n```\n\n## Usage\n\nYou will need a PrairieLearn API token to use this package. Store the token as an environment variable for security:\n\n```bash\nexport PL_API_TOKEN=\"your_api_token_here\"\n```\n\n## Classes Overview\n\n1. `Course`\n\nRepresents a PrairieLearn course. Use it to:\n\n- Fetch students and assessments.\n- Display summary statistics.\n- Generate visualizations.\n\n2. `Student`\n\nRepresents an individual student, providing access to their user ID, name, and UID.\n\n3. `Assessment`\n\nRepresents an assessment within a course. Fetch submissions and analyze score distributions.\n\n## Contributing\n\nContributions are welcome! If you\u2019d like to contribute to `pl_viz`, please open an issue or submit a pull request. Ensure you follow the coding standards and add tests for new features.\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Fetch and visualize data from PL.",
    "version": "0.2.0",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f4c55daaf33e1ed58b7c8bc7c00eefc85975a081fe1aa64a4a9d3cf0cc29ec2a",
                "md5": "8f5cf9b20c3ce03153d223e57921af61",
                "sha256": "cbff0a129ecb981d22bd77a8d2c049cbcff52f81f6ac070e04b668310a8f9845"
            },
            "downloads": -1,
            "filename": "pl_viz-0.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8f5cf9b20c3ce03153d223e57921af61",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 8390,
            "upload_time": "2025-02-14T08:38:39",
            "upload_time_iso_8601": "2025-02-14T08:38:39.955739Z",
            "url": "https://files.pythonhosted.org/packages/f4/c5/5daaf33e1ed58b7c8bc7c00eefc85975a081fe1aa64a4a9d3cf0cc29ec2a/pl_viz-0.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1d5d1a747594e69c3588f5828540d96ddc0e63a280342e413e54dbe9501040ee",
                "md5": "272ac00fd982a4a1913f86b30fc13cde",
                "sha256": "aef773b0f21be4fb3d5b2c397b1c9179dcc0ab09724c069edffeef45df90dc8a"
            },
            "downloads": -1,
            "filename": "pl_viz-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "272ac00fd982a4a1913f86b30fc13cde",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 7480,
            "upload_time": "2025-02-14T08:38:41",
            "upload_time_iso_8601": "2025-02-14T08:38:41.514348Z",
            "url": "https://files.pythonhosted.org/packages/1d/5d/1a747594e69c3588f5828540d96ddc0e63a280342e413e54dbe9501040ee/pl_viz-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-14 08:38:41",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "pl-viz"
}
        
Elapsed time: 0.59121s