You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
PDF GUI Tools v1.1.0 | New interfaces and tools (#6)
## New Features:
- Include the utilities provided by the PyPDF2 module.
- New interface with all the included tools.
- Consolidation of the windows into a single piece of code.
- Separation of logic and window code.
- Improvements in code documentation.
## Fixed Bugs:
- Minor fixes are made in the poppler-utils utilities and the functions
of the main Qt window.
Copy file name to clipboardExpand all lines: README.md
+15-14Lines changed: 15 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,13 @@
18
18
<imgsrc="./icons/pdfguitools.svg"width="100">
19
19
</div>
20
20
21
-
**pdfgui_tools** is a user interface tool developed in Qt and Python that integrates with **poppler-utils** for PDF document management. This simple and user-friendly tool allows you to merge PDF files, convert PDF to HTML, as well as convert PDF to text. Additionally, in the near future, more functions with additional features will be added.
21
+
**pdfgui_tools** is a user interface tool developed in Qt and Python that integrates with **poppler-utils** and **PyPDF2** for PDF document management. It's a **simple** and **user-friendly** tool that includes various utilities such as merging PDFs, splitting PDFs, converting them to multimedia files like PNG or SVG, encrypting or decrypting, among other utilities included in pdfgui_tools.
22
+
23
+
<divalign="center">
24
+
<p>pdfgui_tools
25
+
</div>
26
+
27
+

22
28
23
29
# Sections
24
30
### Install pdfgui_tools:
@@ -36,11 +42,11 @@
36
42
## Install via deb package
37
43
To install pdfgui_tools, you will first need to download the **Debian package**, which can be found at the following link:
38
44
39
-
<ahref="https://github.com/TheWatcherMultiversal/pdfgui_tools/releases/download/v1.0.4/pdfgui_tools_stable-release_1.0.4_all.deb"target="_blank">📦 Download deb package</a>
45
+
<ahref="https://github.com/TheWatcherMultiversal/pdfgui_tools/releases/download/v1.1.0/pdfgui_tools_stable-release_1.1.0_all.deb"target="_blank">📦 Download deb package</a>
40
46
41
47
Once we have our **Debian package** installed, simply execute the following command, and it will be downloaded to our system:
- Note: If we find any missing dependencies, it's just a matter of installing them with the `sudo apt install -f` command
46
52
@@ -58,15 +64,15 @@ In case you are using an **Arch-based** distribution, you can download pdfgui_to
58
64
## Install using a script
59
65
If you do not have a Debian-based distribution or if you have a different package manager, you can use the installation script `./install.py`.
60
66
61
-
To do this, first make sure that the `./install.py` script and the `./uninstall.py` script have the necessary permissions to run on the system:
67
+
To do this, first make sure that the `./install.py` script have the necessary permissions to run on the system:
62
68
63
-
chmod 755 ./install.py ./uninstall.py
69
+
chmod 755 ./install.py
64
70
65
71
Now we can install pdfgui_tools by running the installation script:
66
72
67
73
./install.py
68
74
69
-
- Note: You can uninstall pdfgui_tools from the system using the `./uninstall.py` script.
75
+
- Note: To uninstall pdfgui_tools, you can use `./install.py --uninstall` to remove pdfgui_tools from the system.
70
76
71
77
### poppler-utils
72
78
@@ -75,7 +81,7 @@ In a special case where your distribution doesn't include the **poppler-utils**
75
81
./install.py --all
76
82
77
83
- <p>The <b>poppler-utils</b> package included in the installation script is designed for the <b>amd64</b> architecture. If you need this package for a different architecture, we recommend checking the official <ahref="https://poppler.freedesktop.org/" >poppler-utils</a> page and obtaining the source code.</p>
78
-
- If you need to uninstall everything, run `./uninstall.py` again with the `--all` parameter.
84
+
- If you need to uninstall everything, run `./install.py` again with the `--remove-all` parameter.
79
85
80
86
Now we just need to check if the program was installed correctly, for this we execute the following:
81
87
@@ -90,18 +96,13 @@ To start using pdfgui_tools, run the `pdfgui_tools` command, and a window like
90
96
91
97

92
98
93
-
As you can see, it's a very simple window that displays the functions the application can perform.
94
-
95
-
If we select an option, we will see a window like the following:
96
-
97
-

98
-
99
-
A window appears displaying the application's function. Each window is similar, and you can explore each function as needed. Additionally, if you require assistance, you can access a help window using the `F1` key.
99
+
If you need help or assistance navigating PDF GUI Tools, use the `F1` key to display the help window.
100
100
101
101
## Dependencies
102
102
Before being able to use pdfgui_tools, you need to have the following **dependencies** installed on your system for the program to function properly:
Here is where the code and program logic are stored. Modify the files only if you know what you're doing; the code is documented to enhance readability. If you intend to modify something, I recommend reading this first: https://doc.qt.io/qtforpython-6/
4
+
5
+
## File `pdfguiUtils.py`:
6
+
This is the main utilities file for **pdfgui_tools**, where all the application's utilities are included and will continue to be included. This file will contain variables and classes with their respective functions that will provide functionality to **pdfgui_tools**. Any module can be used as long as it is **stable**.
7
+
8
+
### Classes from the file:
9
+
10
+
#### `class PyPDF2utils`
11
+
It contains functions for the utilities included in the `PyPDF2` module. These functions return a value depending on the state and integrity of the **PDF document**. They should return a **tuple** with information for the **QMessageBox** window in case of an **error** or **informational** message regarding the **PDF documents**.
12
+
13
+
- Functions:
14
+
```python
15
+
# Functions: # Arguments: # Description:
16
+
defmerge_pdf (name_file:str, pdfs:list, pages:list): # -> Combine the PDFs from the list.
17
+
defseparate_pdf (pdf:str, dest:str): # -> Split a PDF document into multiple parts, which are saved in a directory.
18
+
defextract_text (name_file:str, pdf:str): # -> Extract the text from a PDF per page.
19
+
defencrypt_pdf (pdf:str, password:str): # -> Encrypt a PDF
20
+
defdecrypt_pdf (pdf:str, password:str): # -> Decrypt a PDF
21
+
deffileEncrypted (pdf): # -> Determines if a file is encrypted, to prevent importing the PyPDF2 module twice.
0 commit comments