Splatlogger 1.6.2.post1__tar.gz → 1.6.4__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 (27) hide show
  1. splatlogger-1.6.4/MANIFEST.in +1 -0
  2. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/PKG-INFO +32 -20
  3. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/README.md +29 -18
  4. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/pyproject.toml +4 -3
  5. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/Splatlogger.egg-info/PKG-INFO +32 -20
  6. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/Splatlogger.egg-info/SOURCES.txt +7 -2
  7. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/Splatlogger.egg-info/requires.txt +1 -0
  8. splatlogger-1.6.4/src/splatlogger/__main__.py +373 -0
  9. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/splatlogger/cemu_gecko.py +22 -10
  10. splatlogger-1.6.4/src/splatlogger/data/api.json +4 -0
  11. splatlogger-1.6.4/src/splatlogger/data/names.json +725 -0
  12. splatlogger-1.6.4/src/splatlogger/enums.py +33 -0
  13. splatlogger-1.6.4/src/splatlogger/match_logger.py +249 -0
  14. splatlogger-1.6.4/src/splatlogger/tcpgecko.py +161 -0
  15. splatlogger-1.6.4/src/splatlogger/tcpgecko_aroma.py +109 -0
  16. splatlogger-1.6.4/src/splatlogger/tuples.py +49 -0
  17. splatlogger-1.6.4/src/splatlogger/utility_functions.py +173 -0
  18. splatlogger-1.6.2.post1/src/splatlogger/__main__.py +0 -337
  19. splatlogger-1.6.2.post1/src/splatlogger/data.py +0 -764
  20. splatlogger-1.6.2.post1/src/splatlogger/match_logger.py +0 -185
  21. splatlogger-1.6.2.post1/src/splatlogger/tcpgecko.py +0 -162
  22. splatlogger-1.6.2.post1/src/splatlogger/tcpgecko_aroma.py +0 -116
  23. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/setup.cfg +0 -0
  24. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/Splatlogger.egg-info/dependency_links.txt +0 -0
  25. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/Splatlogger.egg-info/entry_points.txt +0 -0
  26. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/Splatlogger.egg-info/top_level.txt +0 -0
  27. {splatlogger-1.6.2.post1 → splatlogger-1.6.4}/src/splatlogger/__init__.py +0 -0
@@ -0,0 +1 @@
1
+ include src/splatlogger/data/*.json
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Splatlogger
3
- Version: 1.6.2.post1
4
- Summary: A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon.
3
+ Version: 1.6.4
4
+ Summary: PID (Principal ID)/Network ID grabber and match logger for Splatoon
5
5
  Author-email: Shadow Doggo <shadowdoggo@protonmail.com>
6
6
  License-Expression: MIT
7
7
  Project-URL: Source Code, https://codeberg.org/ShadowDoggo/Splatlogger
@@ -13,18 +13,15 @@ Requires-Dist: userpaths
13
13
  Requires-Dist: requests
14
14
  Requires-Dist: psutil
15
15
  Requires-Dist: pymemoryeditor
16
+ Requires-Dist: colorama
16
17
 
17
18
  # Splatlogger
18
- A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon, written in Python.
19
-
20
- ## Prerequisites
21
- To install the package, you'll need to have Python 3.11 or newer installed on your system.
22
- On Android devices you can use Termux.
23
- Python is not required for the Windows executable.
19
+ A CLI PID (Principal ID)/Network ID grabber and match logger for Splatoon, written in Python.
24
20
 
25
21
  Both the Wii U and Cemu (Windows and Linux only) are supported.
26
22
 
27
- Your Wii U will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew,
23
+ ## Prerequisites (Wii U)
24
+ Your console will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew,
28
25
  such as Haxchi or the browser exploit.
29
26
 
30
27
  On Tiramisu, use [TCPGecko](https://github.com/BullyWiiPlaza/tcpgecko), [Geckiine](https://hb-app.store/wiiu/geckiine),
@@ -33,27 +30,33 @@ or any other app with the TCPGecko server.
33
30
  On Aroma, install the [TCPGecko Aroma plugin](https://codeberg.org/ShadowDoggo/TCPGeckoAroma).
34
31
 
35
32
  ## Installation
33
+ ### Windows executable
36
34
  On Windows, you can use the executable provided on the releases page.
37
- Though if you already have Python installed, it's recommended to use the package.
35
+ Though if you already have Python installed, it's recommended to use the package instead.
36
+
37
+ ### Python package
38
+ To use the package, you'll need to have Python 3.11 or newer installed on your system.
39
+ On Android devices you can use Termux.
38
40
 
39
- To install the package from PyPI, run:
41
+ Install the package from PyPI:
40
42
  ```
41
43
  pip install Splatlogger
42
44
  ```
45
+ (To upgrade from an older version, use `pip install --upgrade`)
43
46
 
44
47
  Or download the latest release from Codeberg and run:
45
48
  ```
46
49
  pip install path/to/Splatlogger-v1.x.zip
47
50
  ```
48
51
 
49
- If you do have Python installed but do not wish to install the package, you can run the module directly from the source code.
52
+ If you do have Python installed but do not wish to install the package, you can run it from the source code.
50
53
 
51
54
  Install the required dependencies:
52
55
  ```
53
56
  cd path/to/Splatlogger-v1.x/ && pip install -r requirements.txt
54
57
  ```
55
58
 
56
- Then run the module:
59
+ Then run:
57
60
  ```
58
61
  cd src/ && python -m splatlogger
59
62
  ```
@@ -72,6 +75,12 @@ path/to/Splatlogger-1.x.exe -ip IP [options]
72
75
  ```
73
76
 
74
77
  Options:
78
+ - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
79
+
80
+ - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required.
81
+ Note: If you have ptrace protection enabled, you'll need to run Python as root. It's best to run the package from source in that case.
82
+ - `PID` - PID of the Cemu process (optional).
83
+
75
84
  - `-log-level option` - Set how much data should be logged.
76
85
  - `none` - Don't create a log file.
77
86
  - `standard` - Log only basic player information, the same as what's printed to the console (default).
@@ -82,19 +91,20 @@ Options:
82
91
  - `all` - Save a log of all matches you play (default).
83
92
  - `latest` - Save a log of only the latest match.
84
93
 
85
- - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
86
-
87
- - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required and will be ignored.
88
- Note: If you have ptrace protection enabled, you'll need to run python as root. It's best to run the module from source in that case.
89
- - `PID` - PID of the Cemu process (optional).
90
-
91
94
  - `-stack Address (in hex)` - (Cemu only, optional) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
92
95
  Only required for logging stats. If the default values don't work, you'll need to specify this manually.
93
96
 
94
97
  <img src="stack.png" width="600" alt="(example)">
95
98
 
99
+ - `-spfn` - Fetch SFID instead of PNID. Enable if playing on SPFN.
100
+
101
+ - `-no-pnid` - Disable fetching PNIDs.
102
+
96
103
  - `-silent` - Disable printing logs to the console.
97
104
 
105
+ For example, `splatlogger -ip 192.168.1.100 -log-level extended -auto latest` will save an extended log of the latest match you play
106
+ (replace `192.168.1.100` with your actual IP address).
107
+
98
108
  Logs are saved in `(User)/Documents/Splatlogger/logs/`.
99
109
 
100
110
  To always run with the same IP and options without having to type them in manually, create an `args.txt` file in
@@ -104,6 +114,8 @@ Afterward any arguments passed through the command line will be ignored.
104
114
  Only one program can be connected to TCPGecko at a time. If you have something else connected, disconnect it beforehand.
105
115
 
106
116
  ## Credits
107
- - [pyGecko](https://github.com/wiiudev/pyGecko) authors for most of `tcpgecko.py`.
117
+ - [pyGecko](https://github.com/wiiudev/pyGecko) authors for the reference implementation of a Python TCPGecko library.
108
118
 
109
119
  - Everyone who contributed to [PNIDGrab](https://github.com/JerrySM64/PNIDGrab) and other similar PID grabbers as those were used as a reference.
120
+
121
+ - Special thanks to Pirlo for helping me with certain stuff.
@@ -1,14 +1,10 @@
1
1
  # Splatlogger
2
- A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon, written in Python.
3
-
4
- ## Prerequisites
5
- To install the package, you'll need to have Python 3.11 or newer installed on your system.
6
- On Android devices you can use Termux.
7
- Python is not required for the Windows executable.
2
+ A CLI PID (Principal ID)/Network ID grabber and match logger for Splatoon, written in Python.
8
3
 
9
4
  Both the Wii U and Cemu (Windows and Linux only) are supported.
10
5
 
11
- Your Wii U will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew,
6
+ ## Prerequisites (Wii U)
7
+ Your console will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew,
12
8
  such as Haxchi or the browser exploit.
13
9
 
14
10
  On Tiramisu, use [TCPGecko](https://github.com/BullyWiiPlaza/tcpgecko), [Geckiine](https://hb-app.store/wiiu/geckiine),
@@ -17,27 +13,33 @@ or any other app with the TCPGecko server.
17
13
  On Aroma, install the [TCPGecko Aroma plugin](https://codeberg.org/ShadowDoggo/TCPGeckoAroma).
18
14
 
19
15
  ## Installation
16
+ ### Windows executable
20
17
  On Windows, you can use the executable provided on the releases page.
21
- Though if you already have Python installed, it's recommended to use the package.
18
+ Though if you already have Python installed, it's recommended to use the package instead.
19
+
20
+ ### Python package
21
+ To use the package, you'll need to have Python 3.11 or newer installed on your system.
22
+ On Android devices you can use Termux.
22
23
 
23
- To install the package from PyPI, run:
24
+ Install the package from PyPI:
24
25
  ```
25
26
  pip install Splatlogger
26
27
  ```
28
+ (To upgrade from an older version, use `pip install --upgrade`)
27
29
 
28
30
  Or download the latest release from Codeberg and run:
29
31
  ```
30
32
  pip install path/to/Splatlogger-v1.x.zip
31
33
  ```
32
34
 
33
- If you do have Python installed but do not wish to install the package, you can run the module directly from the source code.
35
+ If you do have Python installed but do not wish to install the package, you can run it from the source code.
34
36
 
35
37
  Install the required dependencies:
36
38
  ```
37
39
  cd path/to/Splatlogger-v1.x/ && pip install -r requirements.txt
38
40
  ```
39
41
 
40
- Then run the module:
42
+ Then run:
41
43
  ```
42
44
  cd src/ && python -m splatlogger
43
45
  ```
@@ -56,6 +58,12 @@ path/to/Splatlogger-1.x.exe -ip IP [options]
56
58
  ```
57
59
 
58
60
  Options:
61
+ - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
62
+
63
+ - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required.
64
+ Note: If you have ptrace protection enabled, you'll need to run Python as root. It's best to run the package from source in that case.
65
+ - `PID` - PID of the Cemu process (optional).
66
+
59
67
  - `-log-level option` - Set how much data should be logged.
60
68
  - `none` - Don't create a log file.
61
69
  - `standard` - Log only basic player information, the same as what's printed to the console (default).
@@ -66,19 +74,20 @@ Options:
66
74
  - `all` - Save a log of all matches you play (default).
67
75
  - `latest` - Save a log of only the latest match.
68
76
 
69
- - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
70
-
71
- - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required and will be ignored.
72
- Note: If you have ptrace protection enabled, you'll need to run python as root. It's best to run the module from source in that case.
73
- - `PID` - PID of the Cemu process (optional).
74
-
75
77
  - `-stack Address (in hex)` - (Cemu only, optional) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
76
78
  Only required for logging stats. If the default values don't work, you'll need to specify this manually.
77
79
 
78
80
  <img src="stack.png" width="600" alt="(example)">
79
81
 
82
+ - `-spfn` - Fetch SFID instead of PNID. Enable if playing on SPFN.
83
+
84
+ - `-no-pnid` - Disable fetching PNIDs.
85
+
80
86
  - `-silent` - Disable printing logs to the console.
81
87
 
88
+ For example, `splatlogger -ip 192.168.1.100 -log-level extended -auto latest` will save an extended log of the latest match you play
89
+ (replace `192.168.1.100` with your actual IP address).
90
+
82
91
  Logs are saved in `(User)/Documents/Splatlogger/logs/`.
83
92
 
84
93
  To always run with the same IP and options without having to type them in manually, create an `args.txt` file in
@@ -88,6 +97,8 @@ Afterward any arguments passed through the command line will be ignored.
88
97
  Only one program can be connected to TCPGecko at a time. If you have something else connected, disconnect it beforehand.
89
98
 
90
99
  ## Credits
91
- - [pyGecko](https://github.com/wiiudev/pyGecko) authors for most of `tcpgecko.py`.
100
+ - [pyGecko](https://github.com/wiiudev/pyGecko) authors for the reference implementation of a Python TCPGecko library.
92
101
 
93
102
  - Everyone who contributed to [PNIDGrab](https://github.com/JerrySM64/PNIDGrab) and other similar PID grabbers as those were used as a reference.
103
+
104
+ - Special thanks to Pirlo for helping me with certain stuff.
@@ -4,18 +4,19 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "Splatlogger"
7
- version = "1.6.2.post1"
7
+ version = "1.6.4"
8
8
  authors = [
9
9
  { name="Shadow Doggo", email="shadowdoggo@protonmail.com" }
10
10
  ]
11
- description = "A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon."
11
+ description = "PID (Principal ID)/Network ID grabber and match logger for Splatoon"
12
12
  readme = "README.md"
13
13
  requires-python = ">=3.11"
14
14
  dependencies = [
15
15
  "userpaths",
16
16
  "requests",
17
17
  "psutil",
18
- "pymemoryeditor"
18
+ "pymemoryeditor",
19
+ "colorama"
19
20
  ]
20
21
  classifiers = [
21
22
  "Programming Language :: Python :: 3",
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Splatlogger
3
- Version: 1.6.2.post1
4
- Summary: A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon.
3
+ Version: 1.6.4
4
+ Summary: PID (Principal ID)/Network ID grabber and match logger for Splatoon
5
5
  Author-email: Shadow Doggo <shadowdoggo@protonmail.com>
6
6
  License-Expression: MIT
7
7
  Project-URL: Source Code, https://codeberg.org/ShadowDoggo/Splatlogger
@@ -13,18 +13,15 @@ Requires-Dist: userpaths
13
13
  Requires-Dist: requests
14
14
  Requires-Dist: psutil
15
15
  Requires-Dist: pymemoryeditor
16
+ Requires-Dist: colorama
16
17
 
17
18
  # Splatlogger
18
- A CLI PID (Principal ID)/PNID grabber and match logger for Splatoon, written in Python.
19
-
20
- ## Prerequisites
21
- To install the package, you'll need to have Python 3.11 or newer installed on your system.
22
- On Android devices you can use Termux.
23
- Python is not required for the Windows executable.
19
+ A CLI PID (Principal ID)/Network ID grabber and match logger for Splatoon, written in Python.
24
20
 
25
21
  Both the Wii U and Cemu (Windows and Linux only) are supported.
26
22
 
27
- Your Wii U will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew,
23
+ ## Prerequisites (Wii U)
24
+ Your console will need to have either the Tiramisu or Aroma environment set up or have another way to run homebrew,
28
25
  such as Haxchi or the browser exploit.
29
26
 
30
27
  On Tiramisu, use [TCPGecko](https://github.com/BullyWiiPlaza/tcpgecko), [Geckiine](https://hb-app.store/wiiu/geckiine),
@@ -33,27 +30,33 @@ or any other app with the TCPGecko server.
33
30
  On Aroma, install the [TCPGecko Aroma plugin](https://codeberg.org/ShadowDoggo/TCPGeckoAroma).
34
31
 
35
32
  ## Installation
33
+ ### Windows executable
36
34
  On Windows, you can use the executable provided on the releases page.
37
- Though if you already have Python installed, it's recommended to use the package.
35
+ Though if you already have Python installed, it's recommended to use the package instead.
36
+
37
+ ### Python package
38
+ To use the package, you'll need to have Python 3.11 or newer installed on your system.
39
+ On Android devices you can use Termux.
38
40
 
39
- To install the package from PyPI, run:
41
+ Install the package from PyPI:
40
42
  ```
41
43
  pip install Splatlogger
42
44
  ```
45
+ (To upgrade from an older version, use `pip install --upgrade`)
43
46
 
44
47
  Or download the latest release from Codeberg and run:
45
48
  ```
46
49
  pip install path/to/Splatlogger-v1.x.zip
47
50
  ```
48
51
 
49
- If you do have Python installed but do not wish to install the package, you can run the module directly from the source code.
52
+ If you do have Python installed but do not wish to install the package, you can run it from the source code.
50
53
 
51
54
  Install the required dependencies:
52
55
  ```
53
56
  cd path/to/Splatlogger-v1.x/ && pip install -r requirements.txt
54
57
  ```
55
58
 
56
- Then run the module:
59
+ Then run:
57
60
  ```
58
61
  cd src/ && python -m splatlogger
59
62
  ```
@@ -72,6 +75,12 @@ path/to/Splatlogger-1.x.exe -ip IP [options]
72
75
  ```
73
76
 
74
77
  Options:
78
+ - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
79
+
80
+ - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required.
81
+ Note: If you have ptrace protection enabled, you'll need to run Python as root. It's best to run the package from source in that case.
82
+ - `PID` - PID of the Cemu process (optional).
83
+
75
84
  - `-log-level option` - Set how much data should be logged.
76
85
  - `none` - Don't create a log file.
77
86
  - `standard` - Log only basic player information, the same as what's printed to the console (default).
@@ -82,19 +91,20 @@ Options:
82
91
  - `all` - Save a log of all matches you play (default).
83
92
  - `latest` - Save a log of only the latest match.
84
93
 
85
- - `-aroma` - Switch to Aroma mode. Enable if using the TCPGecko Aroma plugin.
86
-
87
- - `-cemu [PID]` - Switch to Cemu mode. The `-ip` argument is not required and will be ignored.
88
- Note: If you have ptrace protection enabled, you'll need to run python as root. It's best to run the module from source in that case.
89
- - `PID` - PID of the Cemu process (optional).
90
-
91
94
  - `-stack Address (in hex)` - (Cemu only, optional) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
92
95
  Only required for logging stats. If the default values don't work, you'll need to specify this manually.
93
96
 
94
97
  <img src="stack.png" width="600" alt="(example)">
95
98
 
99
+ - `-spfn` - Fetch SFID instead of PNID. Enable if playing on SPFN.
100
+
101
+ - `-no-pnid` - Disable fetching PNIDs.
102
+
96
103
  - `-silent` - Disable printing logs to the console.
97
104
 
105
+ For example, `splatlogger -ip 192.168.1.100 -log-level extended -auto latest` will save an extended log of the latest match you play
106
+ (replace `192.168.1.100` with your actual IP address).
107
+
98
108
  Logs are saved in `(User)/Documents/Splatlogger/logs/`.
99
109
 
100
110
  To always run with the same IP and options without having to type them in manually, create an `args.txt` file in
@@ -104,6 +114,8 @@ Afterward any arguments passed through the command line will be ignored.
104
114
  Only one program can be connected to TCPGecko at a time. If you have something else connected, disconnect it beforehand.
105
115
 
106
116
  ## Credits
107
- - [pyGecko](https://github.com/wiiudev/pyGecko) authors for most of `tcpgecko.py`.
117
+ - [pyGecko](https://github.com/wiiudev/pyGecko) authors for the reference implementation of a Python TCPGecko library.
108
118
 
109
119
  - Everyone who contributed to [PNIDGrab](https://github.com/JerrySM64/PNIDGrab) and other similar PID grabbers as those were used as a reference.
120
+
121
+ - Special thanks to Pirlo for helping me with certain stuff.
@@ -1,3 +1,4 @@
1
+ MANIFEST.in
1
2
  README.md
2
3
  pyproject.toml
3
4
  src/Splatlogger.egg-info/PKG-INFO
@@ -9,7 +10,11 @@ src/Splatlogger.egg-info/top_level.txt
9
10
  src/splatlogger/__init__.py
10
11
  src/splatlogger/__main__.py
11
12
  src/splatlogger/cemu_gecko.py
12
- src/splatlogger/data.py
13
+ src/splatlogger/enums.py
13
14
  src/splatlogger/match_logger.py
14
15
  src/splatlogger/tcpgecko.py
15
- src/splatlogger/tcpgecko_aroma.py
16
+ src/splatlogger/tcpgecko_aroma.py
17
+ src/splatlogger/tuples.py
18
+ src/splatlogger/utility_functions.py
19
+ src/splatlogger/data/api.json
20
+ src/splatlogger/data/names.json
@@ -2,3 +2,4 @@ userpaths
2
2
  requests
3
3
  psutil
4
4
  pymemoryeditor
5
+ colorama