README 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. ASN.1 library for Python
  2. ------------------------
  3. This is an implementation of ASN.1 types and codecs in Python programming
  4. language. It has been first written to support particular protocol (SNMP)
  5. but then generalized to be suitable for a wide range of protocols
  6. based on ASN.1 specification.
  7. FEATURES
  8. --------
  9. * Generic implementation of ASN.1 types (X.208)
  10. * Fully standard compliant BER/CER/DER codecs
  11. * 100% Python, works with Python 2.4 up to Python 3.4
  12. * MT-safe
  13. MISFEATURES
  14. -----------
  15. * No ASN.1 compiler (by-hand ASN.1 spec compilation into Python code required)
  16. * Codecs are not restartable
  17. INSTALLATION
  18. ------------
  19. The pyasn1 package uses setuptools/distutils for installation. Thus do
  20. either:
  21. $ easy_install pyasn1
  22. or
  23. $ tar zxf pyasn1-0.1.8.tar.gz
  24. $ cd pyasn1-0.1.8
  25. $ python setup.py install
  26. $ python setup.py test # run unit tests (optional)
  27. OPERATION
  28. ---------
  29. Perhaps a typical use would involve [by-hand] compilation of your ASN.1
  30. specification into pyasn1-backed Python code at your application.
  31. For more information on pyasn1 APIs, please, refer to the
  32. doc/pyasn1-tutorial.html file in the distribution.
  33. Also refer to example modules. Take a look at pyasn1-modules package -- maybe
  34. it already holds something useful to you.
  35. AVAILABILITY
  36. ------------
  37. The pyasn1 package is distributed under terms and conditions of BSD-style
  38. license. See LICENSE file in the distribution. Source code is freely
  39. available from:
  40. http://pyasn1.sf.net
  41. FEEDBACK
  42. --------
  43. Please, send your comments and fixes to mailing lists at project web site.
  44. =-=-=
  45. mailto: ilya@glas.net