~ubuntu-branches/ubuntu/utopic/mako/utopic-proposed : revision 33

1

2

3

4

<head>

5

<title>

6

7

Changelog

8

—

9

Mako 1.0.0 Documentation

10

</title>

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

var DOCUMENTATION_OPTIONS = {

26

URL_ROOT: './',

27

VERSION: '1.0.0',

28

COLLAPSE_MODINDEX: false,

29

FILE_SUFFIX: '.html'

30

};

31

</script>

32

33

34

35

36

37

38

39

40

41

42

</head>

43

<body>

44

45

46

47

48

49

Hyperfast and lightweight templating for the Python platform.

50

</div>

51

52

53

</div>

54

55

56

57

<hr/>

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

<h1>Mako 1.0.0 Documentation</h1>

76

77

78

Search:

79

80

81

82

83

</form>

84

</div>

85

86

87

Release: 1.0.0

88

89

</div>

90

91

</div>

92

93

94

95

<ul>

96

<li>Prev:

97

<a href="caching.html" title="previous chapter">Caching</a>

98

</li>

99

100

<li>

101

<a href="index.html">Table of Contents</a> |

102

<a href="genindex.html">Index</a>

103

| <a href="_sources/changelog.txt">view source

104

</li>

105

</ul>

106

</div>

107

108

109

<a href="index.html">Mako 1.0.0 Documentation</a>

110

»

111

Changelog

112

113

114

<h2>

115

116

Changelog

117

118

</h2>

119

</div>

120

121

</div>

122

123

124

125

126

<h3><a href="index.html">Table of Contents</a></h3>

127

<ul>

128

<li><a class="reference internal" href="#">Changelog</a><ul>

129

130

131

</ul>

132

</li>

133

134

135

136

</ul>

137

</li>

138

139

140

141

</ul>

142

</li>

143

144

145

146

147

148

</ul>

149

</li>

150

<li><a class="reference internal" href="#older-versions">Older Versions</a><ul>

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

</ul>

183

</li>

184

</ul>

185

</li>

186

</ul>

187

188

189

<h4>Previous Topic</h4>

190

191

<a href="caching.html" title="previous chapter">Caching</a>

192

193

194

<h4>Quick Search</h4>

195

196

197

198

199

200

</form>

201

202

203

</div>

204

205

206

207

208

<h1>Changelog<a class="headerlink" href="#changelog" title="Permalink to this headline">¶</a></h1>

209

210

211

212

213

Released: Sun Jun 8 2014<ul class="simple">

214

<li>[py2k] [bug] Improved the error re-raise operation when a custom

215

<a class="reference internal" href="usage.html#mako.template.Template.params.error_handler" title="mako.template.Template"><tt class="xref py py-paramref docutils literal">Template.error_handler</tt></a> is used that does not handle

216

the exception; the original stack trace etc. is now preserved.

217

Pull request courtesy Manfred Haltner.<a class="changeset-link headerlink reference internal" href="#change-a1b32dcfac59fb3d94194cc23d05eec4">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/pull-request/8">pull request bitbucket:8</a>

218

219

</li>

220

<li>[py2k] [bug] [filters] Added an html_escape filter that works in “non unicode” mode.

221

Previously, when using <tt class="docutils literal">disable_unicode=True</tt>, the <tt class="docutils literal">u</tt> filter

222

would fail to handle non-ASCII bytes properly. Pull request

223

courtesy George Xie.<a class="changeset-link headerlink reference internal" href="#change-7f76f6ca5487a165840d3f1634e26b5f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/pull-request/7">pull request bitbucket:7</a>

224

225

</li>

226

<li>[general] Compatibility changes; in order to modernize the codebase, Mako

227

is now dropping support for Python 2.4 and Python 2.5 altogether.

228

The source base is now targeted at Python 2.6 and forwards.<a class="changeset-link headerlink reference internal" href="#change-b602a175c0ec26eaa4f42962d23cca96">¶</a>

229

230

</li>

231

<li>[feature] Template modules now generate a JSON “metadata” structure at the bottom

232

of the source file which includes parseable information about the

233

templates’ source file, encoding etc. as well as a mapping of module

234

source lines to template lines, thus replacing the “# SOURCE LINE”

235

markers throughout the source code. The structure also indicates those

236

lines that are explicitly not part of the template’s source; the goal

237

here is to allow better integration with coverage and other tools.<a class="changeset-link headerlink reference internal" href="#change-ac6c8e7df6c612e92bf81577c4c96276">¶</a>

238

239

</li>

240

<li>[bug] [py3k] Fixed bug in <tt class="docutils literal">decode.<encoding></tt> filter where a non-string object

241

would not be correctly interpreted in Python 3.<a class="changeset-link headerlink reference internal" href="#change-48f95a70e6b509811d3c6c208b3bbafc">¶</a>

242

243

</li>

244

<li>[bug] [py3k] Fixed bug in Python parsing logic which would fail on Python 3

245

when a “try/except” targeted a tuple of exception types, rather

246

than a single exception.<a class="changeset-link headerlink reference internal" href="#change-7638baccf1cc95230c98f9475713aff4">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/227/">#227</a>

247

248

</li>

249

<li>[feature] mako-render is now implemented as a setuptools entrypoint script;

250

a standalone mako.cmd.cmdline() callable is now available, and the

251

system also uses argparse now instead of optparse. Pull request

252

courtesy Derek Harland.<a class="changeset-link headerlink reference internal" href="#change-4ed767c704faafcfcaa96c993b6c3ce8">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/pull-request/5">pull request bitbucket:5</a>

253

254

</li>

255

<li>[feature] The mako-render script will now catch exceptions and run them

256

into the text error handler, and exit with a non-zero exit code.

257

Pull request courtesy Derek Harland.<a class="changeset-link headerlink reference internal" href="#change-b514d619be9c65cb0abb149be8b3a1a2">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/pull-request/4">pull request bitbucket:4</a>

258

259

</li>

260

<li>[bug] A rework of the mako-render script allows the script to run

261

correctly when given a file pathname that is outside of the current

262

directory, e.g. <tt class="docutils literal">mako-render ../some_template.mako</tt>. In this case,

263

the “template root” defaults to the directory in which the template

264

is located, instead of ”.”. The script also accepts a new argument

265

<tt class="docutils literal">--template-dir</tt> which can be specified multiple times to establish

266

template lookup directories. Standard input for templates also works

267

now too. Pull request courtesy Derek Harland.<a class="changeset-link headerlink reference internal" href="#change-a328a21ec5123a69caf9021bbf70b90a">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/pull-request/2">pull request bitbucket:2</a>

268

269

</li>

270

<li>[feature] [py3k] Support is added for Python 3 “keyword only” arguments, as used in

271

defs. Pull request courtesy Eevee.<a class="changeset-link headerlink reference internal" href="#change-e39fabd3e579af9dd730204a7692c76f">¶</a>References: <a class="reference external" href="https://github.com/zzzeek/mako/pull/7">pull request github:7</a>

272

273

</li>

274

</ul>

275

</div>

276

</div>

277

278

279

280

281

Released: Thu Dec 26 2013<ul class="simple">

282

<li>[bug] Fixed bug in Babel plugin where translator comments

283

would be lost if intervening text nodes were encountered.

284

Fix courtesy Ned Batchelder.<a class="changeset-link headerlink reference internal" href="#change-8b4011d90ed7ddc770e03ef8ade6e6dc">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/225/">#225</a>

285

286

</li>

287

<li>[bug] Fixed TGPlugin.render method to support unicode template

288

names in Py2K - courtesy Vladimir Magamedov.<a class="changeset-link headerlink reference internal" href="#change-a7b4b7fb4a7bf5e4c0ca7c2a7b072eca">¶</a>

289

290

</li>

291

<li>[bug] Fixed an AST issue that was preventing correct operation

292

under alpha versions of Python 3.4. Pullreq courtesy Zer0-.<a class="changeset-link headerlink reference internal" href="#change-c3dd59728d365b33fe9fcbf8ea96f9ab">¶</a>

293

294

</li>

295

<li>[bug] Changed the format of the “source encoding” header output

296

by the code generator to use the format <tt class="docutils literal"># -*- coding:%s -*-</tt>

297

instead of <tt class="docutils literal"># -*- encoding:%s -*-</tt>; the former is more common

298

and compatible with emacs. Courtesy Martin Geisler.<a class="changeset-link headerlink reference internal" href="#change-166e48714e8db96013d1a6038e54aff4">¶</a>

299

300

</li>

301

<li>[bug] Fixed issue where an old lexer rule prevented a template line

302

which looked like “#*” from being correctly parsed.<a class="changeset-link headerlink reference internal" href="#change-9a88fa8f596546fb451bfcbfa7ce6274">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/224/">#224</a>

303

304

</li>

305

</ul>

306

</div>

307

308

309

Released: Tue Aug 27 2013<ul class="simple">

310

<li>[bug] The Context.locals_() method becomes a private underscored

311

method, as this method has a specific internal use. The purpose

312

of Context.kwargs has been clarified, in that it only delivers

313

top level keyword arguments originally passed to template.render().<a class="changeset-link headerlink reference internal" href="#change-f529d0d5bf50c9e01e436ee12672a7f8">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/219/">#219</a>

314

315

</li>

316

<li>[bug] Fixed the babel plugin to properly interpret ${} sections

317

inside of a “call” tag, i.e. <%self:some_tag attr=”${_(‘foo’)}”/>.

318

Code that’s subject to babel escapes in here needs to be

319

specified as a Python expression, not a literal. This change

320

is backwards incompatible vs. code that is relying upon a _(‘’)

321

translation to be working within a call tag.<a class="changeset-link headerlink reference internal" href="#change-41a0ced688ee0a615dcddf766d267241">¶</a>

322

323

</li>

324

<li>[bug] The Babel plugin has been repaired to work on Python 3.<a class="changeset-link headerlink reference internal" href="#change-ac972a0d002a412c4a92175229d7444f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/187/">#187</a>

325

326

</li>

327

<li>[bug] Using <%namespace import=”*” module=”somemodule”/> now

328

skips over module elements that are not explcitly callable,

329

avoiding TypeError when trying to produce partials.<a class="changeset-link headerlink reference internal" href="#change-dbf6f29e5e76133b9dd779baacb24818">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/207/">#207</a>

330

331

</li>

332

<li>[bug] Fixed Py3K bug where a “lambda” expression was not

333

interpreted correctly within a template tag; also

334

fixed in Py2.4.<a class="changeset-link headerlink reference internal" href="#change-693045b580eddfdc7e464ba0426b3495">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/190/">#190</a>

335

336

</li>

337

</ul>

338

</div>

339

</div>

340

341

342

343

344

Released: Fri May 24 2013<ul class="simple">

345

<li>[bug] Changed setup.py to skip installing markupsafe

346

if Python version is < 2.6 or is between 3.0 and

347

less than 3.3, as Markupsafe now only supports 2.6->2.X,

348

3.3->3.X.<a class="changeset-link headerlink reference internal" href="#change-bd4b9d8ffbf32fc1b15161268eefa4d3">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/216/">#216</a>

349

350

</li>

351

<li>[bug] Fixed regression where “entity” filter wasn’t

352

converted for py3k properly (added tests.)<a class="changeset-link headerlink reference internal" href="#change-422ca71aa24f94eb264fc0d653dc726e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/214/">#214</a>

353

354

</li>

355

<li>[bug] Fixed bug where mako-render script wasn’t

356

compatible with Py3k.<a class="changeset-link headerlink reference internal" href="#change-32c8f2eaa85fc02c7f1908ade43391a6">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/212/">#212</a>

357

358

</li>

359

<li>[bug] Cleaned up all the various deprecation/

360

file warnings when running the tests under

361

various Pythons with warnings turned on.<a class="changeset-link headerlink reference internal" href="#change-3493666706cc97f02aa1454a0bfa8b05">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/213/">#213</a>

362

363

</li>

364

</ul>

365

</div>

366

367

368

Released: Wed Apr 10 2013<ul class="simple">

369

<li>[feature] Performance improvement to the

370

“legacy” HTML escape feature, used for XML

371

escaping and when markupsafe isn’t present,

372

courtesy George Xie.<a class="changeset-link headerlink reference internal" href="#change-6b0ea675bf69869d3082ead0019268ac">¶</a>

373

374

</li>

375

<li>[bug] Fixed bug whereby an exception in Python 3

376

against a module compiled to the filesystem would

377

fail trying to produce a RichTraceback due to the

378

content being in bytes.<a class="changeset-link headerlink reference internal" href="#change-9a75951207d1a79183ecde188ec6dc0f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/209/">#209</a>

379

380

</li>

381

<li>[bug] Change default for compile()->reserved_names

382

from tuple to frozenset, as this is expected to be

383

a set by default.<a class="changeset-link headerlink reference internal" href="#change-c3d6a16577c7159388068ce214713af5">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/208/">#208</a>

384

385

</li>

386

<li>[feature] Code has been reworked to support Python 2.4->

387

Python 3.xx in place. 2to3 no longer needed.<a class="changeset-link headerlink reference internal" href="#change-eaf9d70768b7b2e3bf37574dc5776ddb">¶</a>

388

389

</li>

390

<li>[feature] Added lexer_cls argument to Template,

391

TemplateLookup, allows alternate Lexer classes

392

to be used.<a class="changeset-link headerlink reference internal" href="#change-26eea0f7e4b73fcb7f112ad6fff7181d">¶</a>

393

394

</li>

395

<li>[feature] Added future_imports parameter to Template

396

and TemplateLookup, renders the __future__ header

397

with desired capabilities at the top of the generated

398

template module. Courtesy Ben Trofatter.<a class="changeset-link headerlink reference internal" href="#change-b7ef07a547af42dd2677a0ee710a88d8">¶</a>

399

400

</li>

401

</ul>

402

</div>

403

</div>

404

405

406

407

408

Released: Wed Nov 7 2012<ul class="simple">

409

<li>[bug] legacy_html_escape function, used when

410

Markupsafe isn’t installed, was using an inline-compiled

411

regexp which causes major slowdowns on Python 3.3;

412

is now precompiled.<a class="changeset-link headerlink reference internal" href="#change-5b7ac5083658b50ef3156f602a6fbc7f">¶</a>

413

414

</li>

415

<li>[bug] AST supporting now supports tuple-packed

416

function arguments inside pure-python def

417

or lambda expressions.<a class="changeset-link headerlink reference internal" href="#change-591582542cc9469802a12b959ae762fa">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/201/">#201</a>

418

419

</li>

420

<li>[bug] Fixed Py3K bug in the Babel extension.<a class="changeset-link headerlink reference internal" href="#change-3b3a50e075d4d15358ec199aa7c10fa0">¶</a>

421

422

</li>

423

<li>[bug] Fixed the “filter” attribute of the

424

<%text> tag so that it pulls locally specified

425

identifiers from the context the same

426

way as that of <%block> and <%filter>.<a class="changeset-link headerlink reference internal" href="#change-535675bd3ae6ed887cfebf09a83d4311">¶</a>

427

428

</li>

429

<li>[bug] Fixed bug in plugin loader to correctly

430

raise exception when non-existent plugin

431

is specified.<a class="changeset-link headerlink reference internal" href="#change-618340e118c47998e9a6a21d3dfeab3c">¶</a>

432

433

</li>

434

</ul>

435

</div>

436

437

438

Released: Fri Jul 20 2012<ul class="simple">

439

<li>[bug] Fixed regression in 0.7.1 where AST

440

parsing for Py2.4 was broken.<a class="changeset-link headerlink reference internal" href="#change-24885c510552de270fdab999df4d3ee3">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/193/">#193</a>

441

442

</li>

443

</ul>

444

</div>

445

446

447

Released: Sun Jul 8 2012<ul class="simple">

448

<li>[feature] Control lines with no bodies will

449

now succeed, as “pass” is added for these

450

when no statements are otherwise present.

451

Courtesy Ben Trofatter<a class="changeset-link headerlink reference internal" href="#change-52ee3c2b0c1b4d4444ec4e93c7aafa2b">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/146/">#146</a>

452

453

</li>

454

<li>[bug] Fixed some long-broken scoping behavior

455

involving variables declared in defs and such,

456

which only became apparent when

457

the strict_undefined flag was turned on.<a class="changeset-link headerlink reference internal" href="#change-149cdf4c14f9bacfe6dfa61ce8379d4e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/192/">#192</a>

458

459

</li>

460

<li>[bug] Can now use strict_undefined at the

461

same time args passed to def() are used

462

by other elements of the <%def> tag.<a class="changeset-link headerlink reference internal" href="#change-28b06199f79ad5944ce27c6ca795912e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/191/">#191</a>

463

464

</li>

465

</ul>

466

</div>

467

468

469

Released: Fri Mar 30 2012<ul class="simple">

470

<li>[feature] Added new “loop” variable to templates,

471

is provided within a % for block to provide

472

info about the loop such as index, first/last,

473

odd/even, etc. A migration path is also provided

474

for legacy templates via the “enable_loop” argument

475

available on Template, TemplateLookup, and <%page>.

476

Thanks to Ben Trofatter for all

477

the work on this<a class="changeset-link headerlink reference internal" href="#change-99281e61032772527b9b88fa8420e86a">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/125/">#125</a>

478

479

</li>

480

<li>[feature] Added a real check for “reserved”

481

names, that is names which are never pulled

482

from the context and cannot be passed to

483

the template.render() method. Current names

484

are “context”, “loop”, “UNDEFINED”.<a class="changeset-link headerlink reference internal" href="#change-7e9210f880731443d88f862a56ff6279">¶</a>

485

486

</li>

487

<li>[feature] The html_error_template() will now

488

apply Pygments highlighting to the source

489

code displayed in the traceback, if Pygments

490

if available. Courtesy Ben Trofatter<a class="changeset-link headerlink reference internal" href="#change-e3c973cf437f4220015f2d5107b90685">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/95/">#95</a>

491

492

</li>

493

<li>[feature] Added support for context managers,

494

i.e. “% with x as e:/ % endwith” support.

495

Courtesy Ben Trofatter<a class="changeset-link headerlink reference internal" href="#change-3fe398b17c8a48c37534222a31cb6e95">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/147/">#147</a>

496

497

</li>

498

<li>[feature] Added class-level flag to CacheImpl

499

“pass_context”; when True, the keyword argument

500

‘context’ will be passed to get_or_create()

501

containing the Mako Context object.<a class="changeset-link headerlink reference internal" href="#change-4071228d8de4b33e68b6655b7e55324b">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/185/">#185</a>

502

503

</li>

504

<li>[bug] Fixed some Py3K resource warnings due

505

to filehandles being implicitly closed.<a class="changeset-link headerlink reference internal" href="#change-9992c56ef372da93242c0408fde81739">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/182/">#182</a>

506

507

</li>

508

<li>[bug] Fixed endless recursion bug when

509

nesting multiple def-calls with content.

510

Thanks to Jeff Dairiki.<a class="changeset-link headerlink reference internal" href="#change-99f0e301249bf150b6a9aa25f7271be5">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/186/">#186</a>

511

512

</li>

513

<li>[feature] Added Jinja2 to the example

514

benchmark suite, courtesy Vincent Férotin<a class="changeset-link headerlink reference internal" href="#change-5a11b79be7c693f1faf8601f7f61ddfe">¶</a>

515

516

</li>

517

</ul>

518

</div>

519

</div>

520

521

<h2>Older Versions<a class="headerlink" href="#older-versions" title="Permalink to this headline">¶</a></h2>

522

523

524

Released: Thu Feb 2 2012<ul class="simple">

525

<li>[bug] The ${{“foo”:”bar”}} parsing issue is fixed!!

526

The legendary Eevee has slain the dragon!. Also fixes quoting issue

527

at.<a class="changeset-link headerlink reference internal" href="#change-9b201e18db55b80dfdde3ccedde47930">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/86/">#86</a>, <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/20/">#20</a>

528

529

</li>

530

</ul>

531

</div>

532

533

534

Released: Sat Jan 28 2012<ul class="simple">

535

<li>[bug] Added special compatibility for the 0.5.0

536

Cache() constructor, which was preventing file

537

version checks and not allowing Mako 0.6 to

538

recompile the module files.<a class="changeset-link headerlink reference internal" href="#change-cfec33b6e59137a9512e1f1395305774">¶</a>

539

540

</li>

541

</ul>

542

</div>

543

544

545

Released: Sat Jan 21 2012<ul class="simple">

546

<li>[feature] Template caching has been converted into a plugin

547

system, whereby the usage of Beaker is just the

548

default plugin. Template and TemplateLookup

549

now accept a string “cache_impl” parameter which

550

refers to the name of a cache plugin, defaulting

551

to the name ‘beaker’. New plugins can be

552

registered as pkg_resources entrypoints under

553

the group “mako.cache”, or registered directly

554

using mako.cache.register_plugin(). The

555

core plugin is the mako.cache.CacheImpl

556

class.<a class="changeset-link headerlink reference internal" href="#change-2b9d5caf9d33544a386cc21b37a81524">¶</a>

557

558

</li>

559

<li>[feature] Added support for Beaker cache regions

560

in templates. Usage of regions should be considered

561

as superseding the very obsolete idea of passing in

562

backend options, timeouts, etc. within templates.<a class="changeset-link headerlink reference internal" href="#change-6296089f9cbb6d381f1307e8c87903b3">¶</a>

563

564

</li>

565

<li>[feature] The ‘put’ method on Cache is now

566

‘set’. ‘put’ is there for backwards compatibility.<a class="changeset-link headerlink reference internal" href="#change-0843fd024a1d50547e36cb04a4e8b78a">¶</a>

567

568

</li>

569

<li>[feature] The <%def>, <%block> and <%page> tags now accept

570

any argument named “cache_*”, and the key

571

minus the “<a href="#id11">cache_</a>” prefix will be passed as keyword

572

arguments to the CacheImpl methods.<a class="changeset-link headerlink reference internal" href="#change-4f115c692e6156a01ef13450ebbd33dc">¶</a>

573

574

</li>

575

<li>[feature] Template and TemplateLookup now accept an argument

576

cache_args, which refers to a dictionary containing

577

cache parameters. The cache_dir, cache_url, cache_type,

578

cache_timeout arguments are deprecated (will probably

579

never be removed, however) and can be passed

580

now as cache_args={‘url’:<some url>, ‘type’:’memcached’,

581

‘timeout’:50, ‘dir’:’/path/to/some/directory’}<a class="changeset-link headerlink reference internal" href="#change-7a7b3c617612239ebce8bf870d937090">¶</a>

582

583

</li>

584

<li>[feature/bug] Can now refer to context variables

585

within extra arguments to <%block>, <%def>, i.e.

586

<%block name=”foo” cache_key=”${somekey}”>.

587

Filters can also be used in this way, i.e.

588

<%def name=”foo()” filter=”myfilter”>

589

then template.render(myfilter=some_callable)<a class="changeset-link headerlink reference internal" href="#change-d114a1d74a7437b6c3aabe27990a6ed2">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/180/">#180</a>

590

591

</li>

592

<li>[feature] Added “–var name=value” option to the mako-render

593

script, allows passing of kw to the template from

594

the command line.<a class="changeset-link headerlink reference internal" href="#change-9f5fae46c69a1c75f7490adf375f8050">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/178/">#178</a>

595

596

</li>

597

<li>[feature] Added module_writer argument to Template,

598

TemplateLookup, allows a callable to be passed which

599

takes over the writing of the template’s module source

600

file, so that special environment-specific steps

601

can be taken.<a class="changeset-link headerlink reference internal" href="#change-ee72323bae6ecd6f7f0412b687fea6b1">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/181/">#181</a>

602

603

</li>

604

<li>[bug] The exception message in the html_error_template

605

is now escaped with the HTML filter.<a class="changeset-link headerlink reference internal" href="#change-460448904caed525985e90d2fe23dc6f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/142/">#142</a>

606

607

</li>

608

<li>[bug] Added “white-space:pre” style to html_error_template()

609

for code blocks so that indentation is preserved<a class="changeset-link headerlink reference internal" href="#change-0f53470e3d2ace00fedfec05980570bf">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/173/">#173</a>

610

611

</li>

612

<li>[bug] The “benchmark” example is now Python 3 compatible

613

(even though several of those old template libs aren’t

614

available on Py3K, so YMMV)<a class="changeset-link headerlink reference internal" href="#change-a268e715c3a48b1d2e6651948d9f6739">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/175/">#175</a>

615

616

</li>

617

</ul>

618

</div>

619

620

621

Released: Wed Sep 28 2011<ul class="simple">

622

<li>A Template is explicitly disallowed

623

from having a url that normalizes to relative outside

624

of the root. That is, if the Lookup is based

625

at /home/mytemplates, an include that would place

626

the ultimate template at

627

/home/mytemplates/../some_other_directory,

628

i.e. outside of /home/mytemplates,

629

is disallowed. This usage was never intended

630

despite the lack of an explicit check.

631

The main issue this causes

632

is that module files can be written outside

633

of the module root (or raise an error, if file perms aren’t

634

set up), and can also lead to the same template being

635

cached in the lookup under multiple, relative roots.

636

TemplateLookup instead has always supported multiple

637

file roots for this purpose.<a class="changeset-link headerlink reference internal" href="#change-d25af015b75fa0212ca7997ee8f85ee1">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/174/">#174</a>

638

639

</li>

640

</ul>

641

</div>

642

643

644

Released: Fri Aug 5 2011<ul class="simple">

645

<li>Fixed bug regarding <%call>/def calls w/ content

646

whereby the identity of the “caller” callable

647

inside the <%def> would be corrupted by the

648

presence of another <%call> in the same block.<a class="changeset-link headerlink reference internal" href="#change-0d5b25f911cea09b48a3cea73dc8b0ad">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/170/">#170</a>

649

650

</li>

651

<li>Fixed the babel plugin to accommodate <%block><a class="changeset-link headerlink reference internal" href="#change-131badc51e07746b68123281fa7380a3">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/169/">#169</a>

652

653

</li>

654

</ul>

655

</div>

656

657

658

Released: Wed Apr 6 2011<ul class="simple">

659

<li>New tag: <%block>. A variant on <%def> that

660

evaluates its contents in-place.

661

Can be named or anonymous,

662

the named version is intended for inheritance

663

layouts where any given section can be

664

surrounded by the <%block> tag in order for

665

it to become overrideable by inheriting

666

templates, without the need to specify a

667

top-level <%def> plus explicit call.

668

Modified scoping and argument rules as well as a

669

more strictly enforced usage scheme make it ideal

670

for this purpose without at all replacing most

671

other things that defs are still good for.

672

Lots of new docs.<a class="changeset-link headerlink reference internal" href="#change-464bf94bda97d9dfacb13c327c30f669">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/164/">#164</a>

673

674

</li>

675

<li>a slight adjustment to the “highlight” logic

676

for generating template bound stacktraces.

677

Will stick to known template source lines

678

without any extra guessing.<a class="changeset-link headerlink reference internal" href="#change-e5f029ea7d0f9f821c25e308c354006c">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/165/">#165</a>

679

680

</li>

681

</ul>

682

</div>

683

684

685

Released: Sun Mar 6 2011<ul class="simple">

686

<li>A 20% speedup for a basic two-page

687

inheritance setup rendering

688

a table of escaped data

689

(see <a class="reference external" href="http://techspot.zzzeek.org/2010/11/19/quick-mako-vs.-jinja-speed-test/">http://techspot.zzzeek.org/2010/11/19/quick-mako-vs.-jinja-speed-test/</a>).

690

A few configurational changes which

691

affect those in the I-don’t-do-unicode

692

camp should be noted below.<a class="changeset-link headerlink reference internal" href="#change-24faf88ef298503c8544d93f64092984">¶</a>

693

694

</li>

695

<li>The FastEncodingBuffer is now used

696

by default instead of cStringIO or StringIO,

697

regardless of whether output_encoding

698

is set to None or not. FEB is faster than

699

both. Only StringIO allows bytestrings

700

of unknown encoding to pass right

701

through, however - while it is of course

702

not recommended to send bytestrings of unknown

703

encoding to the output stream, this

704

mode of usage can be re-enabled by

705

setting the flag bytestring_passthrough

706

to True.<a class="changeset-link headerlink reference internal" href="#change-4e7e70e466a6b372ba2085724f0c0dcc">¶</a>

707

708

</li>

709

<li>disable_unicode mode requires that

710

output_encoding be set to None - it also

711

forces the bytestring_passthrough flag

712

to True.<a class="changeset-link headerlink reference internal" href="#change-b23a68d0fccb2b8b34d1a727397669a5">¶</a>

713

714

</li>

715

<li>the <%namespace> tag raises an error

716

if the ‘template’ and ‘module’ attributes

717

are specified at the same time in

718

one tag. A different class is used

719

for each case which allows a reduction in

720

runtime conditional logic and function

721

call overhead.<a class="changeset-link headerlink reference internal" href="#change-0237ae4dc8e41beca5fe6392fbd68f4e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/156/">#156</a>

722

723

</li>

724

<li>the keys() in the Context, as well as

725

it’s internal _data dictionary, now

726

include just what was specified to

727

render() as well as Mako builtins

728

‘caller’, ‘capture’. The contents

729

of __builtin__ are no longer copied.

730

Thanks to Daniel Lopez for pointing

731

this out.<a class="changeset-link headerlink reference internal" href="#change-a23ec787ca226d13d1115300493de625">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/159/">#159</a>

732

733

</li>

734

</ul>

735

</div>

736

737

738

Released: Sat Nov 13 2010<ul class="simple">

739

<li>Documentation is on Sphinx.<a class="changeset-link headerlink reference internal" href="#change-ba90f64b03241356193e4e9fef913f63">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/126/">#126</a>

740

741

</li>

742

<li>Beaker is now part of “extras” in

743

setup.py instead of “install_requires”.

744

This to produce a lighter weight install

745

for those who don’t use the caching

746

as well as to conform to Pyramid

747

deployment practices.<a class="changeset-link headerlink reference internal" href="#change-6fa26d3bfceaff55a258fb53794e6313">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/154/">#154</a>

748

749

</li>

750

<li>The Beaker import (or attempt thereof)

751

is delayed until actually needed;

752

this to remove the performance penalty

753

from startup, particularly for

754

“single execution” environments

755

such as shell scripts.<a class="changeset-link headerlink reference internal" href="#change-add98954fc4473f31b998fd2931c0c2c">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/153/">#153</a>

756

757

</li>

758

<li>Patch to lexer to not generate an empty

759

‘’ write in the case of backslash-ended

760

lines.<a class="changeset-link headerlink reference internal" href="#change-6f50239252b9579a5a952a529cce3c8f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/155/">#155</a>

761

762

</li>

763

<li>Fixed missing <a href="#id5">**</a>extra collection in

764

setup.py which prevented setup.py

765

from running 2to3 on install.<a class="changeset-link headerlink reference internal" href="#change-9007a381dea9bd8a980aaf646712fa95">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/148/">#148</a>

766

767

</li>

768

<li>New flag on Template, TemplateLookup -

769

strict_undefined=True, will cause

770

variables not found in the context to

771

raise a NameError immediately, instead of

772

defaulting to the UNDEFINED value.<a class="changeset-link headerlink reference internal" href="#change-d94085d95e60f190e30871ff1c472781">¶</a>

773

774

</li>

775

<li>The range of Python identifiers that

776

are considered “undefined”, meaning they

777

are pulled from the context, has been

778

trimmed back to not include variables

779

declared inside of expressions (i.e. from

780

list comprehensions), as well as

781

in the argument list of lambdas. This

782

to better support the strict_undefined

783

feature. The change should be

784

fully backwards-compatible but involved

785

a little bit of tinkering in the AST code,

786

which hadn’t really been touched for

787

a couple of years, just FYI.<a class="changeset-link headerlink reference internal" href="#change-c7f4bd0543dcd61c301325887e5e868f">¶</a>

788

789

</li>

790

</ul>

791

</div>

792

793

794

Released: Sun Oct 24 2010<ul class="simple">

795

<li>The <%namespace> tag allows expressions

796

for the <cite>file</cite> argument, i.e. with ${}.

797

The <cite>context</cite> variable, if needed,

798

must be referenced explicitly.<a class="changeset-link headerlink reference internal" href="#change-4f131130d9a9c7503c1285d76453772e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/141/">#141</a>

799

800

</li>

801

<li>${} expressions embedded in tags,

802

such as <%foo:bar x=”${...}”>, now

803

allow multiline Python expressions.<a class="changeset-link headerlink reference internal" href="#change-9260777204b90b5d2ef50591a9321f7f">¶</a>

804

805

</li>

806

<li>Fixed previously non-covered regular

807

expression, such that using a ${} expression

808

inside of a tag element that doesn’t allow

809

them raises a CompileException instead of

810

silently failing.<a class="changeset-link headerlink reference internal" href="#change-b17753b5fc8d7a350d6c9d07d9e8698b">¶</a>

811

812

</li>

813

<li>Added a try/except around “import markupsafe”.

814

This to support GAE which can’t run markupsafe. No idea whatsoever if the

815

install_requires in setup.py also breaks GAE,

816

couldn’t get an answer on this.<a class="changeset-link headerlink reference internal" href="#change-26a430536a4ef0aea275166c8ffead73">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/151/">#151</a>

817

818

</li>

819

</ul>

820

</div>

821

822

823

Released: Tue Jun 22 2010<ul class="simple">

824

<li>Now using MarkupSafe for HTML escaping,

825

i.e. in place of cgi.escape(). Faster

826

C-based implementation and also escapes

827

single quotes for additional security.

828

Supports the __html__ attribute for

829

the given expression as well.When using “disable_unicode” mode,

830

a pure Python HTML escaper function

831

is used which also quotes single quotes.

832

Note that Pylons by default doesn’t

833

use Mako’s filter - check your

834

environment.py file.

835

836

837

</li>

838

<li>Fixed call to “unicode.strip” in

839

exceptions.text_error_template which

840

is not Py3k compatible.<a class="changeset-link headerlink reference internal" href="#change-c6b3b30f351cb6e68140eb7ff8ec9339">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/137/">#137</a>

841

842

</li>

843

</ul>

844

</div>

845

846

847

Released: Mon May 31 2010<ul class="simple">

848

<li>Added conditional to RichTraceback

849

such that if no traceback is passed

850

and sys.exc_info() has been reset,

851

the formatter just returns blank

852

for the “traceback” portion.<a class="changeset-link headerlink reference internal" href="#change-bc6d3046e00861b0a815a3373dc21489">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/135/">#135</a>

853

854

</li>

855

<li>Fixed sometimes incorrect usage of

856

exc.__class__.__name__

857

in html/text error templates when using

858

Python 2.4<a class="changeset-link headerlink reference internal" href="#change-7398285484aa0b44f7cb4314d635343f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/131/">#131</a>

859

860

</li>

861

<li>Fixed broken @property decorator on

862

template.last_modified<a class="changeset-link headerlink reference internal" href="#change-fc38c54c185a03815b882ae0235dd0ec">¶</a>

863

864

</li>

865

<li>Fixed error formatting when a stacktrace

866

line contains no line number, as in when

867

inside an eval/exec-generated function.<a class="changeset-link headerlink reference internal" href="#change-e351477ece87f96ce3b8dcbe2093927e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/132/">#132</a>

868

869

</li>

870

<li>When a .py is being created, the tempfile

871

where the source is stored temporarily is

872

now made in the same directory as that of

873

the .py file. This ensures that the two

874

files share the same filesystem, thus

875

avoiding cross-filesystem synchronization

876

issues. Thanks to Charles Cazabon.<a class="changeset-link headerlink reference internal" href="#change-8465d2f035b94270f61add8d37b484b6">¶</a>

877

878

</li>

879

</ul>

880

</div>

881

882

883

Released: Thu Mar 11 2010<ul class="simple">

884

<li>Calling a def from the top, via

885

template.get_def(...).render() now checks the

886

argument signature the same way as it did in

887

0.2.5, so that TypeError is not raised.

888

reopen of<a class="changeset-link headerlink reference internal" href="#change-99967455a3839ef3b397981de9a7b95e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/116/">#116</a>

889

890

</li>

891

</ul>

892

</div>

893

894

895

Released: Sun Mar 7 2010<ul class="simple">

896

<li>Fixed incorrect dir name in setup.py<a class="changeset-link headerlink reference internal" href="#change-10954fab107bd4f83df29f01b7a1db1a">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/129/">#129</a>

897

898

</li>

899

</ul>

900

</div>

901

902

903

Released: Fri Mar 5 2010<ul class="simple">

904

<li>Python 2.3 support is dropped.<a class="changeset-link headerlink reference internal" href="#change-6696642b595c45f48c676d4321c80f4e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/123/">#123</a>

905

906

</li>

907

<li>Python 3 support is added ! See README.py3k

908

for installation and testing notes.<a class="changeset-link headerlink reference internal" href="#change-4ac95d25798d0af74fcbbda6805f4117">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/119/">#119</a>

909

910

</li>

911

<li>Unit tests now run with nose.<a class="changeset-link headerlink reference internal" href="#change-580b71306f06a35525d94dbbc866dff5">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/127/">#127</a>

912

913

</li>

914

<li>Source code escaping has been simplified.

915

In particular, module source files are now

916

generated with the Python “magic encoding

917

comment”, and source code is passed through

918

mostly unescaped, except for that code which

919

is regenerated from parsed Python source.

920

This fixes usage of unicode in

921

<%namespace:defname> tags.<a class="changeset-link headerlink reference internal" href="#change-254948cdd845470bc120bd9537620480">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/99/">#99</a>

922

923

</li>

924

<li>RichTraceback(), html_error_template().render(),

925

text_error_template().render() now accept “error”

926

and “traceback” as optional arguments, and

927

these are now actually used.<a class="changeset-link headerlink reference internal" href="#change-b8d940f383df524cbcb09a4aa8785055">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/122/">#122</a>

928

929

</li>

930

<li>The exception output generated when

931

format_exceptions=True will now be as a Python

932

unicode if it occurred during render_unicode(),

933

or an encoded string if during render().<a class="changeset-link headerlink reference internal" href="#change-c8b4a5c26a15e967ede79e6b3fc12673">¶</a>

934

935

</li>

936

<li>A percent sign can be emitted as the first

937

non-whitespace character on a line by escaping

938

it as in “%%”.<a class="changeset-link headerlink reference internal" href="#change-3685f613780a1778275c5a1c06ffd14d">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/112/">#112</a>

939

940

</li>

941

<li>Template accepts empty control structure, i.e.

942

% if: %endif, etc.<a class="changeset-link headerlink reference internal" href="#change-0b344165d32f9da5eebc93d2e36b751d">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/94/">#94</a>

943

944

</li>

945

<li>The <%page args> tag can now be used in a base

946

inheriting template - the full set of render()

947

arguments are passed down through the inherits

948

chain. Undeclared arguments go into <a href="#id7">**</a>pageargs

949

as usual.<a class="changeset-link headerlink reference internal" href="#change-4e41287388f6da51881b95c2fc27ff9d">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/116/">#116</a>

950

951

</li>

952

<li>defs declared within a <%namespace> section, an

953

uncommon feature, have been improved. The defs

954

no longer get doubly-rendered in the body() scope,

955

and now allow local variable assignment without

956

breakage.<a class="changeset-link headerlink reference internal" href="#change-8f84b7484a62925c50f48334ee6a9756">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/109/">#109</a>

957

958

</li>

959

<li>Windows paths are handled correctly if a Template

960

is passed only an absolute filename (i.e. with c:

961

drive etc.) and no URI - the URI is converted

962

to a forward-slash path and module_directory

963

is treated as a windows path.<a class="changeset-link headerlink reference internal" href="#change-b282c56c8f7389792db2e50b26f4d871">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/128/">#128</a>

964

965

</li>

966

<li>TemplateLookup raises TopLevelLookupException for

967

a given path that is a directory, not a filename,

968

instead of passing through to the template to

969

generate IOError.<a class="changeset-link headerlink reference internal" href="#change-5ea16c786c94f8e04c3e8f5ea3a3b423">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/73/">#73</a>

970

971

</li>

972

</ul>

973

</div>

974

975

976

no release date<ul class="simple">

977

<li>Fix mako function decorators to preserve the

978

original function’s name in all cases. Patch

979

from Scott Torborg.<a class="changeset-link headerlink reference internal" href="#change-d1e4c26171841e1c4fbc0e3f56d0bf96">¶</a>

980

981

</li>

982

<li>Support the <%namespacename:defname> syntax in

983

the babel extractor.<a class="changeset-link headerlink reference internal" href="#change-d1851b428e06541460cbd70bd5c6131f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/118/">#118</a>

984

985

</li>

986

<li>Further fixes to unicode handling of .py files with the

987

html_error_template.<a class="changeset-link headerlink reference internal" href="#change-398bff9c71f24a9ff6c180d0a05018b4">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/88/">#88</a>

988

989

</li>

990

</ul>

991

</div>

992

993

994

Released: Mon Sep 7 2009<ul class="simple">

995

<li>Added a “decorator” kw argument to <%def>,

996

allows custom decoration functions to wrap

997

rendering callables. Mainly intended for

998

custom caching algorithms, not sure what

999

other uses there may be (but there may be).

1000

Examples are in the “filtering” docs.<a class="changeset-link headerlink reference internal" href="#change-c79258c92155abe15ab0f249e56d36f8">¶</a>

1001

1002

</li>

1003

<li>When Mako creates subdirectories in which

1004

to store templates, it uses the more

1005

permissive mode of 0775 instead of 0750,

1006

helping out with certain multi-process

1007

scenarios. Note that the mode is always

1008

subject to the restrictions of the existing

1009

umask.<a class="changeset-link headerlink reference internal" href="#change-4807d411f1e3cfa18c32decd089cab90">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/101/">#101</a>

1010

1011

</li>

1012

<li>Fixed namespace.__getattr__() to raise

1013

AttributeError on attribute not found

1014

instead of RuntimeError.<a class="changeset-link headerlink reference internal" href="#change-8af1bb98b05bf16f832aaea1707f20fb">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/104/">#104</a>

1015

1016

</li>

1017

<li>Added last_modified accessor to Template,

1018

returns the time.time() when the module

1019

was created.<a class="changeset-link headerlink reference internal" href="#change-ca99b7588c54e67a73569aad8e06c0ce">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/97/">#97</a>

1020

1021

</li>

1022

<li>Fixed lexing support for whitespace

1023

around ‘=’ sign in defs.<a class="changeset-link headerlink reference internal" href="#change-d18e860647e39ec0f72eeb38740111cb">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/102/">#102</a>

1024

1025

</li>

1026

<li>Removed errant “lower()” in the lexer which

1027

was causing tags to compile with

1028

case-insensitive names, thus messing up

1029

custom <%call> names.<a class="changeset-link headerlink reference internal" href="#change-602d7edb91f7f94638496e5544c0b8ee">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/108/">#108</a>

1030

1031

</li>

1032

<li>added “mako.__version__” attribute to

1033

the base module.<a class="changeset-link headerlink reference internal" href="#change-9980854809a31d4b404208e286a70d41">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/110/">#110</a>

1034

1035

</li>

1036

</ul>

1037

</div>

1038

1039

1040

Released: Tue Dec 23 2008<ul class="simple">

1041

<li>Fixed compatibility with Jython 2.5b1.<a class="changeset-link headerlink reference internal" href="#change-4854b3f9b6cb5776937ab0695fff1435">¶</a>

1042

1043

</li>

1044

</ul>

1045

</div>

1046

1047

1048

Released: Sun Nov 23 2008<ul class="simple">

1049

<li>the <%namespacename:defname> syntax described at

1050

<a class="reference external" href="http://techspot.zzzeek.org/?p=28">http://techspot.zzzeek.org/?p=28</a> has now

1051

been added as a built in syntax, and is recommended

1052

as a more modern syntax versus <%call expr=”expression”>.

1053

The %call tag itself will always remain,

1054

with <%namespacename:defname> presenting a more HTML-like

1055

alternative to calling defs, both plain and

1056

nested. Many examples of the new syntax are in the

1057

“Calling a def with embedded content” section

1058

of the docs.<a class="changeset-link headerlink reference internal" href="#change-37bce8b359a8e44e7b91c12652eee2b8">¶</a>

1059

1060

</li>

1061

<li>added support for Jython 2.5.<a class="changeset-link headerlink reference internal" href="#change-35a6c7b85a04372530f2be1805959799">¶</a>

1062

1063

</li>

1064

<li>cache module now uses Beaker’s CacheManager

1065

object directly, so that all cache types are included.

1066

memcached is available as both “ext:memcached” and

1067

“memcached”, the latter for backwards compatibility.<a class="changeset-link headerlink reference internal" href="#change-f8334ef0e1678c06e374ba1a0d3931cd">¶</a>

1068

1069

</li>

1070

<li>added “cache” accessor to Template, Namespace.

1071

e.g. ${local.cache.get(‘somekey’)} or

1072

template.cache.invalidate_body()<a class="changeset-link headerlink reference internal" href="#change-ed3a6c17f2cbd83a593de4d2724a6a84">¶</a>

1073

1074

</li>

1075

<li>added “cache_enabled=True” flag to Template,

1076

TemplateLookup. Setting this to False causes cache

1077

operations to “pass through” and execute every time;

1078

this flag should be integrated in Pylons with its own

1079

cache_enabled configuration setting.<a class="changeset-link headerlink reference internal" href="#change-70e586f7cde0ac7b344e8e8986c58b9a">¶</a>

1080

1081

</li>

1082

<li>the Cache object now supports invalidate_def(name),

1083

invalidate_body(), invalidate_closure(name),

1084

invalidate(key), which will remove the given key

1085

from the cache, if it exists. The cache arguments

1086

(i.e. storage type) are derived from whatever has

1087

been already persisted for that template.<a class="changeset-link headerlink reference internal" href="#change-fe9e64fb24df2528a185b3317fce35fb">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/92/">#92</a>

1088

1089

</li>

1090

<li>For cache changes to work fully, Beaker 1.1 is required.

1091

1.0.1 and up will work as well with the exception of

1092

cache expiry. Note that Beaker 1.1 is required

1093

for applications which use dynamically generated keys,

1094

since previous versions will permanently store state in memory

1095

for each individual key, thus consuming all available

1096

memory for an arbitrarily large number of distinct

1097

keys.<a class="changeset-link headerlink reference internal" href="#change-fc8e53f27e96f1442a8e85b52988d4c4">¶</a>

1098

1099

</li>

1100

<li>fixed bug whereby an <%included> template with

1101

<%page> args named the same as a __builtin__ would not

1102

honor the default value specified in <%page><a class="changeset-link headerlink reference internal" href="#change-6215a523e4a44009dd085141f89bb1ea">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/93/">#93</a>

1103

1104

</li>

1105

<li>fixed the html_error_template not handling tracebacks from

1106

normal .py files with a magic encoding comment<a class="changeset-link headerlink reference internal" href="#change-c269853926ff7f52a94ddf94c705cff7">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/88/">#88</a>

1107

1108

</li>

1109

<li>RichTraceback() now accepts an optional traceback object

1110

to be used in place of sys.exc_info()[2]. html_error_template()

1111

and text_error_template() accept an optional

1112

render()-time argument “traceback” which is passed to the

1113

RichTraceback object.<a class="changeset-link headerlink reference internal" href="#change-87c44d844a042343e22d55e2a2b8d4e9">¶</a>

1114

1115

</li>

1116

<li>added ModuleTemplate class, which allows the construction

1117

of a Template given a Python module generated by a previous

1118

Template. This allows Python modules alone to be used

1119

as templates with no compilation step. Source code

1120

and template source are optional but allow error reporting

1121

to work correctly.<a class="changeset-link headerlink reference internal" href="#change-7a562520a57d62460f54fadac0d94100">¶</a>

1122

1123

</li>

1124

<li>fixed Python 2.3 compat. in mako.pyparser<a class="changeset-link headerlink reference internal" href="#change-6e699add881ad62aa72c44efa3899ae5">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/90/">#90</a>

1125

1126

</li>

1127

<li>fix Babel 0.9.3 compatibility; stripping comment tags is now

1128

optional (and enabled by default).<a class="changeset-link headerlink reference internal" href="#change-54c464fa5c94b0aba86b2b99d13f9eb4">¶</a>

1129

1130

</li>

1131

</ul>

1132

</div>

1133

1134

1135

Released: Mon Jun 23 2008<ul class="simple">

1136

<li>cached blocks now use the current context when rendering

1137

an expired section, instead of the original context

1138

passed in<a class="changeset-link headerlink reference internal" href="#change-df54b04a766bd7511f1b92e438573fdf">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/87/">#87</a>

1139

1140

</li>

1141

<li>fixed a critical issue regarding caching, whereby

1142

a cached block would raise an error when called within a

1143

cache-refresh operation that was initiated after the

1144

initiating template had completed rendering.<a class="changeset-link headerlink reference internal" href="#change-c6f8379cfe314e3a5a202e256699d586">¶</a>

1145

1146

</li>

1147

</ul>

1148

</div>

1149

1150

1151

Released: Mon Jun 16 2008<ul class="simple">

1152

<li>fixed bug where ‘output_encoding’ parameter would prevent

1153

render_unicode() from returning a unicode object.<a class="changeset-link headerlink reference internal" href="#change-908eed7e4807846bda8b7883b98f4a02">¶</a>

1154

1155

</li>

1156

<li>bumped magic number, which forces template recompile for

1157

this version (fixes incompatible compile symbols from 0.1

1158

series).<a class="changeset-link headerlink reference internal" href="#change-765658fae385e8c30cafd7372f7da000">¶</a>

1159

1160

</li>

1161

<li>added a few docs for cache options, specifically those that

1162

help with memcached.<a class="changeset-link headerlink reference internal" href="#change-00ae3ce99ec2767e28b645a85815d1f9">¶</a>

1163

1164

</li>

1165

</ul>

1166

</div>

1167

1168

1169

Released: Tue Jun 3 2008<ul class="simple">

1170

<li>Speed improvements (as though we needed them, but people

1171

contributed and there you go):<a class="changeset-link headerlink reference internal" href="#change-7df2aeab716d6fcf91429566949d3297">¶</a>

1172

1173

</li>

1174

<li>added “bytestring passthru” mode, via

1175

<cite>disable_unicode=True</cite> argument passed to Template or

1176

TemplateLookup. All unicode-awareness and filtering is

1177

turned off, and template modules are generated with

1178

the appropriate magic encoding comment. In this mode,

1179

template expressions can only receive raw bytestrings

1180

or Unicode objects which represent straight ASCII, and

1181

render_unicode() may not be used if multibyte

1182

characters are present. When enabled, speed

1183

improvement around 10-20%. (courtesy

1184

anonymous guest)<a class="changeset-link headerlink reference internal" href="#change-d9c6b2b32a4d7d52614f9557a59dd57d">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/77/">#77</a>

1185

1186

</li>

1187

<li>inlined the “write” function of Context into a local

1188

template variable. This affords a 12-30% speedup in

1189

template render time. (idea courtesy same anonymous

1190

guest)<a class="changeset-link headerlink reference internal" href="#change-1e1d8d3bf89815e481535914ac54e954">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/76/">#76</a>

1191

1192

</li>

1193

<li>New Features, API changes:<a class="changeset-link headerlink reference internal" href="#change-4425ad7ea582f24d81e9ca7ef4f92e6e">¶</a>

1194

1195

</li>

1196

<li>added “attr” accessor to namespaces. Returns

1197

attributes configured as module level attributes, i.e.

1198

within <%! %> sections. i.e.:# somefile.html

1199

<%!

1200

1201

1202

%>

1203

# some other template

1204

<%namespace name=”myns” file=”somefile.html”/>

1205

${myns.attr.foo}

1206

The slight backwards incompatibility here is, you

1207

can’t have namespace defs named “attr” since the

1208

“attr” descriptor will occlude it.

1209

<a class="changeset-link headerlink reference internal" href="#change-9da04566e35e386418120e4d29572595">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/62/">#62</a>

1210

1211

</li>

1212

<li>cache_key argument can now render arguments passed

1213

directly to the %page or %def, i.e. <%def

1214

name=”foo(x)” cached=”True” cache_key=”${x}”/><a class="changeset-link headerlink reference internal" href="#change-47006dc7aa8160f70e0ed126113f0f5a">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/78/">#78</a>

1215

1216

</li>

1217

<li>some functions on Context are now private:

1218

_push_buffer(), _pop_buffer(),

1219

caller_stack._push_frame(), caller_stack._pop_frame().<a class="changeset-link headerlink reference internal" href="#change-d5e0803b1807eb8f0128d3ccd973525f">¶</a>

1220

1221

</li>

1222

<li>added a runner script “mako-render” which renders

1223

standard input as a template to stdout<a class="changeset-link headerlink reference internal" href="#change-c53f2fb7206af6bed4a266fc8e39da44">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/56/">#56</a>, <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/81/">#81</a>

1224

1225

</li>

1226

<li>[bugfixes] can now use most names from __builtins__ as variable

1227

names without explicit declaration (i.e. ‘id’,

1228

‘exception’, ‘range’, etc.)<a class="changeset-link headerlink reference internal" href="#change-1cf0feb7e1a86092b97d375978dba60d">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/83/">#83</a>, <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/84/">#84</a>

1229

1230

</li>

1231

<li>[bugfixes] can also use builtin names as local variable names

1232

(i.e. dict, locals) (came from fix for)<a class="changeset-link headerlink reference internal" href="#change-b42dffceb4d5586db34c320d5368a1a0">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/84/">#84</a>

1233

1234

</li>

1235

<li>[bugfixes] fixed bug in python generation when variable names are

1236

used with identifiers like “else”, “finally”, etc.

1237

inside them<a class="changeset-link headerlink reference internal" href="#change-66d96bea88684ee0d97467bfe1ccbd28">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/68/">#68</a>

1238

1239

</li>

1240

<li>[bugfixes] fixed codegen bug which occured when using <%page>

1241

level caching, combined with an expression-based

1242

cache_key, combined with the usage of <%namespace

1243

import=”*”/> - fixed lexer exceptions not cleaning up

1244

temporary files, which could lead to a maximum number

1245

of file descriptors used in the process<a class="changeset-link headerlink reference internal" href="#change-bc4345614fb8e0b7a0f6a4cd7c824afa">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/69/">#69</a>

1246

1247

</li>

1248

<li>[bugfixes] fixed issue with inline format_exceptions that was

1249

producing blank exception pages when an inheriting

1250

template is present<a class="changeset-link headerlink reference internal" href="#change-f7edc331eeedd9d0e4e390279db7f1c6">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/71/">#71</a>

1251

1252

</li>

1253

<li>[bugfixes] format_exceptions will apply the encoding options of

1254

html_error_template() to the buffered output<a class="changeset-link headerlink reference internal" href="#change-c380b62194e7806f2ba96a72cf35f4a5">¶</a>

1255

1256

</li>

1257

<li>[bugfixes] rewrote the “whitespace adjuster” function to work

1258

with more elaborate combinations of quotes and

1259

comments<a class="changeset-link headerlink reference internal" href="#change-aaa77e397a4d5a128ee8ead89aca6552">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/75/">#75</a>

1260

1261

</li>

1262

</ul>

1263

</div>

1264

1265

1266

no release date<ul class="simple">

1267

<li>fixed propagation of ‘caller’ such that nested %def calls

1268

within a <%call> tag’s argument list propigates ‘caller’

1269

to the %call function itself (propigates to the inner

1270

calls too, this is a slight side effect which previously

1271

existed anyway)<a class="changeset-link headerlink reference internal" href="#change-35446d7c963081d4cb4420f1a2b68beb">¶</a>

1272

1273

</li>

1274

<li>fixed bug where local.get_namespace() could put an

1275

incorrect “self” in the current context<a class="changeset-link headerlink reference internal" href="#change-60935107d31e2d12b8725bfa98a4e15e">¶</a>

1276

1277

</li>

1278

<li>fixed another namespace bug where the namespace functions

1279

did not have access to the correct context containing

1280

their ‘self’ and ‘parent’<a class="changeset-link headerlink reference internal" href="#change-a03b9e4773bb4ad04e67baf857946095">¶</a>

1281

1282

</li>

1283

</ul>

1284

</div>

1285

1286

1287

no release date<ul class="simple">

1288

<li>filters.Decode filter can also accept a non-basestring

1289

object and will call str() + unicode() on it<a class="changeset-link headerlink reference internal" href="#change-b6be8d8f9ba7a78451926e2e5a00168a">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/47/">#47</a>

1290

1291

</li>

1292

<li>comments can be placed at the end of control lines,

1293

i.e. if foo: # a comment,, thanks to

1294

Paul Colomiets<a class="changeset-link headerlink reference internal" href="#change-80d0f355df4c2e0e2044d9b34ba8ffe6">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/53/">#53</a>

1295

1296

</li>

1297

<li>fixed expressions and page tag arguments and with embedded

1298

newlines in CRLF templates, follow up to, thanks

1299

Eric Woroshow<a class="changeset-link headerlink reference internal" href="#change-4a1a251233e66deb83ebbca806c75e7e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/16/">#16</a>

1300

1301

</li>

1302

<li>added an IOError catch for source file not found in RichTraceback

1303

exception reporter<a class="changeset-link headerlink reference internal" href="#change-b3479ae6d58bd0ac59439c4b81428d3e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/51/">#51</a>

1304

1305

</li>

1306

</ul>

1307

</div>

1308

1309

1310

Released: Tue Jun 26 2007<ul class="simple">

1311

<li>variable names declared in render methods by internal

1312

codegen prefixed by “__M_” to prevent name collisions

1313

with user code<a class="changeset-link headerlink reference internal" href="#change-bbc10b00b2959f71e6703161fe1a45a1">¶</a>

1314

1315

</li>

1316

<li>added a Babel (<a class="reference external" href="http://babel.edgewall.org/">http://babel.edgewall.org/</a>) extractor entry

1317

point, allowing extraction of gettext messages directly from

1318

mako templates via Babel<a class="changeset-link headerlink reference internal" href="#change-12a94b4bec51562504cc0951143d7b14">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/45/">#45</a>

1319

1320

</li>

1321

<li>fix to turbogears plugin to work with dot-separated names

1322

(i.e. load_template(‘foo.bar’)). also takes file extension

1323

as a keyword argument (default is ‘mak’).<a class="changeset-link headerlink reference internal" href="#change-ff313c4aec5d1b008cf8253396b514d6">¶</a>

1324

1325

</li>

1326

<li>more tg fix: fixed, allowing string-based

1327

templates with tgplugin even if non-compatible args were sent<a class="changeset-link headerlink reference internal" href="#change-7f4b2edc94747c2be57aebfd1f725cf9">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/35/">#35</a>

1328

1329

</li>

1330

</ul>

1331

</div>

1332

1333

1334

Released: Wed Jun 13 2007<ul class="simple">

1335

<li>one small fix to the unit tests to support python 2.3<a class="changeset-link headerlink reference internal" href="#change-f9d399621cbe00065331cffcfd726aaf">¶</a>

1336

1337

</li>

1338

<li>a slight hack to how cache.py detects Beaker’s memcached,

1339

works around unexplained import behavior observed on some

1340

python 2.3 installations<a class="changeset-link headerlink reference internal" href="#change-d54e6f740ac7e3c9302f434352c6ad24">¶</a>

1341

1342

</li>

1343

</ul>

1344

</div>

1345

1346

1347

Released: Fri May 18 2007<ul class="simple">

1348

<li>caching is now supplied directly by Beaker, which has

1349

all of MyghtyUtils merged into it now. The latest Beaker

1350

(0.7.1) also fixes a bug related to how Mako was using the

1351

cache API.<a class="changeset-link headerlink reference internal" href="#change-52836ef58904a858efff55a21272a3aa">¶</a>

1352

1353

</li>

1354

<li>fix to module_directory path generation when the path is ”./”<a class="changeset-link headerlink reference internal" href="#change-7bc90d84523c2290a3350c133e269c20">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/34/">#34</a>

1355

1356

</li>

1357

<li>TGPlugin passes options to string-based templates<a class="changeset-link headerlink reference internal" href="#change-ea6d95d606ab7dd8f3b3f8b49bc0ca99">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/35/">#35</a>

1358

1359

</li>

1360

<li>added an explicit stack frame step to template runtime, which

1361

allows much simpler and hopefully bug-free tracking of ‘caller’,

1362

fixes<a class="changeset-link headerlink reference internal" href="#change-31e1248422bcd0c78c13b47b458a9085">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/28/">#28</a>

1363

1364

</li>

1365

<li>if plain Python defs are used with <%call>, a decorator

1366

@runtime.supports_callable exists to ensure that the “caller”

1367

stack is properly handled for the def.<a class="changeset-link headerlink reference internal" href="#change-54a970a9cf864a6c262da7b7d9216109">¶</a>

1368

1369

</li>

1370

<li>fix to RichTraceback and exception reporting to get template

1371

source code as a unicode object<a class="changeset-link headerlink reference internal" href="#change-d2cd0326db0e6586eabcce097caf31ff">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/37/">#37</a>

1372

1373

</li>

1374

<li>html_error_template includes options “full=True”, “css=True”

1375

which control generation of HTML tags, CSS<a class="changeset-link headerlink reference internal" href="#change-dc0199630744815964c1e6174ea78785">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/39/">#39</a>

1376

1377

</li>

1378

<li>added the ‘encoding_errors’ parameter to Template/TemplateLookup

1379

for specifying the error handler associated with encoding to

1380

‘output_encoding’<a class="changeset-link headerlink reference internal" href="#change-b0a96b76069cee8cd44ba31774b27fa2">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/40/">#40</a>

1381

1382

</li>

1383

<li>the Template returned by html_error_template now defaults to

1384

output_encoding=sys.getdefaultencoding(),

1385

encoding_errors=’htmlentityreplace’<a class="changeset-link headerlink reference internal" href="#change-528e7eeb36e454ad6679969c443b951c">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/37/">#37</a>

1386

1387

</li>

1388

<li>control lines, i.e. % lines, support backslashes to continue long

1389

lines (#32)<a class="changeset-link headerlink reference internal" href="#change-87df4540a9078340f98f18122437d6dd">¶</a>

1390

1391

</li>

1392

<li>fixed codegen bug when defining <%def> within <%call> within <%call><a class="changeset-link headerlink reference internal" href="#change-5a582713c17cb4654879f3adb098f00f">¶</a>

1393

1394

</li>

1395

<li>leading utf-8 BOM in template files is honored according to pep-0263<a class="changeset-link headerlink reference internal" href="#change-e80dc8f529838d0f39320706a515d3fa">¶</a>

1396

1397

</li>

1398

</ul>

1399

</div>

1400

1401

1402

Released: Sat Mar 31 2007<ul class="simple">

1403

<li>AST expression generation - added in just about everything

1404

expression-wise from the AST module<a class="changeset-link headerlink reference internal" href="#change-f55f1eaaa360047ad0dbf07496beae9c">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/26/">#26</a>

1405

1406

</li>

1407

<li>AST parsing, properly detects imports of the form “import foo.bar”<a class="changeset-link headerlink reference internal" href="#change-038f363f37ffb6f6e1d81aaeb32d371d">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/27/">#27</a>

1408

1409

</li>

1410

<li>fix to lexing of <%docs> tag nested in other tags<a class="changeset-link headerlink reference internal" href="#change-fe4577a3f1111e2f31098302811ed765">¶</a>

1411

1412

</li>

1413

<li>fix to context-arguments inside of <%include> tag which broke

1414

during 0.1.4<a class="changeset-link headerlink reference internal" href="#change-895781e7f1f9e56da8e1f7d84a2d75e8">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/29/">#29</a>

1415

1416

</li>

1417

<li>added “n” filter, disables all filters normally applied to an expression

1418

via <%page> or default_filters (but not those within the filter)<a class="changeset-link headerlink reference internal" href="#change-f4a4e7c2e333277389fa0febf1b94548">¶</a>

1419

1420

</li>

1421

<li>added buffer_filters argument, defines filters applied to the return value

1422

of buffered/cached/filtered %defs, after all filters defined with the %def

1423

itself have been applied. allows the creation of default expression filters

1424

that let the output of return-valued %defs “opt out” of that filtering

1425

via passing special attributes or objects.<a class="changeset-link headerlink reference internal" href="#change-1373f4756af28d08dc3d0c42b55ba89f">¶</a>

1426

1427

</li>

1428

</ul>

1429

</div>

1430

1431

1432

Released: Sat Mar 10 2007<ul class="simple">

1433

<li>got defs-within-defs to be cacheable<a class="changeset-link headerlink reference internal" href="#change-d9a3f08eba0431ad7fcc2c4a44ebbae6">¶</a>

1434

1435

</li>

1436

<li>fixes to code parsing/whitespace adjusting where plain python comments

1437

may contain quote characters<a class="changeset-link headerlink reference internal" href="#change-810513a0fe251b003785e47c73c05d6b">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/23/">#23</a>

1438

1439

</li>

1440

<li>fix to variable scoping for identifiers only referenced within

1441

functions<a class="changeset-link headerlink reference internal" href="#change-02205b506bd613a4038f90d3894ff1e4">¶</a>

1442

1443

</li>

1444

<li>added a path normalization step to lookup so URIs like

1445

“/foo/bar/../etc/../foo” pre-process the ”..” tokens before checking

1446

the filesystem<a class="changeset-link headerlink reference internal" href="#change-dffdf2c7b62fa47b54cac838b32b5a15">¶</a>

1447

1448

</li>

1449

<li>fixed/improved “caller” semantics so that undefined caller is

1450

“UNDEFINED”, propigates __nonzero__ method so it evaulates to False if

1451

not present, True otherwise. this way you can say % if caller:n

1452

${caller.body()}n% endif<a class="changeset-link headerlink reference internal" href="#change-2a6fb9feefccb0dc5a6a53f4a1145389">¶</a>

1453

1454

</li>

1455

<li><%include> has an “args” attribute that can pass arguments to the

1456

called template (keyword arguments only, must be declared in that

1457

page’s <%page> tag.)<a class="changeset-link headerlink reference internal" href="#change-7969cae88e43d5ccd928a0e231e9d242">¶</a>

1458

1459

</li>

1460

<li><%include> plus arguments is also programmatically available via

1461

self.include_file(<filename>, <a href="#id9">**</a>kwargs)<a class="changeset-link headerlink reference internal" href="#change-4b7deb2ea46de8d9db7b502ced7728dd">¶</a>

1462

1463

</li>

1464

<li>further escaping added for multibyte expressions in %def, %call

1465

attributes<a class="changeset-link headerlink reference internal" href="#change-5e3d31c7ecde9769cc0daf0a545e50da">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/24/">#24</a>

1466

1467

</li>

1468

</ul>

1469

</div>

1470

1471

1472

Released: Wed Feb 21 2007<ul class="simple">

1473

<li>*Small Syntax Change* - the single line comment character is now

1474

two hash signs, i.e. “## this is a comment”. This avoids a common

1475

collection with CSS selectors.<a class="changeset-link headerlink reference internal" href="#change-18db551453b5679b3f20ea5bdb7bdc52">¶</a>

1476

1477

</li>

1478

<li>the magic “coding” comment (i.e. # coding:utf-8) will still work with

1479

either one “#” sign or two for now; two is preferred going forward, i.e.

1480

## coding:<someencoding>.<a class="changeset-link headerlink reference internal" href="#change-e30c3dbf8c63dae51878e95465b46c4b">¶</a>

1481

1482

</li>

1483

<li>new multiline comment form: “<%doc> a comment </%doc>”<a class="changeset-link headerlink reference internal" href="#change-722a3aa892f188f6c474fbe157b52980">¶</a>

1484

1485

</li>

1486

<li>UNDEFINED evaluates to False<a class="changeset-link headerlink reference internal" href="#change-d38fba282e33819ce79a8f8f93bfd42c">¶</a>

1487

1488

</li>

1489

<li>improvement to scoping of “caller” variable when using <%call> tag<a class="changeset-link headerlink reference internal" href="#change-921044895d61328452e3a335bad34172">¶</a>

1490

1491

</li>

1492

<li>added lexer error for unclosed control-line (%) line<a class="changeset-link headerlink reference internal" href="#change-8be7ad08f79e900b80f8c291c23e7fe1">¶</a>

1493

1494

</li>

1495

<li>added “preprocessor” argument to Template, TemplateLookup - is a single

1496

callable or list of callables which will be applied to the template text

1497

before lexing. given the text as an argument, returns the new text.<a class="changeset-link headerlink reference internal" href="#change-85b846c5476142b1c2506c5a32d50817">¶</a>

1498

1499

</li>

1500

<li>added mako.ext.preprocessors package, contains one preprocessor so far:

1501

‘convert_comments’, which will convert single # comments to the new ##

1502

format<a class="changeset-link headerlink reference internal" href="#change-43d0af8d5e881c09c61799065df23349">¶</a>

1503

1504

</li>

1505

</ul>

1506

</div>

1507

1508

1509

Released: Thu Feb 1 2007<ul class="simple">

1510

<li>fix to parsing of code/expression blocks to insure that non-ascii

1511

characters, combined with a template that indicates a non-standard

1512

encoding, are expanded into backslash-escaped glyphs before being AST

1513

parsed<a class="changeset-link headerlink reference internal" href="#change-e5e97c09505aa0d25c29ce1e158d4a8f">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/11/">#11</a>

1514

1515

</li>

1516

<li>all template lexing converts the template to unicode first, to

1517

immediately catch any encoding issues and ensure internal unicode

1518

representation.<a class="changeset-link headerlink reference internal" href="#change-3ff8d6c650379a6f712a25b5d9f0f67f">¶</a>

1519

1520

</li>

1521

<li>added module_filename argument to Template to allow specification of a

1522

specific module file<a class="changeset-link headerlink reference internal" href="#change-0b29735786156418071800fe54aa64cd">¶</a>

1523

1524

</li>

1525

<li>added modulename_callable to TemplateLookup to allow a function to

1526

determine module filenames (takes filename, uri arguments). used for<a class="changeset-link headerlink reference internal" href="#change-6904da36fbdded623dc4b3ee751d5674">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/14/">#14</a>

1527

1528

</li>

1529

<li>added optional input_encoding flag to Template, to allow sending a

1530

unicode() object with no magic encoding comment<a class="changeset-link headerlink reference internal" href="#change-ecf4eb2962f40391b75f8ce8f2a94a08">¶</a>

1531

1532

</li>

1533

<li>“expression_filter” argument in <%page> applies only to expressions<a class="changeset-link headerlink reference internal" href="#change-5ea31cc5e58c79c774aaa9458928f827">¶</a>

1534

1535

</li>

1536

<li>[“unicode”] added “default_filters” argument to Template, TemplateLookup. applies only

1537

to expressions, gets prepended to “expression_filter” arg from <%page>.

1538

defaults to, so that all expressions get stringified into u’’

1539

by default (this is what Mako already does). By setting to [], expressions

1540

are passed through raw.<a class="changeset-link headerlink reference internal" href="#change-84beefcbcdc568675b6e3fefd7940957">¶</a>

1541

1542

</li>

1543

<li>added “imports” argument to Template, TemplateLookup. so you can predefine

1544

a list of import statements at the top of the template. can be used in

1545

conjunction with default_filters.<a class="changeset-link headerlink reference internal" href="#change-fd580f1d839dc719fa1f0563b46ba474">¶</a>

1546

1547

</li>

1548

<li>support for CRLF templates...whoops ! welcome to all the windows users.<a class="changeset-link headerlink reference internal" href="#change-817d592b540ba64129e24055c5f8ec27">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/16/">#16</a>

1549

1550

</li>

1551

<li>small fix to local variable propigation for locals that are conditionally

1552

declared<a class="changeset-link headerlink reference internal" href="#change-5976a1e5691f501b38fc485209ec52a1">¶</a>

1553

1554

</li>

1555

<li>got “top level” def calls to work, i.e. template.get_def(“somedef”).render()<a class="changeset-link headerlink reference internal" href="#change-e51de8d14422e4b2b7fb4d583f5fb5f3">¶</a>

1556

1557

</li>

1558

</ul>

1559

</div>

1560

1561

1562

Released: Sun Jan 14 2007<ul class="simple">

1563

<li>buffet plugin supports string-based templates, allows ToscaWidgets to work<a class="changeset-link headerlink reference internal" href="#change-05b7c1f3eb0cb4630b5ebbd1a172f5d5">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/8/">#8</a>

1564

1565

</li>

1566

<li>AST parsing fixes: fixed TryExcept identifier parsing<a class="changeset-link headerlink reference internal" href="#change-20940aacb7e79ba6e20a4826ed237c0b">¶</a>

1567

1568

</li>

1569

<li>removed textmate tmbundle from contrib and into separate SVN location;

1570

windows users cant handle those files, setuptools not very good at

1571

“pruning” certain directories<a class="changeset-link headerlink reference internal" href="#change-eb9efa2f093687fd2d4f5f7ac4e51c3c">¶</a>

1572

1573

</li>

1574

<li>fix so that “cache_timeout” parameter is propigated<a class="changeset-link headerlink reference internal" href="#change-e1142489a6eb32082650995d95b37a71">¶</a>

1575

1576

</li>

1577

<li>fix to expression filters so that string conversion (actually unicode)

1578

properly occurs before filtering<a class="changeset-link headerlink reference internal" href="#change-603cfb5b4987686ea04bebe62aa32b24">¶</a>

1579

1580

</li>

1581

<li>better error message when a lookup is attempted with a template that has no

1582

lookup<a class="changeset-link headerlink reference internal" href="#change-b07fbe08a504a4fa5f2d9827be99693a">¶</a>

1583

1584

</li>

1585

<li>implemented “module” attribute for namespace<a class="changeset-link headerlink reference internal" href="#change-bf10710d0a3d4e00b23e4c12739df8d8">¶</a>

1586

1587

</li>

1588

<li>fix to code generation to correctly track multiple defs with the same name<a class="changeset-link headerlink reference internal" href="#change-d2a20975eda94230da878d7b2bc53081">¶</a>

1589

1590

</li>

1591

<li>“directories” can be passed to TemplateLookup as a scalar in which case it

1592

gets converted to a list<a class="changeset-link headerlink reference internal" href="#change-8e234744095c72fc80b927b7a27b3d4e">¶</a>References: <a class="reference external" href="https://bitbucket.org/zzzeek/mako/issue/9/">#9</a>

1593

1594

</li>

1595

</ul>

1596

</div>

1597

</div>

1598

</div>

1599

1600

</div>

1601

1602

</div>

1603

1604

1605

<a href="caching.html" title="previous chapter">Caching</a>

1607

1608

1609

1610

Documentation generated using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2b1

1611

with Mako templates.

1612

</div>

1613

</div>

1614

1615

</div>

1616

1617

1618

1619

<hr/>

1620

1621

1622

1623

under the MIT license. mike(&)zzzcomputing.com</div>

1624

1625

</div>

1626

</div>

1627

</body>

1628

</html>