Version 0.8.0 (#34)

- Adding log_exception wrapper
- Adding ProtectedDict
- Adding hooks for Tasker main loop
- Adding roman number functions
- Adding directory_duplicates function
- Adding integer to words functions
- Adding option to enable scandir package walk instead of os.walk
- Adding url_to_ip and ip_to_url functions
- Adding hex_digest kwarg to file_hash
- Adding args and kwargs to time_it and log_exception wrappers
- Fixing file_hash checks by just passing to hashlib
- Changing functions to remove 'all' from them, extract_all, archive_all, find_all_files and find_all_files_generator
- Changing time_it function to use time.perf_counter on 3.3+ and time.clock on 2.6-3.2
- Depreciation Warning: extract_all is changing to extract
- Depreciation Warning: archive_all is changing to archive
- Depreciation Warning: find_all_files is changing to find_files
- Depreciation Warning: find_all_files_generator is changing to find_files_generator
- Depreciation Warning: count_all_files is changing to count_files
- Breaking change: Removing reuse wrapper
- Breaking change: archive_all now detects type based off name, should supply extension to name
- Breaking change: time_it message now takes args seconds, args, kwargs and does not allow positionals
- Breaking change: os_tree will no longer return an empty dictionary on failure, but include the base directory supplied
- Breaking change: renaming splice to cut

Author: cdgriffith

.coveragerc

@@ -5,6 +5,8 @@ omit =
     */test/*
     */pypy/*
     */nose/*
+    */.*/*
+    */*.egg-info/*
 exclude_lines =
     pragma: no cover
     except Exception
@@ -25,3 +27,16 @@ exclude_lines =
     self.free_tasks
     self.busy_tasks
     self.current_tasks
+    except KeyError
+    if size < self.max_tasks
+    elif size > self.max_tasks
+    raise NotImplementedError
+    return self.result_queue
+    except (Exception, KeyboardInterrupt)
+    if _os.path.isfile
+    elif _os.path.isfile
+    raise InvalidSchema
+    pass
+    _logger
+    t += 1
+    us = 0

.pep8speaks.yml

@@ -0,0 +1,5 @@
+scanner:
+    diff_only: False
+
+pycodestyle:
+    max-line-length: 100

.travis.yml

@@ -7,7 +7,8 @@ python:
     - "3.3"
     - "3.4"
     - "3.5"
-    - "3.6-dev"
+    - "3.6"
+    - "3.7-dev"
     - "pypy"
 before_install:
     - sudo apt-get -qq update
@@ -16,5 +17,5 @@ install:
     - pip install -r requirements.txt
     - pip install -r requirements-test.txt
     - pip install coveralls
-script: nosetests --with-coverage -vv --cover-package=reusables test
+script: pytest --cov=reusables
 after_success: coveralls

AUTHORS.rst

@@ -0,0 +1,7 @@
+Reusables is written and maintained by Chris Griffith <chris@cdgriffith.com>.
+
+A big thank you to everyone that has helped! From PRs to suggestions and bug
+reporting, all input is greatly appreciated!
+
+- Clara Griffith (beautiousmax)
+- Hellowlol

CHANGES.rst

@@ -1,6 +1,33 @@
 Changelog
 =========
 
+Version 0.8.0
+-------------
+
+- Adding log_exception wrapper
+- Adding ProtectedDict
+- Adding hooks for Tasker main loop
+- Adding roman number functions
+- Adding directory_duplicates function
+- Adding integer to words functions
+- Adding option to enable scandir package walk instead of os.walk
+- Adding url_to_ip and ip_to_url functions
+- Adding hex_digest kwarg to file_hash
+- Adding args and kwargs to time_it and log_exception wrappers
+- Fixing file_hash checks by just passing to hashlib
+- Changing functions to remove 'all' from them, extract_all, archive_all, find_all_files and find_all_files_generator
+- Changing time_it function to use time.perf_counter on 3.3+ and time.clock on 2.6-3.2
+- Depreciation Warning: extract_all is changing to extract
+- Depreciation Warning: archive_all is changing to archive
+- Depreciation Warning: find_all_files is changing to find_files
+- Depreciation Warning: find_all_files_generator is changing to find_files_generator
+- Depreciation Warning: count_all_files is changing to count_files
+- Breaking change: Removing reuse wrapper
+- Breaking change: archive_all now detects type based off name, should supply extension to name
+- Breaking change: time_it message now takes args seconds, args, kwargs and does not allow positionals
+- Breaking change: os_tree will no longer return an empty dictionary on failure, but include the base directory supplied
+- Breaking change: renaming splice to cut
+
 Version 0.7.0
 -------------
 

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 Chris Griffith
+Copyright (c) 2014-2017 Chris Griffith
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

Makefile

@@ -2,8 +2,10 @@ HOME ?= $HOME
 CWD = $(shell pwd)
 VENVS ?= $(HOME)/.virtualenvs
 PYTHON2 = $(VENVS)/builder2.7/bin/python2.7
-PYTHON3 = $(VENVS)/builder3.5/bin/python3.5
-PYTHONS = $(VENVS)/builder2.6/bin/python2.6 $(VENVS)/builder2.7/bin/python2.7 $(VENVS)/builder3.5/bin/python3.5 $(VENVS)/builder3.3/bin/python3.3 $(VENVS)/builder3.4/bin/python3.4
+PYTHON2BIN = $(VENVS)/builder2.7/bin
+PYTHON3BIN = $(VENVS)/builder3.6/bin
+PYTHON3 = $(VENVS)/builder3.5/bin/python3.6
+PYTHONS = $(VENVS)/builder2.6/bin/python2.6 $(VENVS)/builder2.7/bin/python2.7 $(VENVS)/builder3.5/bin/python3.5 $(VENVS)/builder3.3/bin/python3.3 $(VENVS)/builder3.4/bin/python3.4 $(VENVS)/builder3.6/bin/python3.6
 PYPY = $(VENVS)/builderpypy/bin/python
 
 .PHONY: all test clean help register build
@@ -24,9 +26,10 @@ clean:
 	rm -rf dist;
 
 test:
-	(set -e; for python in $(PYTHONS); do\
-		PYTHONPATH=$(CWD) "$$python" setup.py test; \
-	done)
+	$(PYTHON3BIN)/tox;
+#	(set -e; for python in $(PYTHONS); do\
+#		PYTHONPATH=$(CWD) "$$python" setup.py test; \
+#	done)
 
 
 build:
@@ -37,6 +40,9 @@ build:
  	"$$python" setup.py bdist_egg; \
  done
 
+rstcheck:
+	$(PYTHON2BIN)/rstcheck README.rst;
+
 
 register:
 	$(PYTHON2) setup.py register;
@@ -66,7 +72,7 @@ help:
 develop:
 	sudo add-apt-repository ppa:fkrull/deadsnakes;
 	sudo apt-get update;
-	sudo apt-get install python2.6 python2.7 python3.5 python3.3 python3.4 pypy python-pip unrar -y;
+	sudo apt-get install python2.6 python2.6-dev python2.7 python2.7-dev python3.3 python3.3-dev python3.4 python3.4-dev python3.5 python3.5-dev python3.6 python3.6-dev pypy pypy-dev python-pip unrar -y;
 	sudo pip install virtualenv --upgrade;
 	rm -rf $(VENVS);
 	mkdir -p $(VENVS);
@@ -75,4 +81,7 @@ develop:
 	virtualenv -p python3.3 $(VENVS)/builder3.3;
 	virtualenv -p python3.4 $(VENVS)/builder3.4;
 	virtualenv -p python3.5 $(VENVS)/builder3.5;
+	virtualenv -p python3.6 $(VENVS)/builder3.6;
 	virtualenv -p pypy $(VENVS)/builderpypy;
+	$(PYTHON2BIN)/pip install rstcheck --upgrade;
+	$(PYTHON3BIN)/pip install tox;

README.rst

@@ -41,7 +41,7 @@ readthedocs.org_.
 
 Please note this is currently in development. Any item in development
 prior to a major version (1.x, 2.x) may change. Once at a major version,
-no breaking changes will occur within it.
+no breaking changes are planned to occur within that version.
 
 What's in the box
 -----------------
@@ -53,19 +53,19 @@ General Helpers and File Management
 
         import reusables
 
-        reusables.find_all_files(".", ext=reusables.exts.pictures)
+        reusables.find_files_list(".", ext=reusables.exts.pictures)
         # ['/home/user/background.jpg', '/home/user/private.png']
 
-        reusables.archive_all("reusables", name="reuse", archive_type="zip")
+        reusables.archive("reusables", name="reuse", archive_type="zip")
         # 'C:\\Users\\Me\\Reusables\\reuse.zip'
 
-        reusables.extract_all("test/test_structure.zip", "my_archive")
+        reusables.extract("test/test_structure.zip", "my_archive")
         # All files in the zip will be extracted into directory "my_archive"
 
         reusables.config_dict('my_config.cfg')
         # {'Section 1': {'key 1': 'value 1', 'key2': 'Value2'}, 'Section 2': {}}
 
-        reusables.count_all_files(".")
+        reusables.count_files(".")
         # 405
 
         reusables.file_hash("test_structure.zip", hash_type="sha256")
@@ -77,30 +77,33 @@ General Helpers and File Management
         reusables.run("echo 'hello there!'", shell=True)
         # CompletedProcess(args="echo 'hello there!'", returncode=0, stdout='hello there!\n')
 
+        reusables.cut("abcdefghi")
+        # ['ab', 'cd', 'ef', 'gh', 'i']
 
-One of the most reusables pieces of code is the find_all_files. It is always
+
+One of the most reusables pieces of code is the find_files. It is always
 appearing on stackoverflow and forums of how to implement os.walk or glob;
 here's both.
 
 .. code:: python
 
-         reusables.find_all_files(".", name="*reuse*", depth=2)
+         reusables.find_files_list(".", name="*reuse*", depth=2)
          # ['.\\test\\test_reuse.py', '.\\test\\test_reuse_datetime.py',
          #  '.\\test\\test_reuse_logging.py', '.\\test\\test_reuse_namespace.py']
 
          # match_case works for both ext and name
          # depth of 1 means this working directory only, no further
 
-         reusables.find_all_files(ext=".PY", depth=1, match_case=True)
+         reusables.find_files_list(ext=".PY", depth=1, match_case=True)
          # []
 
-         reusables.find_all_files(ext=".py", depth=1, match_case=True)
+         reusables.find_files_list(ext=".py", depth=1, match_case=True)
          # ['.\\setup.py']
 
-         reusables.find_all_files(name="setup", ext=".py", match_case=True)
+         reusables.find_files_list(name="setup", ext=".py", match_case=True)
          # ['.\\setup.py']
 
-         reusables.find_all_files(name="Setup", ext=".py", match_case=True)
+         reusables.find_files_list(name="Setup", ext=".py", match_case=True)
          # []
 
 
@@ -400,7 +403,7 @@ License
 
 The MIT License (MIT)
 
-Copyright (c) 2014-2016 Chris Griffith
+Copyright (c) 2014-2017 Chris Griffith
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in
@@ -455,4 +458,6 @@ improve existing code is warmly welcomed!
    multiprocess_helpers
    cli
    wrappers
+   numbers
    changelog
+

doc/source/numbers.rst

@@ -0,0 +1,6 @@
+Numbers
+=======
+
+.. automodule:: reusables.numbers
+   :members:
+   :undoc-members:

requirements-test.txt

@@ -1,3 +1,6 @@
-nose >= 1.3
+pytest
 coverage >= 3.6
 rarfile
+scandir
+tox
+pytest-cov

requirements.txt

@@ -1 +1,2 @@
 rarfile
+scandir

reusables/__init__.py

@@ -1,3 +1,9 @@
+#!/usr/bin/env python
+# -*- coding: UTF-8 -*-
+#
+# Part of the Reusables package.
+#
+# Copyright (c) 2014-2017 - Chris Griffith - MIT License
 from __future__ import absolute_import
 from .reusables import *
 from .namespace import *
@@ -8,6 +14,7 @@
 from .multiprocess_helpers import *
 from .web import *
 from .shared_variables import *
+from .numbers import *
 
 __author__ = "Chris Griffith"
-__version__ = "0.7.0"
+__version__ = "0.8.0"

reusables/browser.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python
-# -*- coding: utf-8 -*-
+# -*- coding: UTF-8 -*-
 #
 # Part of the Reusables package.
 #
-# Copyright (c) 2014-2016 - Chris Griffith - MIT License
+# Copyright (c) 2014-2017 - Chris Griffith - MIT License
 """
 Classes for managing Firefox and Chrome Cookies
 """

reusables/cli.py

@@ -3,7 +3,7 @@
 #
 # Part of the Reusables package.
 #
-# Copyright (c) 2014-2016 - Chris Griffith - MIT License
+# Copyright (c) 2014-2017 - Chris Griffith - MIT License
 """
 Functions to only be used on Interactive instances to ease life.
 
@@ -16,7 +16,7 @@
 
 # Keep touch and download import so it can be imported with other CLI commands
 from .shared_variables import *
-from .reusables import run, win_based, find_all_files, touch
+from .reusables import run, win_based, find_files_list, touch
 from .web import download
 from .log import add_stream_handler
 
@@ -104,7 +104,7 @@ def ls(params="", directory=".", printed=True):
 def find(name=None, ext=None, directory=".", match_case=False,
          disable_glob=False, depth=None):
     """ Designed for the interactive interpreter by making default order
-    of find_all_files faster.
+    of find_files faster.
 
     :param name: Part of the file name
     :param ext: Extensions of the file you are looking for
@@ -114,9 +114,9 @@ def find(name=None, ext=None, directory=".", match_case=False,
     :param depth: How many directories down to search
     :return: list of all files in the specified directory
     """
-    return find_all_files(directory=directory, ext=ext, name=name,
-                          match_case=match_case, disable_glob=disable_glob,
-                          depth=depth)
+    return find_files_list(directory=directory, ext=ext, name=name,
+                           match_case=match_case, disable_glob=disable_glob,
+                           depth=depth)
 
 
 def head(file_path, lines=10, encoding="utf-8", printed=True,
@@ -149,13 +149,16 @@ def head(file_path, lines=10, encoding="utf-8", printed=True,
 
 def cat(file_path, encoding="utf-8", errors='strict'):
     """
-          ^-^
-         (-.-)
-          |.|
-         /  \\
-        |    |   _/
-        | || |  |
-        \_||_/_/
+
+    .. code:
+
+              ^-^
+             (-.-)
+              |.|
+             /  \\
+            |    |   _/
+            | || |  |
+            \_||_/_/
 
     :param file_path: Path to file to read
     :param encoding: defaults to utf-8 to decode as, will fail on binary

reusables/dt.py

@@ -3,7 +3,7 @@
 #
 # Part of the Reusables package.
 #
-# Copyright (c) 2014-2016 - Chris Griffith - MIT License
+# Copyright (c) 2014-2017 - Chris Griffith - MIT License
 """
 A hopefully easier to use formatting system for datetime.
 """