Port from bower to yarn.

.coveragerc

 [run]
-include = djangobower*
+include = django_yarnpkg*

.covio.yml

-violations:
-  pep8: pep8 . --exclude='*migrations*,*settings*,*components*,*docs*'
-  sloccount: sloccount .
-  py_unittest: cat test_out

CHANGELOG.rst

+Version 6.0  (2019-12-07)
+=====================================================
+
+* Fork and port to yarnpkg
+
 Version 4.8  (2013-10-02)
 =====================================================
 

README.rst

-Django-bower
-============
+Django-yarnpkg
+==============
 
-.. image:: https://travis-ci.org/nvbn/django-bower.png
-   :alt: Build Status
-   :target: https://travis-ci.org/nvbn/django-bower
-.. image:: https://coveralls.io/repos/nvbn/django-bower/badge.png?branch=develop
-   :alt: Coverage Status
-   :target: https://coveralls.io/r/nvbn/django-bower
-.. image:: https://pypip.in/v/django-bower/badge.png
-   :target: https://crate.io/packages/django-bower/
-.. image:: https://pypip.in/d/django-bower/badge.png
-   :target: https://crate.io/packages/django-bower/
+Easy way to use `yarnpkg <http://yarnpkg.com/>`_ with your `Django <https://www.djangoproject.com/>`_ project.
 
-Easy way to use `bower <http://bower.io/>`_ with your `Django <https://www.djangoproject.com/>`_ project.
+This is a fork of `django-bower <https://github.com/nvbn/django-bower>` by Vladimir Iakovlev.
 
-Bower is a package manager for the web. It offers a generic, unopinionated solution to the problem of front-end package management, while exposing the package dependency model via an API that can be consumed by a more opinionated build stack. There are no system wide dependencies, no dependencies are shared between different apps, and the dependency tree is flat.
-
-Read full documentation on `read-the-docs <https://django-bower.readthedocs.io/en/latest/>`_.
+Read full documentation on `read-the-docs <https://django-yarnpkg.readthedocs.io/en/latest/>`_.
 
 Installation
 ------------
 
-Install django-bower package:
+Install django-yarnpkg package:
 
 .. code-block:: bash
 
-    pip install django-bower
+    pip install django-yarnpkg
 
 Add django-bower to `INSTALLED_APPS` in your settings:
 
 .. code-block:: python
 
-    'djangobower',
+    'django_yarnpkg',
 
 Add staticfinder to `STATICFILES_FINDERS`:
 
 .. code-block:: python
 
-    'djangobower.finders.BowerFinder',
+    'django_yarnpkg.finders.NodeModulesFinder',
 
 Specify path to components root (you need to use an absolute path):
 
 .. code-block:: python
 
-    BOWER_COMPONENTS_ROOT = '/PROJECT_ROOT/components/'
+    NODE_MODULES_ROOT = os.path.join(BASE_DIR, 'node_modules')
 
 
-If you need, you can manually set the path to bower:
+If you need, you can manually set the path to yarnpkg:
 
 .. code-block:: python
 
-    BOWER_PATH = '/usr/bin/bower'
+    YARN_PATH = '/usr/bin/yarnpkg'
 
-You can see an example settings file in `example project <https://github.com/nvbn/django-bower/blob/master/example/example/settings.py>`_.
+You can see an example settings file in `example project <https://github.com/Natureshadow/django-yarnpkg/blob/master/example/example/settings.py>`_.
 
 Usage
 -----
 
-Specify `BOWER_INSTALLED_APPS` in settings, like:
+Specify `YARN_INSTALLED_APPS` in settings, like:
 
 .. code-block:: python
 
-    BOWER_INSTALLED_APPS = (
-        'jquery#1.9',
-        'underscore',
+    YARN_INSTALLED_APPS = (
+        'bootstrap@^4.4.1',
+        'underscore@^1.6.1',
     )
 
-Download bower packages with the management command:
+Download yarn packages with the management command:
 
 .. code-block:: bash
 
-    ./manage.py bower install
+    ./manage.py yarn install
 
 Add scripts in the template, like:
 
@@ -79,32 +68,26 @@ Add scripts in the template, like:
     {% load static %}
     <script type="text/javascript" src='{% static 'jquery/dist/jquery.js' %}'></script>
 
-In production you need to call `bower install` before `collectstatic`:
+In production you need to call `yarnpkg install` before `collectstatic`:
 
 .. code-block:: bash
 
-    ./manage.py bower install
+    ./manage.py yarn install
     ./manage.py collectstatic
 
-If you need to pass arguments to bower, like `--allow-root`, use:
-
-.. code-block:: bash
-
-    ./manage.py bower install -- --allow-root
-
-You can use `bower freeze` to receive `BOWER_INSTALLED_APPS` with fixed current versions:
+If you need to pass arguments to yarnpkg, like `--flat`, use:
 
 .. code-block:: bash
 
-    ./manage.py bower freeze
+    ./manage.py yarn install -- --flat
 
-You can call bower commands like `info` and `update` with:
+You can call yarnpkg commands like `info` and `update` with:
 
 .. code-block:: bash
 
-    ./manage.py bower info backbone
-    ./manage.py bower update
+    ./manage.py yarn info backbone
+    ./manage.py yarn update
 
 Python 3 support
 ----------------
-django-bower supports python 3.3+
+django-yarnpkg supports python 3.3+

django_yarnpkg/conf.py

+# -*- coding: utf-8 -*-
+from distutils.spawn import find_executable
+import os
+import sys
+from django.conf import settings
+
+__all__ = ['NODE_MODULES_ROOT', 'YARN_PATH']
+
+NODE_MODULES_ROOT = getattr(settings, 'NODE_MODULES_ROOT', os.path.abspath(os.path.dirname(__name__)))
+
+default_yarn_path = find_executable('yarn') or find_executable('yarnpkg')
+
+YARN_PATH = getattr(settings, 'YARN_PATH', default_yarn_path)

djangobower/context_processors.py → django_yarnpkg/context_processors.py

@@ -6,26 +6,23 @@ from django.conf import settings
 from django.utils.datastructures import OrderedSet
 
 
-def read_mains():
-    for component in settings.BOWER_INSTALLED_APPS:
+def read_files():
+    for component in settings.YARN_INSTALLED_APPS:
         component = component.split('#')[0]
         try:
             with open(os.path.join(
-                    settings.BOWER_COMPONENTS_ROOT,
-                    'bower_components',
+                    settings.NODE_MODULES_ROOT,
+                    'node_modules',
                     component,
-                    'bower.json')) as bower_json:
-                main = json.load(bower_json).get('main')
-                if isinstance(main, six.string_types):
-                    yield '%s/%s' % (component, main)
-                elif isinstance(main, list):
-                    for m in main:
-                        yield '%s/%s' % (component, m)
+                    'package.json')) as package_json:
+                files = json.load(bower_json).get('files')
+                for f in files:
+                    yield '%s/%s' % (component, f)
         except FileNotFoundError:
             continue
 
 
-def bower_components(request):
+def node_modules(request):
     return {
-        'bower_components': OrderedSet([main for main in read_mains()]),
+        'node_modules': OrderedSet([f for f in read_files()]),
     }

django_yarnpkg/exceptions.py

+from django.core.management.base import CommandError
+
+
+class YarnNotInstalled(CommandError):
+    """Custom command error"""
+
+    def __init__(self):
+        super(YarnNotInstalled, self).__init__(
+            "Yarn not installed, read instruction here - http://yarnpkg.com/",
+        )

djangobower/finders.py → django_yarnpkg/finders.py

@@ -9,14 +9,14 @@ from . import conf
 import os
 
 
-class BowerFinder(FileSystemFinder):
-    """Find static files installed with bower"""
+class NodeModulesFinder(FileSystemFinder):
+    """Find static files installed with yarnpkg"""
 
     def __init__(self, apps=None, *args, **kwargs):
         self.locations = []
         self.storages = OrderedDict()
 
-        root = self._get_bower_components_location()
+        root = self._get_node_modules_location()
         if root is not None:
             prefix = ''
             self.locations.append((prefix, root))
@@ -25,13 +25,10 @@ class BowerFinder(FileSystemFinder):
             filesystem_storage.prefix = prefix
             self.storages[root] = filesystem_storage
 
-    def _get_bower_components_location(self):
+    def _get_node_modules_location(self):
         """
-        Return the bower components location, or None if one does not exist.
+        Return the node modules location, or None if one does not exist.
         """
-        # Bower 0.10 changed the default folder from 'components' to 'bower_components'.
-        # Try 'bower_components' first, then fall back to trying 'components'.
-        for name in ['bower_components', 'components']:
-            path = os.path.join(conf.COMPONENTS_ROOT, name)
-            if os.path.exists(path):
-                return path
+        path = os.path.join(conf.NODE_MODULES_ROOT, 'node_modules')
+        if os.path.exists(path):
+            return path

djangobower/management/base.py → django_yarnpkg/management/base.py

 from pprint import pformat
 from django.core.management.base import BaseCommand
 from django.conf import settings
-from ..bower import bower_adapter
-from ..exceptions import BowerNotInstalled
+from ..yarn import yarn_adapter
+from ..exceptions import YarnNotInstalled
 
 
-class BaseBowerCommand(BaseCommand):
-    """Base management command with bower support"""
+class BaseYarnCommand(BaseCommand):
+    """Base management command with yarn support"""
 
     requires_system_checks = False
 
@@ -15,21 +15,13 @@ class BaseBowerCommand(BaseCommand):
         option_list = ()
 
     def handle(self, *args, **options):
-        self._check_bower_exists()
-        bower_adapter.create_components_root()
+        self._check_yarn_exists()
+        yarn_adapter.create_node_modules_root()
 
-    def _check_bower_exists(self):
-        """Check bower exists or raise exception"""
-        if not bower_adapter.is_bower_exists():
-            raise BowerNotInstalled()
+    def _check_yarn_exists(self):
+        """Check yarn exists or raise exception"""
+        if not yarn_adapter.is_yarn_exists():
+            raise YarnNotInstalled()
 
     def _install(self, args):
-        bower_adapter.install(settings.BOWER_INSTALLED_APPS, *args)
-
-    def _freeze(self):
-        packages = list(bower_adapter.freeze())
-        packages.sort()
-        output = 'BOWER_INSTALLED_APPS = {0}'.format(
-            pformat(packages),
-        )
-        self.stdout.write(output)
+        yarn_adapter.install(settings.YARN_INSTALLED_APPS, *args)

djangobower/management/commands/bower.py → django_yarnpkg/management/commands/yarn.py

-from ...bower import bower_adapter
-from ..base import BaseBowerCommand
+from ...yarn import yarn_adapter
+from ..base import BaseYarnCommand
 
 
-class Command(BaseBowerCommand):
+class Command(BaseYarnCommand):
     args = 'command'
-    help = 'Call bower in components root ({0}).'.format(
-        bower_adapter._components_root)
+    help = 'Call yarn in node modules root ({0}).'.format(
+        yarn_adapter._node_modules_root)
 
-    # for Django>=1.10
     def add_arguments(self, parser):
         parser.add_argument('command', nargs='*')
 
@@ -16,10 +15,8 @@ class Command(BaseBowerCommand):
         args = args or tuple(options.pop('command'))
         if self._is_single_command('install', args):
             self._install([])
-        elif self._is_single_command('freeze', args):
-            self._freeze()
         else:
-            bower_adapter.call_bower(args)
+            yarn_adapter.call_bower(args)
 
     def _is_single_command(self, name, args):
         return len(args) == 1 and args[0] == name

djangobower/management/commands/bower_freeze.py → django_yarnpkg/management/commands/yarn_install.py

-from ..base import BaseBowerCommand
+from optparse import make_option
+from ..base import BaseYarnCommand
 
 
-class Command(BaseBowerCommand):
-    help = 'Freeze bower apps'
+class Command(BaseYarnCommand):
+    help = 'Install yarn apps'
 
     def handle(self, *args, **options):
         super(Command, self).handle(*args, **options)
-        self._freeze()
+        self._install(args)

djangobower/shortcuts.py → django_yarnpkg/shortcuts.py

@@ -7,22 +7,3 @@ def is_executable(path):
         executable = os.access(path, os.X_OK) or path.lower().endswith(".cmd")
         return os.path.isfile(path) and executable
     return os.path.isfile(path) and os.access(path, os.X_OK)
-
-
-def which(program):
-    """
-    Find by path and check exists.
-    Analog of unix `which` command.
-    """
-    path, name = os.path.split(program)
-    if path:
-        if is_executable(program):
-            return program
-    else:
-        for path in os.environ["PATH"].split(os.pathsep):
-            path = path.strip('"')
-            exe_file = os.path.join(path, program)
-            if is_executable(exe_file):
-                return exe_file
-
-    return None

djangobower/templatetags/bower.py → django_yarnpkg/templatetags/yarn.py

@@ -24,13 +24,13 @@ script_template = template.Template(
 
 def tags(context, args, type):
     components = (
-        [arg for arg in args if arg in context['bower_components']]
-        if args else context['bower_components']
+        [arg for arg in args if arg in context['node_modules']]
+        if args else context['node_modules']
     )
     files = []
     for component in components:
         files.append(component)
-        context['bower_components'].remove(component)
+        context['node_modules'].remove(component)
     return {'files': [
         static.static(f)
         for f in files
@@ -39,10 +39,10 @@ def tags(context, args, type):
 
 
 @register.inclusion_tag(style_template, takes_context=True)
-def bower_styles(context, *args):
+def yarn_styles(context, *args):
     return tags(context, args, 'css')
 
 
 @register.inclusion_tag(script_template, takes_context=True)
-def bower_scripts(context, *args):
+def yarn_scripts(context, *args):
     return tags(context, args, 'js')

djangobower/test_settings.py → django_yarnpkg/test_settings.py

@@ -8,21 +8,21 @@ TEST_PROJECT_ROOT = os.path.abspath(
 
 BASE_DIR = TEST_PROJECT_ROOT
 
-BOWER_COMPONENTS_ROOT = os.path.join(TEST_PROJECT_ROOT, 'bower_components')
+NODE_MODULES_ROOT = os.path.join(TEST_PROJECT_ROOT, 'node_modules')
 
-STATIC_ROOT = os.path.join(TEST_PROJECT_ROOT, 'bower_static')
+STATIC_ROOT = os.path.join(TEST_PROJECT_ROOT, 'yarnpkg_static')
 
 STATIC_URL = '/static/'
 
-BOWER_INSTALLED_APPS = (
+YARN_INSTALLED_APPS = (
     'jquery#1.9',
     'underscore',
 )
 
-SECRET_KEY = 'iamdjangobower'
+SECRET_KEY = 'iamdjangoyarnpkg'
 
 INSTALLED_APPS = (
-    'djangobower',
+    'django_yarnpkg',
 )
 
 DATABASES = {