From ba975a8687189c1c533a5004efd1d919287976f7 Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Tue, 2 Mar 2010 20:51:52 +0000
Subject: [PATCH] Move portage.flatten to portage.dep.flatten. (trunk r15413)

svn path=/main/branches/2.1.7/; revision=15635
---
 pym/portage/__init__.py | 13 +------------
 pym/portage/dep.py      | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+), 12 deletions(-)

diff --git a/pym/portage/__init__.py b/pym/portage/__init__.py
index e9adceba9..e311c9db8 100644
--- a/pym/portage/__init__.py
+++ b/pym/portage/__init__.py
@@ -85,7 +85,7 @@ try:
 			'uid,userland,userpriv_groups,wheelgid',
 		'portage.dep',
 		'portage.dep:best_match_to_list,dep_getcpv,dep_getkey,' + \
-			'get_operator,isjustname,isspecific,isvalidatom,' + \
+			'flatten,get_operator,isjustname,isspecific,isvalidatom,' + \
 			'match_from_list,match_to_list',
 		'portage.eclass_cache',
 		'portage.env.loaders',
@@ -673,17 +673,6 @@ def listdir(mypath, recursive=False, filesonly=False, ignorecvs=False, ignorelis
 
 	return rlist
 
-def flatten(mytokens):
-	"""this function now turns a [1,[2,3]] list into
-	a [1,2,3] list and returns it."""
-	newlist=[]
-	for x in mytokens:
-		if isinstance(x, list):
-			newlist.extend(flatten(x))
-		else:
-			newlist.append(x)
-	return newlist
-
 #beautiful directed graph object
 
 class digraph(object):
diff --git a/pym/portage/dep.py b/pym/portage/dep.py
index e2eeb6d5b..282fe749d 100644
--- a/pym/portage/dep.py
+++ b/pym/portage/dep.py
@@ -3,6 +3,16 @@
 # Distributed under the terms of the GNU General Public License v2
 # $Id$
 
+__all__ = [
+	'Atom', 'best_match_to_list', 'cpvequal',
+	'dep_getcpv', 'dep_getkey', 'dep_getslot',
+	'dep_getusedeps', 'dep_opconvert', 'flatten',
+	'get_operator', 'isjustname', 'isspecific',
+	'isvalidatom', 'match_from_list', 'match_to_list',
+	'paren_enclose', 'paren_normalize', 'paren_reduce',
+	'remove_slot', 'strip_empty', 'use_reduce'
+]
+
 # DEPEND SYNTAX:
 #
 # 'use?' only affects the immediately following word!
@@ -343,6 +353,28 @@ def dep_opconvert(deplist):
 		x += 1
 	return retlist
 
+def flatten(mylist):
+	"""
+	Recursively traverse nested lists and return a single list containing
+	all non-list elements that are found.
+
+	Example usage:
+		>>> flatten([1, [2, 3, [4]]])
+		[1, 2, 3, 4]
+
+	@param mylist: A list containing nested lists and non-list elements.
+	@type mylist: List
+	@rtype: List
+	@return: A single list containing only non-list elements.
+	"""
+	newlist = []
+	for x in mylist:
+		if isinstance(x, list):
+			newlist.extend(flatten(x))
+		else:
+			newlist.append(x)
+	return newlist
+
 class _use_dep(object):
 
 	__slots__ = ("__weakref__", "conditional",
-- 
2.26.2