from urllib.request import urlopen
import warnings
import os
import json

URL = 'http://www.oreilly.com/pub/sc/osconfeed'
JSON = 'data/osconfeed.json'

def load():
  if not os.path.exists(JSON):
    msg = 'downloading {} to {}'.format(URL, JSON)
    warnings.warn(msg) #如果需要下載就發(fā)出提醒。
    with urlopen(URL) as remote, open(JSON, 'wb') as local: #在with語(yǔ)句中使用兩個(gè)上下文管理器分別用于讀取和保存遠(yuǎn)程文件。
      local.write(remote.read())
  with open(JSON) as fp:
    return json.load(fp)#json.load函數(shù)解析JSON文件，返回Python原生對(duì)象。

from collections import abc

class FronenJSON():
  def __init__(self,mapping):
    self.__data=dict(mapping)#創(chuàng)建副本，同時(shí)確保處理的是字典。
    
  def __getattr__(self, name):#僅當(dāng)沒(méi)有指定名稱的屬性才調(diào)用__getattr__方法。
    if hasattr(self,name):
      return getattr(self.__data,name)
    else:
      return FronenJSON.build(self.__data[name])
  
  @classmethod  
  def __build__(cls,obj):
    if isinstance(obj,abc.Mapping):#判斷obj是否是映射。
      return cls(obj)#創(chuàng)建FrozenJSON對(duì)象。
    elif isinstance(obj,abc.MutableSequence):
      return [cls.build(item) for item in obj]#遞歸調(diào)用.build()方法，構(gòu)建一個(gè)列表。
    else:#既不是字典也不是列表，則返回元素本身。
      return obj

  def __init__(self,mapping):
    self.__data={}
    for key,value in mapping.items():
      if keyword.iskeyword(key):
        key+='_'#與Python關(guān)鍵字重復(fù)的key在尾部加上下劃線。
      self.__data[key]=value

from collections import abc

class FronenJSON():
  def __new__(cls, arg): # __new__是類方法，第一個(gè)參數(shù)是類本身cls。
    if isinstance(arg, abc.Mapping):
      return super().__new__(cls) #委托給超類object基類的__new__方法處理。
    elif isinstance(arg, abc.MutableSequence): # 余下方法與原先的build方法一致。
      return [cls(item) for item in arg]
    else:
      return arg
 
   def __init__(self,mapping):
    self.__data={}
    for key,value in mapping.items():
      if keyword.iskeyword(key):
        key+='_'
      self.__data[key]=value 

  def __getattr__(self, name):
    if hasattr(self,name):
      return getattr(self.__data,name)
    else:
      return FronenJSON(self.__data[name]) 

class LineItem():
  def __init__(self,description,weight,price):
    self.description=description
    self.weight=weight
    self.price=price

  def subtotal(self):
    return self.weight*self.price

  @property#讀值。
  def weight(self):
    return self.__weight#真正的值存儲(chǔ)在私有屬性中。

  @weight.setter
  def weight(self,value):
    if value >0:
      self.__weight=value#有效值存入私有屬性中。
    else:
      raise ValueError('Value must be > 0')#對(duì)于無(wú)效的值拋出ValueError。

class LineItem:
  def __init__(self, description, weight, price):
    self.description = description
    self.weight = weight
    self.price = price

  def subtotal(self):
    return self.weight * self.price

  def get_weight(self): #普通讀值方法。
    return self.__weight

  def set_weight(self, value): #普通設(shè)值方法。
    if value > 0:
      self.__weight = value
    else:
      raise ValueError('value must be > 0')
  weight = property(get_weight, set_weight) #構(gòu)建property對(duì)象，賦值給公開(kāi)的類特性。

property(fget=None, fset=None, fdel=None, doc=None)

def quantity(storage_name): 

  def qty_getter(instance): # instance指的是要把屬性存儲(chǔ)其中的LineItem實(shí)例。
    return instance.__dict__[storage_name] # 引用閉包中的自由變量storage_name，值直接從instance.__dict__中獲取，以便跳過(guò)特性，防止無(wú)限遞歸。

  def qty_setter(instance, value): 
    if value > 0:
      instance.__dict__[storage_name] = value # 同理存儲(chǔ)，跳過(guò)特性。
    else:
      raise ValueError('value must be > 0')

  return property(qty_getter, qty_setter) # 構(gòu)建自定義特性對(duì)象并返回。

class LineItem:
  weight = quantity('weight') # 將自定義特性weight定義為類屬性。
  price = quantity('price') # 同上。

  def __init__(self, description, weight, price):
    self.description = description
    self.weight = weight # 此處特性已經(jīng)激活，可驗(yàn)證值的有效性。
    self.price = price

  def subtotal(self):
    return self.weight * self.price # 此處利用特性獲取實(shí)例中存儲(chǔ)的值。

class BlackKnight:
 def __init__(self):
   self.members = ['an arm', 'another arm',
           'a leg', 'another leg']
   self.phrases = ["'Tis but a scratch.",
           "It's just a flesh wound.",
           "I'm invincible!",
           "All right, we'll call it a draw."]

 @property
 def member(self):
   print('next member is:')
   return self.members[0]

 @member.deleter
 def member(self):
   text = 'BLACK KNIGHT (loses {})\n-- {}'
   print(text.format(self.members.pop(0), self.phrases.pop(0)))