An open API service indexing awesome lists of open source software.

https://github.com/maxblee/force_deps

A small package for enforcing package requirements at the class- or function-level.
https://github.com/maxblee/force_deps

Last synced: 12 months ago
JSON representation

A small package for enforcing package requirements at the class- or function-level.

Awesome Lists containing this project

README

          

force-dependencies
===============================

version number: "0.1.0"
author: Max Lee

[![Build Status](https://travis-ci.org/maxblee/force_deps.svg?branch=master)](https://travis-ci.org/maxblee/force_deps) [![Coverage Status](https://coveralls.io/repos/github/maxblee/force_deps/badge.svg?branch=master)](https://coveralls.io/github/maxblee/force_deps?branch=master)

Overview
--------

`force-dependencies` is a small package for enforcing package requirements at the class- or function-level.

Simply use:

```python
from force_deps import requires, requires_any, requires_all

@requires("sqlalchemy")
class SQLHandler(object):
def __init__(self):
pass

db = SQLHandler()
Traceback (most recent call last):
...
ImportError: You must import `sqlalchemy` in order to run `SQLHandler`
```
to require users to have a package installed in order to use your class or function,

```python
@requires_any(["sqlalchemy", "sqlite3"])
...
```
to require that users have at least one of a number of packages installed, or

```python
@requires_all(["sqlalchemy", "pandas"])
...
```
to require that users have all of a number of packages installed in order to use a class or function.

Finally, you can combine the decorators together in pretty much any way you please:
```python
@requires_any(["sqlalchemy", "sqlite3"])
@requires("pandas")
...
```

Installation / Usage
--------------------

This library requires Python>=3.5. You should be able to extend its compatibility by removing the dependencies
on Python's `typing` libraries.

To install use pip:

$ pip install force_deps

Or clone the repo:
```shell
$ git clone https://github.com/maxblee/force_deps.git
$ python setup.py install
```

Project template based off [this minimal Python cookiecutter template](https://github.com/wdm0006/cookiecutter-pipproject).