qlsdk2 0.4.1__py3-none-any.whl → 0.5.0__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.
qlsdk/rsc/parser/base.py CHANGED
@@ -1,3 +1,6 @@
1
+ from io import BytesIO
2
+ from multiprocessing import Lock
3
+ import time
1
4
  from qlsdk.rsc.interface import IDevice, IParser
2
5
 
3
6
  from loguru import logger
@@ -11,7 +14,13 @@ class TcpMessageParser(IParser):
11
14
  self.device = device
12
15
  self.running = False
13
16
 
14
- self.cache = b''
17
+ # 网络实时数据缓存,选用BytesIO
18
+ # 临时缓冲区-用于接收数据
19
+ self.cache = BytesIO()
20
+ # 缓冲区-用于处理数据
21
+ self.buffer = BytesIO()
22
+ # 读写锁-用于临时缓冲区(避免读写冲突)
23
+ self._lock = Lock()
15
24
 
16
25
  @property
17
26
  def header(self):
@@ -24,43 +33,118 @@ class TcpMessageParser(IParser):
24
33
  @property
25
34
  def cmd_pos(self):
26
35
  return 12
36
+
37
+ def set_device(self, device):
38
+ self.device = device
27
39
 
28
- def append(self, buffer):
29
- self.cache += buffer
30
- logger.debug(f"已缓存的数据长度: {len(self.cache)}")
40
+ def append(self, value):
41
+ # self.cache.write(buffer)
42
+ with self._lock:
43
+ self.cache.write(value)
31
44
 
32
45
  def __parser__(self):
33
- logger.info("数据解析开始")
46
+ logger.trace("数据解析开始")
47
+
48
+ # 告警阈值(10M)
49
+ warn_len = 10 * 1024 * 1024
50
+
34
51
  while self.running:
35
- if len(self.cache) < 14:
36
- continue
37
- if self.cache[0] != 0x5A or self.cache[1] != 0xA5:
38
- self.cache = self.cache[1:]
39
- continue
40
- pkg_len = int.from_bytes(self.cache[8:12], 'little')
41
- logger.trace(f" cache len: {len(self.cache)}, pkg_len len: {len(self.cache)}")
42
- # 一次取整包数据
43
- if len(self.cache) < pkg_len:
52
+ buf_len = get_len(self.buffer)
53
+
54
+ # logger.info(f"当前操作区缓存长度: {buf_len}, 缓存内容: {self.buffer.getvalue().hex()}")
55
+ if buf_len < self.header_len:
56
+ # logger.trace(f"操作区缓存数据不足: {len}, 等待数据...")
57
+ if not self.__fill_from_cache():
58
+ time.sleep(0.05)
59
+ continue
60
+
61
+ if buf_len > warn_len:
62
+ logger.warning(f"操作区缓存数据过大: {buf_len} bytes, 可能存在数据丢失风险")
63
+
64
+ start_pos = self.buffer.tell()
65
+ # logger.info(f"当前缓存位置: {start_pos}")
66
+ head = self.buffer.read(2)
67
+ # logger.info(f'当前缓存头部: {head.hex()}')
68
+ if head != self.header:
69
+ logger.debug(f"数据包头部不匹配: {head.hex()}, 期望: {self.header.hex()},继续查找...")
70
+ self.buffer.seek(start_pos + 1) # 移动到下一个字节
44
71
  continue
45
- pkg = self.cache[:pkg_len]
46
- self.cache = self.cache[pkg_len:]
72
+
73
+ # 移动下标(指向包长度的位置)
74
+ self.buffer.seek(start_pos + 8)
75
+ # 包总长度
76
+ pkg_len = int.from_bytes(self.buffer.read(4), 'little')
77
+ # logger.trace(f" cache len: {len(self.cache)}, pkg_len len: {len(self.cache)}")
78
+
79
+ buf_len = get_len(self.buffer)
80
+ # 直接等待长度足够(如果从头开始判断,因为逻辑相同,所以会执行一样的操作)
81
+ while buf_len < pkg_len:
82
+ if self.__fill_from_cache():
83
+ continue
84
+ else:
85
+ time.sleep(0.05)
86
+
87
+ # 读取剩余数据
88
+ self.buffer.seek(pkg_len)
89
+ tmp = self.buffer.read()
90
+
91
+ # 读取当前数据包
92
+ self.buffer.seek(start_pos)
93
+ pkg = self.buffer.read(pkg_len)
94
+
95
+ # 清空操作区缓存(truncate会保留内存,重新初始化)
96
+ self.buffer = BytesIO()
97
+ if len(tmp) > 0:
98
+ self.buffer.write(tmp)
99
+ self.buffer.seek(0)
100
+
47
101
  self.unpack(pkg)
48
102
 
103
+ # 填充操作区缓存
104
+ def __fill_from_cache(self) -> bool:
105
+ result = False
106
+
107
+ cur_pos = self.buffer.tell()
108
+ # 移动到操作区缓存末尾,内容追加到缓冲区尾部
109
+ self.buffer.seek(0,2)
110
+ # 操作缓冲区
111
+ with self._lock:
112
+ self.cache.seek(0, 2)
113
+
114
+ # 临时缓冲区只要有数据,就写入操作缓冲区(避免分片传输导致数据不完整)
115
+ if self.cache.tell() > 0:
116
+ self.buffer.write(self.cache.getvalue())
117
+ self.cache = BytesIO() # 清空缓冲区
118
+ result = True
119
+
120
+ self.buffer.seek(cur_pos) # 恢复到原位置
121
+
122
+ return result
123
+
49
124
  def unpack(self, packet):
50
125
  # 提取指令码
51
126
  cmd_code = int.from_bytes(packet[self.cmd_pos : self.cmd_pos + 2], 'little')
52
127
  cmd_class = CommandFactory.create_command(cmd_code)
53
- logger.debug(f"收到指令:{cmd_class.cmd_desc}[{hex(cmd_code)}]")
128
+ # logger.trace(f"收到指令:{cmd_class.cmd_desc}[{hex(cmd_code)}]")
54
129
  instance = cmd_class(self.device)
55
130
  start = time_ns()
56
- logger.debug(f"开始解析: {start}")
131
+ # logger.trace(f"开始解析: {start}")
57
132
  instance.parse_body(packet[self.header_len:-2])
58
- logger.debug(f"解析完成:{time_ns()}, 解析耗时:{time_ns() - start}ns")
133
+ # logger.trace(f"解析完成:{time_ns()}, 解析耗时:{time_ns() - start}ns")
59
134
  return instance
60
135
 
61
136
  def start(self):
62
137
  self.running = True
63
- parser = Thread(target=self.__parser__,)
64
- parser.daemon = True
138
+ parser = Thread(target=self.__parser__, daemon=True)
65
139
  parser.start()
66
-
140
+
141
+ # 工具方法
142
+ def get_len(buf: BytesIO) -> int:
143
+ if buf is None:
144
+ return 0
145
+ cur_pos = buf.tell()
146
+ buf.seek(0, 2) # 移动到操作区缓存末尾
147
+ len = buf.tell()
148
+ buf.seek(cur_pos) # 恢复到原位置
149
+ return len
150
+
@@ -0,0 +1,40 @@
1
+ Metadata-Version: 2.2
2
+ Name: qlsdk2
3
+ Version: 0.5.0
4
+ Summary: SDK for quanlan device
5
+ Home-page: https://github.com/hehuajun/qlsdk
6
+ Author: hehuajun
7
+ Author-email: hehuajun@eegion.com
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: License :: OSI Approved :: MIT License
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.9
12
+ Description-Content-Type: text/markdown
13
+ Requires-Dist: loguru>=0.6.0
14
+ Requires-Dist: numpy>=1.23.5
15
+ Requires-Dist: bitarray>=1.5.3
16
+ Provides-Extra: dev
17
+ Requires-Dist: pytest>=6.0; extra == "dev"
18
+ Requires-Dist: twine>=3.0; extra == "dev"
19
+ Dynamic: author
20
+ Dynamic: author-email
21
+ Dynamic: classifier
22
+ Dynamic: description
23
+ Dynamic: description-content-type
24
+ Dynamic: home-page
25
+ Dynamic: requires-dist
26
+ Dynamic: requires-python
27
+ Dynamic: summary
28
+
29
+ 版本:v0.5.0
30
+ 时间:2025-07-29
31
+ [新特性]
32
+ 1. C16R设备搜索
33
+ 2、C16R设备连接
34
+ 3、C16R信号采集/停止
35
+ 4、C16R数据自动记录到文件
36
+ 5、C16R采集通道设置支持数字和名称两种模式(可混用)
37
+
38
+ [优化]
39
+ 1、提升信号接收及指令解析性能
40
+ 2、日志级别及文案优化
@@ -5,10 +5,10 @@ qlsdk/core/__init__.py,sha256=WMjvdiSD3BWAsebktWJU3dt71wOML44xe_EAZ5WJZQY,159
5
5
  qlsdk/core/device.py,sha256=p0XQ2otFaFnJW7ZQ9VtHeVF1EQGB73cKjWDkORZHesM,798
6
6
  qlsdk/core/exception.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
7
7
  qlsdk/core/local.py,sha256=vbison4XZtS4SNYLJ9CqBhetEcukdviTWmvtdA1efkQ,811
8
- qlsdk/core/utils.py,sha256=Dcpor6CGjkIhaZbUzVGFQMdCY54PDJ_etdZ68WD1q8g,4071
8
+ qlsdk/core/utils.py,sha256=yfCiLpufO96I68MLs6Drc6IECRjcQ-If8sXn7RaRHrk,4241
9
9
  qlsdk/core/crc/__init__.py,sha256=kaYSr6KN5g4U49xlxAvT2lnEeGtwX4Dz1ArwKDvUIIY,143
10
10
  qlsdk/core/crc/crctools.py,sha256=sDeE6CMccQX2cRAyMQK0SZUk1fa50XMuwqXau5UX5C8,4242
11
- qlsdk/core/entity/__init__.py,sha256=THJpYIO-rDfK_UMU6qgraIKft7KfRZ_1dcBQliLT6AM,3291
11
+ qlsdk/core/entity/__init__.py,sha256=OHedug2XusjSuxQ479bcX5IVq35FTFWEfYriFT3rEzY,3339
12
12
  qlsdk/core/filter/__init__.py,sha256=YIWIzDUKN30mq2JTr53ZGblggZfC_rLUp2FSRrsQFgU,36
13
13
  qlsdk/core/filter/norch.py,sha256=5RdIBX5eqs5w5nmVAnCB3ESSuAT_vVBZ2g-dg6HMZdY,1858
14
14
  qlsdk/core/message/__init__.py,sha256=sHuavOyHf4bhH6VdDpTA1EsCh7Q-XsPHcFiItpVz3Rs,51
@@ -17,9 +17,11 @@ qlsdk/core/message/tcp.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
17
17
  qlsdk/core/message/udp.py,sha256=KS_pKZcCEFhNGABCOZTOHiVFkfPNZl_0K5RXppwMIvA,3085
18
18
  qlsdk/core/network/__init__.py,sha256=9Ww0cGgBEU_TVrwmgiDz20zA2fMFgepI_kOF4ggHcS0,1111
19
19
  qlsdk/core/network/monitor.py,sha256=QqjjPwSr1kgqDTTySp5bpalZmsBQTaAWSxrfPLdROZo,1810
20
- qlsdk/persist/__init__.py,sha256=OR8mnPTsktxw67G-z0VsPWJXInkKircMTHQdibmmz3M,63
20
+ qlsdk/persist/__init__.py,sha256=b8qk1aOU6snEMCQNYDl1ijV3-2gwBmMt76fiAzNk1E8,107
21
+ qlsdk/persist/ars_edf.py,sha256=_pYtHqucB-utMw-xUXZc9IB8_8ThbLFpTl_-WBQR-Sc,10555
21
22
  qlsdk/persist/edf.py,sha256=ETngb86CfkIUJYWmw86QR445MvTFC7Edk_CH9nyNgtY,7857
22
- qlsdk/persist/rsc_edf.py,sha256=s1zQBml8o0vdOrzMRrApxelWscmYpbisXanB4z-gvcQ,11675
23
+ qlsdk/persist/rsc_edf.py,sha256=wV3akdwzEihDAyR9DtmO0jNdLH1jEvx34ghJQtrfk2k,12578
24
+ qlsdk/persist/stream.py,sha256=TCVF1sqDrHiYBsJC27At66AaCs-_blXeXA_WXdJiIVA,5828
23
25
  qlsdk/rsc/__init__.py,sha256=hOMiN0eYn4jYo7O4_0IPlQT0hD15SqqCQUihOVlTZvs,269
24
26
  qlsdk/rsc/device_manager.py,sha256=1ucd-lzHkNeQPKPzXV6OBkAMqPp_vOcsLyS-9TJ7wRc,4448
25
27
  qlsdk/rsc/discover.py,sha256=ONXN6YWY-OMU0sBoLqqKUyb-8drtAp1g_MvnpzaFvHQ,3124
@@ -27,24 +29,28 @@ qlsdk/rsc/eegion.py,sha256=lxrktO-3Z_MYdFIwc4NxvgLM5AL5kU3UItjH6tsKmHY,11670
27
29
  qlsdk/rsc/entity.py,sha256=-fRWFkVWp9d8Y1uh6GiacXC5scdeEKNiNFf3aziGdCE,17751
28
30
  qlsdk/rsc/paradigm.py,sha256=DGfwY36sMdPIMRjbGo661GvUTEwsRRi3jrmG405mSTk,12840
29
31
  qlsdk/rsc/proxy.py,sha256=9CPdGNGWremwBUh4GvlXAykYB-x_BEPPLqsNvwuwIDE,2736
30
- qlsdk/rsc/command/__init__.py,sha256=j_yAg61dgyP3FHR21bVSpObiwPYf23MVGzj_0Mbyx6c,12248
32
+ qlsdk/rsc/command/__init__.py,sha256=FpumdCRV3aSnCvLT7MceMb7lF8WgGbdi_w0L8wX7ryg,12137
31
33
  qlsdk/rsc/command/message.py,sha256=nTdG-Vp4MBnltyrgedAWiKD6kzOaPrg58Z_hq6yjhys,12220
32
- qlsdk/rsc/device/__init__.py,sha256=5tNSYmpl_jfaHZcOMyB2IcO-tzL-Pj5f3V8CRC8uLHc,73
33
- qlsdk/rsc/device/base.py,sha256=c9jhDH89BNPWVSitPmtLdMRN5dCZUyQjH3jAKYNxMLo,14823
34
- qlsdk/rsc/device/c64_rs.py,sha256=iZDXMjYHOPmlrx3gkxEx18dihXqj81DfkUmtniHljck,13920
35
- qlsdk/rsc/device/device_factory.py,sha256=h4kfSLngu10ME60JOHjkxWbCVMEqBdPRo4_3g2yZZbw,1137
34
+ qlsdk/rsc/device/__init__.py,sha256=xtTXLT9QFKtb-qS-A8-ewSxJ3zXgImFCX0OoAPw6hHE,185
35
+ qlsdk/rsc/device/arskindling.py,sha256=owci6MEGjyWqohEXzPdKj_ESeVIZKgO53StVj6Tmi18,15002
36
+ qlsdk/rsc/device/base.py,sha256=6cMaACVVgZ7oKdqbyVRl3B32M9Em6_jjr-FUuxRW6Ys,17404
37
+ qlsdk/rsc/device/c16_rs.py,sha256=IpJn4hBFHg67lvWkl8kAAztdZYsgi2-njFuxMi2SsHQ,6390
38
+ qlsdk/rsc/device/c256_rs.py,sha256=K1XmLqZpvHTAfCm_dr2VsGxHc67aJQVDV1cI41a1WTI,13955
39
+ qlsdk/rsc/device/c64_rs.py,sha256=cZIioIRGgd4Ub0ieho4_XujBNo8AQgJEjXcqgcEkyFQ,13644
40
+ qlsdk/rsc/device/c64s1.py,sha256=L7nKmsoMCGj6GMjHYfYkKgkBtrGfP516kQHQ5I1FAUE,13986
41
+ qlsdk/rsc/device/device_factory.py,sha256=P8nNDB2qk0kbu4OMYtEZMKSdXWp-7fLDzuNyR1Thf8Q,1315
36
42
  qlsdk/rsc/interface/__init__.py,sha256=xeRzIlQSB7ZSf4r5kLfH5cDQLzCyWeJAReG8Xq5nOE0,70
37
43
  qlsdk/rsc/interface/command.py,sha256=1s5Lxb_ejsd-JNvKMqU2aFSnOoW-_cx01VSD3czxmQI,199
38
- qlsdk/rsc/interface/device.py,sha256=mn3YvOgpymWvfBr8Lqj0WZm74DIhWi9A7v1P27erC-0,2940
44
+ qlsdk/rsc/interface/device.py,sha256=apBQAeu1g0Qmw73qQqr6uG1re9qCep6oKfjWKlGJdp4,3092
39
45
  qlsdk/rsc/interface/handler.py,sha256=ADDe_a2RAxGMuooLyivH0JBPTGBcFP2JaTVX41R1A4w,198
40
- qlsdk/rsc/interface/parser.py,sha256=uNl0E-T4TIq2iHFjV1oeRDUKN4GX0q2GXUxzrio1240,196
46
+ qlsdk/rsc/interface/parser.py,sha256=DxuFZiprJJbG4pfFbbZPaG8MlBiBRe0S0lJrvc2Iees,251
41
47
  qlsdk/rsc/manager/__init__.py,sha256=4ljT3mR8YPBDQur46B5xPqK5tjLKlsWfgCJVuA0gs-8,40
42
- qlsdk/rsc/manager/container.py,sha256=Bx7W0p3oCEjxVOjHgW42wsWHeRt-O9gs7-Bq4PiTQ-M,4582
48
+ qlsdk/rsc/manager/container.py,sha256=N9QB85FOA_7Oa_8M1y1M2UODA_tpS9JQONhGj8ObBG8,4811
43
49
  qlsdk/rsc/manager/search.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
44
50
  qlsdk/rsc/network/__init__.py,sha256=PfYiqXS2pZV__uegQ1TjaeYhY1pefZ_shwE_X5HNVbs,23
45
- qlsdk/rsc/network/discover.py,sha256=ONXN6YWY-OMU0sBoLqqKUyb-8drtAp1g_MvnpzaFvHQ,3124
51
+ qlsdk/rsc/network/discover.py,sha256=4aojzRFInTC3d8K2TYGbnP1Ji5fOFEi31ekghj7ce5k,2977
46
52
  qlsdk/rsc/parser/__init__.py,sha256=8RgwbKCINu3eTsxVLF9cMoBXJnVrDocOEFP6NGP_atk,34
47
- qlsdk/rsc/parser/base.py,sha256=6t0StSsx87s7bQq_av9a7ieROZ0LEDhtUHixKoiwcto,2209
53
+ qlsdk/rsc/parser/base.py,sha256=s6tkWQXoMq8ZA4Nns_aG1JS5PV3UXLMFarTZiCoPagM,5504
48
54
  qlsdk/sdk/__init__.py,sha256=v9LKP-5qXCqnAsCkiRE9LDb5Tagvl_Qd_fqrw7y9yd4,68
49
55
  qlsdk/sdk/ar4sdk.py,sha256=tugH3UUeNebdka78AzLyrtAXbYQQE3iFJ227zUit6tY,27261
50
56
  qlsdk/sdk/hub.py,sha256=uEOGZBZtMDCWlV8G2TZe6FAo6eTPcwHAW8zdqr1eq_0,1571
@@ -52,7 +58,7 @@ qlsdk/sdk/libs/libAr4SDK.dll,sha256=kZp9_DRwPdAJ5OgTFQSqS8tEETxUs7YmmETuBP2g60U,
52
58
  qlsdk/sdk/libs/libwinpthread-1.dll,sha256=W77ySaDQDi0yxpnQu-ifcU6-uHKzmQpcvsyx2J9j5eg,52224
53
59
  qlsdk/x8/__init__.py,sha256=FDpDK7GAYL-g3vzfU9U_V03QzoYoxH9YLm93PjMlANg,4870
54
60
  qlsdk/x8m/__init__.py,sha256=cLeUqEEj65qXw4Qa4REyxoLh6T24anSqPaKe9_lR340,634
55
- qlsdk2-0.4.1.dist-info/METADATA,sha256=yrxJIVqc4nl2o1iAa0DPaHnQKFtMuOC_1MK6uq8bR7E,7063
56
- qlsdk2-0.4.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
57
- qlsdk2-0.4.1.dist-info/top_level.txt,sha256=2CHzn0SY-NIBVyBl07Suh-Eo8oBAQfyNPtqQ_aDatBg,6
58
- qlsdk2-0.4.1.dist-info/RECORD,,
61
+ qlsdk2-0.5.0.dist-info/METADATA,sha256=Lp7nByzF1dCM1LGXQxyKv8sc-vkTDuLjZtw9nu_JFBk,1134
62
+ qlsdk2-0.5.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
63
+ qlsdk2-0.5.0.dist-info/top_level.txt,sha256=2CHzn0SY-NIBVyBl07Suh-Eo8oBAQfyNPtqQ_aDatBg,6
64
+ qlsdk2-0.5.0.dist-info/RECORD,,
@@ -1,121 +0,0 @@
1
- Metadata-Version: 2.2
2
- Name: qlsdk2
3
- Version: 0.4.1
4
- Summary: SDK for quanlan device
5
- Home-page: https://github.com/hehuajun/qlsdk
6
- Author: hehuajun
7
- Author-email: hehuajun@eegion.com
8
- Classifier: Programming Language :: Python :: 3
9
- Classifier: License :: OSI Approved :: MIT License
10
- Classifier: Operating System :: OS Independent
11
- Requires-Python: >=3.9
12
- Description-Content-Type: text/markdown
13
- Requires-Dist: loguru>=0.6.0
14
- Requires-Dist: numpy>=1.23.5
15
- Requires-Dist: bitarray>=1.5.3
16
- Provides-Extra: dev
17
- Requires-Dist: pytest>=6.0; extra == "dev"
18
- Requires-Dist: twine>=3.0; extra == "dev"
19
- Dynamic: author
20
- Dynamic: author-email
21
- Dynamic: classifier
22
- Dynamic: description
23
- Dynamic: description-content-type
24
- Dynamic: home-page
25
- Dynamic: requires-dist
26
- Dynamic: requires-python
27
- Dynamic: summary
28
-
29
- # qlsdk project
30
-
31
-
32
-
33
- ## Getting started
34
-
35
- To make it easy for you to get started with GitLab, here's a list of recommended next steps.
36
-
37
- Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)!
38
-
39
- ## Add your files
40
-
41
- - [ ] [Create](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#create-a-file) or [upload](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#upload-a-file) files
42
- - [ ] [Add files using the command line](https://docs.gitlab.com/ee/gitlab-basics/add-file.html#add-a-file-using-the-command-line) or push an existing Git repository with the following command:
43
-
44
- ```
45
- cd existing_repo
46
- git remote add origin http://10.60.170.104/sw/qlsdk-project.git
47
- git branch -M main
48
- git push -uf origin main
49
- ```
50
-
51
- ## Integrate with your tools
52
-
53
- - [ ] [Set up project integrations](http://10.60.170.104/sw/qlsdk-project/-/settings/integrations)
54
-
55
- ## Collaborate with your team
56
-
57
- - [ ] [Invite team members and collaborators](https://docs.gitlab.com/ee/user/project/members/)
58
- - [ ] [Create a new merge request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html)
59
- - [ ] [Automatically close issues from merge requests](https://docs.gitlab.com/ee/user/project/issues/managing_issues.html#closing-issues-automatically)
60
- - [ ] [Enable merge request approvals](https://docs.gitlab.com/ee/user/project/merge_requests/approvals/)
61
- - [ ] [Set auto-merge](https://docs.gitlab.com/ee/user/project/merge_requests/merge_when_pipeline_succeeds.html)
62
-
63
- ## Test and Deploy
64
-
65
- Use the built-in continuous integration in GitLab.
66
-
67
- - [ ] [Get started with GitLab CI/CD](https://docs.gitlab.com/ee/ci/quick_start/)
68
- - [ ] [Analyze your code for known vulnerabilities with Static Application Security Testing (SAST)](https://docs.gitlab.com/ee/user/application_security/sast/)
69
- - [ ] [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/ee/topics/autodevops/requirements.html)
70
- - [ ] [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/ee/user/clusters/agent/)
71
- - [ ] [Set up protected environments](https://docs.gitlab.com/ee/ci/environments/protected_environments.html)
72
-
73
- ***
74
-
75
- # Editing this README
76
-
77
- When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thanks to [makeareadme.com](https://www.makeareadme.com/) for this template.
78
-
79
- ## Suggestions for a good README
80
-
81
- Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information.
82
-
83
- ## Name
84
- Choose a self-explaining name for your project.
85
-
86
- ## Description
87
- Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background subsection can also be added here. If there are alternatives to your project, this is a good place to list differentiating factors.
88
-
89
- ## Badges
90
- On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge.
91
-
92
- ## Visuals
93
- Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method.
94
-
95
- ## Installation
96
- Within a particular ecosystem, there may be a common way of installing things, such as using Yarn, NuGet, or Homebrew. However, consider the possibility that whoever is reading your README is a novice and would like more guidance. Listing specific steps helps remove ambiguity and gets people to using your project as quickly as possible. If it only runs in a specific context like a particular programming language version or operating system or has dependencies that have to be installed manually, also add a Requirements subsection.
97
-
98
- ## Usage
99
- Use examples liberally, and show the expected output if you can. It's helpful to have inline the smallest example of usage that you can demonstrate, while providing links to more sophisticated examples if they are too long to reasonably include in the README.
100
-
101
- ## Support
102
- Tell people where they can go to for help. It can be any combination of an issue tracker, a chat room, an email address, etc.
103
-
104
- ## Roadmap
105
- If you have ideas for releases in the future, it is a good idea to list them in the README.
106
-
107
- ## Contributing
108
- State if you are open to contributions and what your requirements are for accepting them.
109
-
110
- For people who want to make changes to your project, it's helpful to have some documentation on how to get started. Perhaps there is a script that they should run or some environment variables that they need to set. Make these steps explicit. These instructions could also be useful to your future self.
111
-
112
- You can also document commands to lint the code or run tests. These steps help to ensure high code quality and reduce the likelihood that the changes inadvertently break something. Having instructions for running tests is especially helpful if it requires external setup, such as starting a Selenium server for testing in a browser.
113
-
114
- ## Authors and acknowledgment
115
- Show your appreciation to those who have contributed to the project.
116
-
117
- ## License
118
- For open source projects, say how it is licensed.
119
-
120
- ## Project status
121
- If you have run out of energy or time for your project, put a note at the top of the README saying that development has slowed down or stopped completely. Someone may choose to fork your project or volunteer to step in as a maintainer or owner, allowing your project to keep going. You can also make an explicit request for maintainers.
File without changes