using functions and file renaming problem

Re: using functions and file renaming problem

[email protected] (Bengt Richter) wrote in message[color=blue]
> This looks like an old post that ignores some responses you got to your original post like this.
> Did some mail get lost? Or was this an accidental repost of something old? I still see
> indentation misalignments, probably due to mixing tabs and spaces (bad news in python ;-)
>
> Regards,
> Bengt Richter[/color]

Sorry Bengt, I overlooked some responses to an earlier, similar
question. I have too many computers in too many places, so forgive me.
Thanks for taking the time to tell me again!!! I'll clean up the
indentation... I promise.

Re: using functions and file renaming problem

On Friday 18 Jul 2003 2:33 am, hokiegal99 wrote:[color=blue]
> A few questions about the following code. How would I "wrap" this in a
> function, and do I need to?
>
> Also, how can I make the code smart enough to realize that when a file
> has 2 or more bad charcters in it, that the code needs to run until all
> bad characters are gone?[/color]

It almost is ;-)
[color=blue]
> For example, if a file has the name
> "<bad*mac\f ile" the program has to run 3 times to get all three bad
> chars out of the file name.
>
> The passes look like this:
>
> 1. <bad*mac\file becomes -bad*mac\file
> 2. -bad*mac\file becomes -bad-mac\file
> 3. -bad-mac\file becomes -bad-mac-file
>
> I think the problem is that once the program finds a bad char in a
> filename it replaces it with a dash, which creates a new filename that
> wasn't present when the program first ran, thus it has to run again to
> see the new filename.[/color]

No, the problem is that you're throwing away all but the last correction.
Read my comments below:

import os, re, string
bad = re.compile(r'%2 f|%25|[*?<>/\|\\]') #search for these.
print " "
setpath = raw_input("Path to the dir that you would like to clean: ")
print " "
print "--- Remove Bad Charaters From Filenames ---"
print " "
for root, dirs, files in os.walk(setpath ):
for file in files:
badchars = bad.findall(fil e) # find any bad characters
newfile = file
for badchar in badchars: # loop through each character in badchars
# note that if badchars is empty, this loop is not entered
# show whats happening
print "replacing",bad char,"in",newfi le,":",
# replace all occurrences of this badchar with '-' and remember
# it for next iteration of loop:
newfile = newfile.replace (badchar,'-') #replace bad chars.
print newfile
if badchars: # were there any bad characters in the name?
newpath = os.path.join(ro ot,newfile)
oldpath = os.path.join(ro ot,file)
os.rename(oldpa th,newpath)
print oldpath
print newpath
print " "
print "--- Done ---"
print " "


wrt wrapping it up in a function, here's a starter for you... "fill in the
blanks":


-------8<-----------
def cleanup(setpath ):
# compile regex for finding bad characters

# walk directory tree...

# find any bad characters

# loop through each character in badchars

# replace all occurrences of this badchar with '-' and remember

# were there any bad characters in the name?

-------8<-----------

To call this you could do (on linux - mac paths are different):

-------8<-----------
cleanup("/home/andy/Python")
-------8<-----------

hope that helps
-andyj

Re: using functions and file renaming problem

On Friday 18 Jul 2003 11:16 pm, hokiegal99 wrote:[color=blue]
> Thanks again for the help Andy! One last question: What is the advantage
> of placing code in a function? I don't see how having this bit of code
> in a function improves it any. Could someone explain this?
>
> Thanks![/color]
8<--- (old quotes)

The 'benefit' of functions is only really reaped when you have a specificneed
for them! You don't *have* to use them if you don't *need* to (but they can
still improve the readability of your code).

Consider the following contrived example:

----------8<------------
# somewhere in the dark recesses of a large project...
. . .
for filename in os.listdir(cfg. userdir):
newname = filename
for ch in cfg.badchars:
newname.replace (ch,"-")
if newname != filename:
os.rename(os.pa th.join(cfg.use rdir,filename),
os.path.join(cf g.userdir,newna me)
. . .
. . .
# in another dark corner...

. . .
for filename in os.listdir(cfg. tempdir):
newname = filename
for ch in cfg.badchars:
newname.replace (ch,"-")
if newname != filename:
os.rename(os.pa th.join(cfg.use rdir,filename),
os.path.join(cf g.userdir,newna me)
. . .
# somewhere else...

. . .
for filename in os.listdir(cfg. extradir):
newname = filename
for ch in cfg.badchars:
newname.replace (ch,"-")
if newname != filename:
os.rename(os.pa th.join(cfg.use rdir,filename),
os.path.join(cf g.userdir,newna me)
. . .
----------8<------------

See the repetition? ;-)

Imagine a situation where you need to do something far more complicated over,
and over again... It's not very programmer efficient, and it makes the code
longer, too - thus costing more to write (time) and more to store (disks).

Imagine having to change the behaviour of this 'hard-coded' routine, and what
would happen if you missed one... however, if it is in a function, you only
have *one* place to change it.

When we generalise the algorithm and put it into a function we can do:

----------8<------------

. . .
. . .

# somewhere near the top of the project code...
def cleanup_filenam es(dir):

""" renames any files within dir that contain bad characters
(ie. ones in cfg.badchars). Does not walk the directory tree.
"""

for filename in os.listdir(dir) :
newname = filename
for ch in cfg.badchars:
newname.replace (ch,"-")
if newname != filename:
os.rename(os.pa th.join(cfg.use rdir,filename),
os.path.join(cf g.userdir,newna me)

. . .
. . .

# somewhere in the dark recesses of a large project...
. . .
cleanup_filenam es(cfg.userdir)
. . .
. . .
# in another dark corner...
. . .
cleanup_filenam es(cfg.tempdir)
. . .
# somewhere else...
. . .
cleanup_filenam es(cfg.extradir )
. . .

----------8<------------

Even in this small, contrived example, we've saved about 13 lines of code(ok,
that's notwithstanding the blank lines and the """ docstring """ at the top
of the function).

There's another twist, too. In the docstring for cleanup_filenam es it says
"Does not walk the directory tree." because we didn't code it to deal with
subdirectories. But we could, without using os.walk...

Directories form a tree structure, and the easiest way to process trees is by
using /recursion/, which means functions that call themselves. An old
programmer's joke is this:

Recursion, defn. [if not understood] see Recursion.

Each time you call a function, it gets a brand new environment, called the
'local scope'. All variables inside this scope are private; they may have
the same names, but they refer to different objects. This can be really
handy...

----------8<------------

def cleanup_filenam es(dir):

""" renames any files within dir that contain bad characters
(ie. ones in cfg.badchars). Walks the directory tree to process
subdirectories.
"""

for filename in os.listdir(dir) :
newname = filename
for ch in cfg.badchars:
newname.replace (ch,"-")
if newname != filename:
os.rename(os.pa th.join(cfg.use rdir,filename),
os.path.join(cf g.userdir,newna me)
# recurse if subdirectory...
if os.path.isdir(o s.path.join(cfg .userdir,newnam e)):
cleanup_filenam es(os.path.join (cfg.userdir,ne wname))

----------8<------------

This version *DOES* deal with subdirectories. .. with only two extra lines,
too! Trying to write this without recursion would be a nightmare (even in
Python).

A very important thing to note, however, is that there is a HARD LIMIT onthe
number of times a function can call itself, called the RecursionLimit:

----------8<------------[color=blue][color=green][color=darkred]
>>>n=1
>>>def rec():[/color][/color][/color]
n=n+1
rec()
[color=blue][color=green][color=darkred]
>>>rec()[/color][/color][/color]
. . .
(huge traceback list)
. . .
RuntimeError: maximum recursion limit reached.[color=blue][color=green][color=darkred]
>>>n[/color][/color][/color]
991
----------8<------------

Another very important thing about recursion is that a recursive function
should *ALWAYS* have a 'get-out-clause', a condition that stops the
recursion. Guess what happens if you don't have one ... ;-)

Finally (at least for now), functions also provide a way to break down your
code into logical sections. Many programmers will write the higher level
functions first, delegating 'complicated bits' to further sub-functions as
they go, and worry about implementing them once they've got the overall
algorithm finished. This allows one to concentrate on the right level of
detail, rather than getting bogged down in the finer points: you just make up
names for functions that you're *going* to implement later. Sometimes, you
might make a 'stub' like:

def doofer(dooby, doo):
pass

so that your program is /syntactically/ correct, and will run (to a certain
degree). This allows debugging to proceed before you have written
everything. You'd do this for functions which aren't *essential* to the
program, but maybe add 'special features', for example, additonal
error-checking or output formatting.

A sort of extension of the function idea is 'modules', which make functions
and other objects available to other 'client' programs. When you say:

import os

you are effectively adding all the functions and objects of the os moduleinto
your own program, without having to re-write them. This enables programmers
to share their functions and other code as convenient 'black boxes'. Modules,
however, are a slightly more advanced topic.


Hope that helps.

-andyj

Re: using functions and file renaming problem

My scripts aren't long and complex, so I don't really *need* to use
functions. But the idea of using them is appealing to me because it
seems the right thing to do from a design point of view. I can see how
larger, more complex programs would get out of hand if the programmer
did not use functions so they'd be absolutely necessary there. But if
they allow larger programs to have a better overall design that's more
compact and readable (like your examples showed) then one could argue
that they would do the same for smaller, simplier programs too.

Thanks for the indepth explanation. It was very helpful. I'm going to
try using functions within my fix_files.py script.


Andy Jewell wrote:[color=blue]
> On Friday 18 Jul 2003 11:16 pm, hokiegal99 wrote:
>[color=green]
>>Thanks again for the help Andy! One last question: What is the advantage
>>of placing code in a function? I don't see how having this bit of code
>>in a function improves it any. Could someone explain this?
>>
>>Thanks![/color]
>
> 8<--- (old quotes)
>
> The 'benefit' of functions is only really reaped when you have a specific need
> for them! You don't *have* to use them if you don't *need* to (but they can
> still improve the readability of your code).
>
> Consider the following contrived example:
>
> ----------8<------------
> # somewhere in the dark recesses of a large project...
> . . .
> for filename in os.listdir(cfg. userdir):
> newname = filename
> for ch in cfg.badchars:
> newname.replace (ch,"-")
> if newname != filename:
> os.rename(os.pa th.join(cfg.use rdir,filename),
> os.path.join(cf g.userdir,newna me)
> . . .
> . . .
> # in another dark corner...
>
> . . .
> for filename in os.listdir(cfg. tempdir):
> newname = filename
> for ch in cfg.badchars:
> newname.replace (ch,"-")
> if newname != filename:
> os.rename(os.pa th.join(cfg.use rdir,filename),
> os.path.join(cf g.userdir,newna me)
> . . .
> # somewhere else...
>
> . . .
> for filename in os.listdir(cfg. extradir):
> newname = filename
> for ch in cfg.badchars:
> newname.replace (ch,"-")
> if newname != filename:
> os.rename(os.pa th.join(cfg.use rdir,filename),
> os.path.join(cf g.userdir,newna me)
> . . .
> ----------8<------------
>
> See the repetition? ;-)
>
> Imagine a situation where you need to do something far more complicated over,
> and over again... It's not very programmer efficient, and it makes the code
> longer, too - thus costing more to write (time) and more to store (disks).
>
> Imagine having to change the behaviour of this 'hard-coded' routine, and what
> would happen if you missed one... however, if it is in a function, you only
> have *one* place to change it.
>
> When we generalise the algorithm and put it into a function we can do:
>
> ----------8<------------
>
> . . .
> . . .
>
> # somewhere near the top of the project code...
> def cleanup_filenam es(dir):
>
> """ renames any files within dir that contain bad characters
> (ie. ones in cfg.badchars). Does not walk the directory tree.
> """
>
> for filename in os.listdir(dir) :
> newname = filename
> for ch in cfg.badchars:
> newname.replace (ch,"-")
> if newname != filename:
> os.rename(os.pa th.join(cfg.use rdir,filename),
> os.path.join(cf g.userdir,newna me)
>
> . . .
> . . .
>
> # somewhere in the dark recesses of a large project...
> . . .
> cleanup_filenam es(cfg.userdir)
> . . .
> . . .
> # in another dark corner...
> . . .
> cleanup_filenam es(cfg.tempdir)
> . . .
> # somewhere else...
> . . .
> cleanup_filenam es(cfg.extradir )
> . . .
>
> ----------8<------------
>
> Even in this small, contrived example, we've saved about 13 lines of code (ok,
> that's notwithstanding the blank lines and the """ docstring """ at the top
> of the function).
>
> There's another twist, too. In the docstring for cleanup_filenam es it says
> "Does not walk the directory tree." because we didn't code it to deal with
> subdirectories. But we could, without using os.walk...
>
> Directories form a tree structure, and the easiest way to process trees is by
> using /recursion/, which means functions that call themselves. An old
> programmer's joke is this:
>
> Recursion, defn. [if not understood] see Recursion.
>
> Each time you call a function, it gets a brand new environment, called the
> 'local scope'. All variables inside this scope are private; they may have
> the same names, but they refer to different objects. This can be really
> handy...
>
> ----------8<------------
>
> def cleanup_filenam es(dir):
>
> """ renames any files within dir that contain bad characters
> (ie. ones in cfg.badchars). Walks the directory tree to process
> subdirectories.
> """
>
> for filename in os.listdir(dir) :
> newname = filename
> for ch in cfg.badchars:
> newname.replace (ch,"-")
> if newname != filename:
> os.rename(os.pa th.join(cfg.use rdir,filename),
> os.path.join(cf g.userdir,newna me)
> # recurse if subdirectory...
> if os.path.isdir(o s.path.join(cfg .userdir,newnam e)):
> cleanup_filenam es(os.path.join (cfg.userdir,ne wname))
>
> ----------8<------------
>
> This version *DOES* deal with subdirectories. .. with only two extra lines,
> too! Trying to write this without recursion would be a nightmare (even in
> Python).
>
> A very important thing to note, however, is that there is a HARD LIMIT on the
> number of times a function can call itself, called the RecursionLimit:
>
> ----------8<------------
>[color=green][color=darkred]
>>>>n=1
>>>>def rec():
>>>[/color][/color]
> n=n+1
> rec()
>
>[color=green][color=darkred]
>>>>rec()
>>>[/color][/color]
> . . .
> (huge traceback list)
> . . .
> RuntimeError: maximum recursion limit reached.
>[color=green][color=darkred]
>>>>n
>>>[/color][/color]
> 991
> ----------8<------------
>
> Another very important thing about recursion is that a recursive function
> should *ALWAYS* have a 'get-out-clause', a condition that stops the
> recursion. Guess what happens if you don't have one ... ;-)
>
> Finally (at least for now), functions also provide a way to break down your
> code into logical sections. Many programmers will write the higher level
> functions first, delegating 'complicated bits' to further sub-functions as
> they go, and worry about implementing them once they've got the overall
> algorithm finished. This allows one to concentrate on the right level of
> detail, rather than getting bogged down in the finer points: you just make up
> names for functions that you're *going* to implement later. Sometimes, you
> might make a 'stub' like:
>
> def doofer(dooby, doo):
> pass
>
> so that your program is /syntactically/ correct, and will run (to a certain
> degree). This allows debugging to proceed before you have written
> everything. You'd do this for functions which aren't *essential* to the
> program, but maybe add 'special features', for example, additonal
> error-checking or output formatting.
>
> A sort of extension of the function idea is 'modules', which make functions
> and other objects available to other 'client' programs. When you say:
>
> import os
>
> you are effectively adding all the functions and objects of the os module into
> your own program, without having to re-write them. This enables programmers
> to share their functions and other code as convenient 'black boxes'. Modules,
> however, are a slightly more advanced topic.
>
>
> Hope that helps.
>
> -andyj
>
>
>[/color]

Re: using functions and file renaming problem

hokiegal99 wrote:[color=blue]
>
> My scripts aren't long and complex, so I don't really *need* to use
> functions. But the idea of using them is appealing to me because it
> seems the right thing to do from a design point of view. I can see how
> larger, more complex programs would get out of hand if the programmer
> did not use functions so they'd be absolutely necessary there. But if
> they allow larger programs to have a better overall design that's more
> compact and readable (like your examples showed) then one could argue
> that they would do the same for smaller, simplier programs too.[/color]

Uh oh! You're being poisoned with the meme of "right design".

Don't use functions because they "seem the right thing to do", use
them because *they reduce repetition*, or simplify code by *making
it more readable*.

If you aren't reducing repetition with them you are losing the
primary benefit. If you also aren't making your code more readable,
don't use functions.

Whatever you do, don't use them just because somebody has convinced
you "they're the right thing".

-Peter