Metadata-Version: 2.1
Name: Flask-Board
Version: 0.1.2
Summary: Build base flask app depends on template.
Home-page: https://github.com/wwtg99/flask-board
Author: Wu Wentao
Author-email: wwtg99@gmail.com
License: MIT
Keywords: flask template
Platform: any
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Customer Service
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
Requires-Dist: Werkzeug (>=0.15)
Requires-Dist: Jinja2 (>=2.10.1)
Requires-Dist: flask (>=1.0)
Requires-Dist: click (>=5.1)
Requires-Dist: python-dotenv (>=0.12)

Flask Board
===========

# Description

[Flask](https://flask.palletsprojects.com/en/1.1.x/) is a powerful and flexible web framework.
Since it is so flexible, we have to "copy" some codes to start a new production project.
Flask Board is aimed to start a flask project depends on some carefully prepared templates.

# Installation

```
pip install flask-board
```

After installation, we can see flask board installed as a flask command plugin.

```
flask board --help
```

# Usage

## Create flask project depends on pre defined templates.

```
flask board your-project
```

Same as used the `default` template.

```
flask board your-project -t default
```

## Available templates

- default: default flask web app
- restful: flask restful API web app
- celery: flask app with celery

## Change the project directory

Change project directory by option `-d`, default use the current directory.

```
flask board your-project -d <path-to-directory>
```

## Use your own project template

Use `-t` option point to the custom project directory.

```
flask board your-project -t <path-to-your-tempalte-directory>
```

We use jinja2 engine to render all files in the template directory.

We can also exclude files in the template directory (default excludes file patterns *.pyc, *.pyo, *.pyd, *.egg, *.log, *.so, *.zip, *.tar, *.tar.gz).

And exclude directories and all files under it (default excludes directories .git, `__pycache__`, *.egg-info, build, dist, .idea).

```
flask board your-project -t <path-to-your-template-directory> --excludes="*.pyc,*.log" excludes_dir=".git,__pycache__"
```


