1CLINT(1)                             clint                            CLINT(1)
2
3
4

NAME

6       clint - Clint Documentation
7
8       Welcome to Clint.
9

CONTENTS

11       This part of the documentation, which is mostly prose, begins with some
12       background  information  about  Clint,  then  focuses  on  step-by-step
13       instructions for using Clint for development.
14
15   Properly Installing Python
16   Mac OS X
17       Or, “Installing Python 2.7 via Homebrew”.
18
19       One of the reasons everybody loves Python is the interactive shell.  It
20       basically allows you to execute Python commands in real time and  imme‐
21       diately  get results back.  Flask itself does not come with an interac‐
22       tive shell, because it does not require  any  specific  setup  upfront,
23       just import your application and start playing around.
24
25   Package Manager
26       While  Snow  Leopard comes with a large number of UNIX utilities, those
27       familiar with Linux systems will notice one key  component  missing:  a
28       package manager. Mxcl’s Homebrew is the answer.
29
30       To install Homebrew, simply run:
31
32          $ ruby -e "$(curl -fsS http://gist.github.com/raw/323731/install_homebrew.rb)"
33
34       It’s basic commands are update, install, and remove.
35
36   Python Interpreter
37       And we can now install Python 2.7:
38
39          $ brew install python --framework
40
41       The  --framework  option  tells  Homebrew  to compile a Framework-style
42       Python build, rather than a UNIX-style build. The outdated  version  of
43       Python  that  Snow Leopard comes packaged with is built as a Framework,
44       so this helps avoid some future module installation bugs.
45
46       Don’t forget to update your environment PATH.
47
48   Distribute & Pip
49       Distribute is a fantastic  drop-in  replacement  for  easy_install  and
50       setuptools.  It  allows  you to install and manage python packages from
51       pypi.python.org, amongst a few other sources. It also plays  well  with
52       virtualenv and user-enviornments.
53
54       easy_install  is  considered  by  many to be a deprecated system, so we
55       will install it’s replacement: pip. Pip allows  for  uninstallation  of
56       packages, and is actively maintained, unlike setuptool’s easy_install.
57
58       To install pip and Distribute’s easy_install:
59
60       If you have homebrew:
61
62          $ brew install pip
63
64       …And, if you’re a masochist:
65
66          $ curl -O http://python-distribute.org/distribute_setup.py
67          $ python distribute_setup.py
68
69          $ easy_install pip
70
71       To install pip:
72
73       Hopefully you’ll never have to use easy_install again.
74
75   Updating Python
76       Homebrew makes it simple.
77
78          $ brew update
79          $ brew install --force python
80
81   Windows
82   Prerequisites:
83       · Python2.7 (x86) from Python.org
84
85       · Microsoft Visual Studio
86
87   Step 1: Install Distribute & Pip
88       Distribute  is  a  fantastic  drop-in  replacement for easy_install and
89       setuptools. It allows you to install and manage  python  packages  from
90       PyPi, amongst a few other sources.
91
92       To install it, run the python script available here:
93              <http://python-distribute.org/distribute_setup.py>
94
95       Make  sure  that `C:\Python27\`, and  `C:\Python27\Scripts` are in your
96       PATH.
97
98       easy_install is considered by many to be a  deprecated  system,  so  we
99       will  install  it’s  replacement: pip. Pip allows for uninstallation of
100       packages, and is actively maintained, unlike setuptool’s easy_install.
101
102       To install pip, simply run:
103
104          $ easy_install pip
105
106   Linux (Ubuntu)
107   Linux (Manual)
108   Useful Tools
109   IPython
110          $ pip install ipython
111
112   BPython
113          $ pip install bpython
114

API DOCUMENTATION

116          api
117

ADDITIONAL NOTES

119       Contribution notes and legal information are here for the interested.
120
121   Contribute
122       Python-guide is under active development, and contributors are welcome.
123
124       If you have a feature request, suggestion, or bug report, please open a
125       new  issue  on GitHub. To submit patches, please send a pull request on
126       GitHub. Make sure you add yourself to AUTHORS.
127
128       If you'd like to contribute, there's plenty to do. Here's a short  todo
129       list.
130
131   License
132       TBD.
133

AUTHOR

135       Kenneth Reitz
136
138       2011, Kenneth Reitz
139
140
141
142
1430.5.1                            Jul 15, 2018                         CLINT(1)
Impressum