Metadata-Version: 2.1
Name: flask-interface
Version: 0.1
Summary: flask-interface comes with a command-line interface (CLI) that mimics a bash terminal. It provides a CLI command to quickly generate a full file structure for a Flask app, along with a user-friendly bash-like UI for executing commands. and You can use it to execute various commands related to your Flask app.
Home-page: https://github.com/freebaizid/flask-interface
Author: mdbaizidtanvir
Author-email: mdbaizidtanvir@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: Click
Requires-Dist: Flask
Requires-Dist: Flask-SQLAlchemy
Requires-Dist: Flask-WTF
Requires-Dist: Flask-Bcrypt
Requires-Dist: Flask-Login
Requires-Dist: Flask-Admin
Requires-Dist: email-validator

# flask-interface

![Flask Logo](https://flask.palletsprojects.com/en/3.0.x/_images/flask-horizontal.png)

## Introduction

flask-interface is a Python package that simplifies the process of creating and managing Flask web applications. It provides a CLI command to quickly generate a full file structure for a Flask app, along with a user-friendly bash-like UI for executing commands.

## Get Started

To install flask-interface, simply run:

```bash
pip install flask-interface
```

## Create a New Flask App

To create a new Flask app, use the following command:

```bash
create-flask-app mynewapp # app name
```

Replace `mynewapp` with the desired name of your Flask application.

## Command UI Bash

flask-interface comes with a command-line interface (CLI) that mimics a bash terminal. You can use it to execute various commands related to your Flask app.

### Example Command:

```bash
> create-flask-app mynewapp
```

### What Executing Commands Do

The commands executed via the bash-like UI will handle all necessary steps for setting up a Flask application. This includes creating the project structure, setting up configuration files, and initializing essential Flask components such as blueprints, models, forms, and routes.

### Project Directory Structure

After running the command, the project directory structure will look like this:

```
mynewapp/
│
├── app/
│   ├── __init__.py
│   ├── models.py
│   ├── routes.py
│   ├── auth_routes.py
│   ├── forms.py
│   ├── admin.py
│   ├── static/
│   │   ├── css/
│   │   │   └── styles.css
│   │   ├── js/
│   │   │   └── scripts.js
│   │   └── img/
│   │       └── logo.png
│   └── templates/
│       ├── base.html
│       ├── index.html
│       ├── login.html
│       ├── register.html
│       ├── docs.html
│       ├── about.html
│       └── blog/
│           ├── create_post.html
│           └── post.html
├── config.py
├── app.py
└── README.md
```

### flask-interfaceApp Structure

The Flask app structure created by flask-interface follows a full-fledged MVC architecture, providing separation of concerns and scalability for your application.

### Included Libraries

flask-interface includes several libraries that are commonly used in Flask projects:

```
Click
Flask
Flask-SQLAlchemy
Flask-WTF
Flask-Bcrypt
Flask-Login
Flask-Admin
email-validator

```

## Contributing

Contributions are welcome! Please feel free to open issues or pull requests on the [GitHub repository](https://github.com/freebaizid/flask-interface).

## License

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