Popular recipes tagged "meta:min_python_3=*" but not "algorithm" and "tkinter"

Uno (Text-Based) (Python)

2017-07-15T00:46:59-07:00

Python recipe 580811 by Brandon Martin (artificial_intelligence, cards, game, text_game, uno).

A text based recreation of the classic card game featuring functional AIs to play with. Some rules have been modified. User interface is text based, non-curses, using only simple python commands to draw it.

Equally-spaced numbers (linspace) (Python)

2015-01-12T22:16:37-08:00

Python recipe 579000 by Andrew Barnert (float, linspace, range, spread).

An equivalent of numpy.linspace, but as a pure-Python lazy sequence.

Like NumPy's linspace, but unlike the spread and frange recipes listed here, the num argument specifies the number of values, not the number of intervals, and the range is closed, not half-open.

Although this is primarily designed for floats, it will work for Fraction, Decimal, NumPy arrays (although this would be silly) and even datetime values.

This recipe can also serve as an example for creating lazy sequences.

See the discussion below for caveats.

Shoelace Formula for polygonal area (Python)

2017-07-17T05:53:45-07:00

Python recipe 580812 by Paddy McCarthy (2d, area).

Copied, by author from "Paddy3118 Go deh!: Python investigation of the Shoelace Formula for polygonal area http://paddy3118.blogspot.com/2017/07/python-investigation-of-shoelace.html#ixzz4n43Dqhaa " Where there is more meat on the bone (under a different license though).

PDF Text Extraction using fitz / MuPDF (PyMuPDF) (Python)

2016-03-17T12:00:06-07:00

Python recipe 580626 by Jorj X. McKie (cbz, epub, mupdf, openxps, pdf, pymupdf, text_extraction, xps).

Extract all the text of a PDF (or other supported container types) at very high speed. In general, text pieces of a PDF page are not arranged in natural reading order, but in the order they were entered during PDF creation. This script re-arranges text blocks according to their pixel coordinates to achieve a more readable output, i.e. top-down, left-right.

Variable Abbreviations (Python)

2017-06-22T11:57:20-07:00

Python recipe 580807 by Alfe (abbreviations, contextmanager, variables, with).

One sometimes has nice long speaking names vor variables, maybe things like buildingList[foundIndex].height, but would like to address these in a shorter fashion to be used within a formula or similar where lots of longs names tend to confuse any reader trying to understand the formula. Physicists use one-letter names for a reason.

For this I wrote a small context provider which allows using short names instead of long ones:

with Abbr(h=buildingList[foundIndex].height, g=gravitationalConstant):
    fallTime = sqrt(2 * h / g)
    endSpeed = sqrt(2 * h * g)
print("Fall time:", fallTime)
print("End speed:", endSpeed)

For longer formulas this can reduce ugly multi-line expressions to clearly readable one-liners.

One could use this:

h = buildingList[foundIndex].height
g = gravitationalConstant
fallTime = sqrt(2 * h / g)
endSpeed = sqrt(2 * h * g)
del g, h
print("Fall time:", fallTime)
print("End speed:", endSpeed)

to achieve the same result, but

it would not look as clean and
the context provider solves the typical issues like cleanup on exception etc.

Just using local variables without cleanup (like above without the del statement) also is an option of course, but that would clutter the variable name space unnecessarily.

CAVEATS: The implementation of Abbr() is a hack. If used as intended and described here, it should work just fine, though. But the hackish nature forces me to mention some things: Since at compile time the compiler decides that the h and g in the example must be global variables (because they aren't assigned in the function), it produces byte code accessing global variables. The context provider changes the global variable structure to fill the needs. (Overridden already existing global variables of the same name get restored properly at context exit.) This means some things:

One cannot have a local variable of the same name in the frame surrounding the context manager.
Existing global variables are changed during the time of the context manager; so using names like sys or os for abbreviations might be a bad idea due to side-effects.

Guard against an exception in the wrong place (Python)

2017-06-25T17:17:43-07:00

Python recipe 580808 by Steven D'Aprano (context, exception, guard, manager). Revision 2.

Sometimes exception handling can obscure bugs unless you guard against a particular exception occurring in a certain place. One example is that accidentally raising StopIteration inside a generator will halt the generator instead of displaying a traceback. That was solved by PEP 479, which automatically has such StopIteration exceptions change to RuntimeError. See the discussion below for further examples.

Here is a class which can be used as either a decorator or context manager for guarding against the given exceptions. It takes an exception (or a tuple of exceptions) as argument, and if the wrapped code raises that exception, it is re-raised as another exception type (by default RuntimeError).

For example:

try:
    with exception_guard(ZeroDivisionError):
        1/0  # raises ZeroDivisionError
except RuntimeError:
    print ('ZeroDivisionError replaced by RuntimeError')


@exception_guard(KeyError)
def demo():
    return {}['key']  # raises KeyError

try:
    demo()
except RuntimeError:
    print ('KeyError replaced by RuntimeError')

Unit Testing Nested Functions (Python)

2016-11-10T10:23:11-08:00

Python recipe 580716 by Alfe (introspection, nested, unittests). Revision 3.

Python allows the declaration of nested functions. These are typically hard to unit test because using just the normal ways of calling they cannot be called from outside their surrounding function. So they cannot be considered a clearly separated unit and thus cannot be unit tested.

This is a drawback of using them, so many developers (especially the ones deep into test driven development who strive to have a high unit test coverage) tend to avoid them in favor for standalone functions which can be called from the unit tests without any hassle.

But not all solutions with nested functions can be written as elegant with standalone functions. Nested functions are powerful insofar that they can access the local variables of the surrounding function without any need to pass them into the nested function, thus the code can in many cases stay neat and tidy while using a standalone function instead might raise the need to pass the complete context in form of a bunch of parameters. Also, using nested functions makes their local usage clear to any reader and keeps the name space tight.

But at least in the standard CPython (i. e. not necessarily in Jython, etc.) the implementation of functions (and methods) allows to find the nested function's code, wrap it properly to give it its needed context and then call it from the outside. I wrote a small module which helps doing exactly this.

Lines Of Code (LOC) (Python)

2016-10-25T17:53:01-07:00

Python recipe 580709 by Jean Brouwers (count, lines, python2, python3, source). Revision 3.

Count the number of lines (code, comment, blank) in one or several Python source files.

Rotate a PDF page in 3 lines (Python)

2016-11-06T11:33:59-08:00

Python recipe 580713 by Jorj X. McKie (fitz, mupdf, pdf, pymupdf). Revision 2.

PyMuPDF v1.9.3 now supports several new features for manipulating PDFs.

Here is an example to rotate a page with just a few lines of Python code.

How to delete pages in a PDF using fitz / MuPDF / PyMuPDF (Python)

2016-05-01T09:26:44-07:00

Python recipe 580657 by Jorj X. McKie (mupdf, pdf, pdf_generation).

A new method select() in PyMuPDF 1.9.0 allows selecting pages of a PDF document to create a new one. Any Python list of integers (0 <= n < page count) can be taken.

The resulting PDF contains all links, annotations and bookmarks (provided they still point to valid targets).

Retry Decorator in Python (Python)

2017-01-11T10:10:30-08:00

Python recipe 580745 by Alfe (aspect, except, exception, retry, try).

This is a Python decorator which helps implementing an aspect oriented implementation of a retrying of certain steps which might fail sometimes. A typical example for this would be communication processes with the outside world, e. g. HTTP requests, allocation of some resource, etc. To use it, refactor the step in question into a (local) function and decorate this with the retry decorator. See examples in the discussion sector below.

TicTacToe (text based) (Python)

2016-11-27T07:10:56-08:00

Python recipe 580723 by Brandon Martin (artificial_intelligence, game, python, random, tac, tic, tictactoe, toe).

A text based version of TicTacToe for Python. Difficulty is not yet implemented, however, a computer player has been implemented that cannot be beaten. Posting just for fun.

Context Manager for an Arbitrary Number of Files in Python (Python)

2017-03-13T13:27:50-07:00

Python recipe 580763 by Alfe (contextmanager, file, open). Revision 2.

The pattern using with together with open() to automatically close a file after leaving the context is well known. To open a fixed number you can simply nest these statements or use the comma notation. For having a context which represents an arbitrary number of open files you can use the ExitStack class, but only for Python 3.3+.

For other Python versions I'm using the following class which I named Files. The presented implementation is only for reading files (for keeping it clear). Extending it for having various file modes should not pose a problem.

How to parse a table in a PDF document (Python)

2016-04-10T22:43:57-07:00

Python recipe 580635 by Jorj X. McKie (cbz, epub, fitz, mupdf, openxps, parsing, pdf, pymupdf, table, xps). Revision 4.

A Python function that converts a table contained in a page of a PDF (or OpenXPS, EPUB, CBZ, XPS) document to a matrix-like Python object (list of lists of strings).

Simple signal library, similar to PyQT signals (Python)

2017-04-01T21:11:50-07:00

Python recipe 580764 by Miguel Martínez López (event, pubsub, signal). Revision 11.

Simple signal library similar to PyQT signals. Signals helps to decouple code in GUI applications. This code could be used in Tkinter applications for example.

Inspired and based in these other modules:

https://github.com/shaunduncan/smokesignal

https://github.com/dgovil/PySignal

https://github.com/jek/blinker

Easily create a Python REPL in Python (Python)

2016-10-31T21:53:30-07:00

Python recipe 580712 by Vasudev Ram (code_module, dynamic, evaluation, read_eval_print_loop, repl).

This recipe shows how to easily create a Python REPL (Read-Eval-Print Loop) in Python itself. This can allow the user to interact with a running Python program, including typing in Python statements at the REPL prompt, defining functions, using and changing variables that were set before the interaction started, and those variables modified during the interaction, will persist in the memory of the program, for any use, even after the interaction is over, as long as the program continues to run.

Python add/set attributes to list (Python)

2015-09-29T16:28:46-07:00

Python recipe 579103 by webby1111 (attributes, class, dictionary, list, subclass). Revision 3.

Python Attribute List

Add/set attributes to python lists.

A google search for "add attributes to python lists" yields no good stackoverflow answer, hence the need for this.

Useful for machine learning stuff where you need labeled feature vectors.

This technique can be easily adapted for other built-ins (e.g. int).

The Problem

a = [1, 2, 4, 8]
a.x = "Hey!" # AttributeError: 'list' object has no attribute 'x'

The Solution

a = L(1, 2, 4, 8)
a.x = "Hey!"
print a       # [1, 2, 4, 8]
print a.x     # "Hey!"
print len(a)  # 4

# You can also do these:
a = L( 1, 2, 4, 8 , x="Hey!" )                 # [1, 2, 4, 8]
a = L( 1, 2, 4, 8 )( x="Hey!" )                # [1, 2, 4, 8]
a = L( [1, 2, 4, 8] , x="Hey!" )               # [1, 2, 4, 8]
a = L( {1, 2, 4, 8} , x="Hey!" )               # [1, 2, 4, 8]
a = L( [2 ** b for b in range(4)] , x="Hey!" ) # [1, 2, 4, 8]
a = L( (2 ** b for b in range(4)) , x="Hey!" ) # [1, 2, 4, 8]
a = L( 2 ** b for b in range(4) )( x="Hey!" )  # [1, 2, 4, 8]
a = L( 2 )                                     # [2]

Compute Memory footprint of an object and its contents (Python)

2012-11-23T23:57:31-08:00

Python recipe 577504 by Raymond Hettinger (memory, sizeof). Revision 3.

Recursive version sys.getsizeof(). Extendable with custom handlers.

Give Python code a web plus command-line interface with hug (Python)

2017-01-05T16:57:15-08:00

Python recipe 580742 by Vasudev Ram (cli, commandline, hug, library, python, python3, user_interface, web, web_server).

This recipe shows how to take a Python function and wrap it with both a web and a command-line interface, somewhat easily, using the hug Python library. The example used shows how to wrap a function that uses the psutil library to get information on disk partitions. So you can see the disk partition info either via the web browser or the command line. The code for the recipe is shown below. It is also possible to wrap multiple functions in the same Python file, and expose all of them via both the web and the command-line.

More information and multiple sample outputs are available here:

https://jugad2.blogspot.in/2017/01/give-your-python-function-webcli-hug.html

Get names and types of all attributes of a Python module (Python)

2016-10-06T17:21:42-07:00

Python recipe 580705 by Vasudev Ram (documentation, introspection, modules, reflection, type).

This recipe shows how to get the names and types of all the attributes of a Python module. This can be useful when exploring new modules (either built-in or third-party), because attributes are mostly a) data elements or b) functions or methods, and for either of those, you would like to know the type of the attribute, so that, if it is a data element, you can print it, and if it is a function or method, you can print its docstring to get brief help on its arguments, processsing and outputs or return values, as a way of learning how to use it.

The code for the recipe includes an example call to it, at the end of the code. Note that you first have to import the modules that you want to introspect in this way.