Viewing file:  ns.py (10.21 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
"""NS module -- XML Namespace constants
This module contains the definitions of namespaces (and sometimes other
URI's) used by a variety of XML standards. Each class has a short
all-uppercase name, which should follow any (emerging) convention for
how that standard is commonly used. For example, ds is almost always
used as the namespace prefixes for items in XML Signature, so DS is the
class name. Attributes within that class, all uppercase, define symbolic
names (hopefully evocative) for "constants" used in that standard.
"""
class XMLNS:
"""XMLNS, Namespaces in XML
XMLNS (14-Jan-1999) is a W3C Recommendation. It is specified in
http://www.w3.org/TR/REC-xml-names
BASE -- the basic namespace defined by the specification
XML -- the namespace for XML 1.0
HTML -- the namespace for HTML4.0
"""
BASE = "http://www.w3.org/2000/xmlns/"
XML = "http://www.w3.org/XML/1998/namespace"
HTML = "http://www.w3.org/TR/REC-html40"
class XLINK:
"""XLINK, XML Linking Language
XLink (v1.0, 27-Jun-2001) is a W3C Recommendation. It is
specified in http://www.w3.org/TR/xlink/
"""
BASE = "http://www.w3.org/1999/xlink"
class SOAP:
"""SOAP, the Simple Object Access Protocol
SOAP (v1.1, 8-May-2000) is a W3C note. It is specified in
http://www.w3.org/TR/SOAP
ENV -- namespace for the SOAP envelope
ENC -- namespace for the SOAP encoding in section 5
ACTOR_NEXT -- the URI for the "next" actor
(Note that no BASE is defined.)
"""
ENV = "http://schemas.xmlsoap.org/soap/envelope/"
ENC = "http://schemas.xmlsoap.org/soap/encoding/"
ACTOR_NEXT = "http://schemas.xmlsoap.org/soap/actor/next"
class DSIG:
"""DSIG, XML-Signature Syntax and Processing
DSIG (19-Apr-2001) is a W3C Candidate Recommendation. It is specified
in http://www.w3.org/TR/xmldsig-core/
BASE -- the basic namespace defined by the specification
DIGEST_SHA1 -- The SHA-1 digest method
DIGEST_MD2 -- The MD2 digest method
DIGEST_MD5 -- The MD5 digest method
SIG_DSA_SHA1 -- The DSA/DHA-1 signature method
SIG_RSA_SHA1 -- The RSA/DHA-1 signature method
HMAC_SHA1 -- The SHA-1 HMAC method
ENC_BASE64 -- The Base64 encoding method
ENVELOPED -- an enveloped XML signature
C14N -- XML canonicalization
C14N_COMM -- XML canonicalization, retaining comments
C14N_EXCL -- XML exclusive canonicalization
XPATH -- The identifier for an XPATH transform
XSLT -- The identifier for an XSLT transform
"""
BASE = "http://www.w3.org/2000/09/xmldsig#"
DIGEST_SHA1 = BASE + "sha1"
DIGEST_MD2 = BASE + "md2"
DIGEST_MD5 = BASE + "md5"
SIG_DSA_SHA1= BASE + "dsa-sha1"
SIG_RSA_SHA1= BASE + "rsa-sha1"
HMAC_SHA1 = BASE + "hmac-sha1"
ENC_BASE64 = BASE + "base64"
ENVELOPED = BASE + "enveloped-signature"
C14N = "http://www.w3.org/TR/2000/CR-xml-c14n-20010315"
C14N_COMM = C14N + "#WithComments"
C14N_EXCL = "http://www.w3.org/2001/10/xml-exc-c14n#"
XPATH = "http://www.w3.org/TR/1999/REC-xpath-19991116"
XSLT = "http://www.w3.org/TR/1999/REC-xslt-19991116"
class ENCRYPTION:
"""ENCRYPTION, XML-Encryption Syntax and Processing
ENCRYPTION (26-Jun-2001) is a W3C Working Draft. It is specified in
http://www.w3.org/TR/xmlenc-core/
BASE -- the basic namespace defined by the specification
BLOCK_3DES -- The triple-DES symmetric encryption method
BLOCK_AES128 -- The 128-bit AES symmetric encryption method
BLOCK_AES256 -- The 256-bit AES symmetric encryption method
BLOCK_AES192 -- The 192-bit AES symmetric encryption method
STREAM_ARCFOUR -- The ARCFOUR symmetric encryption method
KT_RSA_1_5 -- The RSA v1.5 key transport method
KT_RSA_OAEP -- The RSA OAEP key transport method
KA_DH -- The Diffie-Hellman key agreement method
WRAP_3DES -- The triple-DES symmetric key wrap method
WRAP_AES128 -- The 128-bit AES symmetric key wrap method
WRAP_AES256 -- The 256-bit AES symmetric key wrap method
WRAP_AES192 -- The 192-bit AES symmetric key wrap method
DIGEST_SHA256 -- The SHA-256 digest method
DIGEST_SHA512 -- The SHA-512 digest method
DIGEST_RIPEMD160 -- The RIPEMD-160 digest method
"""
BASE = "http://www.w3.org/2001/04/xmlenc#"
BLOCK_3DES = BASE + "des-cbc"
BLOCK_AES128 = BASE + "aes128-cbc"
BLOCK_AES256 = BASE + "aes256-cbc"
BLOCK_AES192 = BASE + "aes192-cbc"
STREAM_ARCFOUR = BASE + "arcfour"
KT_RSA_1_5 = BASE + "rsa-1_5"
KT_RSA_OAEP = BASE + "rsa-oaep-mgf1p"
KA_DH = BASE + "dh"
WRAP_3DES = BASE + "kw-3des"
WRAP_AES128 = BASE + "kw-aes128"
WRAP_AES256 = BASE + "kw-aes256"
WRAP_AES192 = BASE + "kw-aes192"
DIGEST_SHA256 = BASE + "sha256"
DIGEST_SHA512 = BASE + "sha512"
DIGEST_RIPEMD160 = BASE + "ripemd160"
class SCHEMA:
"""SCHEMA, XML Schema
XML Schema (30-Mar-2001) is a W3C candidate recommendation. It is
specified in http://www.w3.org/TR/xmlschema-1 (Structures) and
http://www.w3.org/TR/xmlschema-2 (Datatypes). Schema has been under
development for a comparitively long time, and other standards have
at times used earlier drafts. This class defines the most-used, and
sets BASE to the latest.
BASE -- the basic namespace (2001)
XSD1, XSI1 -- schema and schema-instance for 1999
XSD2, XSI2 -- schema and schema-instance for October 2000
XSD3, XSI3 -- schema and schema-instance for 2001
XSD_LIST -- a sequence of the XSDn values
XSI_LIST -- a sequence of the XSIn values
"""
XSD1 = "http://www.w3.org/1999/XMLSchema"
XSD2 = "http://www.w3.org/2000/10/XMLSchema"
XSD3 = "http://www.w3.org/2001/XMLSchema"
XSD_LIST = [ XSD1, XSD2, XSD3 ]
XSI1 = "http://www.w3.org/1999/XMLSchema-instance"
XSI2 = "http://www.w3.org/2000/10/XMLSchema-instance"
XSI3 = "http://www.w3.org/2001/XMLSchema-instance"
XSI_LIST = [ XSI1, XSI2, XSI3 ]
BASE = XSD3
class XSLT:
"""XSLT, XSL Transformations
XSLT (16-Nov-1999) is a W3C Recommendation. It is specified in
http://www.w3.org/TR/xslt/
BASE -- the basic namespace defined by this specification
"""
BASE = "http://www.w3.org/1999/XSL/Transform"
class XPATH:
"""XPATH, XML Path Language
XPATH (16-Nov-1999) is a W3C Recommendation. It is specified in
http://www.w3.org/TR/xpath. This class is currently empty.
"""
pass
class WSDL:
"""WSDL, Web Services Description Language
WSDL (V1.1, 15-Mar-2001) is a W3C Note. It is specified in
http://www.w3.org/TR/wsdl
BASE -- the basic namespace defined by this specification
BIND_SOAP -- SOAP binding for WSDL
BIND_HTTP -- HTTP GET and POST binding for WSDL
BIND_MIME -- MIME binding for WSDL
"""
BASE = "http://schemas.xmlsoap.org/wsdl/"
BIND_SOAP = BASE + "soap/"
BIND_HTTP = BASE + "http/"
BIND_MIME = BASE + "mime/"
class RNG:
"""RELAX NG, schema language for XML
RELAX NG (03-Dec-2001) is a simple schema languge for XML,
published under the auspices of OASIS. The specification, tutorial,
and other information are available from http://www.relaxng.org.
"""
BASE = "http://relaxng.org/ns/structure/1.0"
class DCMI:
"""Dublin Core Metadata Initiative
The DCMI defines a commonly-used set of general metadata elements.
There is a base set of elements, a variety of refinements of
those, a set of value encodings, and a 'type vocabulary' used to
describe what something described in metadata actually is (a text,
a physical object, a collection, etc.).
Documentation on the Dublin Core, including recommendations for
encoding Dublin Core metadata in XML and HTML/XHTML can be found
at http://dublincore.org/.
"""
# not used directly:
BASE = "http://purl.org/dc/"
# the core element set:
DCMES_1_1 = BASE + "elements/1.1/"
DCMES = DCMES_1_1
# standardized additions and refinements:
TERMS = BASE + "terms/"
# type vocabulary:
TYPE = BASE + "dcmitype/"
class _Namespace:
"""Base class for Namespace classes.
Namespace objects are a convenient way to 'spell' (uri, localName)
pairs in application code. A namespace object would be created to
represent a namespace (URI), and attributes of the namespace
object would represent the (uri, localName) pairs.
For example, a namespace object would be created by providing the
URI are any known local names for that namespace to the
constructor:
xbel = xml.ns.ClosedNamespace(
'http://www.python.org/topics/xml/xbel/',
['xbel', 'title', 'info', 'metadata', 'folder', 'bookmark',
'desc', 'separator', 'alias'])
Specific (uri, localName) pairs can then be referenced by more
convenient names:
xbel.title # ==> ('http://www.python.org/topics/xml/xbel/', 'title')
This can be convenient in (for example) SAX ContentHandler
implementations.
"""
def __init__(self, uri, names):
d = self.__dict__
for name in names:
d[name] = (uri, name)
class ClosedNamespace(_Namespace):
"""Namespace that doesn't allow names to be added after instantiation.
This is useful when the set of names for the namespace is known in
advance; using a ClosedNamespace doesn't allow names to be added
inadvertently.
"""
def __setattr__(self, name, value):
raise AttributeError("can't set attributes on a ClosedNamespace")
class OpenNamespace(_Namespace):
"""Namespace that allows names to be added automatically.
When attributes of these objects are referenced, (uri, localName)
pairs are generated for the name if they don't already exist.
"""
def __init__(self, uri, names=()):
_Namespace.__init__(self, uri, names)
self.__uri = uri
def __getattr__(self, name):
t = self.__uri, name
setattr(self, name, t)
return t
|