chore: fixed merge conflict

Author: jeafreezy

.github/workflows/python-publish.yml

@@ -6,7 +6,7 @@
 # separate terms of service, privacy policy, and support
 # documentation.
 
-name: Upload Python Package
+name: graphfaker Package build
 
 on:
   release:
@@ -38,33 +38,33 @@ jobs:
           name: release-dists
           path: dist/
 
-  pypi-publish:
-    runs-on: ubuntu-latest
-    needs:
-      - release-build
-    permissions:
-      # IMPORTANT: this permission is mandatory for trusted publishing
-      id-token: write
+  # pypi-publish:
+  #   runs-on: ubuntu-latest
+  #   needs:
+  #     - release-build
+  #   permissions:
+  #     # IMPORTANT: this permission is mandatory for trusted publishing
+  #     id-token: write
 
-    # Dedicated environments with protections for publishing are strongly recommended.
-    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
-    environment:
-      name: pypi
-      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
-      url: https://pypi.org/p/graphfaker
-      #
-      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
-      # ALTERNATIVE: exactly, uncomment the following line instead:
-      # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
+  #   # Dedicated environments with protections for publishing are strongly recommended.
+  #   # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+  #   environment:
+  #     name: pypi
+  #     # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+  #     url: https://pypi.org/p/graphfaker
+  #     #
+  #     # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+  #     # ALTERNATIVE: exactly, uncomment the following line instead:
+  #     # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
 
-    steps:
-      - name: Retrieve release distributions
-        uses: actions/download-artifact@v4
-        with:
-          name: release-dists
-          path: dist/
+  #   steps:
+  #     - name: Retrieve release distributions
+  #       uses: actions/download-artifact@v4
+  #       with:
+  #         name: release-dists
+  #         path: dist/
 
-      - name: Publish release distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist/
+  #     - name: Publish release distributions to PyPI
+  #       uses: pypa/gh-action-pypi-publish@release/v1
+  #       with:
+  #         packages-dir: dist/

AUTHORS.rst

@@ -5,9 +5,9 @@ Credits
 Development Lead
 ----------------
 
-* Dennis Irorere <[email protected]>
+* Dennis Irorere
 
 Contributors
 ------------
+* Emmanuel Jolaiya 
 
-None yet. Why not be the first?

HISTORY.rst

@@ -6,3 +6,15 @@ History
 ------------------
 
 * First release on PyPI.
+
+0.2.0 (2025-06-08)
+------------------
+GraphFaker v0.2.0 – June 2025
+
+This release expands GraphFaker’s scope with a new data sources to support graph construction and entity recognition tutorials:
+
+* Wikipedia fetcher (WikiFetcher)
+  - Retrieve raw page data (title, summary, content, sections, links, references) via the wikipedia package
+  - Export JSON dumps of article fields
+
+Upgrade now to effortlessly pull in unstructured Wikipedia data

README.md

@@ -1,6 +1,6 @@
 # GraphFaker
 
-GraphFaker is a Python library for generating, and loading synthetic and real-world graph datasets. It supports `faker`  as social graph, OpenStreetMap (OSM) road networks, and real airline flight networks. Use it for data science, research, teaching, rapid prototyping, and more!
+GraphFaker is a Python library for generating and loading synthetic and real-world datasets tailored for graph-based applications. It supports `faker`  as social graph, OpenStreetMap (OSM) road networks, and real airline flight networks. Use it for data science, research, teaching, rapid prototyping, and more!
 
 *Note: The authors and graphgeeks labs do not hold any responsibility for the correctness of this generator.*
 
@@ -24,11 +24,25 @@ GraphFaker is an open-source Python library designed to generate, load, and expo
 
 ## Features
 - **Multiple Graph Sources:**
-  - `faker`: Synthetic social graphs with rich node/edge types
-  - `osm`: Real-world road networks from OpenStreetMap
-  - `flights`: Real airline, airport, and flight networks
+  - `faker`: Synthetic “social-knowledge” graphs powered by Faker (people, places, organizations, events, products with rich attributes and relationships)
+  - `osm`: Real-world street networks directly from OpenStreetMap (by place name, address, or bounding box)
+  - `flights`: Flight/airline networks from Bureau of Transportation Statistics (airlines ↔ airports ↔ flight legs, complete with cancellation and delay flags)
+- **Unstructured Data Source:**
+  - `WikiFetcher`: Raw Wikipedia page data (title, summary, content, sections, links, references) ready for custom graph or RAG pipelines
 - **Easy CLI & Python Library**
 
+This removes friction around data acquisition, letting you focus on algorithms, teaching or rapid prototyping.
+
+## ✨ Key Features
+
+| Source        | What It Gives You                                                                                                                                                                                     |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Faker**     | Synthetic social-knowledge graphs with configurable sizes, weighted and directional relationships.                                                      |
+| **OSM**       | Real road or walking networks via OSMnx under the hood—fetch by place, address, or bounding box; simplify topology; project to UTM.                                                |
+| **Flights**   | Airline/airport graph from BTS on-time performance data: nodes for carriers, airports, flights; edges for OPERATED\_BY, DEPARTS\_FROM, ARRIVES\_AT; batch or date-range support; subgraph sampling.   |
+| **WikiFetcher** | Raw page dumps (title, summary, content, sections, links, references) as JSON |
+
+
 ---
 
 *Disclaimer: This is still a work in progress (WIP). With logging and debugging print statement. Our goal for releasing early is to get feedback and reiterate.*
@@ -62,10 +76,17 @@ gf = GraphFaker()
 # Synthetic social/knowledge graph
 g1 = gf.generate_graph(source="faker", total_nodes=200, total_edges=800)
 # OSM road network
-g2 = gf.generate_graph(source="osm", place="Berlin, Germany", network_type="drive")
+g2 = gf.generate_graph(source="osm", place="Chinatown, San Francisco, California", network_type="drive")
 # Flight network
 g3 = gf.generate_graph(source="flights", year=2024, month=1)
 
+# Fetch Wikipedia page data
+from graphfaker import WikiFetcher
+page = WikiFetcher.fetch_page("Graph theory")
+print(page['summary'])
+print(page['content'])
+WikiFetcher.export_page_json(page, "graph_theory.json")
+
 ```
 
 #### Advanced: Date Range for Flights

README.rst

@@ -1,7 +1,7 @@
 GraphFaker
 ==========
 
-GraphFaker is a Python library for generating and loading synthetic and real-world graph datasets. It supports `faker` as social graph, OpenStreetMap (OSM) road networks, and real airline flight networks. Use it for data science, research, teaching, rapid prototyping, and more!
+GraphFaker is a python library for generating and loading synthetic and real-world datasets tailored for graph-based applications. It supports `faker` as social graph, OpenStreetMap (OSM) road networks, and real airline flight networks. Use it for data science, research, teaching, rapid prototyping, and more!
 
 *Note: The authors and GraphGeeks Labs do not hold any responsibility for the correctness of this generator.*
 
@@ -35,14 +35,40 @@ Solution: graphfaker
 GraphFaker is an open-source Python library designed to generate, load, and export synthetic graph datasets in a user-friendly and configurable way. It enables users to generate graphs tailored to their specific needs, allowing for better experimentation and learning without needing to think about where the data is coming from or how to fetch the data.
 
 Features
---------
+========
 
 - **Multiple Graph Sources:**
-  - `faker`: Synthetic social graphs with rich node/edge types
-  - `osm`: Real-world road networks from OpenStreetMap
-  - `flights`: Real airline, airport, and flight networks
+  - ``faker``: Synthetic “social-knowledge” graphs powered by Faker (people, places, organizations, events, products with rich attributes and relationships)
+  - ``osm``: Real-world street networks directly from OpenStreetMap (by place name, address, or bounding box)
+  - ``flights``: Flight/airline networks from Bureau of Transportation Statistics (airlines ↔ airports ↔ flight legs, complete with cancellation and delay flags)
+
+- **Unstructured Data Source:**
+  - ``WikiFetcher``: Raw Wikipedia page data (title, summary, content, sections, links, references) ready for custom graph or entity recognition
+
 - **Easy CLI & Python Library**
 
+
+*Vision:: To remove friction around data acquisition, letting you focus on algorithms, teaching, or rapid prototyping.*
+
+
+Key Features
+============
+
+.. list-table::
+   :header-rows: 1
+   :widths: 15 85
+
+   * - Source
+     - What It Gives You
+   * - **Faker**
+     - Synthetic social-knowledge graphs with configurable sizes, weighted and directional relationships.
+   * - **OSM**
+     - Real road or walking networks via OSMnx under the hood—fetch by place, address, or bounding box; simplify topology; project to UTM.
+   * - **Flights**
+     - Airline/airport graph from BTS on-time performance data: nodes for carriers, airports, flights; edges for OPERATED_BY, DEPARTS_FROM, ARRIVES_AT; batch or date-range support; subgraph sampling.
+   * - **Wikipedia**
+     - Raw page dumps (title, summary, content, sections, links, references) as JSON.
+
 .. note::
 
    This is still a work in progress (WIP). Includes logging and debugging print statements. Our goal for releasing early is to get feedback and reiterate.
@@ -78,10 +104,17 @@ Python Library Usage
    # Synthetic social/knowledge graph
    g1 = gf.generate_graph(source="faker", total_nodes=200, total_edges=800)
    # OSM road network
-   g2 = gf.generate_graph(source="osm", place="Berlin, Germany", network_type="drive")
+   g2 = gf.generate_graph(source="osm", place="Chinatown, San Francisco, California", network_type="drive")
    # Flight network
    g3 = gf.generate_graph(source="flights", year=2024, month=1)
 
+      # Fetch Wikipedia page data
+   from graphfaker import WikiFetcher
+   page = WikiFetcher.fetch_page("Graph theory")
+   print(page['summary'])
+   print(page['content'])
+   WikiFetcher.export_page_json(page, "graph_theory.json")
+
 Advanced: Date Range for Flights
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^