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.
- print_at_soc-0.1.0/LICENSE +21 -0
- print_at_soc-0.1.0/MANIFEST.in +5 -0
- print_at_soc-0.1.0/PKG-INFO +199 -0
- print_at_soc-0.1.0/README.md +172 -0
- print_at_soc-0.1.0/print_at_soc/__init__.py +13 -0
- print_at_soc-0.1.0/print_at_soc/__main__.py +6 -0
- print_at_soc-0.1.0/print_at_soc/_post_install.py +60 -0
- print_at_soc-0.1.0/print_at_soc/cli.py +378 -0
- print_at_soc-0.1.0/print_at_soc/config.py +51 -0
- print_at_soc-0.1.0/print_at_soc/downloader.py +418 -0
- print_at_soc-0.1.0/print_at_soc.egg-info/PKG-INFO +199 -0
- print_at_soc-0.1.0/print_at_soc.egg-info/SOURCES.txt +17 -0
- print_at_soc-0.1.0/print_at_soc.egg-info/dependency_links.txt +1 -0
- print_at_soc-0.1.0/print_at_soc.egg-info/entry_points.txt +3 -0
- print_at_soc-0.1.0/print_at_soc.egg-info/top_level.txt +1 -0
- print_at_soc-0.1.0/print_at_soc.pth +2 -0
- print_at_soc-0.1.0/pyproject.toml +48 -0
- print_at_soc-0.1.0/setup.cfg +4 -0
- print_at_soc-0.1.0/setup.py +7 -0
|
@@ -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,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
|
+
[](https://badge.fury.io/py/EasyPaper)
|
|
34
|
+
[](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
|
+
[](https://badge.fury.io/py/EasyPaper)
|
|
7
|
+
[](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,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
|
+
|