Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Python implementation of a edges, vertices, and graphs

Project Description

A Python implementation of edges, vertices, and graphs


There are two types of each object: Undirected and Directed.

To begin, import one of the graph classes:

from graphpy.graph import UndirectedGraph

and create a graph from a dictionary of vertex vals:

# graph with vertices 'v0' and 'v1', with an edge between them

g = UndirectedGraph.from_dict({'v0': [('v1',)],
                               'v1': []})

or from a list of vertices and a list of edges:

g = UndirectedGraph.from_lists([('v0',), ('v1',)],
                               [('v0', 'v1')])

You can also initialize a graph, then add vertices and edges:

g = UndirectedGraph()

g.add_edge(('v0', 'v1'))

A vertex’s val can be any hashable object, like a string, int, tuple, etc.:

# graph with vertices 'v0', 1, and (2, 2), with some edges

g = UndirectedGraph.from_dict({'v0': [(1,)],
                               1: [('v0',), ((2, 2),)],
                               (2, 2): [(1,)]})

Retrieve vertex and edge objects:

# v is an UndirectedVertex object, and e is an UndirectedEdge object

v = g.get_vertex('v0')

e = g.get_edge(('v0', 'v1'))
print e.vertices

Iterate through a graph’s vertices:

for v in g:
    print v

Perform graph algorithms, such as search:

paths ='v0', method='depth_first')
print paths

Create graphs with vertices and edges that have whatever attributes you want (for example, edge weights):

g = UndirectedGraph.from_lists([('v0', {'city': 'Paris'}), ('v1', {'city': 'London'})],
                               [('v0', 'v1', {'weight': 5})])

>From there, use graphs to model situations, implement more graph algorithms, and whatever else you desire. And, as always, have fun!

(The tests found on Github at give many more examples and showcase the rest of the library’s functionality.)


Find the full documentation at:


If you don’t have pip, get pip at:

Run the command pip install graphpy in your terminal to get the graphpy library.

To test your installation, start a Python interpreter with the python command in your terminal and make sure you can run import graphpy in it without getting an error.


Find the code on Github at:


Contact me (Tyler Singer-Clark) at with any questions or concerns.


The project is licensed under the MIT license.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
graphpy-1.1.0-py2-none-any.whl (21.0 kB) Copy SHA256 Checksum SHA256 py2 Wheel Nov 10, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting