Metadata-Version: 2.1
Name: desktop_shop
Version: 1.0.0
Summary: Desktop shop application
Home-page: https://github.com/rbaltrusch/desktop_shop
Author: Richard Baltrusch
License: MIT
Description: [![Unit tests](https://github.com/rbaltrusch/desktop_shop/actions/workflows/pytest-unit-tests.yml/badge.svg)](https://github.com/rbaltrusch/desktop_shop/actions/workflows/pytest-unit-tests.yml)
        [![Pylint](https://github.com/rbaltrusch/desktop_shop/actions/workflows/pylint.yml/badge.svg)](https://github.com/rbaltrusch/desktop_shop/actions/workflows/pylint.yml)
        [![License: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](https://opensource.org/licenses/MIT)
        
        # Desktop Shop
        
        This is a mock shop application, running completely offline on a desktop. The graphical interface connects with a generated, local database of customers, products and transactions (Python / SQLite3). As the application runs completely offline, it does away with any networking or server complexity and showcases a bare implementation of an application interfacing with a production database.
        
        ![Screenshot of the application GUI](desktop_shop/gui/media/gif.gif?raw=true "Screenshot of the application GUI")
        
        
        ## Disclaimer
        
        Any personal information shown in the gui or stored in the database is not related to any natural people. All information was generated automatically. Any names or other user data which coincide with real individuals are pure coincidence.
        
        ## Getting started
        
        To get a copy of this repository, simply open up git bash in an empty folder and use the command:
        
            $ git clone https://github.com/rbaltrusch/desktop_shop
        
        To install all python dependencies, run the following in your command line:
        
            python -m pip install -r requirements.txt
        
        Run the shop application by installing the desktop_shop package locally, generating the random database (this can take a few seconds) and calling the desktop_shop package:
        
            python -m pip install -e .
            python "desktop_shop/database.py" generate --fast
            python -m desktop_shop
        
        To run tests, run the run_tests script in the tests directory:
        
            python "tests/run_tests.py" --all
        
        ## Contributions
        
        To contribute to this repository, please read the [contribution guidelines](CONTRIBUTING.md).
        
        ## Python
        
        Written in Python 3.8.3.
        
        ## License
        
        This repository is open-source software available under the [MIT License](https://github.com/rbaltrusch/desktop_shop/blob/master/LICENSE).
        
        ## Contact
        
        Please raise an issue for code changes. To reach out, please send an email to richard@baltrusch.net.
        
Keywords: python
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
