Metadata-Version: 2.1
Name: naas
Version: 1.24.0b8
Summary: Scheduler system for notebooks
Home-page: https://github.com/cashstory/naas
Author: Martin Donadieu
Author-email: martindonadieu@gmail.com
License: BSD
Description: ![GitHub license](https://img.shields.io/github/license/jupyter-naas/drivers)
        ![Bump version](https://github.com/jupyter-naas/naas/workflows/Bump%20version/badge.svg)
        ![Upload Python Package](https://github.com/jupyter-naas/naas/workflows/Upload%20Python%20Package/badge.svg)
        ![codecov](https://codecov.io/gh/jupyter-naas/naas/branch/main/graph/badge.svg?token=UC3SAL8S0U)
        ![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
        [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=jupyter-naas_naas&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=jupyter-naas_naas)
        <a href="#badge">
          <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
        </a>
        <a href="http://commitizen.github.io/cz-cli/"><img alt="Commitizen friendly" src="https://img.shields.io/badge/commitizen-friendly-brightgreen.svg"></a>
        ![PyPI](https://img.shields.io/pypi/v/naas)
        
        # 🎱 Naas in short
        
        The Naas project and its hosted version naas.ai is open-source, it transforms Jupyter Notebooks in a safe production environment thanks to micro-services(like a scheduler) accessible in « low-code ».
        
        The product is based on 3 elements: features, drivers and templates.
        The templates enable "data geeks" to kickstart projects in minutes, the low-code drivers act as connectors to facilitate access to tools, and complex libraries (database, API, ML algorithm...) while the low-code features (scheduling, asset sharing, notifications...) enable faster iteration and deployment of outputs to end users, in a headless manner.
        
        Naas is forever free to use with 100 credits/month.
        Open your account
        PS: If you contribute to this library of open-source notebooks templates, you can X2 your monthly credits 🏆
        
        # Documentation 
        
        <p>
          <a href="https://naas.gitbook.io/naas/" title="Redirect to Documentation">
            <img width="200px" src="https://raw.githubusercontent.com/jupyter-naas/naas/main/images/gitbook.svg" alt="Gitbooks naas" />
          </a>
         </p>
        
        # Issue
        
        If you found a bug or need a new feature, please open an Issue here. 
        
        
        # Try Naas on Binder
        
        You can try out some of Naas features using the My Binder service.
        
        Click on a link below to try Naas, on a sandbox environment, without having to install anything.
        Test it in binder (WIP)
        [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter-naas/naas/main?urlpath=lab)
        
        ## Install Naas only
        
        `pip3 install naas`
        
        ## Install Naas with drivers
        
        `pip3 install 'naas[full]'`
        
        ---
        
        # Run locally
        
        ### Requirements
        
        - Docker
        - Make (Not needed on windows and not needed on Linux/MacOS if you prefer to use `docker-compose` directly).
        
        
        
        ### ⚡Run
        
        ##### Linux / MacOS
        
        ```bash
        make
        ```
        
        Then you can go on http://localhost:8888/lab?token=naas
        
        ##### Windows
        
        You just need to double click on the file `windows_start.bat`, this will open a terminal, start naas and open your browser on http://localhost:8888/lab?token=naas.
        
        
        
        ### 🛑 Stop
        
        ##### Linux / MacOS
        
        ```bash
        make stop
        ```
        
        or if you want to delete the container as well you can run
        
        ```bash
        make down
        ```
        
        
        
        ##### Windows
        
        Double click on `windows_stop.bat`
        
        
        
        ### 📦 Build
        
        You don't really have to run this, unless you changed something related to the `Dockerfile.dev`. The build process is done automatically when running naas (`make` or `make run`) if it never happened before.
        
        ##### Linux / MacOS
        
        ```bash
        make build
        ```
        
        
        
        ### 🔧 Open a shell in the container (root)
        
        ##### Linux / MacOS
        
        ```bash
        make sh
        ```
        
        
        
        ### File structure for local development
        
        When you land in your freshly started naas, on the left you should see a file structure like this:
        
        ```
        .
        ├── awesome-notebooks
        ├── file_sharing
        ├── drivers
        ├── naas
        └── Welcome_to_Naas.ipynb
        ```
        
        When naas is starting, it will automatically mount `../drivers` and `../awesome-notebooks` in your home directory of your naas. This means that if these directories does not exists on your machine it will create them and `git clone` [naas drivers](https://github.com/jupyter-naas/drivers) in `../drivers` and [awesome-notebooks](https://github.com/jupyter-naas/awesome-notebooks) in `../awesome-notebooks`.
        
        `naas` folder corespond to `.` directory on your machine (where naas project is cloned).
        
        `file_sharing` directory  is a folder created next to `./naas` to allow easy file sharing between your computer and naas container. Every file that you will drop in this directory, either from naas or from your computer will be accesible on both naas and your machine.
        
        `Welcome_to_Naas.ipynb` is our welcoming notebook to get you a place to start your journey.
        
        ### Api documentation
        
        We have a WIP documentation in swagger.
        
        `http://127.0.0.1:5000/swagger/`
        
        ### Live reload 
        
        If you do change in naas code, the server will live reload.
        
        If you use naas in a notebook restart the kernel to get the changes.
        
        ### Naas Manager
        Open Naas manager outsite of jupyter context :
        
        `http://localhost:5000/naas`
        
        ## Run test 
        
        Open Jupyterlab
        click on `+` to open Launcher
        Open Shell
        Go the right directory `cd naas`
        Run it in the shell `pytest -x`  to test your code
        
        Each Change you do from your IDE or from jupyter in the Naas folder is live reloaded
        If you test naas feature inside a notebook reload your kernel between changes.
        Same for the manager page you have to reload the Page to see the changes.
        To go faster you can use `isolated Manager` to reload only manager and not full jupyterlab
        
        ## Check lint
        
        `python -m black naas` format better
        `python -m flake8 naas` check if any left error
        
        ## Publish
        
        You can commit from jupyter or from your local IDE, code of Naas is sync between docker machine and your computer
        
        this auto publish by github action on main branch
        
        # Supporters: 
        <p>
          <a href="http://sentry.com" title="Redirect to Sentry">
            <img width="200px" src="https://raw.githubusercontent.com/jupyter-naas/naas/main/images/sentry.svg" alt="Sentry" />
          </a>
          <a href="https://gitbook.com" title="Redirect to Gitbook">
            <img width="200px" src="https://raw.githubusercontent.com/jupyter-naas/naas/main/images/gitbook.svg" alt="Gitbooks" />
          </a>
        </p>
        
        ### Authors:
        * [Jeremy Ravenel](https://github.com/jravenel)
        * [Maxime Jublou](https://github.com/Dr0p42)
        * [Martin Donadieu](https://github.com/riderx)
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: BSD License
Classifier: Framework :: Jupyter
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: full
Provides-Extra: fulldev
