RacksDB 0.3.0__tar.gz → 0.5.0__tar.gz
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.
- {RacksDB-0.3.0 → racksdb-0.5.0}/PKG-INFO +60 -18
- {RacksDB-0.3.0 → racksdb-0.5.0}/README.md +47 -15
- {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/PKG-INFO +60 -18
- racksdb-0.5.0/RacksDB.egg-info/SOURCES.txt +87 -0
- racksdb-0.5.0/RacksDB.egg-info/requires.txt +18 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/pyproject.toml +14 -16
- racksdb-0.5.0/racksdb/__init__.py +123 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/bases.py +75 -10
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/__init__.py +2 -1
- racksdb-0.5.0/racksdb/drawers/axonometric_infrastructure.py +603 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/base.py +74 -9
- racksdb-0.5.0/racksdb/drawers/coordinates/__init__.py +17 -0
- racksdb-0.5.0/racksdb/drawers/coordinates/base.py +10 -0
- racksdb-0.5.0/racksdb/drawers/coordinates/json.py +19 -0
- racksdb-0.5.0/racksdb/drawers/coordinates/yaml.py +19 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/dtypes/hexcolor.py +5 -3
- racksdb-0.5.0/racksdb/drawers/infrastructure.py +613 -0
- racksdb-0.5.0/racksdb/drawers/room.py +237 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/angle.py +0 -1
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/bits.py +3 -4
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/bytes.py +3 -4
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/dimension.py +0 -1
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/netif_type.py +0 -1
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/rack_height.py +0 -1
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/rack_width.py +0 -1
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/storage_type.py +0 -1
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/watts.py +2 -3
- racksdb-0.5.0/racksdb/errors.py +32 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/exec.py +78 -23
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/db.py +85 -38
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/json.py +4 -18
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/yaml.py +8 -25
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/openapi.py +98 -43
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/schema.py +8 -3
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/views.py +59 -16
- racksdb-0.5.0/racksdb/tests/drawers/__init__.py +0 -0
- racksdb-0.5.0/racksdb/tests/drawers/test_axonometric_infrastructure.py +84 -0
- RacksDB-0.3.0/racksdb/tests/test_drawer.py → racksdb-0.5.0/racksdb/tests/drawers/test_base.py +31 -34
- racksdb-0.5.0/racksdb/tests/drawers/test_infrastructure.py +158 -0
- racksdb-0.5.0/racksdb/tests/drawers/test_parameters.py +53 -0
- racksdb-0.5.0/racksdb/tests/generic/__init__.py +0 -0
- racksdb-0.5.0/racksdb/tests/generic/dumpers/__init__.py +0 -0
- racksdb-0.5.0/racksdb/tests/generic/dumpers/test_dumper_console.py +49 -0
- racksdb-0.5.0/racksdb/tests/generic/dumpers/test_dumper_json.py +55 -0
- racksdb-0.5.0/racksdb/tests/generic/dumpers/test_dumper_yaml.py +74 -0
- racksdb-0.5.0/racksdb/tests/generic/dumpers/test_factory.py +35 -0
- racksdb-0.5.0/racksdb/tests/generic/lib/__init__.py +0 -0
- racksdb-0.5.0/racksdb/tests/generic/lib/bases.py +19 -0
- racksdb-0.5.0/racksdb/tests/generic/lib/common.py +185 -0
- racksdb-0.5.0/racksdb/tests/generic/lib/views.py +85 -0
- racksdb-0.5.0/racksdb/tests/generic/test_db.py +132 -0
- racksdb-0.5.0/racksdb/tests/generic/test_db_dict.py +85 -0
- racksdb-0.5.0/racksdb/tests/generic/test_db_list.py +39 -0
- racksdb-0.5.0/racksdb/tests/generic/test_db_loader.py +137 -0
- racksdb-0.5.0/racksdb/tests/generic/test_openapi.py +20 -0
- {RacksDB-0.3.0/racksdb/tests → racksdb-0.5.0/racksdb/tests/generic}/test_schema.py +66 -95
- racksdb-0.5.0/racksdb/tests/generic/test_schema_file_loader.py +47 -0
- racksdb-0.5.0/racksdb/tests/generic/test_views.py +40 -0
- racksdb-0.5.0/racksdb/tests/lib/__init__.py +0 -0
- racksdb-0.5.0/racksdb/tests/lib/common.py +66 -0
- racksdb-0.5.0/racksdb/tests/lib/reference.py +75 -0
- racksdb-0.5.0/racksdb/tests/lib/web.py +24 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/tests/test_defined_type_hexcolor.py +4 -2
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/tests/test_defined_type_watts.py +2 -2
- racksdb-0.5.0/racksdb/tests/test_exec.py +668 -0
- racksdb-0.5.0/racksdb/tests/test_racksdb.py +161 -0
- racksdb-0.5.0/racksdb/tests/web/__init__.py +0 -0
- racksdb-0.5.0/racksdb/tests/web/test_app.py +155 -0
- racksdb-0.5.0/racksdb/tests/web/test_blueprint.py +940 -0
- racksdb-0.5.0/racksdb/version.py +15 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/views.py +85 -7
- racksdb-0.5.0/racksdb/web/__init__.py +0 -0
- racksdb-0.5.0/racksdb/web/app.py +449 -0
- RacksDB-0.3.0/RacksDB.egg-info/SOURCES.txt +0 -54
- RacksDB-0.3.0/RacksDB.egg-info/requires.txt +0 -7
- RacksDB-0.3.0/racksdb/__init__.py +0 -74
- RacksDB-0.3.0/racksdb/drawers/infrastructure.py +0 -282
- RacksDB-0.3.0/racksdb/drawers/room.py +0 -163
- RacksDB-0.3.0/racksdb/errors.py +0 -9
- RacksDB-0.3.0/racksdb/tests/tests_db_load.py +0 -82
- RacksDB-0.3.0/racksdb/version.py +0 -11
- RacksDB-0.3.0/racksdb/web/app.py +0 -248
- RacksDB-0.3.0/racksdb/web/ui/node_modules/flatted/python/flatted.py +0 -149
- RacksDB-0.3.0/racksdb/web/ui/node_modules/flatted/python/test.py +0 -63
- {RacksDB-0.3.0 → racksdb-0.5.0}/LICENSE +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/dependency_links.txt +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/entry_points.txt +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/top_level.txt +0 -0
- {RacksDB-0.3.0/racksdb → racksdb-0.5.0/racksdb/drawers}/dtypes/__init__.py +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/parameters.py +0 -0
- {RacksDB-0.3.0/racksdb/generic → racksdb-0.5.0/racksdb/dtypes}/__init__.py +0 -0
- {RacksDB-0.3.0/racksdb/tests → racksdb-0.5.0/racksdb/generic}/__init__.py +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/definedtype.py +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/__init__.py +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/_common.py +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/console.py +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/errors.py +0 -0
- {RacksDB-0.3.0/racksdb/web → racksdb-0.5.0/racksdb/tests}/__init__.py +0 -0
- {RacksDB-0.3.0/racksdb/tests → racksdb-0.5.0/racksdb/tests/generic}/test_schema_defined_type_loader.py +0 -0
- {RacksDB-0.3.0 → racksdb-0.5.0}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
Metadata-Version: 2.
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
2
|
Name: RacksDB
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.5.0
|
|
4
4
|
Summary: Modelize your datacenters infrastructures in YAML database
|
|
5
5
|
Author-email: Rémi Palancher <remi@rackslab.io>
|
|
6
6
|
License: GPLv3+
|
|
@@ -20,20 +20,29 @@ License-File: LICENSE
|
|
|
20
20
|
Requires-Dist: PyYAML
|
|
21
21
|
Requires-Dist: ClusterShell
|
|
22
22
|
Requires-Dist: pycairo
|
|
23
|
+
Requires-Dist: PyGObject
|
|
24
|
+
Requires-Dist: RFL.log
|
|
25
|
+
Provides-Extra: dev
|
|
26
|
+
Requires-Dist: Flask-Cors; extra == "dev"
|
|
23
27
|
Provides-Extra: web
|
|
24
28
|
Requires-Dist: Flask; extra == "web"
|
|
25
|
-
Requires-Dist:
|
|
29
|
+
Requires-Dist: requests-toolbelt; extra == "web"
|
|
30
|
+
Provides-Extra: tests
|
|
31
|
+
Requires-Dist: coverage; extra == "tests"
|
|
32
|
+
Requires-Dist: parameterized; extra == "tests"
|
|
33
|
+
Requires-Dist: pytest; extra == "tests"
|
|
34
|
+
Requires-Dist: pytest-cov; extra == "tests"
|
|
35
|
+
Dynamic: license-file
|
|
36
|
+
|
|
37
|
+
# RacksDB
|
|
38
|
+
|
|
39
|
+
## Overview
|
|
26
40
|
|
|
27
41
|
<img
|
|
28
42
|
src="assets/bitmaps/logo_full_white_medium.png"
|
|
29
43
|
alt="RacksDB Overview"
|
|
30
44
|
align="right"
|
|
31
|
-
width="200px"
|
|
32
|
-
style="margin: 20px;">
|
|
33
|
-
|
|
34
|
-
# RacksDB
|
|
35
|
-
|
|
36
|
-
## Overview
|
|
45
|
+
width="200px">
|
|
37
46
|
|
|
38
47
|
**RacksDB** is an _open source_ solution to modelize your datacenters
|
|
39
48
|
infrastructures. It provides a simple database schema to store information about
|
|
@@ -53,9 +62,8 @@ source** for many purposes in IT management.
|
|
|
53
62
|
|
|
54
63
|
<p align="center">
|
|
55
64
|
<img
|
|
56
|
-
src="docs/modules/overview/images/racksdb_overview.
|
|
65
|
+
src="docs/modules/overview/images/racksdb_overview.png"
|
|
57
66
|
alt="RacksDB Overview"
|
|
58
|
-
width="600px"
|
|
59
67
|
style="margin: 0 auto;">
|
|
60
68
|
</p>
|
|
61
69
|
|
|
@@ -81,11 +89,39 @@ solutions are the following:
|
|
|
81
89
|
* **Extensibility.** In addition to RacksDB simple format, custom schema
|
|
82
90
|
extensions can be defined to store specific data.
|
|
83
91
|
|
|
84
|
-
RacksDB provides multiple interfaces
|
|
92
|
+
RacksDB provides multiple interfaces with its
|
|
85
93
|
[CLI tool](https://docs.rackslab.io/racksdb/usage/racksdb.html), a
|
|
86
94
|
[Python library](https://docs.rackslab.io/racksdb/usage/lib.html), a
|
|
87
95
|
[REST API](https://docs.rackslab.io/racksdb/usage/rest.html) and a
|
|
88
|
-
[Web UI](racksdb/
|
|
96
|
+
[Web UI](https://docs.rackslab.io/racksdb/usage/ui.html).
|
|
97
|
+
|
|
98
|
+
<p align="center">
|
|
99
|
+
<img
|
|
100
|
+
src="docs/modules/overview/images/racksdb_interfaces.png"
|
|
101
|
+
alt="RacksDB web UI">
|
|
102
|
+
<p>
|
|
103
|
+
|
|
104
|
+
<p align="center">
|
|
105
|
+
<img
|
|
106
|
+
src="assets/screenshots/assemblies/bitmaps/screenshots-small.webp"
|
|
107
|
+
alt="RacksDB web UI"
|
|
108
|
+
width="600px">
|
|
109
|
+
<p>
|
|
110
|
+
|
|
111
|
+
RacksDB can generate graphical representations of your datacenter rooms and your
|
|
112
|
+
infrastructures with their racks and equipment, including axonometric views for
|
|
113
|
+
3D representations:
|
|
114
|
+
|
|
115
|
+
<p align="center">
|
|
116
|
+
<img
|
|
117
|
+
src="docs/modules/overview/images/racksdb_diagrams.png"
|
|
118
|
+
alt="RacksDB graphical representations"
|
|
119
|
+
width="500px">
|
|
120
|
+
<p>
|
|
121
|
+
|
|
122
|
+
These graphical representations can be generated in various formats (PNG, SVG,
|
|
123
|
+
PDF) and can be customized with many
|
|
124
|
+
[drawing parameters](https://docs.rackslab.io/racksdb/usage/drawparams.html).
|
|
89
125
|
|
|
90
126
|
For more details, read the
|
|
91
127
|
[full description](https://docs.rackslab.io/racksdb/overview/overview.html)
|
|
@@ -115,11 +151,11 @@ are available:
|
|
|
115
151
|
* **Matrix Chat** [#racksdb:talk.rackslab.io](https://matrix.to/#/#racksdb:talk.rackslab.io):
|
|
116
152
|
instant messaging for quick feedback and help.
|
|
117
153
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
154
|
+
> [!NOTE]
|
|
155
|
+
> A [Matrix account](https://matrix.org/docs/chat_basics/matrix-for-im/#creating-a-matrix-account)
|
|
156
|
+
> is required to access the chat room. It can be created in few steps on any
|
|
157
|
+
> Matrix network public provider such as [matrix.org](https://matrix.org) or
|
|
158
|
+
> [gitter.im](https://gitter.im/#apps).
|
|
123
159
|
|
|
124
160
|
* [**GitHub Discussions**](https://github.com/rackslab/RacksDB/discussions):
|
|
125
161
|
send questions, ideas and suggestions.
|
|
@@ -143,6 +179,12 @@ To run the unit tests, launch this command:
|
|
|
143
179
|
$ python3 -m unittest discover -v .
|
|
144
180
|
```
|
|
145
181
|
|
|
182
|
+
Or:
|
|
183
|
+
|
|
184
|
+
```
|
|
185
|
+
$ pytest
|
|
186
|
+
```
|
|
187
|
+
|
|
146
188
|
## License
|
|
147
189
|
|
|
148
190
|
RacksDB is distributed under the terms of the GNU General Public License v3.0 or
|
|
@@ -1,13 +1,12 @@
|
|
|
1
|
+
# RacksDB
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
1
5
|
<img
|
|
2
6
|
src="assets/bitmaps/logo_full_white_medium.png"
|
|
3
7
|
alt="RacksDB Overview"
|
|
4
8
|
align="right"
|
|
5
|
-
width="200px"
|
|
6
|
-
style="margin: 20px;">
|
|
7
|
-
|
|
8
|
-
# RacksDB
|
|
9
|
-
|
|
10
|
-
## Overview
|
|
9
|
+
width="200px">
|
|
11
10
|
|
|
12
11
|
**RacksDB** is an _open source_ solution to modelize your datacenters
|
|
13
12
|
infrastructures. It provides a simple database schema to store information about
|
|
@@ -27,9 +26,8 @@ source** for many purposes in IT management.
|
|
|
27
26
|
|
|
28
27
|
<p align="center">
|
|
29
28
|
<img
|
|
30
|
-
src="docs/modules/overview/images/racksdb_overview.
|
|
29
|
+
src="docs/modules/overview/images/racksdb_overview.png"
|
|
31
30
|
alt="RacksDB Overview"
|
|
32
|
-
width="600px"
|
|
33
31
|
style="margin: 0 auto;">
|
|
34
32
|
</p>
|
|
35
33
|
|
|
@@ -55,11 +53,39 @@ solutions are the following:
|
|
|
55
53
|
* **Extensibility.** In addition to RacksDB simple format, custom schema
|
|
56
54
|
extensions can be defined to store specific data.
|
|
57
55
|
|
|
58
|
-
RacksDB provides multiple interfaces
|
|
56
|
+
RacksDB provides multiple interfaces with its
|
|
59
57
|
[CLI tool](https://docs.rackslab.io/racksdb/usage/racksdb.html), a
|
|
60
58
|
[Python library](https://docs.rackslab.io/racksdb/usage/lib.html), a
|
|
61
59
|
[REST API](https://docs.rackslab.io/racksdb/usage/rest.html) and a
|
|
62
|
-
[Web UI](racksdb/
|
|
60
|
+
[Web UI](https://docs.rackslab.io/racksdb/usage/ui.html).
|
|
61
|
+
|
|
62
|
+
<p align="center">
|
|
63
|
+
<img
|
|
64
|
+
src="docs/modules/overview/images/racksdb_interfaces.png"
|
|
65
|
+
alt="RacksDB web UI">
|
|
66
|
+
<p>
|
|
67
|
+
|
|
68
|
+
<p align="center">
|
|
69
|
+
<img
|
|
70
|
+
src="assets/screenshots/assemblies/bitmaps/screenshots-small.webp"
|
|
71
|
+
alt="RacksDB web UI"
|
|
72
|
+
width="600px">
|
|
73
|
+
<p>
|
|
74
|
+
|
|
75
|
+
RacksDB can generate graphical representations of your datacenter rooms and your
|
|
76
|
+
infrastructures with their racks and equipment, including axonometric views for
|
|
77
|
+
3D representations:
|
|
78
|
+
|
|
79
|
+
<p align="center">
|
|
80
|
+
<img
|
|
81
|
+
src="docs/modules/overview/images/racksdb_diagrams.png"
|
|
82
|
+
alt="RacksDB graphical representations"
|
|
83
|
+
width="500px">
|
|
84
|
+
<p>
|
|
85
|
+
|
|
86
|
+
These graphical representations can be generated in various formats (PNG, SVG,
|
|
87
|
+
PDF) and can be customized with many
|
|
88
|
+
[drawing parameters](https://docs.rackslab.io/racksdb/usage/drawparams.html).
|
|
63
89
|
|
|
64
90
|
For more details, read the
|
|
65
91
|
[full description](https://docs.rackslab.io/racksdb/overview/overview.html)
|
|
@@ -89,11 +115,11 @@ are available:
|
|
|
89
115
|
* **Matrix Chat** [#racksdb:talk.rackslab.io](https://matrix.to/#/#racksdb:talk.rackslab.io):
|
|
90
116
|
instant messaging for quick feedback and help.
|
|
91
117
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
118
|
+
> [!NOTE]
|
|
119
|
+
> A [Matrix account](https://matrix.org/docs/chat_basics/matrix-for-im/#creating-a-matrix-account)
|
|
120
|
+
> is required to access the chat room. It can be created in few steps on any
|
|
121
|
+
> Matrix network public provider such as [matrix.org](https://matrix.org) or
|
|
122
|
+
> [gitter.im](https://gitter.im/#apps).
|
|
97
123
|
|
|
98
124
|
* [**GitHub Discussions**](https://github.com/rackslab/RacksDB/discussions):
|
|
99
125
|
send questions, ideas and suggestions.
|
|
@@ -117,6 +143,12 @@ To run the unit tests, launch this command:
|
|
|
117
143
|
$ python3 -m unittest discover -v .
|
|
118
144
|
```
|
|
119
145
|
|
|
146
|
+
Or:
|
|
147
|
+
|
|
148
|
+
```
|
|
149
|
+
$ pytest
|
|
150
|
+
```
|
|
151
|
+
|
|
120
152
|
## License
|
|
121
153
|
|
|
122
154
|
RacksDB is distributed under the terms of the GNU General Public License v3.0 or
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
Metadata-Version: 2.
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
2
|
Name: RacksDB
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.5.0
|
|
4
4
|
Summary: Modelize your datacenters infrastructures in YAML database
|
|
5
5
|
Author-email: Rémi Palancher <remi@rackslab.io>
|
|
6
6
|
License: GPLv3+
|
|
@@ -20,20 +20,29 @@ License-File: LICENSE
|
|
|
20
20
|
Requires-Dist: PyYAML
|
|
21
21
|
Requires-Dist: ClusterShell
|
|
22
22
|
Requires-Dist: pycairo
|
|
23
|
+
Requires-Dist: PyGObject
|
|
24
|
+
Requires-Dist: RFL.log
|
|
25
|
+
Provides-Extra: dev
|
|
26
|
+
Requires-Dist: Flask-Cors; extra == "dev"
|
|
23
27
|
Provides-Extra: web
|
|
24
28
|
Requires-Dist: Flask; extra == "web"
|
|
25
|
-
Requires-Dist:
|
|
29
|
+
Requires-Dist: requests-toolbelt; extra == "web"
|
|
30
|
+
Provides-Extra: tests
|
|
31
|
+
Requires-Dist: coverage; extra == "tests"
|
|
32
|
+
Requires-Dist: parameterized; extra == "tests"
|
|
33
|
+
Requires-Dist: pytest; extra == "tests"
|
|
34
|
+
Requires-Dist: pytest-cov; extra == "tests"
|
|
35
|
+
Dynamic: license-file
|
|
36
|
+
|
|
37
|
+
# RacksDB
|
|
38
|
+
|
|
39
|
+
## Overview
|
|
26
40
|
|
|
27
41
|
<img
|
|
28
42
|
src="assets/bitmaps/logo_full_white_medium.png"
|
|
29
43
|
alt="RacksDB Overview"
|
|
30
44
|
align="right"
|
|
31
|
-
width="200px"
|
|
32
|
-
style="margin: 20px;">
|
|
33
|
-
|
|
34
|
-
# RacksDB
|
|
35
|
-
|
|
36
|
-
## Overview
|
|
45
|
+
width="200px">
|
|
37
46
|
|
|
38
47
|
**RacksDB** is an _open source_ solution to modelize your datacenters
|
|
39
48
|
infrastructures. It provides a simple database schema to store information about
|
|
@@ -53,9 +62,8 @@ source** for many purposes in IT management.
|
|
|
53
62
|
|
|
54
63
|
<p align="center">
|
|
55
64
|
<img
|
|
56
|
-
src="docs/modules/overview/images/racksdb_overview.
|
|
65
|
+
src="docs/modules/overview/images/racksdb_overview.png"
|
|
57
66
|
alt="RacksDB Overview"
|
|
58
|
-
width="600px"
|
|
59
67
|
style="margin: 0 auto;">
|
|
60
68
|
</p>
|
|
61
69
|
|
|
@@ -81,11 +89,39 @@ solutions are the following:
|
|
|
81
89
|
* **Extensibility.** In addition to RacksDB simple format, custom schema
|
|
82
90
|
extensions can be defined to store specific data.
|
|
83
91
|
|
|
84
|
-
RacksDB provides multiple interfaces
|
|
92
|
+
RacksDB provides multiple interfaces with its
|
|
85
93
|
[CLI tool](https://docs.rackslab.io/racksdb/usage/racksdb.html), a
|
|
86
94
|
[Python library](https://docs.rackslab.io/racksdb/usage/lib.html), a
|
|
87
95
|
[REST API](https://docs.rackslab.io/racksdb/usage/rest.html) and a
|
|
88
|
-
[Web UI](racksdb/
|
|
96
|
+
[Web UI](https://docs.rackslab.io/racksdb/usage/ui.html).
|
|
97
|
+
|
|
98
|
+
<p align="center">
|
|
99
|
+
<img
|
|
100
|
+
src="docs/modules/overview/images/racksdb_interfaces.png"
|
|
101
|
+
alt="RacksDB web UI">
|
|
102
|
+
<p>
|
|
103
|
+
|
|
104
|
+
<p align="center">
|
|
105
|
+
<img
|
|
106
|
+
src="assets/screenshots/assemblies/bitmaps/screenshots-small.webp"
|
|
107
|
+
alt="RacksDB web UI"
|
|
108
|
+
width="600px">
|
|
109
|
+
<p>
|
|
110
|
+
|
|
111
|
+
RacksDB can generate graphical representations of your datacenter rooms and your
|
|
112
|
+
infrastructures with their racks and equipment, including axonometric views for
|
|
113
|
+
3D representations:
|
|
114
|
+
|
|
115
|
+
<p align="center">
|
|
116
|
+
<img
|
|
117
|
+
src="docs/modules/overview/images/racksdb_diagrams.png"
|
|
118
|
+
alt="RacksDB graphical representations"
|
|
119
|
+
width="500px">
|
|
120
|
+
<p>
|
|
121
|
+
|
|
122
|
+
These graphical representations can be generated in various formats (PNG, SVG,
|
|
123
|
+
PDF) and can be customized with many
|
|
124
|
+
[drawing parameters](https://docs.rackslab.io/racksdb/usage/drawparams.html).
|
|
89
125
|
|
|
90
126
|
For more details, read the
|
|
91
127
|
[full description](https://docs.rackslab.io/racksdb/overview/overview.html)
|
|
@@ -115,11 +151,11 @@ are available:
|
|
|
115
151
|
* **Matrix Chat** [#racksdb:talk.rackslab.io](https://matrix.to/#/#racksdb:talk.rackslab.io):
|
|
116
152
|
instant messaging for quick feedback and help.
|
|
117
153
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
154
|
+
> [!NOTE]
|
|
155
|
+
> A [Matrix account](https://matrix.org/docs/chat_basics/matrix-for-im/#creating-a-matrix-account)
|
|
156
|
+
> is required to access the chat room. It can be created in few steps on any
|
|
157
|
+
> Matrix network public provider such as [matrix.org](https://matrix.org) or
|
|
158
|
+
> [gitter.im](https://gitter.im/#apps).
|
|
123
159
|
|
|
124
160
|
* [**GitHub Discussions**](https://github.com/rackslab/RacksDB/discussions):
|
|
125
161
|
send questions, ideas and suggestions.
|
|
@@ -143,6 +179,12 @@ To run the unit tests, launch this command:
|
|
|
143
179
|
$ python3 -m unittest discover -v .
|
|
144
180
|
```
|
|
145
181
|
|
|
182
|
+
Or:
|
|
183
|
+
|
|
184
|
+
```
|
|
185
|
+
$ pytest
|
|
186
|
+
```
|
|
187
|
+
|
|
146
188
|
## License
|
|
147
189
|
|
|
148
190
|
RacksDB is distributed under the terms of the GNU General Public License v3.0 or
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
LICENSE
|
|
2
|
+
README.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
RacksDB.egg-info/PKG-INFO
|
|
5
|
+
RacksDB.egg-info/SOURCES.txt
|
|
6
|
+
RacksDB.egg-info/dependency_links.txt
|
|
7
|
+
RacksDB.egg-info/entry_points.txt
|
|
8
|
+
RacksDB.egg-info/requires.txt
|
|
9
|
+
RacksDB.egg-info/top_level.txt
|
|
10
|
+
racksdb/__init__.py
|
|
11
|
+
racksdb/bases.py
|
|
12
|
+
racksdb/errors.py
|
|
13
|
+
racksdb/exec.py
|
|
14
|
+
racksdb/version.py
|
|
15
|
+
racksdb/views.py
|
|
16
|
+
racksdb/drawers/__init__.py
|
|
17
|
+
racksdb/drawers/axonometric_infrastructure.py
|
|
18
|
+
racksdb/drawers/base.py
|
|
19
|
+
racksdb/drawers/infrastructure.py
|
|
20
|
+
racksdb/drawers/parameters.py
|
|
21
|
+
racksdb/drawers/room.py
|
|
22
|
+
racksdb/drawers/coordinates/__init__.py
|
|
23
|
+
racksdb/drawers/coordinates/base.py
|
|
24
|
+
racksdb/drawers/coordinates/json.py
|
|
25
|
+
racksdb/drawers/coordinates/yaml.py
|
|
26
|
+
racksdb/drawers/dtypes/__init__.py
|
|
27
|
+
racksdb/drawers/dtypes/hexcolor.py
|
|
28
|
+
racksdb/dtypes/__init__.py
|
|
29
|
+
racksdb/dtypes/angle.py
|
|
30
|
+
racksdb/dtypes/bits.py
|
|
31
|
+
racksdb/dtypes/bytes.py
|
|
32
|
+
racksdb/dtypes/dimension.py
|
|
33
|
+
racksdb/dtypes/netif_type.py
|
|
34
|
+
racksdb/dtypes/rack_height.py
|
|
35
|
+
racksdb/dtypes/rack_width.py
|
|
36
|
+
racksdb/dtypes/storage_type.py
|
|
37
|
+
racksdb/dtypes/watts.py
|
|
38
|
+
racksdb/generic/__init__.py
|
|
39
|
+
racksdb/generic/db.py
|
|
40
|
+
racksdb/generic/definedtype.py
|
|
41
|
+
racksdb/generic/errors.py
|
|
42
|
+
racksdb/generic/openapi.py
|
|
43
|
+
racksdb/generic/schema.py
|
|
44
|
+
racksdb/generic/views.py
|
|
45
|
+
racksdb/generic/dumpers/__init__.py
|
|
46
|
+
racksdb/generic/dumpers/_common.py
|
|
47
|
+
racksdb/generic/dumpers/console.py
|
|
48
|
+
racksdb/generic/dumpers/json.py
|
|
49
|
+
racksdb/generic/dumpers/yaml.py
|
|
50
|
+
racksdb/tests/__init__.py
|
|
51
|
+
racksdb/tests/test_defined_type_hexcolor.py
|
|
52
|
+
racksdb/tests/test_defined_type_watts.py
|
|
53
|
+
racksdb/tests/test_exec.py
|
|
54
|
+
racksdb/tests/test_racksdb.py
|
|
55
|
+
racksdb/tests/drawers/__init__.py
|
|
56
|
+
racksdb/tests/drawers/test_axonometric_infrastructure.py
|
|
57
|
+
racksdb/tests/drawers/test_base.py
|
|
58
|
+
racksdb/tests/drawers/test_infrastructure.py
|
|
59
|
+
racksdb/tests/drawers/test_parameters.py
|
|
60
|
+
racksdb/tests/generic/__init__.py
|
|
61
|
+
racksdb/tests/generic/test_db.py
|
|
62
|
+
racksdb/tests/generic/test_db_dict.py
|
|
63
|
+
racksdb/tests/generic/test_db_list.py
|
|
64
|
+
racksdb/tests/generic/test_db_loader.py
|
|
65
|
+
racksdb/tests/generic/test_openapi.py
|
|
66
|
+
racksdb/tests/generic/test_schema.py
|
|
67
|
+
racksdb/tests/generic/test_schema_defined_type_loader.py
|
|
68
|
+
racksdb/tests/generic/test_schema_file_loader.py
|
|
69
|
+
racksdb/tests/generic/test_views.py
|
|
70
|
+
racksdb/tests/generic/dumpers/__init__.py
|
|
71
|
+
racksdb/tests/generic/dumpers/test_dumper_console.py
|
|
72
|
+
racksdb/tests/generic/dumpers/test_dumper_json.py
|
|
73
|
+
racksdb/tests/generic/dumpers/test_dumper_yaml.py
|
|
74
|
+
racksdb/tests/generic/dumpers/test_factory.py
|
|
75
|
+
racksdb/tests/generic/lib/__init__.py
|
|
76
|
+
racksdb/tests/generic/lib/bases.py
|
|
77
|
+
racksdb/tests/generic/lib/common.py
|
|
78
|
+
racksdb/tests/generic/lib/views.py
|
|
79
|
+
racksdb/tests/lib/__init__.py
|
|
80
|
+
racksdb/tests/lib/common.py
|
|
81
|
+
racksdb/tests/lib/reference.py
|
|
82
|
+
racksdb/tests/lib/web.py
|
|
83
|
+
racksdb/tests/web/__init__.py
|
|
84
|
+
racksdb/tests/web/test_app.py
|
|
85
|
+
racksdb/tests/web/test_blueprint.py
|
|
86
|
+
racksdb/web/__init__.py
|
|
87
|
+
racksdb/web/app.py
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "RacksDB"
|
|
7
|
-
version = "0.
|
|
7
|
+
version = "0.5.0"
|
|
8
8
|
description = "Modelize your datacenters infrastructures in YAML database"
|
|
9
9
|
license = {text = "GPLv3+"}
|
|
10
10
|
requires-python = ">=3.6"
|
|
@@ -16,6 +16,8 @@ dependencies = [
|
|
|
16
16
|
"PyYAML",
|
|
17
17
|
"ClusterShell",
|
|
18
18
|
"pycairo",
|
|
19
|
+
"PyGObject",
|
|
20
|
+
"RFL.log",
|
|
19
21
|
]
|
|
20
22
|
readme = "README.md"
|
|
21
23
|
classifiers = [
|
|
@@ -29,9 +31,18 @@ classifiers = [
|
|
|
29
31
|
]
|
|
30
32
|
|
|
31
33
|
[project.optional-dependencies]
|
|
34
|
+
dev = [
|
|
35
|
+
"Flask-Cors",
|
|
36
|
+
]
|
|
32
37
|
web = [
|
|
33
38
|
"Flask",
|
|
34
|
-
"
|
|
39
|
+
"requests-toolbelt",
|
|
40
|
+
]
|
|
41
|
+
tests = [
|
|
42
|
+
"coverage",
|
|
43
|
+
"parameterized",
|
|
44
|
+
"pytest",
|
|
45
|
+
"pytest-cov",
|
|
35
46
|
]
|
|
36
47
|
|
|
37
48
|
[project.scripts]
|
|
@@ -40,24 +51,11 @@ racksdb-web = "racksdb.web.app:RacksDBWebApp.run"
|
|
|
40
51
|
|
|
41
52
|
[tool.setuptools.packages.find]
|
|
42
53
|
include = ["racksdb*"]
|
|
43
|
-
exclude = ["racksdb.web.ui*"]
|
|
44
54
|
|
|
45
55
|
[project.urls]
|
|
46
56
|
"Homepage" = "https://github.com/rackslab/RacksDB"
|
|
47
57
|
"Bug Tracker" = "https://github.com/rackslab/RacksDB/issues"
|
|
48
58
|
|
|
49
|
-
|
|
50
|
-
# especially required for files under UI folder that could be could considered
|
|
51
|
-
# data files even though they are explicitely excluded from packages search
|
|
52
|
-
# paths.
|
|
53
|
-
[tool.setuptools]
|
|
54
|
-
include-package-data = false
|
|
55
|
-
|
|
56
|
-
[tool.black]
|
|
57
|
-
target-version = ['py36']
|
|
58
|
-
color = 1
|
|
59
|
-
|
|
60
|
-
[tool.ruff]
|
|
59
|
+
[tool.ruff.lint]
|
|
61
60
|
# Enable pycodestyle (`E`) and Pyflakes (`F`) codes by default.
|
|
62
61
|
select = ["E", "F"]
|
|
63
|
-
target-version = "py37"
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Copyright (c) 2022-2023 Rackslab
|
|
2
|
+
#
|
|
3
|
+
# This file is part of RacksDB.
|
|
4
|
+
#
|
|
5
|
+
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
6
|
+
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
import typing as t
|
|
9
|
+
|
|
10
|
+
from .generic.schema import Schema, SchemaFileLoader, SchemaDefinedTypeLoader
|
|
11
|
+
from .generic.db import GenericDB, DBDict, DBList, DBSplittedFilesLoader
|
|
12
|
+
from .generic.errors import DBSchemaError, DBFormatError
|
|
13
|
+
from .errors import (
|
|
14
|
+
RacksDBFormatError,
|
|
15
|
+
RacksDBSchemaError,
|
|
16
|
+
RacksDBRequestError,
|
|
17
|
+
RacksDBNotFoundError,
|
|
18
|
+
)
|
|
19
|
+
from . import bases
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
class RacksDB(GenericDB):
|
|
23
|
+
DEFAULT_DB = "/var/lib/racksdb"
|
|
24
|
+
DEFAULT_SCHEMA = "/usr/share/racksdb/schemas/racksdb.yml"
|
|
25
|
+
DEFAULT_EXT = "/etc/racksdb/extensions.yml"
|
|
26
|
+
DEFAULT_UI = "/usr/share/racksdb/frontend"
|
|
27
|
+
PREFIX = "RacksDB"
|
|
28
|
+
DEFINED_TYPES_MODULE = "racksdb.dtypes"
|
|
29
|
+
|
|
30
|
+
def __init__(self, schema, loader):
|
|
31
|
+
super().__init__(self.PREFIX, schema, bases)
|
|
32
|
+
self._loader = loader
|
|
33
|
+
|
|
34
|
+
@property
|
|
35
|
+
def nodes(self):
|
|
36
|
+
result = DBDict()
|
|
37
|
+
for infrastructure in self.infrastructures:
|
|
38
|
+
result.update(infrastructure.nodes)
|
|
39
|
+
return result
|
|
40
|
+
|
|
41
|
+
@property
|
|
42
|
+
def racks(self):
|
|
43
|
+
result = DBList()
|
|
44
|
+
for datacenter in self.datacenters:
|
|
45
|
+
for room in datacenter.rooms:
|
|
46
|
+
for row in room.rows:
|
|
47
|
+
for rack in row.racks:
|
|
48
|
+
result.append(rack)
|
|
49
|
+
return result
|
|
50
|
+
|
|
51
|
+
def tags(
|
|
52
|
+
self,
|
|
53
|
+
node: t.Optional[str] = None,
|
|
54
|
+
infrastructure: t.Optional[str] = None,
|
|
55
|
+
datacenter: t.Optional[str] = None,
|
|
56
|
+
on_nodes: bool = False,
|
|
57
|
+
on_racks: bool = False,
|
|
58
|
+
) -> DBList:
|
|
59
|
+
if not node and not infrastructure and not datacenter:
|
|
60
|
+
raise RacksDBRequestError(
|
|
61
|
+
"Either node, infrastructure or datacenter parameter must be defined "
|
|
62
|
+
"to retrieve tags"
|
|
63
|
+
)
|
|
64
|
+
|
|
65
|
+
if node:
|
|
66
|
+
nodes = self.nodes.filter(name=node)
|
|
67
|
+
if node not in nodes:
|
|
68
|
+
raise RacksDBNotFoundError(f"Unable to find node {node}")
|
|
69
|
+
return nodes[node].tags
|
|
70
|
+
elif infrastructure:
|
|
71
|
+
if infrastructure not in self.infrastructures:
|
|
72
|
+
raise RacksDBNotFoundError(
|
|
73
|
+
f"Unable to find infrastructure {infrastructure}"
|
|
74
|
+
)
|
|
75
|
+
if on_nodes:
|
|
76
|
+
return self.infrastructures[infrastructure].nodes_tags
|
|
77
|
+
else:
|
|
78
|
+
return getattr(self.infrastructures[infrastructure], "tags", [])
|
|
79
|
+
elif datacenter:
|
|
80
|
+
if datacenter not in self.datacenters:
|
|
81
|
+
raise RacksDBNotFoundError(f"Unable to find datacenter {datacenter}")
|
|
82
|
+
if on_racks:
|
|
83
|
+
return self.datacenters[datacenter].racks_tags
|
|
84
|
+
else:
|
|
85
|
+
return self.datacenters[datacenter].tags
|
|
86
|
+
|
|
87
|
+
@classmethod
|
|
88
|
+
def load(
|
|
89
|
+
cls,
|
|
90
|
+
schema: t.Union[str, Path, None] = None,
|
|
91
|
+
ext: t.Union[str, Path, None] = None,
|
|
92
|
+
db: t.Union[str, Path, None] = None,
|
|
93
|
+
):
|
|
94
|
+
# Unfortunately, default values to arguments cannot be used as they are
|
|
95
|
+
# class attributes and the class is not defined yet at this stage at
|
|
96
|
+
# compilation time. As an alternative, the value None is checked at
|
|
97
|
+
# runtime and replaced by values of class attributes.
|
|
98
|
+
|
|
99
|
+
if schema is None:
|
|
100
|
+
schema = Path(cls.DEFAULT_SCHEMA)
|
|
101
|
+
elif isinstance(schema, str):
|
|
102
|
+
schema = Path(schema)
|
|
103
|
+
if ext is None:
|
|
104
|
+
ext = Path(cls.DEFAULT_EXT)
|
|
105
|
+
elif isinstance(ext, str):
|
|
106
|
+
ext = Path(ext)
|
|
107
|
+
if db is None:
|
|
108
|
+
db = Path(cls.DEFAULT_DB)
|
|
109
|
+
elif isinstance(db, str):
|
|
110
|
+
db = Path(db)
|
|
111
|
+
try:
|
|
112
|
+
_schema = Schema(
|
|
113
|
+
SchemaFileLoader(schema, ext),
|
|
114
|
+
SchemaDefinedTypeLoader(cls.DEFINED_TYPES_MODULE),
|
|
115
|
+
)
|
|
116
|
+
except DBSchemaError as err:
|
|
117
|
+
raise RacksDBSchemaError(str(err)) from err
|
|
118
|
+
try:
|
|
119
|
+
_db = cls(_schema, DBSplittedFilesLoader(db))
|
|
120
|
+
super(cls, _db).load(_db._loader)
|
|
121
|
+
except DBFormatError as err:
|
|
122
|
+
raise RacksDBFormatError(str(err)) from err
|
|
123
|
+
return _db
|