pyfilesysobjects 00.01.013

The 'pyfilesysobjects' package provides utilities for usage of the filesystem as a class tree containing files as objects. The package also contains 'normpathX' as replacement for 'os.path.normpath'.

The ‘filesysobjects’ package provides utilities for the application of basic object oriented features onto filesystems. This includes basic coverage of the ‘inspect’ package for the simplified gathering of information on packages, modules, and files.

The provided feature modules comprise the following list. For code examples refer to ‘filesysobjects.UseCases’.

The package ‘filesysobjects’ is a spin off from the project ‘UnifiedSessionsManager-2.0’, see ‘https://sourceforge.net/projects/ctys/’.

The main interface classes are:

• FileSysObjects - Filesystem objects.

For UseCases refer to subdirectory:

• UseCases

Downloads:

• Sourceforge.net: https://sourceforge.net/projects/pyfilesysobjetcs/files/

• Sourceforge.net: https://sourceforge.net/projects/pyfilesysobjects/files/

• Github: https://github.com/ArnoCan/pyfilesysobjects/

Online documentation:

• https://pypi.python.org/pypi/pyfilesysobjects/

• https://pythonhosted.org/pyfilesysobjects/

setup.py

The installer adds a few options to the standard setuptools options.

• build_sphinx: Creates documentation for runtime system by Sphinx, html only. Calls ‘callDocSphinx.sh’.

• build_epydoc: Creates documentation for runtime system by Epydoc, html only. Calls ‘callDocEpydoc.sh’.

• instal_doc: Install a local copy of the previously build documents in accordance to PEP-370.

• test: Runs PyUnit tests by discovery.

• –help-filesysobjects: Displays this help.

• –no-install-required: Suppresses installation dependency checks, requires appropriate PYTHONPATH.

• –offline: Sets online dependencies to offline, or ignores online dependencies.

• –exit: Exit ‘setup.py’.

After successful installation the ‘selftest’ verifies basic checks by:

filesysobjects –selftest

with the exit value ‘0’ when OK.

The option ‘-v’ raises the degree of verbosity for inspection

filesysobjects –selftest -v -v -v -v

Project Data

• PROJECT: ‘filesysobjects’

• MISSION: Extend the standard PyUnit package for arbitrary ExecUnits.

• VERSION: 00.01

• RELEASE: 00.01.013

• NICKNAME: ‘Yggdrasil’

• STATUS: alpha

• AUTHOR: Arno-Can Uestuensoez

• COPYRIGHT: Copyright (C) 2010,2011,2015-2016 Arno-Can Uestuensoez @Ingenieurbuero Arno-Can Uestuensoez

• LICENSE: Artistic-License-2.0 + Forced-Fairplay-Constraints Refer to enclose documents:

  • ArtisticLicense20.html - for base license: Artistic-License-2.0

  • licenses-amendments.txt - for amendments: Forced-Fairplay-Constraints

VERSIONS and RELEASES

Planned Releases:

• RELEASE: 00.00.00x - Pre-Alpha: Extraction of the features from hard-coded application into a reusable package.

• RELEASE: 00.01.00x - Alpha: Completion of basic features.

• RELEASE: 00.02.00x - Alpha: Completion of features, stable interface.

• RELEASE: 00.03.00x - Beta: Accomplish test cases for medium to high complexity.

• RELEASE: 00.04.00x - Production: First production release. Estimated number of UnitTests := 1250.

• RELEASE: 00.05.00x - Production: Various performance enhancements.

• RELEASE: 00.06.00x - Production: Security review.

• RELEASE: > - Production: Stable and compatible continued development.

Current Release: 00.01.013 - Alpha:

OS-Support - Tested by PyUnit/Eclipse with Success:

• Linux: Fedora - others should work, ToDo: CentOS, Debian, and SuSE

• Windows: Win7 - others see Cygwin

• Mac-OS: Snow Leopard - others should work - the last changes are not yet tested on Mac-OS

• Cygwin: 2.874/64 bit

OS-Support - ToDo: Going to follow soon.

• BSD: ToDo: OpenBSD, FreeBSD - others should work

• UNIX: ToDo: Solaris-11 - should work

• Windows: Win10

Python support: 2.6, and 2.7

Major Changes:

• Minor fixes.

• Documentation enhancements.

ToDo:

• Full scale UNC

• Fix bugs in SMB share conversion

• Test for remote and autonomous operations on arbitrary filesystems

Known Issues:

• Some minor failures of units, 1 on MacOS, will be fixed for a.s.a.p.

• Mixed types of os.path.sep with multiple groups of each: Escape to target, but does not clean all redundant.

Current test status:

• UnitTests: >1000

• Use-Cases as UnitTests: >120

Total: >1100

nn