skip to navigation
skip to content

EasyEuler 1.2.1

A command line tool for Project Euler


EasyEuler is a configurable command line tool for working with Project Euler. It provides support for many languages out of the box and adding more is easy.

This project was inspired by EulerPy and intends to provide the same functionality for a larger variety of languages.


EasyEuler can be installed from PyPI using pip:

$ pip install easyeuler


Use create to create a new problem file:

$ easyeuler create 1 python
Written to

$ cat
Problem 1: Multiples of 3 and 5

If we list all the natural numbers below 10 that are multiples of 3 or 5,
we get 3, 5, 6 and 9. The sum of these multiples is 23.

Find the sum of all the multiples of 3 or 5 below 1000.


Once you’ve come up with a solution, output the result and check if it’s correct with verify:

$ easyeuler verify
Checking output of [no output]  # output in red

$ echo print(12345) >
$ easyeuler verify
Checking output of 12345        # incorrect solution, output in red

$ echo print(42) >
$ easyeuler verify
Checking output of 42           # correct solution, output in green

You can even time the execution of your solutions with the time flag:

$ easyeuler verify --time
Checking output of 42
CPU times - user: 16.7ms, system: 3.33ms, total: 20ms
Wall time: 1.02s

…and execute multiple at once:

$ easyeuler verify *
Checking output of 42
Checking output of euler_002.c: 12345
Checking output of [error]  # [error] is displayed if an error occurs during execution

Some problems come with additional files, use generate-resources to generate those:

$ easyeuler create 22 python
Written to
$ cat
Problem 22: Names scores


This problem references the following resources:



$ easyeuler generate-resources 22  # specify the problem ID to generate problem-specific resources
Created names.txt at path .

$ easyeuler generate-resources     # or leave it empty to generate all resources
Created 326_formula2.gif at path .
Created 326_formula1.gif at path .
Created 327_rooms_of_doom.gif at path .
Created 330_formula.gif at path .

Use list and show to browse problems:

$ easyeuler list
│   ID │ Name                               │ Difficulty   │
│    1 │ Multiples of 3 and 5               │ 5%           │
│    2 │ Even Fibonacci numbers             │ 5%           │
│    3 │ Largest prime factor               │ 5%           │

$ easyeuler show 2
Problem 2: Even Fibonacci numbers

Each new term in the Fibonacci sequence is generated by adding the
previous two terms. By starting with 1 and 2, the first 10 terms will be:

                  1, 2, 3, 5, 8, 13, 21, 34, 55, 89, ...

Find the sum of all the even-valued terms in the sequence which do not
exceed four million.


EasyEuler is designed to be configurable and adaptable to any language you may want to use it with. It follows the XDG Base Directory Specification for locating configuration files. The default location is $HOME/.config/EasyEuler. To see examples of configuration, look at config.json and the templates directory inside the package.


Adding a new language is as easy as adding a few lines to the config.json file.

A language has the following general attributes:

  • name - name of the language. (required)
  • extension - file extension for the language. (required)
  • template - name of the template file. (default: name)

These commands are executed in order when using the verify command:

  • build - build the file if required.
  • execute - time this command and compare the output to the solution. (default: ./{path})
  • cleanup - remove binary files after execution, etc.


Templates use the Jinja2 templating engine. New templates should go in the templates directory inside the configuration directory.


EasyEuler requires Python 3.5+, along with the Click, Jinja2 and tabulate modules. It has been tested on Windows and Linux and it should work on any other Unix-based platforms, including macOS.


Please see CONTRIBUTING.rst for information on how to contribute to this project.


The problem descriptions are courtesy of the EulerPy project, which formatted the descriptions from Kyle Keen’s Local Euler project into a human-readable form.


EasyEuler is licensed under the MIT license.

File Type Py Version Uploaded on Size
EasyEuler-1.2.1.tar.gz (md5) Source 2017-01-26 620KB