Introduction
============

pyrad is an implementation of a RADIUS client as described in RFC2865.
It takes care of all the details like building RADIUS packets, sending
them and decoding responses. 

Here is an example of doing a authentication request::

  import pyrad.packet
  from pyrad.client import Client
  from pyrad.dictionary import Dictionary

  srv=Client(server="radius.my.domain", secret="s3cr3t",
  	dict=Dictionary("dicts/dictionary", "dictionary.acc"))

  req=srv.CreateAuthPacket(code=pyrad.packet.AccessRequest,
  		User_Name="wichert", NAS_Identifier="localhost")
  req["User-Password"]=req.PwCrypt("password")

  reply=srv.SendPacket(req)
  if reply.code==pyrad.packet.AccessAccept:
      print "access accepted"
  else:
      print "access denied"

  print "Attributes returned by server:"
  for i in reply.keys():
      print "%s: %s" % (i, reply[i])


Requirements & Installation
===========================

pyrad requires Python 2.4 or later.

Installing is simple; pyrad uses the standard distutils system for installing
Python modules::

  python setup.py install


Author, copyright, availability
===============================

pyrad was written by Wichert Akkerman <wichert@wiggy.net>

Copyright and license information can be found in LICENSE.txt

The current version and documentation can be found at its homepage:
http://www.simplon.biz/software/pyrad

Bugs and wishes can be submitted in the pyrad issue tracker:
https://code.wiggy.net/tracker/pyrad/


