Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs/architecture.mmd
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
sequenceDiagram
autonumber
participant Pytest as Pytest runner
participant ProcFactory as postgresql_proc_factory
participant PgServer as PostgreSQL process
participant BaseProc as base_proc fixture (postgresql_proc_factory)
participant PgServer as PostgreSQL server
participant TemplateDB as Template DB (seeded)
participant TestDB as Per-test DB (clone)

Pytest->>ProcFactory: request postgresql_proc with load=[load_database]
ProcFactory->>PgServer: start server
ProcFactory->>TemplateDB: invoke load_database (create metadata, seed data)
Pytest->>BaseProc: request base_proc with load=[load_database]
BaseProc->>PgServer: start server
BaseProc->>TemplateDB: invoke load_database (create metadata, seed data)
Note right of TemplateDB: Template is created and seeded once per full run
loop per test
Pytest->>PgServer: request clone of TemplateDB
Expand Down
37 changes: 20 additions & 17 deletions docs/architecture_chaining.mmd
Original file line number Diff line number Diff line change
@@ -1,22 +1,25 @@
sequenceDiagram
participant Test as Test
participant ProcF as base_proc Fixture
participant NoProc1 as seeded_noproc Fixture
participant NoProc2 as more_seeded_noproc Fixture
participant DB as PostgreSQL DB
participant Pytest as Pytest runner
participant BaseProc as base_proc fixture (postgresql_proc_factory)
participant NoProc1 as seeded_noproc fixture
participant NoProc2 as more_seeded_noproc fixture
participant PgServer as PostgreSQL server
participant TemplateDB as Template DB (seeded)
participant LayeredDB as Layered DB (seeded)

Test->>ProcF: request base_proc
ProcF->>DB: init database & run load_schema
ProcF-->>Test: return PostgreSQLExecutor
Pytest->>BaseProc: request base_proc
BaseProc->>PgServer: start server
BaseProc->>TemplateDB: init database & run load_schema
BaseProc-->>Pytest: return PostgreSQLExecutor

Test->>NoProc1: request seeded_noproc (depends_on=base_proc)
NoProc1->>ProcF: read connection/template info
NoProc1->>DB: create layered DB / run load_data
NoProc1-->>Test: return NoopExecutor
Pytest->>NoProc1: request seeded_noproc (depends_on=base_proc)
NoProc1->>BaseProc: read connection/template info
NoProc1->>LayeredDB: create layered DB / run load_data
NoProc1-->>Pytest: return NoopExecutor

Test->>NoProc2: request more_seeded_noproc (depends_on=seeded_noproc)
NoProc2->>NoProc1: read connection/template info
NoProc2->>DB: run load_more_data on layered DB
NoProc2-->>Test: return NoopExecutor
Pytest->>NoProc2: request more_seeded_noproc (depends_on=seeded_noproc)
NoProc2->>NoProc1: read connection/template info
NoProc2->>LayeredDB: run load_more_data on layered DB
NoProc2-->>Pytest: return NoopExecutor

Test->>Test: validate tables and data across layers
Pytest->>Pytest: validate tables and data across layers
2 changes: 1 addition & 1 deletion docs/images/architecture.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs/images/architecture_chaining.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions newsfragments/+56cec843.docs.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Make sure diagrams are using unified terminology.