gdeltnews 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: gdeltnews
3
- Version: 1.0.0
3
+ Version: 1.0.1
4
4
  Summary: Reconstruct full-text news articles from GDELT Web News NGrams 3.0
5
5
  Author: Andrea Fronzetti Colladon, Roberto Vestrelli
6
6
  License: GNU GENERAL PUBLIC LICENSE
@@ -708,15 +708,21 @@ http://data.gdeltproject.org/gdeltv3/webngrams/20250316000100.webngrams.json.gz
708
708
 
709
709
  Reconstruction quality depends on the n-gram fragments available in the dataset.
710
710
 
711
- ## Install
711
+ ## Docs
712
+
713
+ 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).
714
+
715
+ ## GUI Version
716
+ 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).
717
+
718
+ ## Python Package Quickstart
719
+
720
+ ### Install
712
721
 
713
722
  ```bash
714
723
  pip install gdeltnews
715
724
  ```
716
725
 
717
- ## Quickstart and Docs
718
- The package is documented [here](https://iandreafc.github.io/gdeltnews/).
719
-
720
726
  ### Step 1: Download Web NGrams files
721
727
 
722
728
  ```bash
@@ -734,6 +740,7 @@ download(
734
740
  Multiprocessing can be problematic inside notebooks. Run this from a `.py` script.
735
741
 
736
742
  ```bash
743
+ from multiprocessing import freeze_support
737
744
  from gdeltnews.reconstruct import reconstruct
738
745
 
739
746
  def main():
@@ -746,6 +753,7 @@ def main():
746
753
  )
747
754
 
748
755
  if __name__ == "__main__":
756
+ freeze_support() # important on Windows
749
757
  main()
750
758
  ```
751
759
 
@@ -763,12 +771,9 @@ filtermerge(
763
771
 
764
772
  Advanced users can pre-filter and download GDELT data via Google BigQuery, then process it directly with `wordmatch.py`.
765
773
 
766
- ## Citation
774
+ ## Citation and Credits
767
775
 
768
776
  If you use this package for research, please cite:
769
-
770
- 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)
771
-
772
- ## Credits
777
+ 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)
773
778
 
774
779
  Code co-developed with [robves99](https://github.com/robves99).
@@ -3,8 +3,8 @@ gdeltnews/download.py,sha256=ibLjW9sLpvmAXp8cjdAnrhIOGY_2wxrwH5YGW2OpdeU,7917
3
3
  gdeltnews/filtermerge.py,sha256=QWGBs7_bBvgPjl7azKY3HZ5uBqil6V5mGLBOCepS7JM,9699
4
4
  gdeltnews/reconstruct.py,sha256=pzZfjyoC8e1X3D0S_OAagTedJ4kBFmPK0UV_DQaUfsA,6745
5
5
  gdeltnews/wordmatch.py,sha256=ptm475aq3WFqtDoF2NrYIcaxW6ofPoKzIto4grzR0qs,15913
6
- gdeltnews-1.0.0.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
7
- gdeltnews-1.0.0.dist-info/METADATA,sha256=yDKgKBDZ-nhsepojxTO_shKHtFTEY0KeFoHJIrAF0Ss,44341
8
- gdeltnews-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
9
- gdeltnews-1.0.0.dist-info/top_level.txt,sha256=W5KefF6IA4a2O_v1GUWiC-ocoLPLYzBO7di9cn187Bc,10
10
- gdeltnews-1.0.0.dist-info/RECORD,,
6
+ gdeltnews-1.0.1.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
7
+ gdeltnews-1.0.1.dist-info/METADATA,sha256=zMSHi9SbnCyqjPv6NeK-mO54ro-lhyPfvh80FdBDpAo,44924
8
+ gdeltnews-1.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
9
+ gdeltnews-1.0.1.dist-info/top_level.txt,sha256=W5KefF6IA4a2O_v1GUWiC-ocoLPLYzBO7di9cn187Bc,10
10
+ gdeltnews-1.0.1.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: setuptools (80.9.0)
2
+ Generator: setuptools (80.10.2)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5