Skip to main content

Tools we use at Somenergia and can be useful

Project description


CI Status Coverage Status PyPI - Downloads

This module includes different Python modules and scripts ubiquiously used on scripts in SomEnergia cooperative but with no entity by themselves to have their own repository.

  • venv: script to run a command under a Python virtual enviroment
  • script to run parametrized sql queries and get the result as (tab separated) csv.
  • tsv: module for quick TSV serialization (csv with tabs as separators) of yamlns.namespace and dict like objects
    • tsvread: provides TSV rows as yamlns.namespaces (dict specialization)
    • tsvwrite: writes a TSV from a sequence of dicts
  • module with db related functions
    • runsql: runs a file with a sql and returns the objects as yamlns namespaces
    • runsql_cached: like runsql but cache the results in a tsv file to avoid second runs
    • fetchNs: a generator that wraps db cursors to fetch objects with attributes instead of psycopg arrays
    • nsList: uses the former to build a list of such object (slower but maybe convinient)
    • csvTable: [deprecated, use runsql] turns the results of a query into a tab separated table with proper header names
    • pgconfig_from_environ: constructs a db connection configuration dictionary from PG environment variables
  • isodates: String to time/date/datetime objects with naive/timezoned handling
  • convenience class to retrieve data from gdrive spreadshets
  • trace: quickly enable and disable tracing function calling by decorating them with @trace
  • testutils: module with common test utilities
    • testutils.destructiveTest: decorator to avoid running destructive tests in production
    • testutils.temp_path: context manager that provides a selfdestructing temporary directory for tests
    • testutils.working_dir: context manager that changes the current working directory and restores it afterwards
    • testutils.sandbox_dir: context manager that combines temp_path and working_dir
  • erptree: extracts an object and its children from the erp (erppeek, odoo) with controlled recursion

venv script

Simplifies running a Python script under a given virtual environtment. This is specially useful to run Python scripts from crontab lines.


Runs an SQL file and outputs the result of the query as tabulator separated csv.a

A local file is required, or you should provide it as -C It should contain a dict named pyscopg with the keyword parameters to psycopg2.connect.

You can provide query parameters either as yamlfile or as commandline options. <sqlfile> [<yamlfile>] [--<var1> <value1> [--<var2> <value2> ..] ]

dbutils Python module

Convenient database access

Having a query in a file.

params = dict(
   param2=[1,3,4,5], # Useful for the IN clause
for item in runsql('myquery.sql', **params):
   print(, item.description) # id and description should be columns in the query

Like sql2csv there must exist a file or provide it with the config keyword parameter

Parameters are inserted as specified in psycopg2 documentation

TODO: db and cursor parameters to reuse existing ones.

If you know the results will be always the same, you can use runsql_cached instead. It will generate a tsv file name like the sql file with the results, and will use it instead of the query for next executions.

The usage of runsql_cached is quite similar to runsql to be exchangeable. runsql_cached just adds a couple of keyword arguments.

  • cachefile: to override the default cache file (a name, a path or a file like object)
  • force: to force the query execution even if the cache exists

Cursor wrappers

Convenient cursor wrappers to make the database access code more readable.


import psycopg2, dbutils
db = psycopg2.connect(**dbconfiguration)
with db.cursor() as cursor :
	cursor.execute("SELECT name, age FROM people")
	for person as dbutils.fetchNs(cursor):
		if person.age < 21: continue
		print("{name} is {age} years old".format(person))

sheetfetcher Python module

Convenient wraper for gdrive.

from sheetfetcher import SheetFetcher

fetcher = SheetFetcher(
	documentName='My Document',
table = fetcher.get_range("My Sheet", "A2:F12")
fulltable = fetcher.get_fullsheet("My Sheet")


This decorator is a fast helper to trace calls to functions and methods. It will show the name of the functions the values of the parameters and the returned values.

from trace import trace

def factorial(n):
    if n<1: return 1
    return n*factorial(n-1)


('> factorial', (6,))
('> factorial', (5,))
('> factorial', (4,))
('> factorial', (3,))
('> factorial', (2,))
('> factorial', (1,))
('> factorial', (0,))
('< factorial', (0,), '->', 1)
('< factorial', (1,), '->', 1)
('< factorial', (2,), '->', 2)
('< factorial', (3,), '->', 6)
('< factorial', (4,), '->', 24)
('< factorial', (5,), '->', 120)
('< factorial', (6,), '->', 720)


Allows to assert equality on json/yaml like structures combining dicts, lists, numbers, strings, dates... The comparision is done on the YAML output so that differences are spoted as text diffs. Also keys in dicts are alphabetically sorted.


An utility to avoid running destrutive tests in a production OpenERP. It is a decorator that checks wheter the erp configured in dbconfig has the testing flag and skips the test if it doesn't.

The script is also provided to set/unset that testing flag which is not defined by default.


Module for simplified isodate parsing and timezone handling.


Interprets strings like the ones the standard Print Dialog uses to specify pages to be printed. ie. "2,4,6-9,13" means "2, 4, from 6 to 9 and 13"

>>> [x for x in sequence("2,4,6-9,13")]
[2, 4, 6, 7, 8, 9, 13]


Creates an structure from ERP objects that you can navigate or dump as yaml. You can select fields to expand, taking just the name or the id, anonymize or removing. You can use dot notation to specify fields in related objects. For multiple relations, a subfield refers to the subfield in all related objects.

from somutils.erptree import erptree

O = Client(....)

partner = erptree(
	expand = {
		# Will expand those attributes
		'partner_id': O.ResPartner,
		'': O.ResPartner,
	pickName = [
		# For those fk pick the name instead of the default id,name tuple
		# pickId parameter does the analog with id
	anonymize = [
		# Will tamper the value
	remove = [
		# Means clear this field
	only = [
		# Means: just retrieve name and code from

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

somutils-1.8.5.tar.gz (23.4 kB view hashes)

Uploaded source

Built Distribution

somutils-1.8.5-py3-none-any.whl (24.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page