Skip to main content

Stories build pypi

Service objects designed with OOP in mind.

Documentation | Source Code | Task Tracker

A paragraph of text explaining the goal of the library…

Pros

  • A feature
  • B feature
  • etc

Example

A line of text explaining snippet below…

>>> from dataclasses import dataclass
>>> from typing import Callable
>>> from stories import Story, I, State
>>> from app.repositories import load_order, load_customer, create_payment

>>> @dataclass
... class Purchase(Story):
...     I.find_order
...     I.find_customer
...     I.check_balance
...     I.persist_payment
...
...     def find_order(self, state):
...         state.order = self.load_order(state.order_id)
...
...     def find_customer(self, state):
...         state.customer = self.load_customer(state.customer_id)
...
...     def check_balance(self, state):
...         if not state.order.affordable_for(state.customer):
...             raise Exception
...
...     def persist_payment(self, state):
...         state.payment = self.create_payment(
...             order_id=state.order_id, customer_id=state.customer_id
...         )
...
...     load_order: Callable
...     load_customer: Callable
...     create_payment: Callable

>>> purchase = Purchase(
...     load_order=load_order,
...     load_customer=load_customer,
...     create_payment=create_payment,
... )

>>> state = State(order_id=1, customer_id=1)

>>> purchase(state)

>>> state  # doctest: +SKIP

>>> state.payment.was_received()
False

Questions

If you have any questions, feel free to create an issue in our Task Tracker. We have the question label exactly for this purpose.

Enterprise support

If you have an issue with any version of the library, you can apply for a paid enterprise support contract. This will guarantee you that no breaking changes will happen to you. No matter how old version you're using at the moment. All necessary features and bug fixes will be backported in a way that serves your needs.

Please contact proofit404@gmail.com if you're interested in it.

License

stories library is offered under the two clause BSD license.

— ⭐ —

Metadata

Release files for stories 5.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for stories 5.1.0
File Size Uploaded
stories-5.1.0.tar.gz 7.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for stories 5.1.0
File Interpreter ABI Platform
stories-5.1.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 16.4 kB

Release files / stories-5.1.0.tar.gz

Download URL stories-5.1.0.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
d0d9fc95dca4b1ac1ee49f5b6ffb93222a0b2cad12f10a5434b225cdb029babf
BLAKE2b-256 checksum
How to use checksums
b1d1253f190cc4ae0eb64498ee2304b75cc09c0bb8690bc3e94279d036c9e38a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.2.2 CPython/3.10.4 Linux/5.15.0-1020-azure

Release files / stories-5.1.0-py2.py3-none-any.whl

Download URL stories-5.1.0-py2.py3-none-any.whl
Size 8.9 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
b67ef87ddfa918e9baeb8fd0da4e0410c09127ca7181a8d929e58f9bea6645a9
BLAKE2b-256 checksum
How to use checksums
616eeff24c7917a7d5b2834c18ab0216f812a9417b31292834bbbf775b5d8773
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.2.2 CPython/3.10.4 Linux/5.15.0-1020-azure
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page