about summary refs log tree commit diff
path: root/assessments/semiprimes/README.md
blob: 7d5a15482ab37b14e08851d05baa8517cbf19ff3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# Semiprimes Service

## Introduction

A **composite** is a number containing at least two prime factors. For example:

```
15 = 3 × 5
9 = 3 × 3
12 = 2 × 2 × 3
```

There are ten composites below thirty containing precisely two, not necessarily
distinct, prime factors: `4, 6, 9, 10, 14, 15, 21, 22, 25, 26`. Let’s call such
numbers *Semiprimes*.

## Task

- Write a module which provides a function to tell whether a given number, `N`,
  is a semiprime. `N` will be less than 100,000
- Please implement an API (RESTful or GraphQL) to factor a given number into two
  prime numbers if it’s a semiprime, otherwise, return an error message.

## Stretch Goals

- Handle the invalid inputs.
- Support batch requests: i.e. users could provide 100 numbers, and the API
  return the answer for all.
- Considering this module will be used by a long running service, could you
  optimize it to give answers faster?

## Usage

To run the application you'll need to have `elixir` installed. Assuming `elixir`
is already installed, consult the following steps to start the application:

```shell
$ cd server
$ mix deps.get
$ iex -S mix
```

Now open a web browser and visit `http://localhost:8080`!