gdeltnews 1.0.0__tar.gz → 1.0.1__tar.gz

{gdeltnews-1.0.0 → gdeltnews-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gdeltnews
-Version: 1.0.0
+Version: 1.0.1
 Summary: Reconstruct full-text news articles from GDELT Web News NGrams 3.0
 Author: Andrea Fronzetti Colladon, Roberto Vestrelli
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -708,15 +708,21 @@ http://data.gdeltproject.org/gdeltv3/webngrams/20250316000100.webngrams.json.gz
 
 Reconstruction quality depends on the n-gram fragments available in the dataset.
 
-## Install
+## Docs
+
+This package documentation is available [here](https://iandreafc.github.io/gdeltnews/), and a more detailed explanation of the functions’ logic is provided in the accompanying [paper](https://doi.org/10.3390/bdcc10020045).
+
+## GUI Version
+If you prefer to use a **software with a graphical user interface** that runs this code, you can find it [here](https://github.com/iandreafc/gdeltnews/tree/main/GUI) and read the [instructions here](https://iandreafc.github.io/gdeltnews/gui).
+
+## Python Package Quickstart
+
+### Install
 
 ```bash
 pip install gdeltnews
 ```
 
-## Quickstart and Docs
-The package is documented [here](https://iandreafc.github.io/gdeltnews/).
-
 ### Step 1: Download Web NGrams files
 
 ```bash
@@ -734,6 +740,7 @@ download(
 Multiprocessing can be problematic inside notebooks. Run this from a `.py` script.
 
 ```bash
+from multiprocessing import freeze_support
 from gdeltnews.reconstruct import reconstruct
 
 def main():
@@ -746,6 +753,7 @@ def main():
     )
 
 if __name__ == "__main__":
+    freeze_support()  # important on Windows
     main()
 ```
 
@@ -763,12 +771,9 @@ filtermerge(
 
 Advanced users can pre-filter and download GDELT data via Google BigQuery, then process it directly with `wordmatch.py`.
 
-## Citation
+## Citation and Credits
 
 If you use this package for research, please cite:
-
-A. Fronzetti Colladon, R. Vestrelli (2025). “A Python Tool for Reconstructing Full News Text from GDELT.” [https://arxiv.org/abs/2504.16063](https://arxiv.org/abs/2504.16063)
-
-## Credits
+Fronzetti Colladon, A., & Vestrelli, R. (2026). Free Access to World News: Reconstructing Full-Text Articles from GDELT. Big Data and Cognitive Computing, 10(2), 45. [https://doi.org/10.3390/bdcc10020045](https://doi.org/10.3390/bdcc10020045)
 
 Code co-developed with [robves99](https://github.com/robves99).

{gdeltnews-1.0.0 → gdeltnews-1.0.1}/README.md

@@ -15,15 +15,21 @@ http://data.gdeltproject.org/gdeltv3/webngrams/20250316000100.webngrams.json.gz
 
 Reconstruction quality depends on the n-gram fragments available in the dataset.
 
-## Install
+## Docs
+
+This package documentation is available [here](https://iandreafc.github.io/gdeltnews/), and a more detailed explanation of the functions’ logic is provided in the accompanying [paper](https://doi.org/10.3390/bdcc10020045).
+
+## GUI Version
+If you prefer to use a **software with a graphical user interface** that runs this code, you can find it [here](https://github.com/iandreafc/gdeltnews/tree/main/GUI) and read the [instructions here](https://iandreafc.github.io/gdeltnews/gui).
+
+## Python Package Quickstart
+
+### Install
 
 ```bash
 pip install gdeltnews
 ```
 
-## Quickstart and Docs
-The package is documented [here](https://iandreafc.github.io/gdeltnews/).
-
 ### Step 1: Download Web NGrams files
 
 ```bash
@@ -41,6 +47,7 @@ download(
 Multiprocessing can be problematic inside notebooks. Run this from a `.py` script.
 
 ```bash
+from multiprocessing import freeze_support
 from gdeltnews.reconstruct import reconstruct
 
 def main():
@@ -53,6 +60,7 @@ def main():
     )
 
 if __name__ == "__main__":
+    freeze_support()  # important on Windows
     main()
 ```
 
@@ -70,12 +78,9 @@ filtermerge(
 
 Advanced users can pre-filter and download GDELT data via Google BigQuery, then process it directly with `wordmatch.py`.
 
-## Citation
+## Citation and Credits
 
 If you use this package for research, please cite:
-
-A. Fronzetti Colladon, R. Vestrelli (2025). “A Python Tool for Reconstructing Full News Text from GDELT.” [https://arxiv.org/abs/2504.16063](https://arxiv.org/abs/2504.16063)
-
-## Credits
+Fronzetti Colladon, A., & Vestrelli, R. (2026). Free Access to World News: Reconstructing Full-Text Articles from GDELT. Big Data and Cognitive Computing, 10(2), 45. [https://doi.org/10.3390/bdcc10020045](https://doi.org/10.3390/bdcc10020045)
 
 Code co-developed with [robves99](https://github.com/robves99).

{gdeltnews-1.0.0 → gdeltnews-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gdeltnews"
-version = "1.0.0"
+version = "1.0.1"
 description = "Reconstruct full-text news articles from GDELT Web News NGrams 3.0"
 readme = "README.md"
 requires-python = ">=3.9"

{gdeltnews-1.0.0 → gdeltnews-1.0.1}/src/gdeltnews.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gdeltnews
-Version: 1.0.0
+Version: 1.0.1
 Summary: Reconstruct full-text news articles from GDELT Web News NGrams 3.0
 Author: Andrea Fronzetti Colladon, Roberto Vestrelli
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -708,15 +708,21 @@ http://data.gdeltproject.org/gdeltv3/webngrams/20250316000100.webngrams.json.gz
 
 Reconstruction quality depends on the n-gram fragments available in the dataset.
 
-## Install
+## Docs
+
+This package documentation is available [here](https://iandreafc.github.io/gdeltnews/), and a more detailed explanation of the functions’ logic is provided in the accompanying [paper](https://doi.org/10.3390/bdcc10020045).
+
+## GUI Version
+If you prefer to use a **software with a graphical user interface** that runs this code, you can find it [here](https://github.com/iandreafc/gdeltnews/tree/main/GUI) and read the [instructions here](https://iandreafc.github.io/gdeltnews/gui).
+
+## Python Package Quickstart
+
+### Install
 
 ```bash
 pip install gdeltnews
 ```
 
-## Quickstart and Docs
-The package is documented [here](https://iandreafc.github.io/gdeltnews/).
-
 ### Step 1: Download Web NGrams files
 
 ```bash
@@ -734,6 +740,7 @@ download(
 Multiprocessing can be problematic inside notebooks. Run this from a `.py` script.
 
 ```bash
+from multiprocessing import freeze_support
 from gdeltnews.reconstruct import reconstruct
 
 def main():
@@ -746,6 +753,7 @@ def main():
     )
 
 if __name__ == "__main__":
+    freeze_support()  # important on Windows
     main()
 ```
 
@@ -763,12 +771,9 @@ filtermerge(
 
 Advanced users can pre-filter and download GDELT data via Google BigQuery, then process it directly with `wordmatch.py`.
 
-## Citation
+## Citation and Credits
 
 If you use this package for research, please cite:
-
-A. Fronzetti Colladon, R. Vestrelli (2025). “A Python Tool for Reconstructing Full News Text from GDELT.” [https://arxiv.org/abs/2504.16063](https://arxiv.org/abs/2504.16063)
-
-## Credits
+Fronzetti Colladon, A., & Vestrelli, R. (2026). Free Access to World News: Reconstructing Full-Text Articles from GDELT. Big Data and Cognitive Computing, 10(2), 45. [https://doi.org/10.3390/bdcc10020045](https://doi.org/10.3390/bdcc10020045)
 
 Code co-developed with [robves99](https://github.com/robves99).