Metadata-Version: 2.1
Name: Mathics-omnibus
Version: 3.0.0
Summary: A Collection Mathics components to provide the full Mathics experience
Home-page: http://github.com/Mathics3/mathics-omnibus
Author: Rocky Bernstein
Author-email: rb@dustyfeet.com
License: UNKNOWN
Description: |Pypi Installs| |Latest Version| |Supported Python Versions|
        
        `Mathics <https://mathics.org>`_ consists of a number of separable components so that those pieces that are desired can be used without the burden of dependencies of the other parts.
        
        For example if you are interested in just running a command-line interface, you might not be interested in having Django and what that entails and vice versa.
        If you are just interested in the computational library, there is no need for either the Web parts or the command-line library parts.
        
        But what if you want both command-line interface, Web interface, all of the Pymathics libraries and whatever else there is to offer?
        
        That's what this repository is about. Here we have a PyPI installable package that pull in the various components and offer commands
        
        * ``mathicsscript`` to run the command-line interface
        * ``mathicsserver`` to run the Django-Web server
        * ``dmathicsscript`` and ``dmathicsserver`` which run the docker version of these.
        
        This repository also contains the dockerfiile to create the `mathicsorg/mathics docker images <https://hub.docker.com/repository/docker/mathicsorg/mathics>`_.
        
        That image is a combination of:
        
        * `Mathics-Scanner <https://github.com/Mathics3/mathics-scanner>`_
        * `mathicsscript <https://github.com/Mathics3/mathicsscript>`_
        * `mathics-pygments <https://github.com/Mathics3/mathics-pygments>`_
        * `Mathics-Django <https://github.com/Mathics3/Mathics-Django>`_
        * `pymathics-natlang <https://github.com/Mathics3/pymathics-natlang>`_
        * `pymathics-graph <https://github.com/Mathics3/pymathics-graph>`_
        
        It is likely that in the future more components will be added, so stay tuned...
        
        .. |Packaging status| image:: https://repology.org/badge/vertical-allrepos/Mathics-omnibus.svg
        			    :target: https://repology.org/project/Mathics-omnibus/versions
        .. |Latest Version| image:: https://badge.fury.io/py/Mathics-omnibus.svg
        		 :target: https://badge.fury.io/py/Mathics-omnibus
        .. |Pypi Installs| image:: https://pepy.tech/badge/Mathics-omnibus
        .. |Supported Python Versions| image:: https://img.shields.io/pypi/pyversions/Mathics-omnibus.svg
        
        
        Docker-specific items
        ---------------------
        
        By default, we use a SQLite database that has examples that you can
        load and use. This data comes from
        [mathics-omnibus/django-db/mathics.sqlite](https://github.com/Mathics3/mathics-omnibus/tree/master/docker/django-db).
        
        Since this is tied to the docker image, any changes made won't survice
        across restarting the docker image.
        
        If you would like to save your own you can set the environment
        variable ``MATHICS_DJANGO_DB_PATH``. Here is an example:
        
        
        .. code:: bash
        
           $ MATHICS_DJANGO_DB_PATH=/usr/src/app/data/mathics-django/mathics.sqlite ../mathics-omnibus/script/dmathicsserver
           MATHICS_DJANGO_DB_PATH=/usr/src/app/data/mathics-django/mathics.sqlite ../mathics-omnibus/script/dmathicsserver^J-(../mathics-omnibus/script/dmathicsserver:5):  -[2,0, 0]
           DOCKER=docker
           -(../mathics-omnibus/script/dmathicsserver:6):  -[2,0, 0]
           MATHICS_DJANGO_DB=mathics.sqlite
           -(../mathics-omnibus/script/dmathicsserver:7):  -[2,0, 0]
           MATHICS_DJANGO_DB_PATH=/usr/src/app/data/mathics-django/mathics.sqlite
           -(../mathics-omnibus/script/dmathicsserver:9):  -[2,0, 0]
           docker run -it --name mathics-web --rm --env=DISPLAY --env MATHICS_DJANGO_DB_PATH=/usr/src/app/data/mathics-django/mathics.sqlite --workdir=/app --volume=/src/external-vcs/github/Mathics3/mathics-django:/app --volume=/tmp/.X11-unix:/tmp/.X11-unix:rw -p 8000:8000 -v /tmp:/usr/src/app/data mathicsorg/mathics --mode ui
        
           ~~~~ app/data has been mounted to /usr/src/app/data ~~~~
           ~~~~ SQLite data (worksheets, user info) will be stored in /usr/src/app/data/mathics django/mathics.sqlite ~~~~
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
            warning: database file /usr/src/app/data/mathics-django/mathics.sqlite not found
        
            Migrating database /usr/src/app/data/mathics-django/mathics.sqlite
            Operations to perform:
              Apply all migrations: auth, contenttypes, sessions, sites, web
            Running migrations:
        
        In the above when it says ``mathics.sqlite not found`` an empty one is
        created. The real location of it outside of the container is in
        ``/tmp/mathics-django/mathics.sqlite``.
        
        
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/x-rst
