diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 202de7b2..56148b3b 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -78,6 +78,7 @@ jobs:
${{ runner.os }}-${{ matrix.python-version }}-${{ matrix.node-version }}-collectstatic-${{ hashFiles('**/*.css', '**/*.js', 'vue/src/*') }}
- name: Django Testing project
+ timeout-minutes: 15
run: pytest --junitxml=junit/test-results-${{ matrix.python-version }}.xml
- name: Publish Test Results
diff --git a/cookbook/apps.py b/cookbook/apps.py
index e551319d..3bd8d847 100644
--- a/cookbook/apps.py
+++ b/cookbook/apps.py
@@ -3,6 +3,7 @@ import traceback
from django.apps import AppConfig
from django.conf import settings
from django.db import OperationalError, ProgrammingError
+from django.db.models.signals import post_save, post_delete
from django_scopes import scopes_disabled
from recipes.settings import DEBUG
@@ -14,6 +15,12 @@ class CookbookConfig(AppConfig):
def ready(self):
import cookbook.signals # noqa
+ if not settings.DISABLE_EXTERNAL_CONNECTORS:
+ from cookbook.connectors.connector_manager import ConnectorManager # Needs to be here to prevent loading race condition of oauth2 modules in models.py
+ handler = ConnectorManager()
+ post_save.connect(handler, dispatch_uid="connector_manager")
+ post_delete.connect(handler, dispatch_uid="connector_manager")
+
# if not settings.DISABLE_TREE_FIX_STARTUP:
# # when starting up run fix_tree to:
# # a) make sure that nodes are sorted when switching between sort modes
diff --git a/cookbook/connectors/connector_manager.py b/cookbook/connectors/connector_manager.py
index fe42c1a7..90ad1bfd 100644
--- a/cookbook/connectors/connector_manager.py
+++ b/cookbook/connectors/connector_manager.py
@@ -29,13 +29,13 @@ class ActionType(Enum):
@dataclass
class Work:
- instance: REGISTERED_CLASSES
+ instance: REGISTERED_CLASSES | ConnectorConfig
actionType: ActionType
# The way ConnectionManager works is as follows:
# 1. On init, it starts a worker & creates a queue for 'Work'
-# 2. Then any time its called, it verifies the type of action (create/update/delete) and if the item is of interest, pushes the Work (non blocking) to the queue.
+# 2. Then any time its called, it verifies the type of action (create/update/delete) and if the item is of interest, pushes the Work (non-blocking) to the queue.
# 3. The worker consumes said work from the queue.
# 3.1 If the work is of type ConnectorConfig, it flushes its cache of known connectors (per space.id)
# 3.2 If work is of type REGISTERED_CLASSES, it asynchronously fires of all connectors and wait for them to finish (runtime should depend on the 'slowest' connector)
@@ -50,6 +50,7 @@ class ConnectorManager:
self._worker = multiprocessing.Process(target=self.worker, args=(self._queue,), daemon=True)
self._worker.start()
+ # Called by post save & post delete signals
def __call__(self, instance: Any, **kwargs) -> None:
if not isinstance(instance, self._listening_to_classes) or not hasattr(instance, "space"):
return
@@ -77,13 +78,15 @@ class ConnectorManager:
@staticmethod
def worker(worker_queue: JoinableQueue):
+ # https://stackoverflow.com/a/10684672 Close open connections after starting a new process to prevent re-use of same connections
from django.db import connections
connections.close_all()
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
- _connectors: Dict[int, List[Connector]] = dict()
+ #
+ _connectors_cache: Dict[int, List[Connector]] = dict()
while True:
try:
@@ -98,7 +101,7 @@ class ConnectorManager:
refresh_connector_cache = isinstance(item.instance, ConnectorConfig)
space: Space = item.instance.space
- connectors: Optional[List[Connector]] = _connectors.get(space.id)
+ connectors: Optional[List[Connector]] = _connectors_cache.get(space.id)
if connectors is None or refresh_connector_cache:
if connectors is not None:
@@ -117,9 +120,10 @@ class ConnectorManager:
logging.exception(f"failed to initialize {config.name}")
continue
- connectors.append(connector)
+ if connector is not None:
+ connectors.append(connector)
- _connectors[space.id] = connectors
+ _connectors_cache[space.id] = connectors
if len(connectors) == 0 or refresh_connector_cache:
worker_queue.task_done()
diff --git a/cookbook/helper/context_processors.py b/cookbook/helper/context_processors.py
index 30e704c1..9beb8b9b 100644
--- a/cookbook/helper/context_processors.py
+++ b/cookbook/helper/context_processors.py
@@ -11,4 +11,5 @@ def context_settings(request):
'PRIVACY_URL': settings.PRIVACY_URL,
'IMPRINT_URL': settings.IMPRINT_URL,
'SHOPPING_MIN_AUTOSYNC_INTERVAL': settings.SHOPPING_MIN_AUTOSYNC_INTERVAL,
+ 'DISABLE_EXTERNAL_CONNECTORS': settings.DISABLE_EXTERNAL_CONNECTORS,
}
diff --git a/cookbook/signals.py b/cookbook/signals.py
index cd183c58..a93ffba1 100644
--- a/cookbook/signals.py
+++ b/cookbook/signals.py
@@ -4,12 +4,11 @@ from django.conf import settings
from django.contrib.auth.models import User
from django.contrib.postgres.search import SearchVector
from django.core.cache import caches
-from django.db.models.signals import post_save, post_delete
+from django.db.models.signals import post_save
from django.dispatch import receiver
from django.utils import translation
from django_scopes import scope, scopes_disabled
-from cookbook.connectors.connector_manager import ConnectorManager
from cookbook.helper.cache_helper import CacheHelper
from cookbook.helper.shopping_helper import RecipeShoppingEditor
from cookbook.managers import DICTIONARY
@@ -162,9 +161,3 @@ def clear_unit_cache(sender, instance=None, created=False, **kwargs):
def clear_property_type_cache(sender, instance=None, created=False, **kwargs):
if instance:
caches['default'].delete(CacheHelper(instance.space).PROPERTY_TYPE_CACHE_KEY)
-
-
-if not settings.DISABLE_EXTERNAL_CONNECTORS:
- handler = ConnectorManager()
- post_save.connect(handler, dispatch_uid="connector_manager")
- post_delete.connect(handler, dispatch_uid="connector_manager")
diff --git a/cookbook/templates/base.html b/cookbook/templates/base.html
index 4cbc1544..f1d6c2f7 100644
--- a/cookbook/templates/base.html
+++ b/cookbook/templates/base.html
@@ -335,7 +335,7 @@
{% trans 'Space Settings' %}
{% endif %}
- {% if request.user == request.space.created_by or user.is_superuser %}
+ {% if not DISABLE_EXTERNAL_CONNECTORS and request.user == request.space.created_by or not DISABLE_EXTERNAL_CONNECTORS and user.is_superuser %}
{% trans 'External Connectors' %}
{% endif %}
diff --git a/cookbook/templatetags/custom_tags.py b/cookbook/templatetags/custom_tags.py
index cdacd8e7..45985510 100644
--- a/cookbook/templatetags/custom_tags.py
+++ b/cookbook/templatetags/custom_tags.py
@@ -112,6 +112,9 @@ def recipe_last(recipe, user):
def page_help(page_name):
help_pages = {
'edit_storage': 'https://docs.tandoor.dev/features/external_recipes/',
+ 'list_connector_config': 'https://docs.tandoor.dev/features/connectors/',
+ 'new_connector_config': 'https://docs.tandoor.dev/features/connectors/',
+ 'edit_connector_config': 'https://docs.tandoor.dev/features/connectors/',
'view_shopping': 'https://docs.tandoor.dev/features/shopping/',
'view_import': 'https://docs.tandoor.dev/features/import_export/',
'view_export': 'https://docs.tandoor.dev/features/import_export/',
diff --git a/cookbook/tests/other/test_connector_manager.py b/cookbook/tests/other/test_connector_manager.py
index c6df778f..b8610082 100644
--- a/cookbook/tests/other/test_connector_manager.py
+++ b/cookbook/tests/other/test_connector_manager.py
@@ -1,5 +1,3 @@
-from dataclasses import dataclass
-
import pytest
from django.contrib import auth
from mock.mock import Mock
diff --git a/cookbook/views/api.py b/cookbook/views/api.py
index 5b44c2f8..1a91a33c 100644
--- a/cookbook/views/api.py
+++ b/cookbook/views/api.py
@@ -181,10 +181,9 @@ class FuzzyFilterMixin(ViewSetMixin, ExtendedRecipeMixin):
self.queryset = self.queryset.filter(space=self.request.space).order_by(Lower('name').asc())
query = self.request.query_params.get('query', None)
if self.request.user.is_authenticated:
- fuzzy = self.request.user.searchpreference.lookup or any(
- [self.model.__name__.lower() in x for x in
- self.request.user.searchpreference.trigram.values_list(
- 'field', flat=True)])
+ fuzzy = self.request.user.searchpreference.lookup or any([self.model.__name__.lower() in x for x in
+ self.request.user.searchpreference.trigram.values_list(
+ 'field', flat=True)])
else:
fuzzy = True
@@ -204,10 +203,8 @@ class FuzzyFilterMixin(ViewSetMixin, ExtendedRecipeMixin):
filter |= Q(name__unaccent__icontains=query)
self.queryset = (
- self.queryset.annotate(
- starts=Case(
- When(name__istartswith=query, then=(Value(100))),
- default=Value(0))) # put exact matches at the top of the result set
+ self.queryset.annotate(starts=Case(When(name__istartswith=query, then=(Value(100))),
+ default=Value(0))) # put exact matches at the top of the result set
.filter(filter).order_by('-starts', Lower('name').asc())
)
@@ -329,9 +326,8 @@ class TreeMixin(MergeMixin, FuzzyFilterMixin, ExtendedRecipeMixin):
return self.annotate_recipe(queryset=super().get_queryset(), request=self.request, serializer=self.serializer_class, tree=True)
self.queryset = self.queryset.filter(space=self.request.space).order_by(Lower('name').asc())
- return self.annotate_recipe(
- queryset=self.queryset, request=self.request, serializer=self.serializer_class,
- tree=True)
+ return self.annotate_recipe(queryset=self.queryset, request=self.request, serializer=self.serializer_class,
+ tree=True)
@decorators.action(detail=True, url_path='move/(?P[^/.]+)', methods=['PUT'], )
@decorators.renderer_classes((TemplateHTMLRenderer, JSONRenderer))
@@ -575,9 +571,8 @@ class FoodViewSet(viewsets.ModelViewSet, TreeMixin):
pass
self.queryset = super().get_queryset()
- shopping_status = ShoppingListEntry.objects.filter(
- space=self.request.space, food=OuterRef('id'),
- checked=False).values('id')
+ shopping_status = ShoppingListEntry.objects.filter(space=self.request.space, food=OuterRef('id'),
+ checked=False).values('id')
# onhand_status = self.queryset.annotate(onhand_status=Exists(onhand_users_set__in=[shared_users]))
return self.queryset \
.annotate(shopping_status=Exists(shopping_status)) \
@@ -598,9 +593,8 @@ class FoodViewSet(viewsets.ModelViewSet, TreeMixin):
shared_users = list(self.request.user.get_shopping_share())
shared_users.append(request.user)
if request.data.get('_delete', False) == 'true':
- ShoppingListEntry.objects.filter(
- food=obj, checked=False, space=request.space,
- created_by__in=shared_users).delete()
+ ShoppingListEntry.objects.filter(food=obj, checked=False, space=request.space,
+ created_by__in=shared_users).delete()
content = {'msg': _(f'{obj.name} was removed from the shopping list.')}
return Response(content, status=status.HTTP_204_NO_CONTENT)
@@ -608,9 +602,8 @@ class FoodViewSet(viewsets.ModelViewSet, TreeMixin):
unit = request.data.get('unit', None)
content = {'msg': _(f'{obj.name} was added to the shopping list.')}
- ShoppingListEntry.objects.create(
- food=obj, amount=amount, unit=unit, space=request.space,
- created_by=request.user)
+ ShoppingListEntry.objects.create(food=obj, amount=amount, unit=unit, space=request.space,
+ created_by=request.user)
return Response(content, status=status.HTTP_204_NO_CONTENT)
@decorators.action(detail=True, methods=['POST'], )
@@ -623,11 +616,8 @@ class FoodViewSet(viewsets.ModelViewSet, TreeMixin):
response = requests.get(f'https://api.nal.usda.gov/fdc/v1/food/{food.fdc_id}?api_key={FDC_API_KEY}')
if response.status_code == 429:
- return JsonResponse(
- {'msg',
- 'API Key Rate Limit reached/exceeded, see https://api.data.gov/docs/rate-limits/ for more information. Configure your key in Tandoor using environment FDC_API_KEY variable.'},
- status=429,
- json_dumps_params={'indent': 4})
+ return JsonResponse({'msg', 'API Key Rate Limit reached/exceeded, see https://api.data.gov/docs/rate-limits/ for more information. Configure your key in Tandoor using environment FDC_API_KEY variable.'}, status=429,
+ json_dumps_params={'indent': 4})
try:
data = json.loads(response.content)
@@ -883,14 +873,12 @@ class RecipePagination(PageNumberPagination):
return super().paginate_queryset(queryset, request, view)
def get_paginated_response(self, data):
- return Response(
- OrderedDict(
- [
- ('count', self.page.paginator.count),
- ('next', self.get_next_link()),
- ('previous', self.get_previous_link()),
- ('results', data),
- ]))
+ return Response(OrderedDict([
+ ('count', self.page.paginator.count),
+ ('next', self.get_next_link()),
+ ('previous', self.get_previous_link()),
+ ('results', data),
+ ]))
class RecipeViewSet(viewsets.ModelViewSet):
@@ -976,10 +964,9 @@ class RecipeViewSet(viewsets.ModelViewSet):
def list(self, request, *args, **kwargs):
if self.request.GET.get('debug', False):
- return JsonResponse(
- {
- 'new': str(self.get_queryset().query),
- })
+ return JsonResponse({
+ 'new': str(self.get_queryset().query),
+ })
return super().list(request, *args, **kwargs)
def get_serializer_class(self):
@@ -1149,10 +1136,8 @@ class ShoppingListEntryViewSet(viewsets.ModelViewSet):
permission_classes = [(CustomIsOwner | CustomIsShared) & CustomTokenHasReadWriteScope]
query_params = [
QueryParam(name='id', description=_('Returns the shopping list entry with a primary key of id. Multiple values allowed.'), qtype='int'),
- QueryParam(
- name='checked', description=_(
- 'Filter shopping list entries on checked. [''true'', ''false'', ''both'', ''recent'']
- ''recent'' includes unchecked items and recently completed items.')
- ),
+ QueryParam(name='checked', description=_('Filter shopping list entries on checked. [''true'', ''false'', ''both'', ''recent'']
- ''recent'' includes unchecked items and recently completed items.')
+ ),
QueryParam(name='supermarket', description=_('Returns the shopping list entries sorted by supermarket category order.'), qtype='int'),
]
schema = QueryParamAutoSchema()
@@ -1343,28 +1328,25 @@ class CustomAuthToken(ObtainAuthToken):
throttle_classes = [AuthTokenThrottle]
def post(self, request, *args, **kwargs):
- serializer = self.serializer_class(
- data=request.data,
- context={'request': request})
+ serializer = self.serializer_class(data=request.data,
+ context={'request': request})
serializer.is_valid(raise_exception=True)
user = serializer.validated_data['user']
if token := AccessToken.objects.filter(user=user, expires__gt=timezone.now(), scope__contains='read').filter(
scope__contains='write').first():
access_token = token
else:
- access_token = AccessToken.objects.create(
- user=user, token=f'tda_{str(uuid.uuid4()).replace("-", "_")}',
- expires=(timezone.now() + timezone.timedelta(days=365 * 5)),
- scope='read write app')
- return Response(
- {
- 'id': access_token.id,
- 'token': access_token.token,
- 'scope': access_token.scope,
- 'expires': access_token.expires,
- 'user_id': access_token.user.pk,
- 'test': user.pk
- })
+ access_token = AccessToken.objects.create(user=user, token=f'tda_{str(uuid.uuid4()).replace("-", "_")}',
+ expires=(timezone.now() + timezone.timedelta(days=365 * 5)),
+ scope='read write app')
+ return Response({
+ 'id': access_token.id,
+ 'token': access_token.token,
+ 'scope': access_token.scope,
+ 'expires': access_token.expires,
+ 'user_id': access_token.user.pk,
+ 'test': user.pk
+ })
class RecipeUrlImportView(APIView):
@@ -1393,71 +1375,61 @@ class RecipeUrlImportView(APIView):
url = serializer.validated_data.get('url', None)
data = unquote(serializer.validated_data.get('data', None))
if not url and not data:
- return Response(
- {
- 'error': True,
- 'msg': _('Nothing to do.')
- }, status=status.HTTP_400_BAD_REQUEST)
+ return Response({
+ 'error': True,
+ 'msg': _('Nothing to do.')
+ }, status=status.HTTP_400_BAD_REQUEST)
elif url and not data:
if re.match('^(https?://)?(www\\.youtube\\.com|youtu\\.be)/.+$', url):
if validators.url(url, public=True):
- return Response(
- {
- 'recipe_json': get_from_youtube_scraper(url, request),
- 'recipe_images': [],
- }, status=status.HTTP_200_OK)
+ return Response({
+ 'recipe_json': get_from_youtube_scraper(url, request),
+ 'recipe_images': [],
+ }, status=status.HTTP_200_OK)
if re.match(
'^(.)*/view/recipe/[0-9]+/[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$',
url):
recipe_json = requests.get(
- url.replace('/view/recipe/', '/api/recipe/').replace(
- re.split('/view/recipe/[0-9]+', url)[1],
- '') + '?share=' +
+ url.replace('/view/recipe/', '/api/recipe/').replace(re.split('/view/recipe/[0-9]+', url)[1],
+ '') + '?share=' +
re.split('/view/recipe/[0-9]+', url)[1].replace('/', '')).json()
recipe_json = clean_dict(recipe_json, 'id')
serialized_recipe = RecipeExportSerializer(data=recipe_json, context={'request': request})
if serialized_recipe.is_valid():
recipe = serialized_recipe.save()
if validators.url(recipe_json['image'], public=True):
- recipe.image = File(
- handle_image(
- request,
- File(
- io.BytesIO(requests.get(recipe_json['image']).content),
- name='image'),
- filetype=pathlib.Path(recipe_json['image']).suffix),
- name=f'{uuid.uuid4()}_{recipe.pk}{pathlib.Path(recipe_json["image"]).suffix}')
+ recipe.image = File(handle_image(request,
+ File(io.BytesIO(requests.get(recipe_json['image']).content),
+ name='image'),
+ filetype=pathlib.Path(recipe_json['image']).suffix),
+ name=f'{uuid.uuid4()}_{recipe.pk}{pathlib.Path(recipe_json["image"]).suffix}')
recipe.save()
- return Response(
- {
- 'link': request.build_absolute_uri(reverse('view_recipe', args={recipe.pk}))
- }, status=status.HTTP_201_CREATED)
+ return Response({
+ 'link': request.build_absolute_uri(reverse('view_recipe', args={recipe.pk}))
+ }, status=status.HTTP_201_CREATED)
else:
try:
if validators.url(url, public=True):
scrape = scrape_me(url_path=url, wild_mode=True)
else:
- return Response(
- {
- 'error': True,
- 'msg': _('Invalid Url')
- }, status=status.HTTP_400_BAD_REQUEST)
+ return Response({
+ 'error': True,
+ 'msg': _('Invalid Url')
+ }, status=status.HTTP_400_BAD_REQUEST)
except NoSchemaFoundInWildMode:
pass
except requests.exceptions.ConnectionError:
- return Response(
- {
- 'error': True,
- 'msg': _('Connection Refused.')
- }, status=status.HTTP_400_BAD_REQUEST)
+ return Response({
+ 'error': True,
+ 'msg': _('Connection Refused.')
+ }, status=status.HTTP_400_BAD_REQUEST)
except requests.exceptions.MissingSchema:
- return Response(
- {
- 'error': True,
- 'msg': _('Bad URL Schema.')
- }, status=status.HTTP_400_BAD_REQUEST)
+ return Response({
+ 'error': True,
+ 'msg': _('Bad URL Schema.')
+ }, status=status.HTTP_400_BAD_REQUEST)
else:
try:
data_json = json.loads(data)
@@ -1473,18 +1445,16 @@ class RecipeUrlImportView(APIView):
scrape = text_scraper(text=data, url=found_url)
if scrape:
- return Response(
- {
- 'recipe_json': helper.get_from_scraper(scrape, request),
- 'recipe_images': list(dict.fromkeys(get_images_from_soup(scrape.soup, url))),
- }, status=status.HTTP_200_OK)
+ return Response({
+ 'recipe_json': helper.get_from_scraper(scrape, request),
+ 'recipe_images': list(dict.fromkeys(get_images_from_soup(scrape.soup, url))),
+ }, status=status.HTTP_200_OK)
else:
- return Response(
- {
- 'error': True,
- 'msg': _('No usable data could be found.')
- }, status=status.HTTP_400_BAD_REQUEST)
+ return Response({
+ 'error': True,
+ 'msg': _('No usable data could be found.')
+ }, status=status.HTTP_400_BAD_REQUEST)
else:
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
@@ -1576,9 +1546,8 @@ def import_files(request):
return Response({'import_id': il.pk}, status=status.HTTP_200_OK)
except NotImplementedError:
- return Response(
- {'error': True, 'msg': _('Importing is not implemented for this provider')},
- status=status.HTTP_400_BAD_REQUEST)
+ return Response({'error': True, 'msg': _('Importing is not implemented for this provider')},
+ status=status.HTTP_400_BAD_REQUEST)
else:
return Response({'error': True, 'msg': form.errors}, status=status.HTTP_400_BAD_REQUEST)
@@ -1654,9 +1623,8 @@ def get_recipe_file(request, recipe_id):
@group_required('user')
def sync_all(request):
if request.space.demo or settings.HOSTED:
- messages.add_message(
- request, messages.ERROR,
- _('This feature is not yet available in the hosted version of tandoor!'))
+ messages.add_message(request, messages.ERROR,
+ _('This feature is not yet available in the hosted version of tandoor!'))
return redirect('index')
monitors = Sync.objects.filter(active=True).filter(space=request.user.userspace_set.filter(active=1).first().space)
@@ -1695,9 +1663,8 @@ def share_link(request, pk):
if request.space.allow_sharing and has_group_permission(request.user, ('user',)):
recipe = get_object_or_404(Recipe, pk=pk, space=request.space)
link = ShareLink.objects.create(recipe=recipe, created_by=request.user, space=request.space)
- return JsonResponse(
- {'pk': pk, 'share': link.uuid,
- 'link': request.build_absolute_uri(reverse('view_recipe', args=[pk, link.uuid]))})
+ return JsonResponse({'pk': pk, 'share': link.uuid,
+ 'link': request.build_absolute_uri(reverse('view_recipe', args=[pk, link.uuid]))})
else:
return JsonResponse({'error': 'sharing_disabled'}, status=403)
diff --git a/docs/features/connectors.md b/docs/features/connectors.md
new file mode 100644
index 00000000..2687f7af
--- /dev/null
+++ b/docs/features/connectors.md
@@ -0,0 +1,43 @@
+!!! warning
+ Connectors are currently in a beta stage.
+
+## Connectors
+
+Connectors are a powerful add-on component to TandoorRecipes.
+They allow for certain actions to be translated to api calls to external services.
+
+### General Config
+
+!!! danger
+ In order for this application to push data to external providers it needs to store authentication information.
+ Please use read only/separate accounts or app passwords wherever possible.
+
+- `DISABLE_EXTERNAL_CONNECTORS` is a global switch to disable External Connectors entirely.
+- `EXTERNAL_CONNECTORS_QUEUE_SIZE` is the amount of changes that are kept in memory if the worker cannot keep up.
+
+Example Config
+```env
+DISABLE_EXTERNAL_CONNECTORS=0 // 0 = connectors enabled, 1 = connectors enabled
+EXTERNAL_CONNECTORS_QUEUE_SIZE=100
+```
+
+## Current Connectors
+
+### HomeAssistant
+
+The current HomeAssistant connector supports the following features:
+1. Push newly created shopping list items.
+2. Pushes all shopping list items if a recipe is added to the shopping list.
+3. Removed todo's from HomeAssistant IF they are unchanged and are removed through TandoorRecipes.
+
+#### How to configure:
+
+Step 1:
+1. Generate a HomeAssistant Long-Lived Access Tokens
+
+2. Get/create a todo list entry you want to sync too.
+
+3. Create a connector
+
+4. ???
+5. Profit
diff --git a/docs/system/configuration.md b/docs/system/configuration.md
index 0eb1b783..8d93f985 100644
--- a/docs/system/configuration.md
+++ b/docs/system/configuration.md
@@ -437,16 +437,6 @@ key [here](https://fdc.nal.usda.gov/api-key-signup.html).
FDC_API_KEY=DEMO_KEY
```
-#### External Connectors
-
-`DISABLE_EXTERNAL_CONNECTORS` is a global switch to disable External Connectors entirely (e.g. HomeAssistant).
-`EXTERNAL_CONNECTORS_QUEUE_SIZE` is the amount of changes that are kept in memory if the worker cannot keep up.
-
-```env
-DISABLE_EXTERNAL_CONNECTORS=0 // 0 = connectors enabled, 1 = connectors enabled
-EXTERNAL_CONNECTORS_QUEUE_SIZE=25
-```
-
### Debugging/Development settings
!!! warning
diff --git a/recipes/settings.py b/recipes/settings.py
index 009c6a5a..f14d2701 100644
--- a/recipes/settings.py
+++ b/recipes/settings.py
@@ -557,6 +557,6 @@ ACCOUNT_EMAIL_SUBJECT_PREFIX = os.getenv(
'ACCOUNT_EMAIL_SUBJECT_PREFIX', '[Tandoor Recipes] ') # allauth sender prefix
DISABLE_EXTERNAL_CONNECTORS = bool(int(os.getenv('DISABLE_EXTERNAL_CONNECTORS', False)))
-EXTERNAL_CONNECTORS_QUEUE_SIZE = int(os.getenv('EXTERNAL_CONNECTORS_QUEUE_SIZE', 25))
+EXTERNAL_CONNECTORS_QUEUE_SIZE = int(os.getenv('EXTERNAL_CONNECTORS_QUEUE_SIZE', 100))
mimetypes.add_type("text/javascript", ".js", True)