# Flask-Shopify-Utils
The utils for Flask Application that build for Shopify Custom App
---
# Installing
```shell
$pip install -U flask-shopify-utils
```
---
## Example / How to ...
Please check the `example` folder for more details.
Remember, this package is using Flask-SQLAlchemy, so you need to initialize the database first.
```python
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_shopify_utils import ShopifyUtil
app = Flask(__name__)
# Init Database
db = SQLAlchemy()
db.init_app(app)
# Initial Shopify Utils
utils = ShopifyUtil()
utils.init_app(app)
# example: register default routes
utils.enroll_default_route()
```
---
## Donate
Well, I have no idea how this work, just copy it from somewhere.
The Pallets organization develops and supports Flask and the libraries
it uses. In order to grow the community of contributors and users, and
allow the maintainers to devote more time to the projects, [please
donate today](https://palletsprojects.com/donate)
---
## First time setup
- Download the repository to your local machine.
- Create a virtualenv.
```shell
# Linux/macOS
$ python3 -m venv env
$ . env/bin/active
# Window
$ py -3 -m venv env
$ env/Scripts/active
```
- Install `pip-tools`, `twine` and `build` in the virtualenv.
```shell
>pip install --upgrade pip
>pip install pip-tools twine build
```
- Install the development dependencies, then install `Flask-ShopifyUtils` in editable mode.
```sheel
$ pip install -r requirements/dev.txt && pip install -e .
```
- Build the wheel
```shell
# new
>python -m build
# For more reference https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html
```
- Deploy to PyPI
```shell
# check
>twine check dist/*
# upload
>twine upload dist/*
```
## requirements.txt
All dependencies are managed by `pip-tools`, so you need to install it first.
And you can find them from the `requirements` folder.
```shell
# development
>pip-compile --extra=dev --output-file=requirements/dev.txt pyproject.toml
# production
>pip-compile --output-file=requirements/index.txt pyproject.toml
````
## Running the tests
Make sure you have install the repository locally.
```shell
# install the package
>pip install -e .
# install the pytest
>pip install pytest
# run all tests
>pytest
# run tests with output
>pytest -s
# run specific test
>pytest -vs tests/test_init.py
# run specific test case
>pytest -vs tests/test_init.py::test_init_app
```
---
# Reference
[Packing for Python](https://packaging.python.org/en/latest/tutorials/installing-packages/)
# TODO
Add test for `ShopifyUtil` methods
Raw data
{
"_id": null,
"home_page": null,
"name": "flask-shopify-utils",
"maintainer": "Leo Chen",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "leo.cxy88@gmail.com",
"keywords": "Extension, Flask, Flask Extension, SDK, Shopify, Shopify-SDK",
"author": "Leo Chen",
"author_email": "leo.cxy88@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/de/c4/a14ba135614765c276ff35ba14b76ed2525564bff6232e82900d93aea272/flask_shopify_utils-0.1.3.tar.gz",
"platform": null,
"description": "# Flask-Shopify-Utils\n\nThe utils for Flask Application that build for Shopify Custom App \n\n---\n\n# Installing\n\n```shell\n$pip install -U flask-shopify-utils\n```\n\n---\n\n## Example / How to ...\n\nPlease check the `example` folder for more details.\n\nRemember, this package is using Flask-SQLAlchemy, so you need to initialize the database first.\n\n```python\nfrom flask import Flask\nfrom flask_sqlalchemy import SQLAlchemy\nfrom flask_shopify_utils import ShopifyUtil\n\napp = Flask(__name__)\n# Init Database\ndb = SQLAlchemy()\ndb.init_app(app)\n\n# Initial Shopify Utils\nutils = ShopifyUtil()\nutils.init_app(app)\n\n# example: register default routes\nutils.enroll_default_route()\n\n```\n\n---\n\n## Donate\n\nWell, I have no idea how this work, just copy it from somewhere.\n\nThe Pallets organization develops and supports Flask and the libraries\nit uses. In order to grow the community of contributors and users, and\nallow the maintainers to devote more time to the projects, [please\ndonate today](https://palletsprojects.com/donate)\n\n---\n\n## First time setup\n\n- Download the repository to your local machine.\n- Create a virtualenv.\n\n```shell\n# Linux/macOS\n$ python3 -m venv env\n$ . env/bin/active\n\n# Window\n$ py -3 -m venv env\n$ env/Scripts/active\n```\n\n- Install `pip-tools`, `twine` and `build` in the virtualenv. \n\n```shell\n>pip install --upgrade pip\n>pip install pip-tools twine build\n```\n\n- Install the development dependencies, then install `Flask-ShopifyUtils` in editable mode.\n\n```sheel\n$ pip install -r requirements/dev.txt && pip install -e .\n```\n\n- Build the wheel\n```shell\n# new \n>python -m build\n# For more reference https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html\n```\n\n- Deploy to PyPI\n\n```shell\n# check\n>twine check dist/*\n# upload\n>twine upload dist/*\n```\n\n## requirements.txt\n\nAll dependencies are managed by `pip-tools`, so you need to install it first.\nAnd you can find them from the `requirements` folder.\n\n```shell\n# development\n>pip-compile --extra=dev --output-file=requirements/dev.txt pyproject.toml\n\n# production\n>pip-compile --output-file=requirements/index.txt pyproject.toml\n````\n\n## Running the tests\n\nMake sure you have install the repository locally.\n\n```shell\n# install the package\n>pip install -e .\n# install the pytest\n>pip install pytest\n# run all tests\n>pytest\n# run tests with output\n>pytest -s\n# run specific test\n>pytest -vs tests/test_init.py\n# run specific test case\n>pytest -vs tests/test_init.py::test_init_app\n```\n\n---\n\n# Reference\n[Packing for Python](https://packaging.python.org/en/latest/tutorials/installing-packages/)\n\n# TODO\nAdd test for `ShopifyUtil` methods",
"bugtrack_url": null,
"license": null,
"summary": "A Flask extension for Shopify app development",
"version": "0.1.3",
"project_urls": {
"Bug Tracker": "https://github.com/leocxy/flask-shopify-utils/issues",
"Homepage": "https://github.com/leocxy/flask-shopify-utils"
},
"split_keywords": [
"extension",
" flask",
" flask extension",
" sdk",
" shopify",
" shopify-sdk"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "21a28f170fed3e84ac81e06a8e00b418d798d355ec1718bfaea95ada95b5bdb2",
"md5": "3feda2bceceb8310087cf639b6e946ef",
"sha256": "a49da549c0a8212161f0c8d811fb3029cb1a28d0e765b38416ecacd8f186fafe"
},
"downloads": -1,
"filename": "flask_shopify_utils-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3feda2bceceb8310087cf639b6e946ef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 14324,
"upload_time": "2024-04-04T22:19:31",
"upload_time_iso_8601": "2024-04-04T22:19:31.900331Z",
"url": "https://files.pythonhosted.org/packages/21/a2/8f170fed3e84ac81e06a8e00b418d798d355ec1718bfaea95ada95b5bdb2/flask_shopify_utils-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dec4a14ba135614765c276ff35ba14b76ed2525564bff6232e82900d93aea272",
"md5": "c4258ad6e989ab0a38e30c9483a72c65",
"sha256": "dc4576536b4b0a69b7a9d013d42fdf0076eb6ae8a6b85ce4cf842c186090fd89"
},
"downloads": -1,
"filename": "flask_shopify_utils-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "c4258ad6e989ab0a38e30c9483a72c65",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14848,
"upload_time": "2024-04-04T22:19:33",
"upload_time_iso_8601": "2024-04-04T22:19:33.910923Z",
"url": "https://files.pythonhosted.org/packages/de/c4/a14ba135614765c276ff35ba14b76ed2525564bff6232e82900d93aea272/flask_shopify_utils-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-04 22:19:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "leocxy",
"github_project": "flask-shopify-utils",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "flask-shopify-utils"
}
JSON
