Repository files navigation

Pyerarchy is a Python package for easy file system surfing and manipulation. It enables to interact with the file systemdirectly as Python objects without making implicit calls toos package. Finally it makes the code much more readableand nice.

The central point of Pyerarchy is the Node. The basic usage starts by initializing an entry point Node and manipulatingit further:

node = Node('entry/point/path')  # Initialize a new nodechildren = node.ls()  # List all child entities of the nodenode.mkdir('newdir').mkdir('anotherdir')  # Create a new directory under node, and another one under the new one :)# Now access the newly created directoriesanotherdir = node/'newdir'/'anotherdir'  # This is the most common way to access nodeschildren = node.newdir.anotherdir.ls()  # This method can be used to invoke an operation on the result node# What about files?myfile = node.myfile# And even...myfile = node.myfile.open('w')# Or...contents = node.myfile.read()  # ...which handles everything# What if the filename contains a dot, dash, etc?# Well...myfile_node = node/'filename.with.dots-and-dashes'# And then do your stuff on myfile_nodewith myfile_node.open('r') as f:    ...# Or again...contents = myfile_node.read()# And finally, just iterate...for child in node    # The child is also a Node object    ...

Another useful feature of Pyerarchy is very handy in Python modules to interact with static files included in the module:

static_data_node = ThisModuleNode()/'path/to/the/static/data/relative/to/module'some_file_node = static_data_node/'some/static/text/file'contents = some_file_node.read()