Metadata-Version: 2.1
Name: flask-unity
Version: 0.0.1
Summary: An extension of flask web framework of python that erase the complexity of constructing flask project blueprint, packages, and other annoying stuffs
Home-page: https://github.com/usmanmusa1920/flask-unity
Author: Usman Musa
Author-email: usmanmusa1920@gmail.com
Keywords: flask-unity
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE

       ____            _                     _____ ______
      /___ /    /|   /_  / /      /  / /|  /   /     /    |/
     /    /    /_|    / /_/      /  / / | /   /     /     /
    /    /___ /  | /_/ /  |     /__/ /  |/ __/__   /     /

# flask-unity

An extension of flask web framework of python that erase the complexity of constructing flask project blueprint, packages, and other annoying stuffs

# How to use the library

First create a virtual environment `python3 -m venv venv` and then activate it `source venv/bin/activate`

Once that finish now install the library using `pip install flask-unity` and wait for the installation basically the library was uploaded using `sdist` (Source Distribution)

## Create flask project

After the installation paste the following command on your termianl

`python3 -c "from flask_unity import project; project('sakyum_todo')"`

or create a file and paste the below codes which is equivalent of the above, and then run the file

```python
from flask_unity import project

project("sakyum_todo")
```

the command/code will create a project called `sakyum_todo` now cd into the `sakyum_todo` directory.

## Create flask project app

For you to start an app within your project (`sakyum_todo`), run the following command

`python3 thunder.py create_app -a todo_app`

this will create an app within your project (`sakyum_todo`), the `-a` flag is for the app name in this example it is called `todo_app`

## Run flask server

once the app is created open the `thunder.py` file of your project and import your app `views.py` file

`from todo_app.views import todo_app`

after that, register it to the blueprint template by

`app.register_blueprint(todo_app)`

once you register the app, boot up the flask webser by

`python thunder.py boot`

This will bring the flask development server on port `5000` you can give it a different port by including a `-p` flag which is for port number:

`python thunder.py boot -p 7000`

this will bring the serve on port `7000` visit the localhost url with the port number, it will show you your project `index.html page` (sakyum_todo). To get to your app page (todo_app), visit the url with your app name e.g

`http://127.0.0.1:7000/todo_app`

this will take you to your app `index.html page` (todo_app). From there you are ready to go.

# recommendation

This software will not be compatible with `windows operating system` use other `OS` such as `linux` or `macOS`

## Github repository:

- https://github.com/usmanmusa1920/flask-unity

Pull requests are welcome


Change Log
==========

0.0.1 (05/august/2023)
------------------
- First Release
