Grammalecte  Hex Artifact Content

Artifact 378a2ab4e14f89000cf91821f5e72fe4535af91e59355659f2eeba109f4d16d8:


0000: 22 22 22 41 20 73 65 74 75 70 74 6f 6f 6c 73 20  """A setuptools 
0010: 62 61 73 65 64 20 73 65 74 75 70 20 6d 6f 64 75  based setup modu
0020: 6c 65 2e 0a 53 65 65 3a 0a 68 74 74 70 73 3a 2f  le..See:.https:/
0030: 2f 70 61 63 6b 61 67 69 6e 67 2e 70 79 74 68 6f  /packaging.pytho
0040: 6e 2e 6f 72 67 2f 65 6e 2f 6c 61 74 65 73 74 2f  n.org/en/latest/
0050: 64 69 73 74 72 69 62 75 74 69 6e 67 2e 68 74 6d  distributing.htm
0060: 6c 0a 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62  l.https://github
0070: 2e 63 6f 6d 2f 70 79 70 61 2f 73 61 6d 70 6c 65  .com/pypa/sample
0080: 70 72 6f 6a 65 63 74 0a 22 22 22 0a 0a 23 20 41  project."""..# A
0090: 6c 77 61 79 73 20 70 72 65 66 65 72 20 73 65 74  lways prefer set
00a0: 75 70 74 6f 6f 6c 73 20 6f 76 65 72 20 64 69 73  uptools over dis
00b0: 74 75 74 69 6c 73 0a 66 72 6f 6d 20 73 65 74 75  tutils.from setu
00c0: 70 74 6f 6f 6c 73 20 69 6d 70 6f 72 74 20 73 65  ptools import se
00d0: 74 75 70 2c 20 66 69 6e 64 5f 70 61 63 6b 61 67  tup, find_packag
00e0: 65 73 0a 0a 0a 23 20 47 65 74 20 74 68 65 20 6c  es...# Get the l
00f0: 6f 6e 67 20 64 65 73 63 72 69 70 74 69 6f 6e 20  ong description 
0100: 66 72 6f 6d 20 74 68 65 20 52 45 41 44 4d 45 20  from the README 
0110: 66 69 6c 65 0a 23 20 66 72 6f 6d 20 6f 73 20 69  file.# from os i
0120: 6d 70 6f 72 74 20 70 61 74 68 0a 23 20 68 65 72  mport path.# her
0130: 65 20 3d 20 70 61 74 68 2e 61 62 73 70 61 74 68  e = path.abspath
0140: 28 70 61 74 68 2e 64 69 72 6e 61 6d 65 28 5f 5f  (path.dirname(__
0150: 66 69 6c 65 5f 5f 29 29 0a 23 20 77 69 74 68 20  file__)).# with 
0160: 6f 70 65 6e 28 70 61 74 68 2e 6a 6f 69 6e 28 68  open(path.join(h
0170: 65 72 65 2c 20 27 52 45 41 44 4d 45 2e 74 78 74  ere, 'README.txt
0180: 27 29 2c 20 65 6e 63 6f 64 69 6e 67 3d 27 75 74  '), encoding='ut
0190: 66 2d 38 27 29 20 61 73 20 66 3a 0a 23 20 20 20  f-8') as f:.#   
01a0: 20 20 6c 6f 6e 67 5f 64 65 73 63 72 69 70 74 69    long_descripti
01b0: 6f 6e 20 3d 20 66 2e 72 65 61 64 28 29 0a 0a 73  on = f.read()..s
01c0: 65 74 75 70 28 0a 20 20 20 20 6e 61 6d 65 3d 27  etup(.    name='
01d0: 47 72 61 6d 6d 61 6c 65 63 74 65 2d 66 72 27 2c  Grammalecte-fr',
01e0: 0a 0a 20 20 20 20 23 20 56 65 72 73 69 6f 6e 73  ..    # Versions
01f0: 20 73 68 6f 75 6c 64 20 63 6f 6d 70 6c 79 20 77   should comply w
0200: 69 74 68 20 50 45 50 34 34 30 2e 20 20 46 6f 72  ith PEP440.  For
0210: 20 61 20 64 69 73 63 75 73 73 69 6f 6e 20 6f 6e   a discussion on
0220: 20 73 69 6e 67 6c 65 2d 73 6f 75 72 63 69 6e 67   single-sourcing
0230: 0a 20 20 20 20 23 20 74 68 65 20 76 65 72 73 69  .    # the versi
0240: 6f 6e 20 61 63 72 6f 73 73 20 73 65 74 75 70 2e  on across setup.
0250: 70 79 20 61 6e 64 20 74 68 65 20 70 72 6f 6a 65  py and the proje
0260: 63 74 20 63 6f 64 65 2c 20 73 65 65 0a 20 20 20  ct code, see.   
0270: 20 23 20 68 74 74 70 73 3a 2f 2f 70 61 63 6b 61   # https://packa
0280: 67 69 6e 67 2e 70 79 74 68 6f 6e 2e 6f 72 67 2f  ging.python.org/
0290: 65 6e 2f 6c 61 74 65 73 74 2f 73 69 6e 67 6c 65  en/latest/single
02a0: 5f 73 6f 75 72 63 65 5f 76 65 72 73 69 6f 6e 2e  _source_version.
02b0: 68 74 6d 6c 0a 20 20 20 20 76 65 72 73 69 6f 6e  html.    version
02c0: 3d 27 24 7b 76 65 72 73 69 6f 6e 7d 27 2c 0a 0a  ='${version}',..
02d0: 20 20 20 20 64 65 73 63 72 69 70 74 69 6f 6e 3d      description=
02e0: 27 46 72 65 6e 63 68 20 67 72 61 6d 6d 61 72 20  'French grammar 
02f0: 63 68 65 63 6b 65 72 27 2c 0a 20 20 20 20 23 6c  checker',.    #l
0300: 6f 6e 67 5f 64 65 73 63 72 69 70 74 69 6f 6e 3d  ong_description=
0310: 6c 6f 6e 67 5f 64 65 73 63 72 69 70 74 69 6f 6e  long_description
0320: 2c 0a 0a 20 20 20 20 23 20 54 68 65 20 70 72 6f  ,..    # The pro
0330: 6a 65 63 74 27 73 20 6d 61 69 6e 20 68 6f 6d 65  ject's main home
0340: 70 61 67 65 2e 0a 20 20 20 20 75 72 6c 3d 27 68  page..    url='h
0350: 74 74 70 73 3a 2f 2f 67 72 61 6d 6d 61 6c 65 63  ttps://grammalec
0360: 74 65 2e 6e 65 74 27 2c 0a 0a 20 20 20 20 23 20  te.net',..    # 
0370: 41 75 74 68 6f 72 20 64 65 74 61 69 6c 73 0a 20  Author details. 
0380: 20 20 20 61 75 74 68 6f 72 3d 27 4f 6c 69 76 69     author='Olivi
0390: 65 72 20 52 2e 27 2c 0a 20 20 20 20 23 61 75 74  er R.',.    #aut
03a0: 68 6f 72 5f 65 6d 61 69 6c 3d 27 66 75 63 6b 6f  hor_email='fucko
03b0: 66 66 2e 6e 6f 72 65 70 6c 79 40 6e 6f 77 68 65  ff.noreply@nowhe
03c0: 72 65 2e 6e 77 27 2c 0a 0a 20 20 20 20 23 20 43  re.nw',..    # C
03d0: 68 6f 6f 73 65 20 79 6f 75 72 20 6c 69 63 65 6e  hoose your licen
03e0: 73 65 0a 20 20 20 20 6c 69 63 65 6e 73 65 3d 27  se.    license='
03f0: 47 50 4c 33 27 2c 0a 0a 20 20 20 20 23 20 53 65  GPL3',..    # Se
0400: 65 20 68 74 74 70 73 3a 2f 2f 70 79 70 69 2e 70  e https://pypi.p
0410: 79 74 68 6f 6e 2e 6f 72 67 2f 70 79 70 69 3f 25  ython.org/pypi?%
0420: 33 41 61 63 74 69 6f 6e 3d 6c 69 73 74 5f 63 6c  3Aaction=list_cl
0430: 61 73 73 69 66 69 65 72 73 0a 20 20 20 20 63 6c  assifiers.    cl
0440: 61 73 73 69 66 69 65 72 73 3d 5b 0a 20 20 20 20  assifiers=[.    
0450: 20 20 20 20 23 20 48 6f 77 20 6d 61 74 75 72 65      # How mature
0460: 20 69 73 20 74 68 69 73 20 70 72 6f 6a 65 63 74   is this project
0470: 3f 20 43 6f 6d 6d 6f 6e 20 76 61 6c 75 65 73 20  ? Common values 
0480: 61 72 65 0a 20 20 20 20 20 20 20 20 23 20 20 20  are.        #   
0490: 33 20 2d 20 41 6c 70 68 61 0a 20 20 20 20 20 20  3 - Alpha.      
04a0: 20 20 23 20 20 20 34 20 2d 20 42 65 74 61 0a 20    #   4 - Beta. 
04b0: 20 20 20 20 20 20 20 23 20 20 20 35 20 2d 20 50         #   5 - P
04c0: 72 6f 64 75 63 74 69 6f 6e 2f 53 74 61 62 6c 65  roduction/Stable
04d0: 0a 20 20 20 20 20 20 20 20 27 44 65 76 65 6c 6f  .        'Develo
04e0: 70 6d 65 6e 74 20 53 74 61 74 75 73 20 3a 3a 20  pment Status :: 
04f0: 33 20 2d 20 41 6c 70 68 61 27 2c 0a 0a 20 20 20  3 - Alpha',..   
0500: 20 20 20 20 20 23 20 49 6e 64 69 63 61 74 65 20       # Indicate 
0510: 77 68 6f 20 79 6f 75 72 20 70 72 6f 6a 65 63 74  who your project
0520: 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72   is intended for
0530: 0a 20 20 20 20 20 20 20 20 27 49 6e 74 65 6e 64  .        'Intend
0540: 65 64 20 41 75 64 69 65 6e 63 65 20 3a 3a 20 44  ed Audience :: D
0550: 65 76 65 6c 6f 70 65 72 73 27 2c 0a 20 20 20 20  evelopers',.    
0560: 20 20 20 20 27 54 6f 70 69 63 20 3a 3a 20 54 65      'Topic :: Te
0570: 78 74 20 50 72 6f 63 65 73 73 69 6e 67 20 3a 3a  xt Processing ::
0580: 20 4c 69 6e 67 75 69 73 74 69 63 27 2c 0a 0a 20   Linguistic',.. 
0590: 20 20 20 20 20 20 20 23 20 50 69 63 6b 20 79 6f         # Pick yo
05a0: 75 72 20 6c 69 63 65 6e 73 65 20 61 73 20 79 6f  ur license as yo
05b0: 75 20 77 69 73 68 20 28 73 68 6f 75 6c 64 20 6d  u wish (should m
05c0: 61 74 63 68 20 22 6c 69 63 65 6e 73 65 22 20 61  atch "license" a
05d0: 62 6f 76 65 29 0a 20 20 20 20 20 20 20 20 27 4c  bove).        'L
05e0: 69 63 65 6e 73 65 20 3a 3a 20 4f 53 49 20 41 70  icense :: OSI Ap
05f0: 70 72 6f 76 65 64 20 3a 3a 20 47 4e 55 20 47 65  proved :: GNU Ge
0600: 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63  neral Public Lic
0610: 65 6e 73 65 20 76 33 20 28 47 50 4c 76 33 29 27  ense v3 (GPLv3)'
0620: 2c 0a 0a 20 20 20 20 20 20 20 20 23 20 53 70 65  ,..        # Spe
0630: 63 69 66 79 20 74 68 65 20 50 79 74 68 6f 6e 20  cify the Python 
0640: 76 65 72 73 69 6f 6e 73 20 79 6f 75 20 73 75 70  versions you sup
0650: 70 6f 72 74 20 68 65 72 65 2e 20 49 6e 20 70 61  port here. In pa
0660: 72 74 69 63 75 6c 61 72 2c 20 65 6e 73 75 72 65  rticular, ensure
0670: 0a 20 20 20 20 20 20 20 20 23 20 74 68 61 74 20  .        # that 
0680: 79 6f 75 20 69 6e 64 69 63 61 74 65 20 77 68 65  you indicate whe
0690: 74 68 65 72 20 79 6f 75 20 73 75 70 70 6f 72 74  ther you support
06a0: 20 50 79 74 68 6f 6e 20 32 2c 20 50 79 74 68 6f   Python 2, Pytho
06b0: 6e 20 33 20 6f 72 20 62 6f 74 68 2e 0a 20 20 20  n 3 or both..   
06c0: 20 20 20 20 20 27 50 72 6f 67 72 61 6d 6d 69 6e       'Programmin
06d0: 67 20 4c 61 6e 67 75 61 67 65 20 3a 3a 20 50 79  g Language :: Py
06e0: 74 68 6f 6e 20 3a 3a 20 33 2e 33 27 2c 0a 20 20  thon :: 3.3',.  
06f0: 20 20 20 20 20 20 27 50 72 6f 67 72 61 6d 6d 69        'Programmi
0700: 6e 67 20 4c 61 6e 67 75 61 67 65 20 3a 3a 20 50  ng Language :: P
0710: 79 74 68 6f 6e 20 3a 3a 20 33 2e 34 27 2c 0a 20  ython :: 3.4',. 
0720: 20 20 20 20 20 20 20 27 50 72 6f 67 72 61 6d 6d         'Programm
0730: 69 6e 67 20 4c 61 6e 67 75 61 67 65 20 3a 3a 20  ing Language :: 
0740: 50 79 74 68 6f 6e 20 3a 3a 20 33 2e 35 27 2c 0a  Python :: 3.5',.
0750: 20 20 20 20 20 20 20 20 27 50 72 6f 67 72 61 6d          'Program
0760: 6d 69 6e 67 20 4c 61 6e 67 75 61 67 65 20 3a 3a  ming Language ::
0770: 20 50 79 74 68 6f 6e 20 3a 3a 20 33 2e 36 27 2c   Python :: 3.6',
0780: 0a 20 20 20 20 5d 2c 0a 0a 20 20 20 20 23 20 57  .    ],..    # W
0790: 68 61 74 20 64 6f 65 73 20 79 6f 75 72 20 70 72  hat does your pr
07a0: 6f 6a 65 63 74 20 72 65 6c 61 74 65 20 74 6f 3f  oject relate to?
07b0: 0a 20 20 20 20 6b 65 79 77 6f 72 64 73 3d 27 46  .    keywords='F
07c0: 72 65 6e 63 68 20 67 72 61 6d 6d 61 72 20 63 68  rench grammar ch
07d0: 65 63 6b 65 72 20 63 6f 72 72 65 63 74 65 75 72  ecker correcteur
07e0: 20 67 72 61 6d 6d 61 74 69 63 61 6c 20 66 72 61   grammatical fra
07f0: 6e c3 a7 61 69 73 27 2c 0a 0a 20 20 20 20 23 20  n..ais',..    # 
0800: 53 63 72 69 70 74 73 0a 20 20 20 20 73 63 72 69  Scripts.    scri
0810: 70 74 3d 5b 27 63 6c 69 2e 70 79 27 2c 20 27 73  pt=['cli.py', 's
0820: 65 72 76 65 72 2e 70 79 27 2c 20 27 62 6f 6f 74  erver.py', 'boot
0830: 6c 65 2e 70 79 27 5d 2c 0a 0a 20 20 20 20 23 20  le.py'],..    # 
0840: 59 6f 75 20 63 61 6e 20 6a 75 73 74 20 73 70 65  You can just spe
0850: 63 69 66 79 20 74 68 65 20 70 61 63 6b 61 67 65  cify the package
0860: 73 20 6d 61 6e 75 61 6c 6c 79 20 68 65 72 65 20  s manually here 
0870: 69 66 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 20  if your project 
0880: 69 73 0a 20 20 20 20 23 20 73 69 6d 70 6c 65 2e  is.    # simple.
0890: 20 4f 72 20 79 6f 75 20 63 61 6e 20 75 73 65 20   Or you can use 
08a0: 66 69 6e 64 5f 70 61 63 6b 61 67 65 73 28 29 2e  find_packages().
08b0: 0a 20 20 20 20 23 20 70 61 63 6b 61 67 65 73 3d  .    # packages=
08c0: 66 69 6e 64 5f 70 61 63 6b 61 67 65 73 28 65 78  find_packages(ex
08d0: 63 6c 75 64 65 3d 5b 27 63 6f 6e 74 72 69 62 27  clude=['contrib'
08e0: 2c 20 27 64 6f 63 73 27 2c 20 27 74 65 73 74 73  , 'docs', 'tests
08f0: 27 5d 29 2c 0a 20 20 20 20 70 61 63 6b 61 67 65  ']),.    package
0900: 73 3d 5b 27 67 72 61 6d 6d 61 6c 65 63 74 65 27  s=['grammalecte'
0910: 2c 20 27 67 72 61 6d 6d 61 6c 65 63 74 65 2e 66  , 'grammalecte.f
0920: 72 27 5d 2c 0a 0a 20 20 20 20 23 20 41 6c 74 65  r'],..    # Alte
0930: 72 6e 61 74 69 76 65 6c 79 2c 20 69 66 20 79 6f  rnatively, if yo
0940: 75 20 77 61 6e 74 20 74 6f 20 64 69 73 74 72 69  u want to distri
0950: 62 75 74 65 20 6a 75 73 74 20 61 20 6d 79 5f 6d  bute just a my_m
0960: 6f 64 75 6c 65 2e 70 79 2c 20 75 6e 63 6f 6d 6d  odule.py, uncomm
0970: 65 6e 74 0a 20 20 20 20 23 20 74 68 69 73 3a 0a  ent.    # this:.
0980: 20 20 20 20 23 20 20 20 70 79 5f 6d 6f 64 75 6c      #   py_modul
0990: 65 73 3d 5b 22 6d 79 5f 6d 6f 64 75 6c 65 22 5d  es=["my_module"]
09a0: 2c 0a 0a 20 20 20 20 23 20 4c 69 73 74 20 72 75  ,..    # List ru
09b0: 6e 2d 74 69 6d 65 20 64 65 70 65 6e 64 65 6e 63  n-time dependenc
09c0: 69 65 73 20 68 65 72 65 2e 20 20 54 68 65 73 65  ies here.  These
09d0: 20 77 69 6c 6c 20 62 65 20 69 6e 73 74 61 6c 6c   will be install
09e0: 65 64 20 62 79 20 70 69 70 20 77 68 65 6e 0a 20  ed by pip when. 
09f0: 20 20 20 23 20 79 6f 75 72 20 70 72 6f 6a 65 63     # your projec
0a00: 74 20 69 73 20 69 6e 73 74 61 6c 6c 65 64 2e 20  t is installed. 
0a10: 46 6f 72 20 61 6e 20 61 6e 61 6c 79 73 69 73 20  For an analysis 
0a20: 6f 66 20 22 69 6e 73 74 61 6c 6c 5f 72 65 71 75  of "install_requ
0a30: 69 72 65 73 22 20 76 73 20 70 69 70 27 73 0a 20  ires" vs pip's. 
0a40: 20 20 20 23 20 72 65 71 75 69 72 65 6d 65 6e 74     # requirement
0a50: 73 20 66 69 6c 65 73 20 73 65 65 3a 0a 20 20 20  s files see:.   
0a60: 20 23 20 68 74 74 70 73 3a 2f 2f 70 61 63 6b 61   # https://packa
0a70: 67 69 6e 67 2e 70 79 74 68 6f 6e 2e 6f 72 67 2f  ging.python.org/
0a80: 65 6e 2f 6c 61 74 65 73 74 2f 72 65 71 75 69 72  en/latest/requir
0a90: 65 6d 65 6e 74 73 2e 68 74 6d 6c 0a 20 20 20 20  ements.html.    
0aa0: 23 20 69 6e 73 74 61 6c 6c 5f 72 65 71 75 69 72  # install_requir
0ab0: 65 73 3d 5b 27 70 65 70 70 65 72 63 6f 72 6e 27  es=['peppercorn'
0ac0: 5d 2c 0a 0a 20 20 20 20 23 20 4c 69 73 74 20 61  ],..    # List a
0ad0: 64 64 69 74 69 6f 6e 61 6c 20 67 72 6f 75 70 73  dditional groups
0ae0: 20 6f 66 20 64 65 70 65 6e 64 65 6e 63 69 65 73   of dependencies
0af0: 20 68 65 72 65 20 28 65 2e 67 2e 20 64 65 76 65   here (e.g. deve
0b00: 6c 6f 70 6d 65 6e 74 0a 20 20 20 20 23 20 64 65  lopment.    # de
0b10: 70 65 6e 64 65 6e 63 69 65 73 29 2e 20 59 6f 75  pendencies). You
0b20: 20 63 61 6e 20 69 6e 73 74 61 6c 6c 20 74 68 65   can install the
0b30: 73 65 20 75 73 69 6e 67 20 74 68 65 20 66 6f 6c  se using the fol
0b40: 6c 6f 77 69 6e 67 20 73 79 6e 74 61 78 2c 0a 20  lowing syntax,. 
0b50: 20 20 20 23 20 66 6f 72 20 65 78 61 6d 70 6c 65     # for example
0b60: 3a 0a 20 20 20 20 23 20 24 20 70 69 70 20 69 6e  :.    # $ pip in
0b70: 73 74 61 6c 6c 20 2d 65 20 2e 5b 64 65 76 2c 74  stall -e .[dev,t
0b80: 65 73 74 5d 0a 20 20 20 20 23 20 65 78 74 72 61  est].    # extra
0b90: 73 5f 72 65 71 75 69 72 65 3d 7b 0a 20 20 20 20  s_require={.    
0ba0: 23 20 20 20 20 20 27 64 65 76 27 3a 20 5b 27 63  #     'dev': ['c
0bb0: 68 65 63 6b 2d 6d 61 6e 69 66 65 73 74 27 5d 2c  heck-manifest'],
0bc0: 0a 20 20 20 20 23 20 20 20 20 20 27 74 65 73 74  .    #     'test
0bd0: 27 3a 20 5b 27 63 6f 76 65 72 61 67 65 27 5d 2c  ': ['coverage'],
0be0: 0a 20 20 20 20 23 20 7d 2c 0a 0a 20 20 20 20 23  .    # },..    #
0bf0: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 64 61   If there are da
0c00: 74 61 20 66 69 6c 65 73 20 69 6e 63 6c 75 64 65  ta files include
0c10: 64 20 69 6e 20 79 6f 75 72 20 70 61 63 6b 61 67  d in your packag
0c20: 65 73 20 74 68 61 74 20 6e 65 65 64 20 74 6f 20  es that need to 
0c30: 62 65 0a 20 20 20 20 23 20 69 6e 73 74 61 6c 6c  be.    # install
0c40: 65 64 2c 20 73 70 65 63 69 66 79 20 74 68 65 6d  ed, specify them
0c50: 20 68 65 72 65 2e 20 20 49 66 20 75 73 69 6e 67   here.  If using
0c60: 20 50 79 74 68 6f 6e 20 32 2e 36 20 6f 72 20 6c   Python 2.6 or l
0c70: 65 73 73 2c 20 74 68 65 6e 20 74 68 65 73 65 0a  ess, then these.
0c80: 20 20 20 20 23 20 68 61 76 65 20 74 6f 20 62 65      # have to be
0c90: 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 4d 41 4e   included in MAN
0ca0: 49 46 45 53 54 2e 69 6e 20 61 73 20 77 65 6c 6c  IFEST.in as well
0cb0: 2e 0a 20 20 20 20 70 61 63 6b 61 67 65 5f 64 61  ..    package_da
0cc0: 74 61 3d 7b 0a 20 20 20 20 20 20 20 20 27 67 72  ta={.        'gr
0cd0: 61 6d 6d 61 6c 65 63 74 65 27 3a 20 5b 27 5f 64  ammalecte': ['_d
0ce0: 69 63 74 69 6f 6e 61 72 69 65 73 2f 46 72 65 6e  ictionaries/Fren
0cf0: 63 68 2e 62 64 69 63 27 2c 20 27 2a 2e 74 78 74  ch.bdic', '*.txt
0d00: 27 5d 0a 20 20 20 20 7d 2c 0a 0a 20 20 20 20 23  '].    },..    #
0d10: 20 41 6c 74 68 6f 75 67 68 20 27 70 61 63 6b 61   Although 'packa
0d20: 67 65 5f 64 61 74 61 27 20 69 73 20 74 68 65 20  ge_data' is the 
0d30: 70 72 65 66 65 72 72 65 64 20 61 70 70 72 6f 61  preferred approa
0d40: 63 68 2c 20 69 6e 20 73 6f 6d 65 20 63 61 73 65  ch, in some case
0d50: 20 79 6f 75 20 6d 61 79 0a 20 20 20 20 23 20 6e   you may.    # n
0d60: 65 65 64 20 74 6f 20 70 6c 61 63 65 20 64 61 74  eed to place dat
0d70: 61 20 66 69 6c 65 73 20 6f 75 74 73 69 64 65 20  a files outside 
0d80: 6f 66 20 79 6f 75 72 20 70 61 63 6b 61 67 65 73  of your packages
0d90: 2e 20 53 65 65 3a 0a 20 20 20 20 23 20 68 74 74  . See:.    # htt
0da0: 70 3a 2f 2f 64 6f 63 73 2e 70 79 74 68 6f 6e 2e  p://docs.python.
0db0: 6f 72 67 2f 33 2e 34 2f 64 69 73 74 75 74 69 6c  org/3.4/distutil
0dc0: 73 2f 73 65 74 75 70 73 63 72 69 70 74 2e 68 74  s/setupscript.ht
0dd0: 6d 6c 23 69 6e 73 74 61 6c 6c 69 6e 67 2d 61 64  ml#installing-ad
0de0: 64 69 74 69 6f 6e 61 6c 2d 66 69 6c 65 73 20 23  ditional-files #
0df0: 20 6e 6f 71 61 0a 20 20 20 20 23 20 49 6e 20 74   noqa.    # In t
0e00: 68 69 73 20 63 61 73 65 2c 20 27 64 61 74 61 5f  his case, 'data_
0e10: 66 69 6c 65 27 20 77 69 6c 6c 20 62 65 20 69 6e  file' will be in
0e20: 73 74 61 6c 6c 65 64 20 69 6e 74 6f 20 27 3c 73  stalled into '<s
0e30: 79 73 2e 70 72 65 66 69 78 3e 2f 6d 79 5f 64 61  ys.prefix>/my_da
0e40: 74 61 27 0a 20 20 20 20 23 20 64 61 74 61 5f 66  ta'.    # data_f
0e50: 69 6c 65 73 3d 5b 28 27 6d 79 5f 64 61 74 61 27  iles=[('my_data'
0e60: 2c 20 5b 27 64 61 74 61 2f 64 61 74 61 5f 66 69  , ['data/data_fi
0e70: 6c 65 27 5d 29 5d 2c 0a 20 20 20 20 64 61 74 61  le'])],.    data
0e80: 5f 66 69 6c 65 73 3d 5b 28 27 27 2c 20 5b 27 63  _files=[('', ['c
0e90: 6c 69 2e 70 79 27 2c 20 27 73 65 72 76 65 72 2e  li.py', 'server.
0ea0: 70 79 27 2c 20 27 62 6f 74 74 6c 65 2e 70 79 27  py', 'bottle.py'
0eb0: 2c 20 27 52 45 41 44 4d 45 2e 74 78 74 27 2c 20  , 'README.txt', 
0ec0: 27 4c 49 43 45 4e 53 45 2e 74 78 74 27 2c 20 5c  'LICENSE.txt', \
0ed0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
0ee0: 20 20 20 20 20 20 20 27 73 65 72 76 65 72 5f 6f         'server_o
0ef0: 70 74 69 6f 6e 73 2e 66 72 2e 69 6e 69 27 2c 20  ptions.fr.ini', 
0f00: 27 73 65 72 76 65 72 5f 6f 70 74 69 6f 6e 73 2e  'server_options.
0f10: 5f 67 6c 6f 62 61 6c 2e 69 6e 69 27 5d 29 5d 2c  _global.ini'])],
0f20: 0a 0a 20 20 20 20 23 20 54 6f 20 70 72 6f 76 69  ..    # To provi
0f30: 64 65 20 65 78 65 63 75 74 61 62 6c 65 20 73 63  de executable sc
0f40: 72 69 70 74 73 2c 20 75 73 65 20 65 6e 74 72 79  ripts, use entry
0f50: 20 70 6f 69 6e 74 73 20 69 6e 20 70 72 65 66 65   points in prefe
0f60: 72 65 6e 63 65 20 74 6f 20 74 68 65 0a 20 20 20  rence to the.   
0f70: 20 23 20 22 73 63 72 69 70 74 73 22 20 6b 65 79   # "scripts" key
0f80: 77 6f 72 64 2e 20 45 6e 74 72 79 20 70 6f 69 6e  word. Entry poin
0f90: 74 73 20 70 72 6f 76 69 64 65 20 63 72 6f 73 73  ts provide cross
0fa0: 2d 70 6c 61 74 66 6f 72 6d 20 73 75 70 70 6f 72  -platform suppor
0fb0: 74 20 61 6e 64 20 61 6c 6c 6f 77 0a 20 20 20 20  t and allow.    
0fc0: 23 20 70 69 70 20 74 6f 20 63 72 65 61 74 65 20  # pip to create 
0fd0: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20  the appropriate 
0fe0: 66 6f 72 6d 20 6f 66 20 65 78 65 63 75 74 61 62  form of executab
0ff0: 6c 65 20 66 6f 72 20 74 68 65 20 74 61 72 67 65  le for the targe
1000: 74 20 70 6c 61 74 66 6f 72 6d 2e 0a 20 20 20 20  t platform..    
1010: 23 20 65 6e 74 72 79 5f 70 6f 69 6e 74 73 3d 7b  # entry_points={
1020: 0a 20 20 20 20 23 20 20 20 20 20 27 63 6f 6e 73  .    #     'cons
1030: 6f 6c 65 5f 73 63 72 69 70 74 73 27 3a 20 5b 0a  ole_scripts': [.
1040: 20 20 20 20 23 20 20 20 20 20 20 20 20 20 27 73      #         's
1050: 61 6d 70 6c 65 3d 73 61 6d 70 6c 65 3a 6d 61 69  ample=sample:mai
1060: 6e 27 2c 0a 20 20 20 20 23 20 20 20 20 20 5d 2c  n',.    #     ],
1070: 0a 20 20 20 20 23 20 7d 2c 0a 29 0a              .    # },.).