print-at-soc 0.1.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.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Silan Hu
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,5 @@
1
+ include README.md
2
+ include LICENSE
3
+ include pyproject.toml
4
+ recursive-include easy_paper *.py
5
+ recursive-include easy_paper py.typed
@@ -0,0 +1,199 @@
1
+ Metadata-Version: 2.4
2
+ Name: print-at-soc
3
+ Version: 0.1.0
4
+ Summary: Print@SoC - Smart Printing for NUS SoC - Python CLI wrapper for desktop application
5
+ Author-email: Silan Hu <silan.hu@u.nus.edu>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/Qingbolan/Print-SoC
8
+ Project-URL: Repository, https://github.com/Qingbolan/Print-SoC
9
+ Project-URL: Issues, https://github.com/Qingbolan/Print-SoC/issues
10
+ Keywords: nus,soc,printing,ssh,pdf,desktop-application
11
+ Classifier: Development Status :: 3 - Alpha
12
+ Classifier: Intended Audience :: Education
13
+ Classifier: Topic :: Printing
14
+ Classifier: Topic :: Utilities
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.8
18
+ Classifier: Programming Language :: Python :: 3.9
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Operating System :: OS Independent
23
+ Requires-Python: >=3.8
24
+ Description-Content-Type: text/markdown
25
+ License-File: LICENSE
26
+ Dynamic: license-file
27
+
28
+
29
+ # EasyPaper
30
+
31
+ > Paper Management Platform for VLDB - Python CLI wrapper
32
+
33
+ [![PyPI version](https://badge.fury.io/py/EasyPaper.svg)](https://badge.fury.io/py/EasyPaper)
34
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
35
+
36
+ EasyPaper is a desktop application for managing academic papers and author information. This Python package provides a convenient command-line interface to download and launch the application.
37
+
38
+ ## Features
39
+
40
+ - Import and manage academic papers from Excel
41
+ - Track author profiles and affiliations
42
+ - Visualize paper metadata and statistics
43
+ - Export organized datasets with custom formatting
44
+ - Cross-platform desktop application (macOS, Windows, Linux)
45
+ - Simple one-command installation via pip
46
+
47
+ ## Installation
48
+
49
+ ### Quick Install
50
+
51
+ ```bash
52
+ pip install EasyPaper
53
+ ```
54
+
55
+ ### Platform Support
56
+
57
+ - **macOS**: Apple Silicon (ARM64) and Intel (x86_64)
58
+ - **Windows**: x64
59
+ - **Linux**: x64
60
+
61
+ ## Usage
62
+
63
+ ### Launch the Application
64
+
65
+ Simply run:
66
+
67
+ ```bash
68
+ EasyPaper
69
+ ```
70
+
71
+ On first run, the application binary will be automatically downloaded (~50-150 MB depending on platform). The binary is stored in `~/.EasyPaper/` for future use.
72
+
73
+ ### Command-Line Options
74
+
75
+ ```bash
76
+ # Show help
77
+ EasyPaper --help
78
+
79
+ # Show version
80
+ EasyPaper --version
81
+
82
+ # Force reinstall the binary
83
+ EasyPaper --install
84
+
85
+ # Show binary installation path
86
+ EasyPaper --path
87
+ ```
88
+
89
+ ## How It Works
90
+
91
+ This Python package is a lightweight wrapper (~50 KB) that:
92
+
93
+ 1. Detects your operating system and architecture
94
+ 2. Downloads the appropriate pre-built binary from GitHub Releases (only on first run)
95
+ 3. Launches the desktop application
96
+
97
+ The actual application is built with:
98
+
99
+ - **Frontend**: React + TypeScript
100
+ - **Backend**: Tauri (Rust)
101
+ - **UI**: Ant Design + Fluent UI
102
+
103
+ ## Development
104
+
105
+ ### Project Structure
106
+
107
+ ```
108
+ EasyPaper/
109
+ ├── app/ # Tauri desktop application
110
+ │ ├── src/ # React frontend
111
+ │ └── src-tauri/ # Rust backend
112
+ └── python-pip/ # Python CLI wrapper
113
+ ├── easy_paper/
114
+ │ ├── __init__.py
115
+ │ ├── cli.py # CLI entry point
116
+ │ ├── config.py # Configuration
117
+ │ └── downloader.py # Binary downloader
118
+ └── pyproject.toml
119
+ ```
120
+
121
+ ### Building from Source
122
+
123
+ To build the desktop application from source:
124
+
125
+ ```bash
126
+ cd app
127
+ npm install
128
+ npm run tauri:build
129
+ ```
130
+
131
+ ### Publishing to PyPI
132
+
133
+ ```bash
134
+ cd python-pip
135
+
136
+ # Build the package
137
+ python -m build
138
+
139
+ # Upload to PyPI
140
+ twine upload dist/*
141
+ ```
142
+
143
+ ## Requirements
144
+
145
+ - Python 3.8+
146
+ - Internet connection (for initial binary download)
147
+
148
+ ## Configuration
149
+
150
+ The package stores data in:
151
+
152
+ - **Binary**: `~/.EasyPaper/bin/`
153
+ - **Version**: `~/.EasyPaper/version.txt`
154
+
155
+ ## Troubleshooting
156
+
157
+ ### Download Issues
158
+
159
+ If download fails, try:
160
+
161
+ ```bash
162
+ EasyPaper --install
163
+ ```
164
+
165
+ ### Permission Issues (Linux/macOS)
166
+
167
+ If the binary is not executable:
168
+
169
+ ```bash
170
+ chmod +x ~/.EasyPaper/bin/EasyPaper
171
+ ```
172
+
173
+ ### Manual Installation
174
+
175
+ You can also download binaries directly from [GitHub Releases](https://github.com/Qingbolan/EasyPaper/releases).
176
+
177
+ ## License
178
+
179
+ MIT License - see LICENSE file for details
180
+
181
+ ## Author
182
+
183
+ **Silan Hu**
184
+
185
+ - Email: silan.hu@u.nus.edu
186
+ - GitHub: [@Qingbolan](https://github.com/Qingbolan)
187
+
188
+ ## Contributing
189
+
190
+ Contributions are welcome! Please feel free to submit a Pull Request.
191
+
192
+ ## Acknowledgments
193
+
194
+ Built with:
195
+
196
+ - [Tauri](https://tauri.app/) - Desktop application framework
197
+ - [React](https://react.dev/) - UI library
198
+ - [Ant Design](https://ant.design/) - UI components
199
+ - [Fluent UI](https://developer.microsoft.com/en-us/fluentui) - Microsoft design system
@@ -0,0 +1,172 @@
1
+
2
+ # EasyPaper
3
+
4
+ > Paper Management Platform for VLDB - Python CLI wrapper
5
+
6
+ [![PyPI version](https://badge.fury.io/py/EasyPaper.svg)](https://badge.fury.io/py/EasyPaper)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
+
9
+ EasyPaper is a desktop application for managing academic papers and author information. This Python package provides a convenient command-line interface to download and launch the application.
10
+
11
+ ## Features
12
+
13
+ - Import and manage academic papers from Excel
14
+ - Track author profiles and affiliations
15
+ - Visualize paper metadata and statistics
16
+ - Export organized datasets with custom formatting
17
+ - Cross-platform desktop application (macOS, Windows, Linux)
18
+ - Simple one-command installation via pip
19
+
20
+ ## Installation
21
+
22
+ ### Quick Install
23
+
24
+ ```bash
25
+ pip install EasyPaper
26
+ ```
27
+
28
+ ### Platform Support
29
+
30
+ - **macOS**: Apple Silicon (ARM64) and Intel (x86_64)
31
+ - **Windows**: x64
32
+ - **Linux**: x64
33
+
34
+ ## Usage
35
+
36
+ ### Launch the Application
37
+
38
+ Simply run:
39
+
40
+ ```bash
41
+ EasyPaper
42
+ ```
43
+
44
+ On first run, the application binary will be automatically downloaded (~50-150 MB depending on platform). The binary is stored in `~/.EasyPaper/` for future use.
45
+
46
+ ### Command-Line Options
47
+
48
+ ```bash
49
+ # Show help
50
+ EasyPaper --help
51
+
52
+ # Show version
53
+ EasyPaper --version
54
+
55
+ # Force reinstall the binary
56
+ EasyPaper --install
57
+
58
+ # Show binary installation path
59
+ EasyPaper --path
60
+ ```
61
+
62
+ ## How It Works
63
+
64
+ This Python package is a lightweight wrapper (~50 KB) that:
65
+
66
+ 1. Detects your operating system and architecture
67
+ 2. Downloads the appropriate pre-built binary from GitHub Releases (only on first run)
68
+ 3. Launches the desktop application
69
+
70
+ The actual application is built with:
71
+
72
+ - **Frontend**: React + TypeScript
73
+ - **Backend**: Tauri (Rust)
74
+ - **UI**: Ant Design + Fluent UI
75
+
76
+ ## Development
77
+
78
+ ### Project Structure
79
+
80
+ ```
81
+ EasyPaper/
82
+ ├── app/ # Tauri desktop application
83
+ │ ├── src/ # React frontend
84
+ │ └── src-tauri/ # Rust backend
85
+ └── python-pip/ # Python CLI wrapper
86
+ ├── easy_paper/
87
+ │ ├── __init__.py
88
+ │ ├── cli.py # CLI entry point
89
+ │ ├── config.py # Configuration
90
+ │ └── downloader.py # Binary downloader
91
+ └── pyproject.toml
92
+ ```
93
+
94
+ ### Building from Source
95
+
96
+ To build the desktop application from source:
97
+
98
+ ```bash
99
+ cd app
100
+ npm install
101
+ npm run tauri:build
102
+ ```
103
+
104
+ ### Publishing to PyPI
105
+
106
+ ```bash
107
+ cd python-pip
108
+
109
+ # Build the package
110
+ python -m build
111
+
112
+ # Upload to PyPI
113
+ twine upload dist/*
114
+ ```
115
+
116
+ ## Requirements
117
+
118
+ - Python 3.8+
119
+ - Internet connection (for initial binary download)
120
+
121
+ ## Configuration
122
+
123
+ The package stores data in:
124
+
125
+ - **Binary**: `~/.EasyPaper/bin/`
126
+ - **Version**: `~/.EasyPaper/version.txt`
127
+
128
+ ## Troubleshooting
129
+
130
+ ### Download Issues
131
+
132
+ If download fails, try:
133
+
134
+ ```bash
135
+ EasyPaper --install
136
+ ```
137
+
138
+ ### Permission Issues (Linux/macOS)
139
+
140
+ If the binary is not executable:
141
+
142
+ ```bash
143
+ chmod +x ~/.EasyPaper/bin/EasyPaper
144
+ ```
145
+
146
+ ### Manual Installation
147
+
148
+ You can also download binaries directly from [GitHub Releases](https://github.com/Qingbolan/EasyPaper/releases).
149
+
150
+ ## License
151
+
152
+ MIT License - see LICENSE file for details
153
+
154
+ ## Author
155
+
156
+ **Silan Hu**
157
+
158
+ - Email: silan.hu@u.nus.edu
159
+ - GitHub: [@Qingbolan](https://github.com/Qingbolan)
160
+
161
+ ## Contributing
162
+
163
+ Contributions are welcome! Please feel free to submit a Pull Request.
164
+
165
+ ## Acknowledgments
166
+
167
+ Built with:
168
+
169
+ - [Tauri](https://tauri.app/) - Desktop application framework
170
+ - [React](https://react.dev/) - UI library
171
+ - [Ant Design](https://ant.design/) - UI components
172
+ - [Fluent UI](https://developer.microsoft.com/en-us/fluentui) - Microsoft design system
@@ -0,0 +1,13 @@
1
+ """Print@SoC Python Wrapper
2
+
3
+ A Python wrapper for Print@SoC desktop application.
4
+ Smart Printing for NUS SoC
5
+ """
6
+
7
+ __version__ = "0.1.0"
8
+ __author__ = "Silan Hu"
9
+ __email__ = "silan.hu@u.nus.edu"
10
+
11
+ from .cli import main
12
+
13
+ __all__ = ["main", "__version__"]
@@ -0,0 +1,6 @@
1
+ """Python -m print_at_soc entry point."""
2
+
3
+ from .cli import main
4
+
5
+ if __name__ == "__main__":
6
+ raise SystemExit(main())
@@ -0,0 +1,60 @@
1
+ """Windows post-install hook invoked via .pth on next Python start.
2
+
3
+ This sets up user-level PATH and App Paths registration so that
4
+ `EasyPaper` can be launched directly from terminals without
5
+ manually editing PATH. It is safe and idempotent.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ import os
11
+ import sys
12
+ from pathlib import Path
13
+
14
+
15
+ def _run_once_guard() -> bool:
16
+ """Return True if we've already run, else create guard and return False."""
17
+ try:
18
+ home = Path.home()
19
+ flag_dir = home / ".EasyPaper"
20
+ flag_dir.mkdir(parents=True, exist_ok=True)
21
+ flag = flag_dir / "win_postinstall_done"
22
+ if flag.exists():
23
+ return True
24
+ flag.write_text("1")
25
+ return False
26
+ except Exception:
27
+ # If guard fails, still attempt once
28
+ return False
29
+
30
+
31
+ def run_post_install(): # pragma: no cover - side-effect hook
32
+ try:
33
+ if os.name != "nt":
34
+ return
35
+ # Allow users/CI to disable via env
36
+ if os.environ.get("easy_paper_NO_POSTINSTALL"):
37
+ return
38
+ # During build/installer contexts, skip
39
+ if any(m in sys.modules for m in ("pip", "build", "setuptools")):
40
+ # Still ok to continue, but keep minimal
41
+ pass
42
+
43
+ # Avoid running multiple times
44
+ if _run_once_guard():
45
+ return
46
+
47
+ # Defer import to avoid overhead when not on Windows
48
+ from .cli import _windows_setup_shortcuts # type: ignore
49
+
50
+ # Best-effort setup: add Scripts to PATH + register App Paths
51
+ _windows_setup_shortcuts(register_app=True, fix_path=True)
52
+ except Exception:
53
+ # Never fail interpreter startup due to post-install
54
+ return
55
+
56
+
57
+ # If imported via .pth, execute immediately
58
+ if __name__ == "__main__":
59
+ run_post_install()
60
+