Metadata-Version: 2.1
Name: classroom-extensions
Version: 0.0.2
Summary: IPython extensions used for teaching
Author-email: Marcos Dias de Assuncao <assuncao@acm.org>
Maintainer-email: Marcos Dias de Assuncao <assuncao@acm.org>
License: MIT
Project-URL: Homepage, https://github.com/assuncaomarcos/classroom_extensions
Project-URL: Bug Reports, https://github.com/assuncaomarcos/classroom_extensions
Project-URL: Say Thanks!, https://saythanks.io/to/assuncaomarcos
Project-URL: Source, https://github.com/assuncaomarcos/classroom_extensions
Keywords: IPython,extensions,teaching
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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 :: Only
Classifier: Topic :: Utilities
Classifier: Framework :: IPython
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
Requires-Python: <4,>=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: ipython
Requires-Dist: psutil (>=5.9.5)
Requires-Dist: plantweb
Provides-Extra: dev
Requires-Dist: ipython ; extra == 'dev'
Requires-Dist: jupyter ; extra == 'dev'
Requires-Dist: mariadb (>=1.0.11) ; extra == 'dev'
Requires-Dist: mariadb-kernel (==0.2.0) ; extra == 'dev'
Requires-Dist: sqlparse ; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: coverage ; extra == 'test'

IPython Extensions for Teaching
===============================

This project provides a set of IPython extensions used for teaching at the
Ecole de Technologie Superieure (ETS) of Montreal. The extensions work on
Google Colab, and Jupyter notebooks with some effort, and provide a set of
magics (e.g., `%%sql`) while customizing existing ones (e.g., `%%javascript`)
to enable lecturers and students to deploy software frameworks quickly and
provide notes with working examples.

The `notebooks` directory contains a set of Google Colab notebooks demonstrating
how to use the extensions.

Installing the Extensions
-------------------------

You can use `pip` to install the extensions:

.. code-block::

    pip3 install classroom-extensions

or:

.. code-block::

    pip3 install git+https://github.com/assuncaomarcos/classroom_extensions.git

Or clone this git repository and load the required extensions from the `classroom_extensions` package.

MariaDB Magics
--------------

Two extensions are available for MariaDB. One extension (`mariadb`) uses some
components of the MariaDB Jupyter Kernel and creates a `%%sql` cell magic that enables
code cells to accept SQL commands that an instance of MariaDB interprets. However,
unlike the MariaDB Jupyter Kernel, this extension does not change the IPython kernel
and its magics, enabling one to continue coding in Python, JavaScript, etc. To ease the
creation of notebooks on Google Colab, a second extension (`mariadb_install`) installs
MariaDB and the required libraries to run the first extension without worrying
about setting things up.

Server-Side JavaScript
----------------------

This extension, called `node,` customizes the `%%javascript` magic to enable
executing JavaScript code on the server or container hosting the Jupyter Notebook or
on Google Colab. Node.js executes the code provided in a cell whose `--target` argument
receives the value `node`. It also enables starting long-running Node.js server
processes that will listen on given ports without blocking the code cell of
the notebook. In addition to executing JavaScript code on the server side, when run
on the browser, the magic enables printing the output of the browser's console in
the result section of the code cell.

Custom HTML Magic
-----------------

The `html` extension customizes the `%%html` magic. After rendering the HTML
code inserted in the cell, the extension displays a high-level copy of the
browser's console. This behavior helps in teaching HTML or JavaScript that writes
on the console.

PlantUML Magics
---------------

PlantUML is a textual domain-specific language (DSL) used for creating diagrams,
primarily focused on software engineering and system design. It allows you to
express diagrams using a simple and intuitive syntax, which PlantUML transforms into
various types of visual diagrams, such as UML (Unified Modeling Language), sequence,
class, activity, and more.

MongoDB Shell Magics
--------------------

The IPython extension `%%mongo` enables seamless interaction with MongoDB using
the `mongosh` CLI. By simply prefixing a cell with `%%mongo`, users can execute queries
and commands against a MongoDB database directly within their IPython environment
or Colab. The extension leverages the power of the `mongosh` CLI to provide a simple
and familiar MongoDB Shell experience, allowing for data exploration, manipulation,
and administration tasks.
