Skip to main content

ORM library to build SQLite based application in format model/dao/service.

Project description

Sqller

ORM library to build SQLite based application in format model/dao/service.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Installing

At first, you need SQLite3 to be installed. Type following in your terminal:

apt-get install libsqlite3-dev

To install the package type the following in your terminal:

sudo pip install sqller

Running the tests

To run tests type the following in your terminal:

python3 -m pytest

or

python -m pytest

if the previous command doesn't work.

Usage

The usage of the library in real application consists of the following steps:

  • Create a model
  • Create a data access object (DAO)
  • Create a service
  • Use the service

The steps are described below.

Create model

class Chat(metaclass=sqller.ModelMeta):
    NAME = 'chats'
    FIELDS = [
        Field(name="id", dtype="integer", postfix="PRIMARY KEY"),
        Field(name="type", dtype="text"),
        Field(name="last_name", dtype="text"),
        Field(name="first_name", dtype="text"),
        Field(name="username", dtype="text"),
        Field(name="chat_id", dtype="integer")
    ]

Create DAO

class ChatDAO(metaclass=sqller.DAOMeta):
    MODEL = Chat

Create service

class TelegramService(metaclass=sqller.ServiceMeta):
    DB_PATH = config.DATABASE_PATH
    MODELS = [
        models.Chat,
        models.SelectedCriterion
    ]

    @staticmethod
    def save_chat_info(chat: telebot.types.Chat):
        obj_exist_checker = models.Chat(id=chat.id)
        obj = models.Chat(
            type = chat.type,
            last_name = chat.last_name,
            first_name = chat.first_name,
            username = chat.username,
            chat_id=chat.id
        )
        sql_exists = dao.ChatDAO.sql_exists(obj_exist_checker)
        sql_save = dao.ChatDAO.sql_save(obj)
        exists = TelegramService.execute(sql_exists)[0][0]
        if not exists:
            TelegramService.execute(sql_save)

Use service

TelegramService.save_chat_info(chat)

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sqller, version 1.4.2
Filename, size File type Python version Upload date Hashes
Filename, size sqller-1.4.2.tar.gz (6.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page