Merge branch 'master' into fix_pandas_test_eq

Author: jph00

.devcontainer.json

@@ -2,12 +2,13 @@
     "name": "fastcore-codespaces",
     "dockerComposeFile": "docker-compose.yml",
     "settings": {"terminal.integrated.shell.linux": "/bin/bash"},
+    "workspaceFolder": "/data/",
     "service": "watcher",
     "mounts": [ "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind" ],
     "forwardPorts": [4000, 8080],
     "appPort": [4000, 8080],
     "extensions": ["ms-python.python",
                    "ms-azuretools.vscode-docker"],
     "runServices": ["notebook", "jekyll", "watcher"],
-    "postStartCommand": "pip install -e ."
+    "postStartCommand": "cd /data && pip install -e \".[dev]\""
 }

.github/workflows/main.yml

@@ -28,7 +28,8 @@ jobs:
       uses: fastai/workflows/nb@master
     - name: Run fastcore tests
       run: |
-        pip install -Uqq nbdev fastcore
+        pip install -Uqq nbdev
+        pip install -e ".[dev]"
         nbdev_test_nbs
   
   nbdev-integration-test:
@@ -79,7 +80,6 @@ jobs:
         pip install -Uqq nbdev
         cd fastai && pip install -Ue .[dev]
         cd ../fastcore && pip install -Ue .[dev]
-        pip install "sentencepiece<0.1.90" wandb tensorboard albumentations pydicom opencv-python scikit-image pyarrow kornia catalyst captum neptune-cli
 
     - name: check for cache hit
       uses: actions/cache@v2

CHANGELOG.md

@@ -2,6 +2,103 @@
 
 <!-- do not remove -->
 
+## 1.3.12
+
+### New Features
+
+- enum support for `call_parse` ([#245](https://github.com/fastai/fastcore/issues/245))
+- Added obj2dict ([#244](https://github.com/fastai/fastcore/issues/244))
+- `return_headers` param for `urlsend` and `urlread` ([#242](https://github.com/fastai/fastcore/issues/242))
+- add common Chrome headers ([#241](https://github.com/fastai/fastcore/issues/241))
+- add `utc2local` and `local2utc` ([#239](https://github.com/fastai/fastcore/issues/239))
+- add `Path.read_json` ([#238](https://github.com/fastai/fastcore/issues/238))
+
+### Bugs Squashed
+
+- `*args` not handled correctly in process/thread pools ([#246](https://github.com/fastai/fastcore/issues/246))
+
+
+## 1.3.11
+
+### Bugs Squashed
+
+- regression in urlopen header user-agent not set ([#237](https://github.com/fastai/fastcore/issues/237))
+- `loads` incompatible with Python 3.9 ([#236](https://github.com/fastai/fastcore/issues/236))
+- Documentation search not working ([#235](https://github.com/fastai/fastcore/issues/235))
+
+
+## 1.3.10
+
+### New Features
+
+- split `parallel` and `net` modules out of `xtras` ([#234](https://github.com/fastai/fastcore/issues/234))
+- New HTTP Exceptions hierarchy for each status code, used by `url*` functions
+- add `Request.summary` and `debug` paramaeter to `urlsend` ([#233](https://github.com/fastai/fastcore/issues/233))
+- Add `ImportEnum`, `StrEnum`, and `str_enum` ([#232](https://github.com/fastai/fastcore/issues/232))
+- handle encoded data in `urlrequest` ([#231](https://github.com/fastai/fastcore/issues/231))
+
+
+## 1.3.9
+
+### New Features
+
+- use `__slots__` in `store_attr` if exists ([#226](https://github.com/fastai/fastcore/issues/226))
+- add `urlrequest` ([#225](https://github.com/fastai/fastcore/issues/225))
+- add `loads` and `urlsend` ([#224](https://github.com/fastai/fastcore/issues/224))
+- add `PartialFormatter` and `partial_format` ([#223](https://github.com/fastai/fastcore/issues/223))
+- add `stringfmt_names` ([#222](https://github.com/fastai/fastcore/issues/222))
+
+
+## 1.3.8
+
+### New Features
+
+- rename `negate_func` to `not_` for consistency with other curried ops ([#221](https://github.com/fastai/fastcore/issues/221))
+- Support empty content for `urljson` ([#219](https://github.com/fastai/fastcore/issues/219))
+- move `patch` and `patch_to` to `fastcore.basics`, and avoid clobbering existing symbols when patching ([#214](https://github.com/fastai/fastcore/issues/214))
+
+
+## 1.3.7
+
+### New Features
+
+- add `startthread` ([#218](https://github.com/fastai/fastcore/issues/218))
+- make `run` compatible with py36 ([#216](https://github.com/fastai/fastcore/issues/216))
+- `reuse_addr` param to `start_server` ([#215](https://github.com/fastai/fastcore/issues/215))
+- add rfc3986 list to `urlquote` ([#213](https://github.com/fastai/fastcore/issues/213))
+
+
+## 1.3.6
+
+### New Features
+
+- quote URL paths in `urlwrap` ([#211](https://github.com/fastai/fastcore/issues/211))
+- Add `start_server` and `start_client` for simple socket networking ([#210](https://github.com/fastai/fastcore/issues/210))
+- new `uniqueify` and `val2idx` functions, and additional params to `listify` ([#209](https://github.com/fastai/fastcore/issues/209))
+- improve representation in `basic_repr` ([#197](https://github.com/fastai/fastcore/issues/197))
+
+
+## 1.3.5
+
+### Breaking Changes
+
+- remove `log_args` ([#176](https://github.com/fastai/fastcore/issues/176))
+
+### New Features
+
+- `Stateful` base class/mixin for objects that should not serialize all their state ([#196](https://github.com/fastai/fastcore/issues/196))
+- new `frame` param to `argnames` ([#195](https://github.com/fastai/fastcore/issues/195))
+- add `urlopen` and `untar_dir` ([#192](https://github.com/fastai/fastcore/issues/192))
+- `SCRIPT_INFO.func` to let functions know what CLI name was called in `fastcore.script` ([#185](https://github.com/fastai/fastcore/issues/185))
+- add `annotations` and `argnames` functions ([#179](https://github.com/fastai/fastcore/issues/179))
+- allow `but` param in `store_attr` to be either `list` or `str` ([#174](https://github.com/fastai/fastcore/issues/174))
+- add `urlvalid` ([#173](https://github.com/fastai/fastcore/issues/173))
+
+### Bugs Squashed
+
+- `@typed` doesn't work with classes ([#183](https://github.com/fastai/fastcore/issues/183)) (reported by @krishnap)
+
+
 ## 1.3.2
 
 ### New Features

README.md

@@ -51,7 +51,7 @@ For more details, including a link to the full documentation and source code, us
 doc(coll_repr)
 ```
 
-<img width="499" src="nbs/images/att_00000.png" align="left">
+<img width="499" src="nbs/images/att_00000.png" style="max-width: 499px">
 
 The documentation also contains links to any related functions or classes, which appear like this: `coll_repr` (in the notebook itself you will just see a word with back-ticks around it; the links are auto-generated in the documentation site). The documentation will generally show one or more examples of use, along with any background context necessary to understand them. As you'll see, the examples for each function and method are shown as tests, rather than example outputs, so let's start by explaining that. 
 

docker-compose.yml

@@ -15,7 +15,7 @@ services:
 
   notebook:
     <<: *fastai
-    command: bash -c "pip install -e . && jupyter notebook --allow-root --no-browser --ip=0.0.0.0 --port=8080 --NotebookApp.token='' --NotebookApp.password=''"
+    command: bash -c "pip install -e \".[dev]\" && jupyter notebook --allow-root --no-browser --ip=0.0.0.0 --port=8080 --NotebookApp.token='' --NotebookApp.password=''"
     ports:
       - "8080:8080"
 

docs_src/_config.yml

@@ -6,7 +6,7 @@ company_name: fast.ai
 github_editme_path: 
 use_math: true
 google_analytics: UA-89522379-3
-google_search: 000837339549978028235:mygjrpycyx2
+google_search: 330b68eee09552ff9 
 
 exclude:
   - .idea/

fastcore/__init__.py

@@ -1 +1 @@
-__version__ = "1.3.3"
+__version__ = "1.3.13"

fastcore/_nbdev.py

@@ -25,6 +25,7 @@
          "basic_repr": "01_basics.ipynb",
          "is_array": "01_basics.ipynb",
          "listify": "01_basics.ipynb",
+         "tuplify": "01_basics.ipynb",
          "true": "01_basics.ipynb",
          "NullType": "01_basics.ipynb",
          "null": "01_basics.ipynb",
@@ -52,17 +53,22 @@
          "store_attr": "01_basics.ipynb",
          "attrdict": "01_basics.ipynb",
          "properties": "01_basics.ipynb",
+         "camel2words": "01_basics.ipynb",
          "camel2snake": "01_basics.ipynb",
          "snake2camel": "01_basics.ipynb",
          "class2attr": "01_basics.ipynb",
          "getattrs": "01_basics.ipynb",
          "hasattrs": "01_basics.ipynb",
          "setattrs": "01_basics.ipynb",
          "try_attrs": "01_basics.ipynb",
+         "GetAttrBase": "01_basics.ipynb",
+         "GetAttr": "01_basics.ipynb",
+         "delegate_attr": "01_basics.ipynb",
          "ShowPrint": "01_basics.ipynb",
          "Int": "01_basics.ipynb",
          "Str": "01_basics.ipynb",
          "Float": "01_basics.ipynb",
+         "concat": "01_basics.ipynb",
          "detuplify": "01_basics.ipynb",
          "replicate": "01_basics.ipynb",
          "setify": "01_basics.ipynb",
@@ -76,13 +82,15 @@
          "cycle": "02_foundation.ipynb",
          "zip_cycle": "02_foundation.ipynb",
          "sorted_ex": "01_basics.ipynb",
-         "negate_func": "01_basics.ipynb",
+         "not_": "01_basics.ipynb",
          "argwhere": "01_basics.ipynb",
          "filter_ex": "01_basics.ipynb",
          "renumerate": "01_basics.ipynb",
          "first": "01_basics.ipynb",
          "nested_attr": "01_basics.ipynb",
          "nested_idx": "01_basics.ipynb",
+         "val2idx": "01_basics.ipynb",
+         "uniqueify": "01_basics.ipynb",
          "num_methods": "01_basics.ipynb",
          "rnum_methods": "01_basics.ipynb",
          "inum_methods": "01_basics.ipynb",
@@ -100,75 +108,102 @@
          "instantiate": "01_basics.ipynb",
          "using_attr": "01_basics.ipynb",
          "Self": "01_basics.ipynb",
+         "copy_func": "01_basics.ipynb",
+         "patch_to": "01_basics.ipynb",
+         "patch": "01_basics.ipynb",
+         "patch_property": "01_basics.ipynb",
+         "ImportEnum": "01_basics.ipynb",
+         "StrEnum": "01_basics.ipynb",
+         "str_enum": "01_basics.ipynb",
+         "Stateful": "01_basics.ipynb",
          "PrettyString": "01_basics.ipynb",
          "even_mults": "01_basics.ipynb",
          "num_cpus": "01_basics.ipynb",
          "defaults.cpus": "01_basics.ipynb",
          "add_props": "01_basics.ipynb",
          "typed": "01_basics.ipynb",
-         "copy_func": "02_foundation.ipynb",
-         "patch_to": "02_foundation.ipynb",
-         "patch": "02_foundation.ipynb",
-         "patch_property": "02_foundation.ipynb",
          "working_directory": "02_foundation.ipynb",
          "add_docs": "02_foundation.ipynb",
          "docs": "02_foundation.ipynb",
          "coll_repr": "02_foundation.ipynb",
          "is_bool": "02_foundation.ipynb",
          "mask2idxs": "02_foundation.ipynb",
          "is_indexer": "02_foundation.ipynb",
-         "GetAttr": "02_foundation.ipynb",
-         "delegate_attr": "02_foundation.ipynb",
          "CollBase": "02_foundation.ipynb",
          "L": "02_foundation.ipynb",
          "L.__signature__": "02_foundation.ipynb",
          "save_config_file": "02_foundation.ipynb",
          "read_config_file": "02_foundation.ipynb",
          "Config": "02_foundation.ipynb",
          "dict2obj": "03_xtras.ipynb",
+         "obj2dict": "03_xtras.ipynb",
          "repr_dict": "03_xtras.ipynb",
          "AttrDict.__repr__": "03_xtras.ipynb",
-         "tuplify": "03_xtras.ipynb",
-         "uniqueify": "03_xtras.ipynb",
          "is_listy": "03_xtras.ipynb",
          "shufflish": "03_xtras.ipynb",
          "mapped": "03_xtras.ipynb",
          "IterLen": "03_xtras.ipynb",
          "ReindexCollection": "03_xtras.ipynb",
-         "Path.readlines": "03_xtras.ipynb",
-         "Path.mk_write": "03_xtras.ipynb",
-         "Path.ls": "03_xtras.ipynb",
-         "open_file": "03_xtras.ipynb",
-         "save_pickle": "03_xtras.ipynb",
-         "load_pickle": "03_xtras.ipynb",
-         "Path.__repr__": "03_xtras.ipynb",
          "maybe_open": "03_xtras.ipynb",
          "image_size": "03_xtras.ipynb",
          "bunzip": "03_xtras.ipynb",
          "join_path_file": "03_xtras.ipynb",
-         "urlread": "03_xtras.ipynb",
-         "urljson": "03_xtras.ipynb",
-         "urlwrap": "03_xtras.ipynb",
-         "urlcheck": "03_xtras.ipynb",
-         "urlclean": "03_xtras.ipynb",
-         "urlsave": "03_xtras.ipynb",
-         "urlvalid": "03_xtras.ipynb",
+         "loads": "03_xtras.ipynb",
+         "untar_dir": "03_xtras.ipynb",
          "repo_details": "03_xtras.ipynb",
          "run": "03_xtras.ipynb",
-         "do_request": "03_xtras.ipynb",
-         "sort_by_run": "03_xtras.ipynb",
+         "open_file": "03_xtras.ipynb",
+         "save_pickle": "03_xtras.ipynb",
+         "load_pickle": "03_xtras.ipynb",
+         "Path.readlines": "03_xtras.ipynb",
+         "Path.read_json": "03_xtras.ipynb",
+         "Path.mk_write": "03_xtras.ipynb",
+         "Path.ls": "03_xtras.ipynb",
+         "Path.__repr__": "03_xtras.ipynb",
+         "truncstr": "03_xtras.ipynb",
+         "spark_chars": "03_xtras.ipynb",
+         "sparkline": "03_xtras.ipynb",
+         "autostart": "03_xtras.ipynb",
+         "time_events": "03_xtras.ipynb",
+         "EventTimer": "03_xtras.ipynb",
+         "stringfmt_names": "03_xtras.ipynb",
+         "PartialFormatter": "03_xtras.ipynb",
+         "partial_format": "03_xtras.ipynb",
+         "utc2local": "03_xtras.ipynb",
+         "local2utc": "03_xtras.ipynb",
          "trace": "03_xtras.ipynb",
          "round_multiple": "03_xtras.ipynb",
          "modified_env": "03_xtras.ipynb",
          "ContextManagers": "03_xtras.ipynb",
          "str2bool": "03_xtras.ipynb",
-         "set_num_threads": "03_xtras.ipynb",
-         "ProcessPoolExecutor": "03_xtras.ipynb",
-         "ThreadPoolExecutor": "03_xtras.ipynb",
-         "parallel": "03_xtras.ipynb",
-         "run_procs": "03_xtras.ipynb",
-         "parallel_gen": "03_xtras.ipynb",
-         "threaded": "03_xtras.ipynb",
+         "sort_by_run": "03_xtras.ipynb",
+         "threaded": "03a_parallel.ipynb",
+         "startthread": "03a_parallel.ipynb",
+         "set_num_threads": "03a_parallel.ipynb",
+         "ThreadPoolExecutor": "03a_parallel.ipynb",
+         "ProcessPoolExecutor": "03a_parallel.ipynb",
+         "parallel": "03a_parallel.ipynb",
+         "run_procs": "03a_parallel.ipynb",
+         "parallel_gen": "03a_parallel.ipynb",
+         "url_default_headers": "03b_net.ipynb",
+         "urlquote": "03b_net.ipynb",
+         "urlwrap": "03b_net.ipynb",
+         "ExceptionsHTTP": "03b_net.ipynb",
+         "HTTP4xxClientError": "03b_net.ipynb",
+         "HTTP5xxServerError": "03b_net.ipynb",
+         "urlopen": "03b_net.ipynb",
+         "urlread": "03b_net.ipynb",
+         "urljson": "03b_net.ipynb",
+         "urlcheck": "03b_net.ipynb",
+         "urlclean": "03b_net.ipynb",
+         "urlsave": "03b_net.ipynb",
+         "urlvalid": "03b_net.ipynb",
+         "urlrequest": "03b_net.ipynb",
+         "Request.summary": "03b_net.ipynb",
+         "urlsend": "03b_net.ipynb",
+         "do_request": "03b_net.ipynb",
+         "start_server": "03b_net.ipynb",
+         "start_client": "03b_net.ipynb",
          "lenient_issubclass": "04_dispatch.ipynb",
          "sorted_topologically": "04_dispatch.ipynb",
          "TypeDispatch": "04_dispatch.ipynb",
@@ -207,6 +242,7 @@
          "store_true": "08_script.ipynb",
          "store_false": "08_script.ipynb",
          "bool_arg": "08_script.ipynb",
+         "clean_type_str": "08_script.ipynb",
          "Param": "08_script.ipynb",
          "anno_parser": "08_script.ipynb",
          "args_from_prog": "08_script.ipynb",
@@ -217,6 +253,8 @@
            "basics.py",
            "foundation.py",
            "xtras.py",
+           "parallel.py",
+           "net.py",
            "dispatch.py",
            "transform.py",
            "meta.py",