#!/usr/bin/env python
"""
Generic stack type for Python.
Copyright (C) Sarah Mount, 2010.
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have rceeived a copy of the GNU General Public License
along with this program. If not, see .
"""
__all__ = ['Stack']
class Stack:
def __init__(self):
self.__stack = []
return
def push(self, value):
self.__stack.append(value)
return
def pop(self):
assert(len(self.__stack) > 0)
return self.__stack.pop()
def peek(self):
assert(len(self.__stack) > 0)
return self.__stack[len(self.__stack) - 1]
def issubset(self, other):
"""Determine whether other stack is a subset of this one.
Order matters.
"""
size = min(len(self.__stack), len(other))
for i in range(size):
if not self.__stack[i] == other[i]:
return False
return True
def __contains__(self, item):
return item in self.__stack
def __len__(self):
return len(self.__stack)
def __getitem__(self, index):
return self.__stack[index]
def __iter__(self):
return self.__stack.__iter__()
def __repr__(self):
return self.__stack.__repr__()
def __str__(self):
return self.__stack.__str__()