Metadata-Version: 2.4
Name: xblocks-extra
Version: 1.5.0
Summary: A collection of XBlocks for the Open edX platform that preserve their original package paths for drop-in replacement
Author-email: Open edX Project <oscm@openedx.org>
License-Expression: AGPL-3.0
Project-URL: Homepage, https://github.com/openedx/xblocks-extra
Project-URL: Repository, https://github.com/openedx/xblocks-extra
Project-URL: Documentation, https://xblocks-extra.readthedocs.io
Keywords: Python,edx,xblock
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.2
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: django-crum
Requires-Dist: Django>=4.2
Requires-Dist: edx-codejail
Requires-Dist: openedx-filters
Requires-Dist: requests
Requires-Dist: six
Requires-Dist: Xblock[django]
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: edx-i18n-tools; extra == "dev"
Provides-Extra: test
Requires-Dist: coverage; extra == "test"
Requires-Dist: edx-lint; extra == "test"
Requires-Dist: edx-opaque-keys; extra == "test"
Requires-Dist: edx-opaque-keys; extra == "test"
Requires-Dist: mock; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: pytest-django; extra == "test"
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: xblock-sdk; extra == "test"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-book-theme; extra == "docs"

# xblocks-extra

A collection of XBlocks for the Open edX platform.

## Purpose

This repository contains XBlocks that are not installed by default in the Open edX platform but can be added as needed. XBlocks added here **preserve their original package paths** for drop-in replacement when migrating from standalone packages.

## Installation

```bash
pip install xblocks-extra
```

Or install specific xblocks by adding to your requirements:

```
xblocks-extra
```

## Development

### Prerequisites

- Python 3.12+
- Django 4.2 or 5.2

### Setup

```bash
# Clone the repository
git clone https://github.com/openedx/xblocks-extra.git
cd xblocks-extra

# Install in development mode
pip install -e ".[dev]"
```

### Running Tests

```bash
make test
```

### Linting

```bash
make lint
make format  # Auto-fix formatting issues
```

## Contributing

Contributions are welcome! Please read our [contributing guidelines](https://openedx.org/contributor-guidelines) before submitting a pull request.

## License

This project is licensed under the AGPL-3.0 License - see the [LICENSE](LICENSE) file for details.
