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.
Files changed (100) hide show
  1. {RacksDB-0.3.0 → racksdb-0.5.0}/PKG-INFO +60 -18
  2. {RacksDB-0.3.0 → racksdb-0.5.0}/README.md +47 -15
  3. {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/PKG-INFO +60 -18
  4. racksdb-0.5.0/RacksDB.egg-info/SOURCES.txt +87 -0
  5. racksdb-0.5.0/RacksDB.egg-info/requires.txt +18 -0
  6. {RacksDB-0.3.0 → racksdb-0.5.0}/pyproject.toml +14 -16
  7. racksdb-0.5.0/racksdb/__init__.py +123 -0
  8. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/bases.py +75 -10
  9. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/__init__.py +2 -1
  10. racksdb-0.5.0/racksdb/drawers/axonometric_infrastructure.py +603 -0
  11. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/base.py +74 -9
  12. racksdb-0.5.0/racksdb/drawers/coordinates/__init__.py +17 -0
  13. racksdb-0.5.0/racksdb/drawers/coordinates/base.py +10 -0
  14. racksdb-0.5.0/racksdb/drawers/coordinates/json.py +19 -0
  15. racksdb-0.5.0/racksdb/drawers/coordinates/yaml.py +19 -0
  16. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/dtypes/hexcolor.py +5 -3
  17. racksdb-0.5.0/racksdb/drawers/infrastructure.py +613 -0
  18. racksdb-0.5.0/racksdb/drawers/room.py +237 -0
  19. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/angle.py +0 -1
  20. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/bits.py +3 -4
  21. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/bytes.py +3 -4
  22. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/dimension.py +0 -1
  23. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/netif_type.py +0 -1
  24. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/rack_height.py +0 -1
  25. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/rack_width.py +0 -1
  26. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/storage_type.py +0 -1
  27. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/dtypes/watts.py +2 -3
  28. racksdb-0.5.0/racksdb/errors.py +32 -0
  29. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/exec.py +78 -23
  30. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/db.py +85 -38
  31. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/json.py +4 -18
  32. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/yaml.py +8 -25
  33. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/openapi.py +98 -43
  34. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/schema.py +8 -3
  35. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/views.py +59 -16
  36. racksdb-0.5.0/racksdb/tests/drawers/__init__.py +0 -0
  37. racksdb-0.5.0/racksdb/tests/drawers/test_axonometric_infrastructure.py +84 -0
  38. RacksDB-0.3.0/racksdb/tests/test_drawer.py → racksdb-0.5.0/racksdb/tests/drawers/test_base.py +31 -34
  39. racksdb-0.5.0/racksdb/tests/drawers/test_infrastructure.py +158 -0
  40. racksdb-0.5.0/racksdb/tests/drawers/test_parameters.py +53 -0
  41. racksdb-0.5.0/racksdb/tests/generic/__init__.py +0 -0
  42. racksdb-0.5.0/racksdb/tests/generic/dumpers/__init__.py +0 -0
  43. racksdb-0.5.0/racksdb/tests/generic/dumpers/test_dumper_console.py +49 -0
  44. racksdb-0.5.0/racksdb/tests/generic/dumpers/test_dumper_json.py +55 -0
  45. racksdb-0.5.0/racksdb/tests/generic/dumpers/test_dumper_yaml.py +74 -0
  46. racksdb-0.5.0/racksdb/tests/generic/dumpers/test_factory.py +35 -0
  47. racksdb-0.5.0/racksdb/tests/generic/lib/__init__.py +0 -0
  48. racksdb-0.5.0/racksdb/tests/generic/lib/bases.py +19 -0
  49. racksdb-0.5.0/racksdb/tests/generic/lib/common.py +185 -0
  50. racksdb-0.5.0/racksdb/tests/generic/lib/views.py +85 -0
  51. racksdb-0.5.0/racksdb/tests/generic/test_db.py +132 -0
  52. racksdb-0.5.0/racksdb/tests/generic/test_db_dict.py +85 -0
  53. racksdb-0.5.0/racksdb/tests/generic/test_db_list.py +39 -0
  54. racksdb-0.5.0/racksdb/tests/generic/test_db_loader.py +137 -0
  55. racksdb-0.5.0/racksdb/tests/generic/test_openapi.py +20 -0
  56. {RacksDB-0.3.0/racksdb/tests → racksdb-0.5.0/racksdb/tests/generic}/test_schema.py +66 -95
  57. racksdb-0.5.0/racksdb/tests/generic/test_schema_file_loader.py +47 -0
  58. racksdb-0.5.0/racksdb/tests/generic/test_views.py +40 -0
  59. racksdb-0.5.0/racksdb/tests/lib/__init__.py +0 -0
  60. racksdb-0.5.0/racksdb/tests/lib/common.py +66 -0
  61. racksdb-0.5.0/racksdb/tests/lib/reference.py +75 -0
  62. racksdb-0.5.0/racksdb/tests/lib/web.py +24 -0
  63. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/tests/test_defined_type_hexcolor.py +4 -2
  64. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/tests/test_defined_type_watts.py +2 -2
  65. racksdb-0.5.0/racksdb/tests/test_exec.py +668 -0
  66. racksdb-0.5.0/racksdb/tests/test_racksdb.py +161 -0
  67. racksdb-0.5.0/racksdb/tests/web/__init__.py +0 -0
  68. racksdb-0.5.0/racksdb/tests/web/test_app.py +155 -0
  69. racksdb-0.5.0/racksdb/tests/web/test_blueprint.py +940 -0
  70. racksdb-0.5.0/racksdb/version.py +15 -0
  71. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/views.py +85 -7
  72. racksdb-0.5.0/racksdb/web/__init__.py +0 -0
  73. racksdb-0.5.0/racksdb/web/app.py +449 -0
  74. RacksDB-0.3.0/RacksDB.egg-info/SOURCES.txt +0 -54
  75. RacksDB-0.3.0/RacksDB.egg-info/requires.txt +0 -7
  76. RacksDB-0.3.0/racksdb/__init__.py +0 -74
  77. RacksDB-0.3.0/racksdb/drawers/infrastructure.py +0 -282
  78. RacksDB-0.3.0/racksdb/drawers/room.py +0 -163
  79. RacksDB-0.3.0/racksdb/errors.py +0 -9
  80. RacksDB-0.3.0/racksdb/tests/tests_db_load.py +0 -82
  81. RacksDB-0.3.0/racksdb/version.py +0 -11
  82. RacksDB-0.3.0/racksdb/web/app.py +0 -248
  83. RacksDB-0.3.0/racksdb/web/ui/node_modules/flatted/python/flatted.py +0 -149
  84. RacksDB-0.3.0/racksdb/web/ui/node_modules/flatted/python/test.py +0 -63
  85. {RacksDB-0.3.0 → racksdb-0.5.0}/LICENSE +0 -0
  86. {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/dependency_links.txt +0 -0
  87. {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/entry_points.txt +0 -0
  88. {RacksDB-0.3.0 → racksdb-0.5.0}/RacksDB.egg-info/top_level.txt +0 -0
  89. {RacksDB-0.3.0/racksdb → racksdb-0.5.0/racksdb/drawers}/dtypes/__init__.py +0 -0
  90. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/drawers/parameters.py +0 -0
  91. {RacksDB-0.3.0/racksdb/generic → racksdb-0.5.0/racksdb/dtypes}/__init__.py +0 -0
  92. {RacksDB-0.3.0/racksdb/tests → racksdb-0.5.0/racksdb/generic}/__init__.py +0 -0
  93. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/definedtype.py +0 -0
  94. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/__init__.py +0 -0
  95. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/_common.py +0 -0
  96. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/dumpers/console.py +0 -0
  97. {RacksDB-0.3.0 → racksdb-0.5.0}/racksdb/generic/errors.py +0 -0
  98. {RacksDB-0.3.0/racksdb/web → racksdb-0.5.0/racksdb/tests}/__init__.py +0 -0
  99. {RacksDB-0.3.0/racksdb/tests → racksdb-0.5.0/racksdb/tests/generic}/test_schema_defined_type_loader.py +0 -0
  100. {RacksDB-0.3.0 → racksdb-0.5.0}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
- Metadata-Version: 2.1
1
+ Metadata-Version: 2.4
2
2
  Name: RacksDB
3
- Version: 0.3.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: Flask-Cors; extra == "web"
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.svg"
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 to request the database with its
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/web/ui/README.md) (in _beta_).
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
- > [!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).
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.svg"
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 to request the database with its
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/web/ui/README.md) (in _beta_).
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
- > [!NOTE]
93
- > A [Matrix account](https://matrix.org/docs/chat_basics/matrix-for-im/#creating-a-matrix-account)
94
- > is required to access the chat room. It can be created in few steps on any
95
- > Matrix network public provider such as [matrix.org](https://matrix.org) or
96
- > [gitter.im](https://gitter.im/#apps).
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
1
+ Metadata-Version: 2.4
2
2
  Name: RacksDB
3
- Version: 0.3.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: Flask-Cors; extra == "web"
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.svg"
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 to request the database with its
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/web/ui/README.md) (in _beta_).
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
- > [!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).
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
@@ -0,0 +1,18 @@
1
+ PyYAML
2
+ ClusterShell
3
+ pycairo
4
+ PyGObject
5
+ RFL.log
6
+
7
+ [dev]
8
+ Flask-Cors
9
+
10
+ [tests]
11
+ coverage
12
+ parameterized
13
+ pytest
14
+ pytest-cov
15
+
16
+ [web]
17
+ Flask
18
+ requests-toolbelt
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "RacksDB"
7
- version = "0.3.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
- "Flask-Cors",
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
- # Do not automatically install all files in package tree as data files. This is
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