syslog2cef 0.1.0__tar.gz → 0.1.1__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 (32) hide show
  1. {syslog2cef-0.1.0/syslog2cef.egg-info → syslog2cef-0.1.1}/PKG-INFO +42 -4
  2. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/README.md +41 -3
  3. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/pyproject.toml +1 -1
  4. {syslog2cef-0.1.0 → syslog2cef-0.1.1/syslog2cef.egg-info}/PKG-INFO +42 -4
  5. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/api.py +1 -1
  6. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/cef.py +1 -1
  7. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/normalizer.py +1 -1
  8. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/parsers.py +1 -1
  9. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/LICENSE +0 -0
  10. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/setup.cfg +0 -0
  11. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslog2cef.egg-info/SOURCES.txt +0 -0
  12. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslog2cef.egg-info/dependency_links.txt +0 -0
  13. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslog2cef.egg-info/entry_points.txt +0 -0
  14. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslog2cef.egg-info/requires.txt +0 -0
  15. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslog2cef.egg-info/top_level.txt +0 -0
  16. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/__init__.py +0 -0
  17. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/__main__.py +0 -0
  18. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/cli.py +0 -0
  19. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/mappings/__init__.py +0 -0
  20. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/mappings/cisco_asa.json +0 -0
  21. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/mappings/cisco_ios.json +0 -0
  22. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/mappings/f5.json +0 -0
  23. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/mappings/linux.json +0 -0
  24. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/mappings/vmware.json +0 -0
  25. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/syslogcef/utils.py +0 -0
  26. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/tests/test_cef.py +0 -0
  27. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/tests/test_cli.py +0 -0
  28. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/tests/test_normalizer.py +0 -0
  29. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/tests/test_parsers.py +0 -0
  30. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/tests/test_parsers_extra.py +0 -0
  31. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/tests/test_pipeline.py +0 -0
  32. {syslog2cef-0.1.0 → syslog2cef-0.1.1}/tests/test_utils.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: syslog2cef
3
- Version: 0.1.0
3
+ Version: 0.1.1
4
4
  Summary: Convert RFC3164/RFC5424 syslog lines into ArcSight CEF
5
5
  Author-email: Tamir Suliman <allamiro@gmail.com>
6
6
  Project-URL: Homepage, https://github.com/allamiro/syslogcef
@@ -17,6 +17,10 @@ Provides-Extra: test
17
17
  Requires-Dist: pytest>=7; extra == "test"
18
18
  Dynamic: license-file
19
19
 
20
+ <p align="center">
21
+ <img src="https://raw.githubusercontent.com/allamiro/syslogcef/main/docs/logo.svg" alt="syslogcef logo" width="540">
22
+ </p>
23
+
20
24
  # syslogcef
21
25
 
22
26
  syslogcef converts syslog events into ArcSight Common Event Format (CEF). It
@@ -58,8 +62,40 @@ cd syslogcef
58
62
  pip install .
59
63
  ```
60
64
 
61
- An RPM package with a systemd service is also available from the GitHub
62
- releases page; see "Running as a service" below.
65
+ The GitHub releases page also provides, for every version:
66
+
67
+ - An RPM package (Fedora/RHEL) with a systemd service — see "Running as a
68
+ Service" below.
69
+ - A Debian package (`syslogcef_X.Y.Z-1_all.deb`) with the same systemd
70
+ service: `sudo apt install ./syslogcef_X.Y.Z-1_all.deb`.
71
+ - An Alpine APK with an OpenRC service:
72
+ `apk add --allow-untrusted syslogcef-X.Y.Z-r0.apk` (or install the
73
+ signing key from [packaging/apk/syslogcef.rsa.pub](packaging/apk/syslogcef.rsa.pub)
74
+ into `/etc/apk/keys/` first to verify).
75
+ - A standalone executable (`syslogcef-X.Y.Z.pyz`) that runs on any system
76
+ with Python 3.9+: `chmod +x syslogcef-X.Y.Z.pyz && ./syslogcef-X.Y.Z.pyz`.
77
+ - A source zip and sdist/wheel files.
78
+
79
+ A multi-arch (amd64/arm64) container image is published to GitHub
80
+ Container Registry on each release:
81
+
82
+ ```bash
83
+ docker run -i ghcr.io/allamiro/syslogcef < /var/log/syslog
84
+ ```
85
+
86
+ Fedora, RHEL/Alma/Rocky 9 and 10, and CentOS Stream users can install
87
+ from the [COPR repository](https://copr.fedorainfracloud.org/coprs/allamiro/syslogcef/),
88
+ which rebuilds automatically from every commit:
89
+
90
+ ```bash
91
+ sudo dnf copr enable allamiro/syslogcef
92
+ sudo dnf install syslogcef
93
+ ```
94
+
95
+ Every asset ships with a detached GPG signature (`.asc`) and is listed in
96
+ a signed `SHA256SUMS` file; RPMs additionally carry embedded `rpmsign`
97
+ signatures. The public key is committed at
98
+ [packaging/rpm/RPM-GPG-KEY-syslogcef](packaging/rpm/RPM-GPG-KEY-syslogcef).
63
99
 
64
100
  ## Command Line Usage
65
101
 
@@ -159,7 +195,9 @@ for the full CEF extension dictionary.
159
195
 
160
196
  ## Running as a Service
161
197
 
162
- The RPM package installs a systemd unit and an environment file:
198
+ The RPM and Debian packages install a systemd unit and an environment
199
+ file (the Alpine APK installs the equivalent OpenRC service with its
200
+ configuration in `/etc/conf.d/syslogcef`):
163
201
 
164
202
  - `/etc/syslogcef/syslogcef.conf` — input file, output file, and extra
165
203
  arguments for the converter.
@@ -1,3 +1,7 @@
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/allamiro/syslogcef/main/docs/logo.svg" alt="syslogcef logo" width="540">
3
+ </p>
4
+
1
5
  # syslogcef
2
6
 
3
7
  syslogcef converts syslog events into ArcSight Common Event Format (CEF). It
@@ -39,8 +43,40 @@ cd syslogcef
39
43
  pip install .
40
44
  ```
41
45
 
42
- An RPM package with a systemd service is also available from the GitHub
43
- releases page; see "Running as a service" below.
46
+ The GitHub releases page also provides, for every version:
47
+
48
+ - An RPM package (Fedora/RHEL) with a systemd service — see "Running as a
49
+ Service" below.
50
+ - A Debian package (`syslogcef_X.Y.Z-1_all.deb`) with the same systemd
51
+ service: `sudo apt install ./syslogcef_X.Y.Z-1_all.deb`.
52
+ - An Alpine APK with an OpenRC service:
53
+ `apk add --allow-untrusted syslogcef-X.Y.Z-r0.apk` (or install the
54
+ signing key from [packaging/apk/syslogcef.rsa.pub](packaging/apk/syslogcef.rsa.pub)
55
+ into `/etc/apk/keys/` first to verify).
56
+ - A standalone executable (`syslogcef-X.Y.Z.pyz`) that runs on any system
57
+ with Python 3.9+: `chmod +x syslogcef-X.Y.Z.pyz && ./syslogcef-X.Y.Z.pyz`.
58
+ - A source zip and sdist/wheel files.
59
+
60
+ A multi-arch (amd64/arm64) container image is published to GitHub
61
+ Container Registry on each release:
62
+
63
+ ```bash
64
+ docker run -i ghcr.io/allamiro/syslogcef < /var/log/syslog
65
+ ```
66
+
67
+ Fedora, RHEL/Alma/Rocky 9 and 10, and CentOS Stream users can install
68
+ from the [COPR repository](https://copr.fedorainfracloud.org/coprs/allamiro/syslogcef/),
69
+ which rebuilds automatically from every commit:
70
+
71
+ ```bash
72
+ sudo dnf copr enable allamiro/syslogcef
73
+ sudo dnf install syslogcef
74
+ ```
75
+
76
+ Every asset ships with a detached GPG signature (`.asc`) and is listed in
77
+ a signed `SHA256SUMS` file; RPMs additionally carry embedded `rpmsign`
78
+ signatures. The public key is committed at
79
+ [packaging/rpm/RPM-GPG-KEY-syslogcef](packaging/rpm/RPM-GPG-KEY-syslogcef).
44
80
 
45
81
  ## Command Line Usage
46
82
 
@@ -140,7 +176,9 @@ for the full CEF extension dictionary.
140
176
 
141
177
  ## Running as a Service
142
178
 
143
- The RPM package installs a systemd unit and an environment file:
179
+ The RPM and Debian packages install a systemd unit and an environment
180
+ file (the Alpine APK installs the equivalent OpenRC service with its
181
+ configuration in `/etc/conf.d/syslogcef`):
144
182
 
145
183
  - `/etc/syslogcef/syslogcef.conf` — input file, output file, and extra
146
184
  arguments for the converter.
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "syslog2cef"
7
- version = "0.1.0"
7
+ version = "0.1.1"
8
8
  description = "Convert RFC3164/RFC5424 syslog lines into ArcSight CEF"
9
9
  authors = [{name = "Tamir Suliman", email = "allamiro@gmail.com"}]
10
10
  readme = "README.md"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: syslog2cef
3
- Version: 0.1.0
3
+ Version: 0.1.1
4
4
  Summary: Convert RFC3164/RFC5424 syslog lines into ArcSight CEF
5
5
  Author-email: Tamir Suliman <allamiro@gmail.com>
6
6
  Project-URL: Homepage, https://github.com/allamiro/syslogcef
@@ -17,6 +17,10 @@ Provides-Extra: test
17
17
  Requires-Dist: pytest>=7; extra == "test"
18
18
  Dynamic: license-file
19
19
 
20
+ <p align="center">
21
+ <img src="https://raw.githubusercontent.com/allamiro/syslogcef/main/docs/logo.svg" alt="syslogcef logo" width="540">
22
+ </p>
23
+
20
24
  # syslogcef
21
25
 
22
26
  syslogcef converts syslog events into ArcSight Common Event Format (CEF). It
@@ -58,8 +62,40 @@ cd syslogcef
58
62
  pip install .
59
63
  ```
60
64
 
61
- An RPM package with a systemd service is also available from the GitHub
62
- releases page; see "Running as a service" below.
65
+ The GitHub releases page also provides, for every version:
66
+
67
+ - An RPM package (Fedora/RHEL) with a systemd service — see "Running as a
68
+ Service" below.
69
+ - A Debian package (`syslogcef_X.Y.Z-1_all.deb`) with the same systemd
70
+ service: `sudo apt install ./syslogcef_X.Y.Z-1_all.deb`.
71
+ - An Alpine APK with an OpenRC service:
72
+ `apk add --allow-untrusted syslogcef-X.Y.Z-r0.apk` (or install the
73
+ signing key from [packaging/apk/syslogcef.rsa.pub](packaging/apk/syslogcef.rsa.pub)
74
+ into `/etc/apk/keys/` first to verify).
75
+ - A standalone executable (`syslogcef-X.Y.Z.pyz`) that runs on any system
76
+ with Python 3.9+: `chmod +x syslogcef-X.Y.Z.pyz && ./syslogcef-X.Y.Z.pyz`.
77
+ - A source zip and sdist/wheel files.
78
+
79
+ A multi-arch (amd64/arm64) container image is published to GitHub
80
+ Container Registry on each release:
81
+
82
+ ```bash
83
+ docker run -i ghcr.io/allamiro/syslogcef < /var/log/syslog
84
+ ```
85
+
86
+ Fedora, RHEL/Alma/Rocky 9 and 10, and CentOS Stream users can install
87
+ from the [COPR repository](https://copr.fedorainfracloud.org/coprs/allamiro/syslogcef/),
88
+ which rebuilds automatically from every commit:
89
+
90
+ ```bash
91
+ sudo dnf copr enable allamiro/syslogcef
92
+ sudo dnf install syslogcef
93
+ ```
94
+
95
+ Every asset ships with a detached GPG signature (`.asc`) and is listed in
96
+ a signed `SHA256SUMS` file; RPMs additionally carry embedded `rpmsign`
97
+ signatures. The public key is committed at
98
+ [packaging/rpm/RPM-GPG-KEY-syslogcef](packaging/rpm/RPM-GPG-KEY-syslogcef).
63
99
 
64
100
  ## Command Line Usage
65
101
 
@@ -159,7 +195,9 @@ for the full CEF extension dictionary.
159
195
 
160
196
  ## Running as a Service
161
197
 
162
- The RPM package installs a systemd unit and an environment file:
198
+ The RPM and Debian packages install a systemd unit and an environment
199
+ file (the Alpine APK installs the equivalent OpenRC service with its
200
+ configuration in `/etc/conf.d/syslogcef`):
163
201
 
164
202
  - `/etc/syslogcef/syslogcef.conf` — input file, output file, and extra
165
203
  arguments for the converter.
@@ -15,7 +15,7 @@ from .cef import CEFEvent, build_cef
15
15
  logger = logging.getLogger(__name__)
16
16
 
17
17
 
18
- @dataclass(slots=True)
18
+ @dataclass
19
19
  class ParseResult:
20
20
  """Container returned by :func:`parse_syslog`.
21
21
 
@@ -34,7 +34,7 @@ DEFAULT_MAPPING = {
34
34
  }
35
35
 
36
36
 
37
- @dataclass(slots=True)
37
+ @dataclass
38
38
  class CEFEvent:
39
39
  header: Dict[str, str]
40
40
  extensions: Dict[str, str]
@@ -11,7 +11,7 @@ from .utils import ensure_tzaware, parse_key_value_pairs, sanitize_message
11
11
  logger = logging.getLogger(__name__)
12
12
 
13
13
 
14
- @dataclass(slots=True)
14
+ @dataclass
15
15
  class NormalizedEvent(ParsedEvent):
16
16
  kv: Dict[str, str] = None
17
17
  extras: Dict[str, Any] = None
@@ -19,7 +19,7 @@ from .utils import (
19
19
  logger = logging.getLogger(__name__)
20
20
 
21
21
 
22
- @dataclass(slots=True)
22
+ @dataclass
23
23
  class ParsedEvent:
24
24
  pri: Optional[int]
25
25
  facility: Optional[int]
File without changes
File without changes
File without changes
File without changes
File without changes