NetworkX to NetworkXGraphs

Author: AJ0070

Project.toml

@@ -1,4 +1,4 @@
-name = "NetworkX"
+name = "NetworkXGraphs"
 uuid = "7cfbcbcf-cd41-4fe6-b90f-527da21b4c9a"
 version = "0.1.0"
 authors = ["Jash <jashambaliya1@gmail.com>"]

README.md

@@ -1,6 +1,6 @@
-# NetworkX.jl
+# NetworkXGraphs.jl
 
-`NetworkX.jl` is a Julia wrapper around Python's `networkx` built on `PythonCall.jl`.
+`NetworkXGraphs.jl` is a Julia wrapper around Python's `networkx` built on `PythonCall.jl`.
 The current milestone is intentionally narrow: constructors plus the basic `Graphs.jl` API needed to pass `GraphsInterfaceChecker`.
 
 `networkx` is declared as a package dependency and is automatically installed via `CondaPkg.jl` — no manual Python setup required.
@@ -9,18 +9,18 @@ The current milestone is intentionally narrow: constructors plus the basic `Grap
 
 - Wrap `networkx.Graph`/`networkx.DiGraph` as `Graphs.AbstractGraph` using the `NetworkXGraph` / `NetworkXDiGraph` constructors
 - Convert between `Graphs.jl` graph types and Python `networkx` objects via `networkx_graph`
-- Access the raw Python `networkx` module through `NetworkX.PythonNetworkX`
+- Access the raw Python `networkx` module through `NetworkXGraphs.PythonNetworkX`
 - Validate interface conformance with `GraphsInterfaceChecker.jl`
 - Stress-test multi-threaded use of independent graphs to catch Python/GIL integration regressions
 
 ## Quick start
 
 ```julia
 using Graphs
-using NetworkX
+using NetworkXGraphs
 
 # Access the raw Python networkx module
-nx = NetworkX.PythonNetworkX.networkx
+nx = NetworkXGraphs.PythonNetworkX.networkx
 
 # Create a Python networkx graph and wrap it as a Graphs.jl-compatible graph
 pyg = nx.path_graph(5)

src/NetworkX.jl src/NetworkXGraphs.jlsrc/NetworkX.jl renamed to src/NetworkXGraphs.jl

@@ -1,4 +1,4 @@
-module NetworkX
+module NetworkXGraphs
 
 using Graphs
 using PythonCall: Py, pynew, pycopy!, pybuiltins, pyconvert, pyimport
@@ -10,16 +10,16 @@ export AbstractNetworkXGraph,
 	refresh_index!
 
 """
-	NetworkX.PythonNetworkX
+	NetworkXGraphs.PythonNetworkX
 
 Sub-module providing direct access to the Python `networkx` package.
 Use this namespace when you need raw Python networkx objects or algorithms
 that are not yet wrapped by the Julia API.
 
 # Example
 ```julia
-using NetworkX
-nx = NetworkX.PythonNetworkX.networkx
+using NetworkXGraphs
+nx = NetworkXGraphs.PythonNetworkX.networkx
 pyg = nx.complete_graph(5)
 ```
 """
@@ -49,8 +49,8 @@ Wrap an undirected Python `networkx.Graph` as a `Graphs.AbstractGraph`.
 
 # Example
 ```julia
-using NetworkX
-nx = NetworkX.PythonNetworkX.networkx
+using NetworkXGraphs
+nx = NetworkXGraphs.PythonNetworkX.networkx
 pyg = nx.path_graph(5)
 gw = NetworkXGraph(pyg)
 ```
@@ -69,8 +69,8 @@ Wrap a directed Python `networkx.DiGraph` as a `Graphs.AbstractGraph`.
 
 # Example
 ```julia
-using NetworkX
-nx = NetworkX.PythonNetworkX.networkx
+using NetworkXGraphs
+nx = NetworkXGraphs.PythonNetworkX.networkx
 pyg = nx.DiGraph()
 pyg.add_edges_from([(1, 2), (2, 3)])
 gw = NetworkXDiGraph(pyg)
@@ -281,4 +281,4 @@ function Base.reverse(g::NetworkXDiGraph{T}) where {T<:Integer}
 	return reversed
 end
 
-end # module NetworkX
+end # module NetworkXGraphs

test/Project.toml

@@ -2,6 +2,6 @@
 Graphs = "86223c79-3864-5bf0-83f7-82e725a168b6"
 GraphsInterfaceChecker = "3bef136c-15ff-4091-acbb-1a4aafe67608"
 Interfaces = "85a1e053-f937-4924-92a5-1367d23b7b87"
-NetworkX = "7cfbcbcf-cd41-4fe6-b90f-527da21b4c9a"
+NetworkXGraphs = "7cfbcbcf-cd41-4fe6-b90f-527da21b4c9a"
 PythonCall = "6099a3de-0909-46bc-b1f4-468b9a2dfc0d"
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"

test/runtests.jl

@@ -4,11 +4,11 @@ using Base.Threads: nthreads
 using Graphs
 using GraphsInterfaceChecker
 using Interfaces
-using NetworkX
+using NetworkXGraphs
 using PythonCall
 
-@testset "NetworkX.jl" begin
-    nx = NetworkX.PythonNetworkX.networkx
+@testset "NetworkXGraphs.jl" begin
+    nx = NetworkXGraphs.PythonNetworkX.networkx
 
     @testset "Constructors and basic API" begin
         pyg = nx.Graph()

test_out.txt

@@ -0,0 +1,248 @@
+    Updating registry at `~/.julia/registries/General.toml`
+    Updating `~/Documents/NetworkX.jl/Project.toml`
+  [992eb4ea] + CondaPkg v0.2.34
+  [86223c79] + Graphs v1.14.0
+  [6099a3de] + PythonCall v0.9.31
+    Updating `~/Documents/NetworkX.jl/Manifest.toml`
+  [ec485272] + ArnoldiMethod v0.4.0
+  [992eb4ea] + CondaPkg v0.2.34
+  [9a962f9c] + DataAPI v1.16.0
+  [864edb3b] + DataStructures v0.19.4
+  [e2d170a0] + DataValueInterfaces v1.0.0
+  [86223c79] + Graphs v1.14.0
+  [d25df0c9] + Inflate v0.1.5
+  [82899510] + IteratorInterfaceExtensions v1.0.0
+  [692b3bcd] + JLLWrappers v1.7.1
+  [682c06a0] + JSON v1.5.1
+  [1914dd2f] + MacroTools v0.5.16
+  [0b3b1443] + MicroMamba v0.1.15
+  [bac558e1] + OrderedCollections v1.8.1
+  [69de0a69] + Parsers v2.8.4
+  [fa939f87] + Pidfile v1.3.0
+  [aea7be01] + PrecompileTools v1.3.3
+  [21216c6a] + Preferences v1.5.2
+  [6099a3de] + PythonCall v0.9.31
+  [6c6a2e73] + Scratch v1.3.0
+  [699a6c99] + SimpleTraits v0.9.5
+  [90137ffa] + StaticArrays v1.9.18
+  [1e83bf80] + StaticArraysCore v1.4.4
+  [10745b16] + Statistics v1.11.1
+  [ec057cc2] + StructUtils v2.8.0
+  [3783bdb8] + TableTraits v1.0.1
+  [bd369af6] + Tables v1.12.1
+  [e17b2a0c] + UnsafePointers v1.0.0
+  [f8abcde7] + micromamba_jll v2.3.1+0
+  [4d7b5844] + pixi_jll v0.41.3+0
+  [0dad84c5] + ArgTools v1.1.2
+  [56f22d72] + Artifacts v1.11.0
+  [2a0f44e3] + Base64 v1.11.0
+  [ade2ca70] + Dates v1.11.0
+  [f43a241f] + Downloads v1.7.0
+  [7b1f6079] + FileWatching v1.11.0
+  [b77e0a4c] + InteractiveUtils v1.11.0
+  [ac6e5ff7] + JuliaSyntaxHighlighting v1.12.0
+  [4af54fe1] + LazyArtifacts v1.11.0
+  [b27032c2] + LibCURL v0.6.4
+  [76f85450] + LibGit2 v1.11.0
+  [8f399da3] + Libdl v1.11.0
+  [37e2e46d] + LinearAlgebra v1.12.0
+  [56ddb016] + Logging v1.11.0
+  [d6f4376e] + Markdown v1.11.0
+  [ca575930] + NetworkOptions v1.3.0
+  [44cfe95a] + Pkg v1.12.1
+  [de0858da] + Printf v1.11.0
+  [9a3f8284] + Random v1.11.0
+  [ea8e919c] + SHA v0.7.0
+  [9e88b42a] + Serialization v1.11.0
+  [2f01184e] + SparseArrays v1.12.0
+  [f489334b] + StyledStrings v1.11.0
+  [fa267f1f] + TOML v1.0.3
+  [a4e569a6] + Tar v1.10.0
+  [8dfed614] + Test v1.11.0
+  [cf7118a7] + UUIDs v1.11.0
+  [4ec0a83e] + Unicode v1.11.0
+  [e66e0078] + CompilerSupportLibraries_jll v1.3.0+1
+  [deac9b47] + LibCURL_jll v8.15.0+0
+  [e37daf67] + LibGit2_jll v1.9.0+0
+  [29816b5a] + LibSSH2_jll v1.11.3+1
+  [14a3606d] + MozillaCACerts_jll v2025.5.20
+  [4536629a] + OpenBLAS_jll v0.3.29+0
+  [458c3c95] + OpenSSL_jll v3.5.4+0
+  [bea87d4a] + SuiteSparse_jll v7.8.3+2
+  [83775a58] + Zlib_jll v1.3.1+2
+  [8e850b90] + libblastrampoline_jll v5.15.0+0
+  [8e850ede] + nghttp2_jll v1.64.0+1
+  [3f19e933] + p7zip_jll v17.7.0+0
+     Testing NetworkXGraphs
+      Status `/tmp/jl_tKQl1D/Project.toml`
+  [86223c79] Graphs v1.14.0
+  [3bef136c] GraphsInterfaceChecker v0.1.0
+  [85a1e053] Interfaces v0.3.2
+  [7cfbcbcf] NetworkXGraphs v0.1.0 `~/Documents/NetworkX.jl`
+  [6099a3de] PythonCall v0.9.31
+  [8dfed614] Test v1.11.0
+      Status `/tmp/jl_tKQl1D/Manifest.toml`
+  [ec485272] ArnoldiMethod v0.4.0
+  [992eb4ea] CondaPkg v0.2.34
+  [9a962f9c] DataAPI v1.16.0
+  [864edb3b] DataStructures v0.19.4
+  [e2d170a0] DataValueInterfaces v1.0.0
+  [86223c79] Graphs v1.14.0
+  [3bef136c] GraphsInterfaceChecker v0.1.0
+  [d25df0c9] Inflate v0.1.5
+  [85a1e053] Interfaces v0.3.2
+  [82899510] IteratorInterfaceExtensions v1.0.0
+  [692b3bcd] JLLWrappers v1.7.1
+  [682c06a0] JSON v1.5.1
+  [1914dd2f] MacroTools v0.5.16
+  [0b3b1443] MicroMamba v0.1.15
+  [7cfbcbcf] NetworkXGraphs v0.1.0 `~/Documents/NetworkX.jl`
+  [bac558e1] OrderedCollections v1.8.1
+  [69de0a69] Parsers v2.8.4
+  [fa939f87] Pidfile v1.3.0
+  [aea7be01] PrecompileTools v1.3.3
+  [21216c6a] Preferences v1.5.2
+  [6099a3de] PythonCall v0.9.31
+  [6c6a2e73] Scratch v1.3.0
+  [699a6c99] SimpleTraits v0.9.5
+  [90137ffa] StaticArrays v1.9.18
+  [1e83bf80] StaticArraysCore v1.4.4
+  [10745b16] Statistics v1.11.1
+  [ec057cc2] StructUtils v2.8.0
+  [3783bdb8] TableTraits v1.0.1
+  [bd369af6] Tables v1.12.1
+  [e17b2a0c] UnsafePointers v1.0.0
+  [f8abcde7] micromamba_jll v2.3.1+0
+  [4d7b5844] pixi_jll v0.41.3+0
+  [0dad84c5] ArgTools v1.1.2
+  [56f22d72] Artifacts v1.11.0
+  [2a0f44e3] Base64 v1.11.0
+  [ade2ca70] Dates v1.11.0
+  [f43a241f] Downloads v1.7.0
+  [7b1f6079] FileWatching v1.11.0
+  [b77e0a4c] InteractiveUtils v1.11.0
+  [ac6e5ff7] JuliaSyntaxHighlighting v1.12.0
+  [4af54fe1] LazyArtifacts v1.11.0
+  [b27032c2] LibCURL v0.6.4
+  [76f85450] LibGit2 v1.11.0
+  [8f399da3] Libdl v1.11.0
+  [37e2e46d] LinearAlgebra v1.12.0
+  [56ddb016] Logging v1.11.0
+  [d6f4376e] Markdown v1.11.0
+  [ca575930] NetworkOptions v1.3.0
+  [44cfe95a] Pkg v1.12.1
+  [de0858da] Printf v1.11.0
+  [9a3f8284] Random v1.11.0
+  [ea8e919c] SHA v0.7.0
+  [9e88b42a] Serialization v1.11.0
+  [2f01184e] SparseArrays v1.12.0
+  [f489334b] StyledStrings v1.11.0
+  [fa267f1f] TOML v1.0.3
+  [a4e569a6] Tar v1.10.0
+  [8dfed614] Test v1.11.0
+  [cf7118a7] UUIDs v1.11.0
+  [4ec0a83e] Unicode v1.11.0
+  [e66e0078] CompilerSupportLibraries_jll v1.3.0+1
+  [deac9b47] LibCURL_jll v8.15.0+0
+  [e37daf67] LibGit2_jll v1.9.0+0
+  [29816b5a] LibSSH2_jll v1.11.3+1
+  [14a3606d] MozillaCACerts_jll v2025.5.20
+  [4536629a] OpenBLAS_jll v0.3.29+0
+  [458c3c95] OpenSSL_jll v3.5.4+0
+  [bea87d4a] SuiteSparse_jll v7.8.3+2
+  [83775a58] Zlib_jll v1.3.1+2
+  [8e850b90] libblastrampoline_jll v5.15.0+0
+  [8e850ede] nghttp2_jll v1.64.0+1
+  [3f19e933] p7zip_jll v17.7.0+0
+Precompiling for configuration --code-coverage=none --color=auto --check-bounds=yes --warn-overwrite=yes --depwarn=yes --inline=yes --startup-file=no --track-allocation=none
+  19676.9 ms  ✓ NetworkXGraphs
+  1 dependency successfully precompiled in 20 seconds. 67 already precompiled.
+  1 dependency had output during precompilation:
+┌ NetworkXGraphs
+│  CondaPkg Found dependencies: /home/jash/.julia/packages/PythonCall/83z4q/CondaPkg.toml
+│      CondaPkg Found dependencies: /home/jash/.julia/packages/CondaPkg/8GjrP/CondaPkg.toml
+│      CondaPkg Found dev dependencies: /home/jash/Documents/NetworkX.jl/CondaPkg.toml
+│      CondaPkg Resolving changes
+│               + libstdcxx
+│               + libstdcxx-ng
+│               + networkx
+│               + openssl
+│               + python
+│      CondaPkg Initialising pixi
+│               │ /home/jash/.julia/artifacts/cefba4912c2b400756d043a2563ef77a0088866b/bin/pixi
+│               │ init
+│               │ --format pixi
+│               └ /tmp/jl_tKQl1D/.CondaPkg
+│  ✔ Created /tmp/jl_tKQl1D/.CondaPkg/pixi.toml
+│      CondaPkg Wrote /tmp/jl_tKQl1D/.CondaPkg/pixi.toml
+│               │ [dependencies]
+│               │ openssl = ">=3, <3.6"
+│               │ libstdcxx = ">=3.4,<15.0"
+│               │ libstdcxx-ng = ">=3.4,<15.0"
+│               │ networkx = "*"
+│               │ 
+│               │     [dependencies.python]
+│               │     channel = "conda-forge"
+│               │     build = "*cp*"
+│               │     version = ">=3.10,!=3.14.0,!=3.14.1,<4"
+│               │ 
+│               │ [project]
+│               │ name = ".CondaPkg"
+│               │ platforms = ["linux-64"]
+│               │ channels = ["conda-forge"]
+│               │ channel-priority = "strict"
+│               └ description = "automatically generated by CondaPkg.jl"
+│      CondaPkg Installing packages
+│               │ /home/jash/.julia/artifacts/cefba4912c2b400756d043a2563ef77a0088866b/bin/pixi
+│               │ install
+│               └ --manifest-path /tmp/jl_tKQl1D/.CondaPkg/pixi.toml
+│  ✔ The default environment has been installed.
+└  
+     Testing Running tests...
+
+Testing AbstractGraphInterface is implemented for NetworkXGraph
+
+Mandatory components
+is_directed: (`is_directed` outputs a boolean [true, true])
+edgetype: (`edgetype` outputs a type [true, true])
+vertices: (`vertices` is coherent with `eltype` [true, true],
+           every vertex in `vertices(g)` exists [true, true],
+           vertices beyond `vertices(g)` don't exist [true, true])
+edges: (`edges` is coherent with `edgetype` [true, true],
+        every edge in `edges` exists [true, true],
+        `edges` are symmetric for undirected graphs [true, true])
+nv: (`nv` outputs an integer` [true, true],
+     `nv` is coherent with `vertices` [true, true])
+ne: (`ne` outputs an integer` [true, true],
+     `ne` is coherent with `edges` [true, true])
+neighbors: (`inneighbors` is coherent with `has_edge` [true, true],
+            `outneighbors` is coherent with `has_edge` [true, true],
+            `inneighbors` and `outneighbors` coincide for undirected graphs [true, true])
+weights: (`weights` outputs a matrix of real numbers [true, true],
+          `weights` has the right size [true, true],
+          `weights` are symmetric for undirected graphs [true, true])
+
+Testing AbstractGraphInterface is implemented for NetworkXDiGraph
+
+Mandatory components
+is_directed: (`is_directed` outputs a boolean [true, true])
+edgetype: (`edgetype` outputs a type [true, true])
+vertices: (`vertices` is coherent with `eltype` [true, true],
+           every vertex in `vertices(g)` exists [true, true],
+           vertices beyond `vertices(g)` don't exist [true, true])
+edges: (`edges` is coherent with `edgetype` [true, true],
+        every edge in `edges` exists [true, true],
+        `edges` are symmetric for undirected graphs [true, true])
+nv: (`nv` outputs an integer` [true, true],
+     `nv` is coherent with `vertices` [true, true])
+ne: (`ne` outputs an integer` [true, true],
+     `ne` is coherent with `edges` [true, true])
+neighbors: (`inneighbors` is coherent with `has_edge` [true, true],
+            `outneighbors` is coherent with `has_edge` [true, true],
+            `inneighbors` and `outneighbors` coincide for undirected graphs [true, true])
+weights: (`weights` outputs a matrix of real numbers [true, true],
+          `weights` has the right size [true, true],
+          `weights` are symmetric for undirected graphs [true, true])
+Test Summary:     | Pass  Total   Time
+NetworkXGraphs.jl |   38     38  11.5s
+     Testing NetworkXGraphs tests passed