buildzr 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- buildzr/__about__.py +1 -1
- {buildzr-0.0.1.dist-info → buildzr-0.0.2.dist-info}/METADATA +15 -5
- {buildzr-0.0.1.dist-info → buildzr-0.0.2.dist-info}/RECORD +5 -5
- {buildzr-0.0.1.dist-info → buildzr-0.0.2.dist-info}/WHEEL +0 -0
- {buildzr-0.0.1.dist-info → buildzr-0.0.2.dist-info}/licenses/LICENSE.md +0 -0
buildzr/__about__.py
CHANGED
@@ -1 +1 @@
|
|
1
|
-
VERSION = "0.0.
|
1
|
+
VERSION = "0.0.2"
|
@@ -1,6 +1,6 @@
|
|
1
1
|
Metadata-Version: 2.3
|
2
2
|
Name: buildzr
|
3
|
-
Version: 0.0.
|
3
|
+
Version: 0.0.2
|
4
4
|
Summary: Structurizr for the `buildzr`s 🧱⚒️
|
5
5
|
Project-URL: homepage, https://github.com/amirulmenjeni/buildzr
|
6
6
|
Project-URL: issues, https://github.com/amirulmenjeni/buildzr/issues
|
@@ -28,19 +28,26 @@ Requires-Dist: pytest-mypy==0.10.3; extra == 'dev'
|
|
28
28
|
Requires-Dist: yq==3.4.3; extra == 'dev'
|
29
29
|
Description-Content-Type: text/markdown
|
30
30
|
|
31
|
+
test: 1
|
31
32
|
# Structurizr for the `buildzr`s 🧱⚒️
|
32
33
|
|
33
34
|
`buildzr` is a [Structurizr](https://structurizr.com/) authoring tool for Python programmers.
|
34
35
|
|
35
36
|
If you're not familiar with Structurizr, it is both an open standard (see [Structurizr JSON schema](https://github.com/structurizr/json)) and a [set of tools](https://docs.structurizr.com/usage) for building software architecture diagrams as code. Structurizr derive its architecture modeling paradigm based on the [C4 model](https://c4model.com/), the modeling language for visualizing software architecture.
|
36
37
|
|
37
|
-
`buildzr` offers flexible and fluent APIs to write software architecture models
|
38
|
+
`buildzr` offers flexible and fluent APIs to write software architecture models,
|
39
|
+
leveraging the standard Structurizr JSON schema for interoperability with
|
40
|
+
various rendering and authoring tools.
|
38
41
|
|
39
42
|
# Quick Start 🚀
|
40
43
|
|
41
44
|
## Installation
|
42
45
|
|
43
|
-
|
46
|
+
You can use `pip` to install the `buildzr` package:
|
47
|
+
|
48
|
+
```bash
|
49
|
+
pip install buildzr
|
50
|
+
```
|
44
51
|
|
45
52
|
## Creating a workspace
|
46
53
|
|
@@ -117,7 +124,10 @@ with open(os.path.join(os.path.curdir, f"{__file__.split('.')[0]}.json"), 'w', e
|
|
117
124
|
json.dump(w.model, f, ensure_ascii=False, indent=4, cls=JsonEncoder)
|
118
125
|
```
|
119
126
|
|
120
|
-
|
127
|
+
Here's a short breakdown on what's happening:
|
128
|
+
- In `Workspace(...).contains(...)` method, we define the _static_ C4 models (i.e., `Person`, `SoftwareSystem`, and the `Container`s in the software system).
|
129
|
+
- In the `Workspace(...).contains(...).where(...)`, we define the relationships between the C4 models in the workspace. We access the models via the `w` parameter in the `lambda` function, and create the relationships using the `>>` operators.
|
130
|
+
- Finally, once we have all the models and their relationships defined, we use (and re-use!) the static models to create multiple views to tell different stories and show various narrative to help document your software architecture.
|
121
131
|
|
122
132
|
The JSON output can be found [here](examples/system_context_and_container_view.json). You can also try out https://structurizr.com/json to see how this workspace will be rendered.
|
123
133
|
|
@@ -131,7 +141,7 @@ The JSON output can be found [here](examples/system_context_and_container_view.j
|
|
131
141
|
|
132
142
|
✅ Writing architecture diagrams in Python allows you to integrate programmability and automation into your software architecture diagramming and documentation workflow.
|
133
143
|
|
134
|
-
✅ Uses the familiar Python programming language to write
|
144
|
+
✅ Uses the familiar Python programming language to write software architecture diagrams!
|
135
145
|
|
136
146
|
# Contributing
|
137
147
|
|
@@ -1,4 +1,4 @@
|
|
1
|
-
buildzr/__about__.py,sha256=
|
1
|
+
buildzr/__about__.py,sha256=9Zlp57vGDZdjqRmTvIScwFM36g13gE1h2p0EScSlrK4,17
|
2
2
|
buildzr/__init__.py,sha256=hY-cOdjBQcz0v2m8cBF1oEJFIbcR3sWI-xww--0RKSo,99
|
3
3
|
buildzr/dsl/__init__.py,sha256=paxuMCCDuOs1eSvBPyuW5pv5j1UZD6TxRZcCzC2iKss,307
|
4
4
|
buildzr/dsl/dsl.py,sha256=X5lJJhD9dQ7YlRAECdXJb9qJKWfrfi-1H5rESYOnGhI,34584
|
@@ -14,7 +14,7 @@ buildzr/encoders/encoder.py,sha256=9_FlQ3aYvz0EcN_G9A3bPdqxCTkLhc2OrYXSYti95f8,2
|
|
14
14
|
buildzr/models/__init__.py,sha256=SRfF7oDVlOOAi6nGKiJIUK6B_arqYLO9iSMp-2IZZps,21
|
15
15
|
buildzr/models/generate.sh,sha256=924UoEXr5WBZ926TZfRgEQGHwBqtLGU5k0G2UfExLEg,1061
|
16
16
|
buildzr/models/models.py,sha256=0LhLG1wmbt4dvROV5MEBZLLoxPbMpkUsOqNz525cynE,42489
|
17
|
-
buildzr-0.0.
|
18
|
-
buildzr-0.0.
|
19
|
-
buildzr-0.0.
|
20
|
-
buildzr-0.0.
|
17
|
+
buildzr-0.0.2.dist-info/METADATA,sha256=qUaIKZRk1A-uGyTkmQ_sXU4t6Eu2EB1OTJOLAk5slu0,6263
|
18
|
+
buildzr-0.0.2.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
|
19
|
+
buildzr-0.0.2.dist-info/licenses/LICENSE.md,sha256=e8e6W6tL4MbBY-c-gXMgDbaMf_BnaQDQv4Yoy42b-CI,1070
|
20
|
+
buildzr-0.0.2.dist-info/RECORD,,
|
File without changes
|
File without changes
|