luci-py: Tools for working with BSD style ar archives.

client/libs/ar/__init__.py

Index: client/libs/ar/__init__.py
diff --git a/client/libs/ar/__init__.py b/client/libs/ar/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c1bd1b9a86371c940633f580e95dcc3cf421c36
--- /dev/null
+++ b/client/libs/ar/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 The LUCI Authors. All rights reserved.
+# Use of this source code is governed under the Apache License, Version 2.0
+# that can be found in the LICENSE file.
+
+"""
+Implements access to ar archives. ar is probably the simplest format that
+standard tools under Linux support.
+
+The base ar format only supports files which are 16 characters long. There
+are multiple methods for supporting longer file names.
+
+This package only supports the "BSD variant" as the filename is stored allow
+"streaming" support (rather than the Sys V / GNU variant which requires
+building a symbol table).
+
+References:
+* https://en.wikipedia.org/wiki/Ar_(Unix)
+"""
+
+from .reader import ArDefaultReader
+from .writer import ArWriter, ArDefaultWriter
+__all__ = ['ArDefaultReader', 'ArWriter', 'ArDefaultWriter']

[M-A Ruel, 2016/06/14 13:26:16]

Ar prefix is not really needed. I don't think we need to export ArWriter.

[mithro, 2016/06/16 11:37:11]

This duplication is pretty normal in Python (IE tarfile.TarInfo) as you often do
a "from ar import ArWriter"