#!/usr/bin/env python
# -*- coding:utf-8 -*-

# This is the Twisted Fast Poetry Server, version 1.0

import optparse, os

from twisted.internet.protocol import ServerFactory, Protocol


"""
这个函数定义了服务端执行的参数有2个port和iface【端口和网络接口】以及返回获取参数和值以及文件名路径
"""
def parse_args():
    usage = """usage: %prog [options] poetry-file

This is the Fast Poetry Server, Twisted edition.
Run it like this:

  python twisted_sendfile.py <path-to-poetry-file>

If you are in the base directory of the twisted-intro package,
you could run it like this:

  python twisted-server-1/fastpoetry.py poetry/ecstasy.txt

to serve up John Donne's Ecstasy, which I know you want to do.
"""
    # 实例化OptionParser
    parser = optparse.OptionParser(usage)
    
    # 关于port参数的相关定义，帮助是的说明，传值的类型，
    help = "The port to listen on. Default to a random available port."
    parser.add_option('--port', type='int', help=help)

    # 关于iface参数的相关定义，帮助是的说明，传值的类型，
    help = "The interface to listen on. Default is localhost."
    parser.add_option('--iface', help=help, default='localhost')
     
    # 通过parse_args()方法获取到option，args 分别赋给这2个变量
    options, args = parser.parse_args()
    #print("--arg:",options,args)
    #print("-->",options.port)

    # 如果指定了多个文件，会出现错误，这里定义了一次传一个文件
    if len(args) != 1:
        parser.error('Provide exactly one poetry file.')
    poetry_file = args[0]

    # 如果文件不存在，的错误异常
    if not os.path.exists(args[0]):
        parser.error('No such file: %s' % poetry_file)
    # 返回脚本选项和要传输的文件路径
    return options, poetry_file


# 定义Protocol （用于连接建立以后，如果对数据进行交互，以及连接的关闭）
class PoetryProtocol(Protocol): #handle
    def connectionMade(self):
        """
        当连接建立以后，直接发送文件，然后关闭连接
        """
        self.transport.write(self.factory.poem)
        self.transport.loseConnection()

# 集成了ServerFactory的factory 定义了协议对象的生成，另外为了让构造时能够获取到文件的句柄，重写了构造函数， 
class PoetryFactory(ServerFactory): #基础类
    protocol = PoetryProtocol
    def __init__(self, poem):
        self.poem = poem

# 主要运行程序，就相当于上面几个部分的组合
def main():
    # 获取参数和文件路径
    options, poetry_file = parse_args() 
    # 得到要传输的文件句柄
    poem = open(poetry_file).read()
    # 实例化factory类，由于重写了构造函数，把文件的句柄作为参数传入进去
    factory = PoetryFactory(poem)
    from twisted.internet import reactor
    # 实例化监听对象，默认使用9000端口
    port = reactor.listenTCP(options.port or 9000, factory,
                             interface=options.iface)
    print 'Serving %s on %s.' % (poetry_file, port.getHost())
    # 调用run方法
    reactor.run()


if __name__ == '__main__':
    main()

#!/usr/bin/env python
# -*- coding:utf-8 -*-
from twisted.internet import protocol
from twisted.internet import reactor

"""
定义一个事件ECHO类,这个类继承了protocol.Protocol，用于连接成功了以后，处理交互功能，数据的收发，连接的断开都是这个类控制
"""
class Echo(protocol.Protocol):
    def dataReceived(self, data): #这个函数就是用于当收到数据以后才调用
        self.transport.write(data) # 这里这个收到数据以后：支持把数据发回去，作为处理

"""
定义个运行的函数，
"""
def main():
    factory = protocol.ServerFactory() #这是实例化factory，目的是在连接成功以后生成一个协议对象
    factory.protocol = Echo #这里生成的协议对象就是前面我们定义的Echo

    # reactor用来loop循环执行事件的处理，这里绑定了9000端口作为网络通信端口
    reactor.listenTCP(9000,factory) 
    reactor.run()

if __name__ == '__main__':
    main()

lst = range(10)
print(type(lst))        # 输出是 <type 'list'> 这是一个list
new_lst = iter(lst)
print(new_lst)          # 输出是 <listiterator object at 0x107b1e510> 这个是迭代器的对象
new_lst.__next__()	    # 迭代器使用next()方法返回迭代器的下个值如果下一个没有值，就会出现一个StopIteration的异常

def func():
	print("Start")
	yield 1

def func(argv):
	"""
	这是注释
	"""
	somecode
	return something