CHANGELOG.md

# Release notes

<!-- do not remove -->

## 2.2.35

### New Features

- Strip OSC hyperlinks in `strip_ansi`, let `call_func` accept functions directly, add `find_cells` maxlen, full flag on Safe/PrettyString ([#952](https://github.com/AnswerDotAI/fastcore/issues/952))


## 2.2.33

### New Features

- Add status-specific HTTP5xx exceptions and raise HTTP error subclasses from urlopen so all URL functions get them ([#946](https://github.com/AnswerDotAI/fastcore/issues/946))


## 2.2.32

### Bugs Squashed

- Fix docments to handle property `__doc__` and falsy-but-valid symbols in docstring/docments traversal ([#945](https://github.com/AnswerDotAI/fastcore/issues/945))


## 2.2.31

### New Features

- truncstr: accept maxlen=None to disable truncation; mark xml module docstring as raw ([#944](https://github.com/AnswerDotAI/fastcore/issues/944))


## 2.2.30

### New Features

- Split argv parsing out of `_run_cli` into new exported `parse_cli` function returning positional args, kwargs, and the --pdb flag ([#943](https://github.com/AnswerDotAI/fastcore/issues/943))


## 2.2.29

### New Features

- Shorten line hashes from 4 hex chars to 2 Base64url chars (low 12 bits of CRC32) ([#942](https://github.com/AnswerDotAI/fastcore/issues/942))


## 2.2.28

### New Features

- Add `path_glob` and `path_re` filters to globtastic for matching against full file paths ([#941](https://github.com/AnswerDotAI/fastcore/issues/941))


## 2.2.27

### New Features

- simplify `prev_line` truncation format ([#940](https://github.com/AnswerDotAI/fastcore/issues/940))


## 2.2.26

### New Features

- Add XML.render for namespace-aware serialization, dict-based attrs, and overridable `E.attr_value` for vocabulary-specific values ([#939](https://github.com/AnswerDotAI/fastcore/issues/939))


## 2.2.25

### New Features

- Add `XML.__call__` to append children to an existing expression and return it ([#938](https://github.com/AnswerDotAI/fastcore/issues/938))


## 2.2.24

### New Features

- Add namespace-aware XML construction to fastcore.xml with E factories and XML expressions that preserve case and namespace bindings ([#937](https://github.com/AnswerDotAI/fastcore/issues/937))
- Add inp parameter to run() for passing stdin to subprocess ([#936](https://github.com/AnswerDotAI/fastcore/issues/936))
- Return only int values from CLI calls for exit codes ([#935](https://github.com/AnswerDotAI/fastcore/issues/935))


## 2.2.23

### New Features

- Docments from Annotated metadata and NumPy docstrings, callable truncstr suffixes, shared preview rows ([#934](https://github.com/AnswerDotAI/fastcore/pull/934)), thanks to [@jph00](https://github.com/jph00)


## 2.2.22

### Bugs Squashed

- fix `init_args` ([#931](https://github.com/AnswerDotAI/fastcore/issues/931))


## 2.2.21

### New Features

- `store_attr` no longer records `__stored_args__`; add `init_args` ([#929](https://github.com/AnswerDotAI/fastcore/pull/929)), thanks to [@jph00](https://github.com/jph00)


## 2.2.20

### New Features

- Add `CliError`, a command error that exits cleanly under a CLI run ([#928](https://github.com/AnswerDotAI/fastcore/pull/928)), thanks to [@jph00](https://github.com/jph00)

### Bugs Squashed

- Fix in_jupyter() detection for IPython shell subclasses ([#919](https://github.com/AnswerDotAI/fastcore/pull/919)), thanks to [@ncoop57](https://github.com/ncoop57)


## 2.2.19

### Bugs Squashed

- Fix docments property unwrapping to use isinstance check, avoiding false positives from permissive `__getattr__` implementations ([#927](https://github.com/AnswerDotAI/fastcore/issues/927))


## 2.2.18

### New Features

- Add `wait_until` to fastcore.aio: polls a sync or async probe until truthy, with configurable timeout and sleep interval ([#926](https://github.com/AnswerDotAI/fastcore/issues/926))
- Support variadic positional (`*args`) params in ``call_parse``, and skip `**kwargs` ([#925](https://github.com/AnswerDotAI/fastcore/pull/925)), thanks to [@jph00](https://github.com/jph00)


## 2.2.17

### New Features

- Add `jupyter_json_default` fallback so nbio JSON encoding handles datetimes, dates, bytes, iterables, and numeric types ([#924](https://github.com/AnswerDotAI/fastcore/issues/924))

### Bugs Squashed

- Update CLI flags for fastcore.script hyphenation ([#922](https://github.com/AnswerDotAI/fastcore/pull/922)), thanks to [@jph00](https://github.com/jph00)


## 2.2.16

### New Features

- Render underscores as hyphens in CLI option names ([#921](https://github.com/AnswerDotAI/fastcore/pull/921)), thanks to [@jph00](https://github.com/jph00)
- Add Debounce, debounced, and throttled to fastcore.aio ([#856](https://github.com/AnswerDotAI/fastcore/pull/856)), thanks to [@ncoop57](https://github.com/ncoop57)


## 2.2.15

### New Features

- Show annotation-based metavars in CLI help instead of upper-cased option names, and quote empty string defaults ([#920](https://github.com/AnswerDotAI/fastcore/issues/920))


## 2.2.14

### New Features

- Add Debounce to fastcore.aio for coalescing bursts of calls, and skip cells tagged skip-execution in `does_cell_eval` ([#918](https://github.com/AnswerDotAI/fastcore/issues/918))
- Make `str_enum` set `__module__` and `__qualname__` from caller frame so generated enums are picklable ([#917](https://github.com/AnswerDotAI/fastcore/issues/917))


## 2.2.13

### New Features

- Add package name and version as epilog to `anno_parser` help output ([#915](https://github.com/AnswerDotAI/fastcore/issues/915))


## 2.2.12

### New Features

- Rewrite `signature_ex` to preserve explicit Parameter.empty defaults via a sentinel ([#908](https://github.com/AnswerDotAI/fastcore/issues/908))


## 2.2.11

### New Features

- Add `free_port`: returns an OS-picked free TCP port on a given host ([#907](https://github.com/AnswerDotAI/fastcore/issues/907))
- Document `open_doc` section layer in editskill; use pilcrow for newlines in CellRow repr ([#906](https://github.com/AnswerDotAI/fastcore/issues/906))
- Add MAXLEN constant (180) for cell display truncation, replacing hardcoded 120 defaults ([#905](https://github.com/AnswerDotAI/fastcore/issues/905))
- Simplify `sig_with_params` by removing keep param ([#904](https://github.com/AnswerDotAI/fastcore/issues/904))


## 2.2.10

### New Features

- Add nbio.`diff_cells` for id-aligned block diffs of cell sequences; harden `bg_task` with strong refs and `on_err` callback ([#903](https://github.com/AnswerDotAI/fastcore/issues/903))


## 2.2.9

### New Features

- Add `id_words`, `to_camel`, `to_pascal`, `to_kebab`, `to_snake` to basics; refactor camel2words/camel2snake/snake2camel to share the splitter ([#902](https://github.com/AnswerDotAI/fastcore/issues/902))


## 2.2.8

### New Features

- Add `trunc_ctr` and TruncatedString to xtras for middle-truncating long strings with a humanized elision marker ([#901](https://github.com/AnswerDotAI/fastcore/issues/901))


## 2.2.7

### New Features

- Add notebook-level `eval` directives, `strvals` booleans, and `kindsort`; remove `skip_noeval` ([#900](https://github.com/AnswerDotAI/fastcore/pull/900)), thanks to [@jph00](https://github.com/jph00)


## 2.2.6

### New Features

- Add `parallel_async_gen` and `parallel_async_dict` for streaming async results ([#899](https://github.com/AnswerDotAI/fastcore/issues/899))
- `render_text` gains `include_imgs=`, rendering image outputs as mime-tagged elements ([#863](https://github.com/AnswerDotAI/fastcore/pull/863)), thanks to [@ncoop57](https://github.com/ncoop57)


## 2.2.5

### New Features

- Replace `exec_cell`/`show_cell` with `run_cell` wrapping IPython `run_cell_async` ([#898](https://github.com/AnswerDotAI/fastcore/issues/898))


## 2.2.4

### New Features

- nbio: extend `nb_frontmatter` with `cell_frontmatter`/`md_frontmatter` (H1 title synthesis, raw wins); frontmatter now raises on bad YAML ([#897](https://github.com/AnswerDotAI/fastcore/issues/897))


## 2.2.3

### New Features

- Support L in `to_xml` rendering; drop ujson fallback in loads/dumps and use stdlib json ([#896](https://github.com/AnswerDotAI/fastcore/issues/896))
- Add metadata directives as XML attrs in cell2xml ([#859](https://github.com/AnswerDotAI/fastcore/issues/859))


## 2.2.2

### New Features

- Add `nb_frontmatter` and frontmatter strvals/closing-fence support; strip ANSI in `render_text` with `tb_maxlen` traceback line capping ([#895](https://github.com/AnswerDotAI/fastcore/issues/895))


## 2.2.1

### New Features

- Make OpGroup.`__doc__` a property so subgroups added after init appear in the listing ([#894](https://github.com/AnswerDotAI/fastcore/issues/894))


## 2.2.0

### Breaking Changes

- Use `__qualname__` in `basic_repr` ([#893](https://github.com/AnswerDotAI/fastcore/issues/893))

### New Features

- Note that path param expands ~ in file/cell editing functions ([#892](https://github.com/AnswerDotAI/fastcore/pull/892)), thanks to [@ncoop57](https://github.com/ncoop57)
- Warn instead of raising when docments source is unreadable ([#893](https://github.com/AnswerDotAI/fastcore/issues/893))


## 2.1.20

### New Features

- nbio: add `find_id`, FoundCells context-aware `find_cells`, `update_cell` and `deep_merge`; expand ~ in nb paths; id prefix lookup ([#891](https://github.com/AnswerDotAI/fastcore/issues/891))
- Extend `render_md` with ansi='html' to render ANSI colors as an {=html} block ([#880](https://github.com/AnswerDotAI/fastcore/pull/880)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)
- Add WebP and GIF image support ([#877](https://github.com/AnswerDotAI/fastcore/pull/877)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)


## 2.1.19

### New Features

- move `pack_frames`/`unpack_frames` websocket binary framing helpers to jupywire ([#890](https://github.com/AnswerDotAI/fastcore/issues/890))


## 2.1.18

### New Features

- Move funccall from toolslm ([#889](https://github.com/AnswerDotAI/fastcore/issues/889))
- Add `IMG_MIMES` constant and support image/webp in `preferred_out` ([#888](https://github.com/AnswerDotAI/fastcore/issues/888))
- Add `exec_cell` and `show_cell` to nbio for running notebook cells in a live IPython shell ([#886](https://github.com/AnswerDotAI/fastcore/issues/886))
- `select_cells`: accept multiple cell ids; hide `maybe_await`/`_amagic` frames in tracebacks ([#885](https://github.com/AnswerDotAI/fastcore/issues/885))
- Add `select_cells` to nbio, move `render_md`/AI output renderers back to aidialog ([#884](https://github.com/AnswerDotAI/fastcore/issues/884))


## 2.1.17

### New Features

- Add str2dt/`revive_dates` and xdumps stdlib type support, plus nbio AI output renderers, websocket frame packing, and iopub msg-to-output conversion ([#883](https://github.com/AnswerDotAI/fastcore/issues/883))
- Add `dir_tag` to format nbdev cell directives as a compact bracket tag, and use it in `CellRow.__repr__` ([#882](https://github.com/AnswerDotAI/fastcore/issues/882))


## 2.1.16

### New Features

- Add fastcore.apisurface module for building documented callables from operation metadata, plus basics.req ([#881](https://github.com/AnswerDotAI/fastcore/issues/881))


## 2.1.15

### New Features

- Add `metadec` to simplify writing decorators usable with or without params ([#879](https://github.com/AnswerDotAI/fastcore/issues/879))


## 2.1.14

### New Features

- Add `athreaded` to `fastcore.aio` for running blocking functions in a worker thread from async code ([#878](https://github.com/AnswerDotAI/fastcore/issues/878))


## 2.1.13

### New Features

- Preserve subclass type in L.`__getitem__` by routing through `_new` instead of constructing a bare L ([#876](https://github.com/AnswerDotAI/fastcore/issues/876))
- Add module-level docstring summaries to all fastcore submodules ([#875](https://github.com/AnswerDotAI/fastcore/issues/875))


## 2.1.12

### New Features

- Add module docstrings, humanize(), `render_md`(), `expect_fail` regex param, and update llms.txt ([#874](https://github.com/AnswerDotAI/fastcore/issues/874))


## 2.1.11

### New Features

- Add `fenced_blocks` to extract top-level, fence-nesting-aware code blocks from markdown text ([#873](https://github.com/AnswerDotAI/fastcore/issues/873))


## 2.1.10

### New Features

- Add structural validation and repair for code cell outputs (`output_type`, data, metadata, traceback) ([#872](https://github.com/AnswerDotAI/fastcore/issues/872))


## 2.1.9

### New Features

- Add `fenced` to wrap text in a code fence longer than any run of the fence char ([#871](https://github.com/AnswerDotAI/fastcore/issues/871))


## 2.1.8

### New Features

- Add Path.`read_jsonl` for parsing newline-delimited JSON files with line-numbered error reporting ([#870](https://github.com/AnswerDotAI/fastcore/issues/870))


## 2.1.7

### New Features

- Add `pos` parameter to `call_parse` and `anno_parser` to make named function params positional CLI args ([#869](https://github.com/AnswerDotAI/fastcore/issues/869))


## 2.1.6

### New Features

- Add async IPython magic support, short flags from capital letters in script params ([#868](https://github.com/AnswerDotAI/fastcore/issues/868))
- Add `incl_out`/`trunc_out` params to `view_cell` to optionally append rendered cell outputs ([#865](https://github.com/AnswerDotAI/fastcore/issues/865))

### Bugs Squashed

- Fix CI: `start_server` host mismatch in port test; add remold to dev deps ([#867](https://github.com/AnswerDotAI/fastcore/pull/867)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)
- Fix asdict UnboundLocalError for iterables of non-pairs ([#866](https://github.com/AnswerDotAI/fastcore/pull/866)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)


## 2.1.5

### New Features

- Add `__pyskill_params__` replace-params group and `nums` option to `view_file` ([#864](https://github.com/AnswerDotAI/fastcore/issues/864))


## 2.1.4

### New Features

- Add Notebook/NbCell session methods, CellRow snapshots, `summary_nb`/`find_cells`, `cell_ast_replace`; rename find→`find_cells` and view→`view_cell` ([#862](https://github.com/AnswerDotAI/fastcore/issues/862))
- Add fastcore.editskill module documenting shared editing conventions and re-exporting tools + nbio; switch pyskills entry point to it ([#861](https://github.com/AnswerDotAI/fastcore/issues/861))
- Add metadata directives as XML attrs in cell2xml ([#860](https://github.com/AnswerDotAI/fastcore/issues/860))


## 2.1.3

### New Features

- rename file tools verb-first, add lnhash/exhash utilities and cell editing tools, require str metadata directive values ([#858](https://github.com/AnswerDotAI/fastcore/issues/858))


## 2.1.2

### New Features

- Add multi-language directive parsing/repair to NbCell and net-waiting utilities from fasthtml (waitfor); added `take_lines` ([#857](https://github.com/AnswerDotAI/fastcore/issues/857))


## 2.1.1

### New Features

- Add `xdumps` with `__json__` protocol and `item2xml` for shared notebook/message XML rendering ([#855](https://github.com/AnswerDotAI/fastcore/issues/855))
- Refactor tools.py into string-level editing primitives + file wrappers; add L.`__copy__`, `str_diff`, notebook validation, and pyskills entry point ([#854](https://github.com/AnswerDotAI/fastcore/issues/854))
    - Add L.`__copy__`, `str_diff`, notebook validation, and pyskills entry point


## 2.1.0

### New Features

- Add back Python 3.10 support by replacing TaskGroup with asyncio.gather, and defer coroutine creation until semaphore is acquired ([#853](https://github.com/AnswerDotAI/fastcore/issues/853))


## 2.0.6

### New Features

- Refactor nbio: replace `apply_controls` with `clean_cli_output`, make `preferred_msg_out` public ([#851](https://github.com/AnswerDotAI/fastcore/issues/851))


## 2.0.4

### New Features

- `mtime_policy` now invalidates on any mtime change ([#850](https://github.com/AnswerDotAI/fastcore/issues/850))


## 2.0.3

- Fix dep


## 2.0.2

### New Features

- Add `needs_args` support to flexicache policies; extend `mtime_policy` with `arg` param to watch call-argument files ([#849](https://github.com/AnswerDotAI/fastcore/issues/849))


## 2.0.1

### Breaking Changes

fastcore v2 removes or relocates a number of APIs that now have better alternatives. If you use `from fastcore.utils import *` (or `fastcore.all`), most of these changes won't affect you.

The breaking changes: `Param` is gone from `fastcore.script`; use plain type annotations with docments, or `typing.Annotated[type, "help"]`, optionally with a `dict` of argparse arguments for advanced features. `L`'s `starmap`, `starfilter`, and the other `star*`/`rstar*` methods are replaced by the `star` and `rstar` function adapters, which compose with every `L` method (e.g. `t.map(star(f))`); relatedly, `spread` is replaced by `star`, and `dspread` is renamed to `dstar`. Async helpers now live in the new `fastcore.aio` module: `run_sync`, `iter_sync`, and `ctx_sync` moved there from `net`, and `maybe_await`, `then`, `mapa`, `acache`, `reawaitable`, `is_async_callable`, and the other async utilities moved there from `xtras`. `Config` and the config file functions moved from `foundation` to `xtras`. `fastcore.net` lost its request builders (`urlrequest`, `urlsend`, `do_request`, `urlcheck`) and `clean_type_str` is gone. `parallel_gen` moved to fastai. Python 3.11 or later is now required.

If you need the old APIs, pin `fastcore<2`.

### New Features

- fastcore v2 ([#847](https://github.com/AnswerDotAI/fastcore/issues/847))
- Replace `Param` class with `typing.Annotated` for CLI param annotations in fastcore.script ([#845](https://github.com/AnswerDotAI/fastcore/issues/845))
- Add `msg` param to `expect_fail`, prefer it over `test_fail` in docs/tests ([#844](https://github.com/AnswerDotAI/fastcore/issues/844))


## 1.14.5

### New Features

- Redesign `Self` as immutable chain with `~` prefix, add `then` async pipe, fix `bind` kwargs placeholders ([#843](https://github.com/AnswerDotAI/fastcore/issues/843))
- Handle `*args` and `**kwargs` correctly in docments ([#842](https://github.com/AnswerDotAI/fastcore/issues/842))


## 1.14.4

### New Features

- Add `run_sync`, `iter_sync`, `ctx_sync` helpers to call async code from sync code ([#841](https://github.com/AnswerDotAI/fastcore/issues/841))


## 1.14.3

### New Features

- Fix `call_parse` to reliably detect direct script execution ([#835](https://github.com/AnswerDotAI/fastcore/pull/835)), thanks to [@ncoop57](https://github.com/ncoop57)
- Refactor `call_parse` CLI detection, add `is_cli`, support comma-separated `but` in delegates, and fix DocmentText for non-callables ([#839](https://github.com/AnswerDotAI/fastcore/issues/839))

### Bugs Squashed

- Improve docment formatting: handle multiline comments, empty signatures, and trim blank lines in output ([#840](https://github.com/AnswerDotAI/fastcore/issues/840))


## 1.14.2

### New Features

- extract tag conversion logic to unify `__getattr__` with fasthtml ([#838](https://github.com/AnswerDotAI/fastcore/pull/838)), thanks to [@jackhogan](https://github.com/jackhogan)


## 1.14.1

### Breaking Changes

- nbio notebook line splitting/rejoining for outputs and attachments now matches nbformat ([#837](https://github.com/AnswerDotAI/fastcore/issues/837))


## 1.13.10

### New Features

- Use cell id for NbCell equality; only create locks in parallel executors when pause is set ([#836](https://github.com/AnswerDotAI/fastcore/issues/836))


## 1.13.9

### New Features

- Improve `is_close` to handle strings and non-numeric types gracefully ([#834](https://github.com/AnswerDotAI/fastcore/issues/834))


## 1.13.8

### New Features

- Add docstring inheritance to `delegates` when decorated function lacks its own ([#833](https://github.com/AnswerDotAI/fastcore/issues/833))


## 1.13.7

### New Features

- uid and gid in `untar_dir` params ([#832](https://github.com/AnswerDotAI/fastcore/pull/832)), thanks to [@curtis-allan](https://github.com/curtis-allan)


## 1.13.6

### Bugs Squashed

- Fix `_get_extended_color` to raise ValueError on empty input ([#830](https://github.com/AnswerDotAI/fastcore/issues/830))


## 1.13.5

### New Features

- Use `tmp` for `atomic_save` temp file suffix ([#828](https://github.com/AnswerDotAI/fastcore/pull/828)), thanks to [@curtis-allan](https://github.com/curtis-allan)


## 1.13.4

### New Features

- Add `acache` ([#827](https://github.com/AnswerDotAI/fastcore/issues/827))

### Bugs Squashed

- Fix `patch_to` to handle Enum and non-type iterables correctly ([#826](https://github.com/AnswerDotAI/fastcore/pull/826)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.13.3

### Bugs Squashed

- `dict2obj` converts None values to `{}` ([#824](https://github.com/AnswerDotAI/fastcore/pull/824)), thanks to [@KeremTurgutlu](https://github.com/KeremTurgutlu)


## 1.13.2

### New Features

- Set `co_qualname` in `patch` ([#821](https://github.com/AnswerDotAI/fastcore/issues/821))
- Convert camelCase tag names to kebab-case in `xml.__getattr__` ([#820](https://github.com/AnswerDotAI/fastcore/issues/820))


## 1.13.0

### Breaking Changes

- Change `parallel_async` default return exceptions

### New Features

- Add `return_exceptions` parameter to parallel et al ([#819](https://github.com/AnswerDotAI/fastcore/issues/819))
- Add `load_mod` ([#818](https://github.com/AnswerDotAI/fastcore/issues/818))
- Add `import_no_init` ([#814](https://github.com/AnswerDotAI/fastcore/issues/814))

### Bugs Squashed

- fix import-no-init ([#816](https://github.com/AnswerDotAI/fastcore/pull/816)), thanks to [@comhar](https://github.com/comhar)


## 1.12.46

### New Features

- Lazy import `progress_bar` ([#812](https://github.com/AnswerDotAI/fastcore/pull/812)), thanks to [@KeremTurgutlu](https://github.com/KeremTurgutlu)


## 1.12.45

### New Features

- Add daemon parameter to startthread and startproc ([#813](https://github.com/AnswerDotAI/fastcore/issues/813))


## 1.12.44

### New Features

- Add daemon option to @threaded decorator ([#811](https://github.com/AnswerDotAI/fastcore/issues/811))


## 1.12.43

### New Features

- Add `render_text` and `mk_result`/`mk_display`/`mk_error` helpers; use `render_text` in cell2xml ([#810](https://github.com/AnswerDotAI/fastcore/issues/810))
- Add `extend_enum` and `static_method` support to patch/`patch_to` ([#809](https://github.com/AnswerDotAI/fastcore/issues/809))


## 1.12.42

### New Features

- Support async functions in `call_parse` ([#808](https://github.com/AnswerDotAI/fastcore/issues/808))


## 1.12.41

### New Features

- Add maxdepth to walk/globtastic, `walk_join` helper, set support in `is_listy` ([#807](https://github.com/AnswerDotAI/fastcore/issues/807))


## 1.12.40

### New Features

- Save original method in `patch_to` for all attr types, not just plain methods ([#806](https://github.com/AnswerDotAI/fastcore/issues/806))
- Add output rendering functions (`preferred_out`, `apply_controls`, `render_output`/s, `concat_streams`) to nbio ([#805](https://github.com/AnswerDotAI/fastcore/issues/805))


## 1.12.39

### New Features

- Minor perf improvements for `to_xml` ([#804](https://github.com/AnswerDotAI/fastcore/issues/804))


## 1.12.38

### New Features

- Add `to_aiter` as public async generator and simplify `maybe_aiter` to use it ([#803](https://github.com/AnswerDotAI/fastcore/issues/803))
- Add async mapping utilities: `mapa` and `maybe_aiter` ([#802](https://github.com/AnswerDotAI/fastcore/pull/802)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.12.36

### New Features

- Add `Notebook` API ([#801](https://github.com/AnswerDotAI/fastcore/issues/801))


## 1.12.35

### New Features

- Add fastcore.nbio ([#800](https://github.com/AnswerDotAI/fastcore/issues/800))


## 1.12.34

### New Features

- Add `can_render` helper ([#797](https://github.com/AnswerDotAI/fastcore/issues/797))


## 1.12.33

### Bugs Squashed

- Handle TypeError in docments, and fix callable name resolution ([#796](https://github.com/AnswerDotAI/fastcore/issues/796))


## 1.12.32

### New Features

- Improve `isinstance_str` to accept multiple type names, fix MarkdownRenderer doc formatting, and warn on shell-escaped args in `run_cmd`/rg/sed ([#795](https://github.com/AnswerDotAI/fastcore/issues/795))


## 1.12.31

### New Features

- Support callable instances in docstring/`get_name`/DocmentText for proper schema and doc display ([#791](https://github.com/AnswerDotAI/fastcore/issues/791))


## 1.12.30

### New Features

- frontmatter: return (dict, body) tuple instead of dict only ([#790](https://github.com/AnswerDotAI/fastcore/issues/790))


## 1.12.29

### Bugs Squashed

- remove `once` patch param ([#789](https://github.com/AnswerDotAI/fastcore/issues/789))


## 1.12.28

### New Features

- Add `frontmatter` function to parse YAML front matter from strings ([#788](https://github.com/AnswerDotAI/fastcore/issues/788))


## 1.12.27

### New Features

- Add `expect_fail` context manager, `clean_cli_output()`, and `patch`/`patch_to` `once` param ([#787](https://github.com/AnswerDotAI/fastcore/issues/787))


## 1.12.26

### New Features

- Add Path.`mkdir_perms` for dir creation with uid/gid support; use in `atomic_save` ([#786](https://github.com/AnswerDotAI/fastcore/issues/786))


## 1.12.25

### New Features

- Add `atomic_save` context manager for safe atomic file writes ([#785](https://github.com/AnswerDotAI/fastcore/issues/785))


## 1.12.24

### New Features

- Add pause parameter to `parallel_async` for staggered task starts ([#784](https://github.com/AnswerDotAI/fastcore/issues/784))


## 1.12.23

### New Features

- `parallel_async`: add `cancel_on_error` via TaskGroup, use `return_exceptions` in gather ([#783](https://github.com/AnswerDotAI/fastcore/issues/783))


## 1.12.22

### New Features

- Add dict2xml helper and support multiple elements in `to_xml` ([#781](https://github.com/AnswerDotAI/fastcore/issues/781))


## 1.12.21

### New Features

- Add `bg_task` ([#780](https://github.com/AnswerDotAI/fastcore/issues/780))


## 1.12.19

### New Features

- Strip Authorization header on cross-origin redirects ([#779](https://github.com/AnswerDotAI/fastcore/pull/779)), thanks to [@erikgaas](https://github.com/erikgaas)


## 1.12.18

### New Features

- Separate MarkdownRenderer `__repr__` from `_repr_markdown_` for clean plain-text output ([#778](https://github.com/AnswerDotAI/fastcore/issues/778))


## 1.12.17

### New Features

- Preserve async def prefix and respect explicit `__signature__` in ShowDocRenderer ([#777](https://github.com/AnswerDotAI/fastcore/issues/777))


## 1.12.16

### New Features

- Add `maybe_await` and `noopa` async helpers to xtras ([#776](https://github.com/AnswerDotAI/fastcore/issues/776))


## 1.12.15

### New Features

- Extract adict base class from AttrDict for lightweight attr-access dicts ([#775](https://github.com/AnswerDotAI/fastcore/issues/775))


## 1.12.14

### New Features

- Add `DepProp` descriptor for property-change-triggered dependency invalidation ([#774](https://github.com/AnswerDotAI/fastcore/issues/774))


## 1.12.13

### New Features

- Add `joins` helper for joining non-string iterables with a separator ([#773](https://github.com/AnswerDotAI/fastcore/issues/773))


## 1.12.12

### New Features

- Add `delegated` decorator ([#772](https://github.com/AnswerDotAI/fastcore/issues/772))
- Add `is_async_callable` from Starlette for detecting async callables ([#771](https://github.com/AnswerDotAI/fastcore/issues/771))
- Make `run_cmd` use POSIX parsing with escaped backslashes for proper arg handling ([#768](https://github.com/AnswerDotAI/fastcore/issues/768))


## 1.12.11

### New Features

- Add `splice_sig` ([#767](https://github.com/AnswerDotAI/fastcore/issues/767))
- Support backslash by using posix=False ([#765](https://github.com/AnswerDotAI/fastcore/issues/765))
- Expand home dir in tools cmds ([#763](https://github.com/AnswerDotAI/fastcore/issues/763))

### Bugs Squashed

- fix `argument should be a str or an os.PathLike object` ([#764](https://github.com/AnswerDotAI/fastcore/issues/764))


## 1.12.9

### New Features

- Add `find_file_parents` ([#762](https://github.com/AnswerDotAI/fastcore/issues/762))

### Bugs Squashed

- tests fail sometimes on mac ([#761](https://github.com/AnswerDotAI/fastcore/issues/761))


## 1.12.8

### Bugs Squashed

- update to `from importlib.metadata import entry_points` ([#760](https://github.com/AnswerDotAI/fastcore/issues/760))


## 1.12.7

### New Features

- Handle nested `call_parse` ([#759](https://github.com/AnswerDotAI/fastcore/issues/759))


## 1.12.6

### New Features

- Return None from `detect_mime` for non-bytes input ([#758](https://github.com/AnswerDotAI/fastcore/pull/758)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)
- Add template support to llmtool decorator ([#757](https://github.com/AnswerDotAI/fastcore/pull/757)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.12.5

### New Features

- docments md shows function names instead of repr ([#756](https://github.com/AnswerDotAI/fastcore/issues/756))


## 1.12.4

### New Features

- Add @llmtool decorator and `valid_paths` restriction for LLM tool functions ([#754](https://github.com/AnswerDotAI/fastcore/issues/754))


## 1.12.3

### Bugs Squashed

- Backslash in format str not allowed in py<312 ([#753](https://github.com/AnswerDotAI/fastcore/issues/753))


## 1.12.2

### New Features

- Add __text_signature__ support for builtin functions in DocmentText ([#750](https://github.com/AnswerDotAI/fastcore/issues/750))


## 1.12.1

### New Features

- Add partial function support to `get_name` and DocmentText ([#749](https://github.com/AnswerDotAI/fastcore/issues/749))


## 1.12.0

### Breaking Changes

- listify: wrap Mapping types instead of iterating their keys ([#748](https://github.com/AnswerDotAI/fastcore/issues/748))

### New Features

- Add `skip_folders` param to view() to filter out `_proc` and `__pycache__` dirs ([#747](https://github.com/AnswerDotAI/fastcore/issues/747))


## 1.11.5

### New Features

- Add kwargs support to flatmap ([#746](https://github.com/AnswerDotAI/fastcore/issues/746))

### Bugs Squashed

- Fix anno typing when `eval_str=True` ([#744](https://github.com/AnswerDotAI/fastcore/pull/744)), thanks to [@curtis-allan](https://github.com/curtis-allan)


## 1.11.4

### New Features

- Enhanced dir view with file sizes and type indicators ([#743](https://github.com/AnswerDotAI/fastcore/issues/743))


## 1.11.3

### New Features

- Add Union type support and improve bool arg handling with negated flags in `call_parse` ([#739](https://github.com/AnswerDotAI/fastcore/issues/739))


## 1.11.2

### New Features

- Add `move_lines` and `get_callable` to tools ([#737](https://github.com/AnswerDotAI/fastcore/issues/737))


## 1.11.1

### Breaking Changes

- Parameters are now documented using a list instead of a table. This shouldn't break any code, but will change rendered documentation.

### New Features

- Add `DocmentsList` and `DocmentsText` ([#736](https://github.com/AnswerDotAI/fastcore/issues/736))


## 1.10.5

### New Features

- Add `sig_source` ([#735](https://github.com/AnswerDotAI/fastcore/issues/735))


## 1.10.4

### New Features

- Add `rtoken_hex` ([#734](https://github.com/AnswerDotAI/fastcore/issues/734))


## 1.10.3

### New Features

- Use `__html__` in `hl_md` if exists ([#732](https://github.com/AnswerDotAI/fastcore/issues/732))


## 1.10.2

### New Features

- add slice support for L assignment ([#731](https://github.com/AnswerDotAI/fastcore/pull/731)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.10.1

### New Features

- Add `spread` and `dspread` ([#730](https://github.com/AnswerDotAI/fastcore/issues/730))
- Add `Path.normpath` ([#729](https://github.com/AnswerDotAI/fastcore/issues/729))


## 1.10.0

### Breaking Changes

- Add `_repr_html_` to `FT` that renders the component ([#728](https://github.com/AnswerDotAI/fastcore/issues/728))


## 1.9.8

### New Features

- Add `pglob` and `fdelegates` ([#727](https://github.com/AnswerDotAI/fastcore/issues/727))


## 1.9.7

### New Features

- Add `sizevar` to `truncstr` ([#726](https://github.com/AnswerDotAI/fastcore/issues/726))


## 1.9.6

### New Features

- Add `exts` to `globtastic` ([#725](https://github.com/AnswerDotAI/fastcore/issues/725))
- Add `flatmap` ([#724](https://github.com/AnswerDotAI/fastcore/issues/724))
- Add negate function ([#722](https://github.com/AnswerDotAI/fastcore/pull/722)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.9.5

### New Features

- Add kwargs to `dict2obj` ([#723](https://github.com/AnswerDotAI/fastcore/issues/723))
- Add negate function ([#722](https://github.com/AnswerDotAI/fastcore/pull/722)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.9.4

### New Features

- Added loads of curried methods to `L` ([#720](https://github.com/AnswerDotAI/fastcore/issues/720))
- Include stderr in `run` exception details ([#719](https://github.com/AnswerDotAI/fastcore/issues/719))


## 1.9.3

### New Features

- Add `unqid` ([#718](https://github.com/AnswerDotAI/fastcore/issues/718))


## 1.9.2

### Breaking Changes

- Patching a function no long clobbers a function with the same name in the current module

### New Features

- Have `@patch` not overwrite existing functions ([#717](https://github.com/AnswerDotAI/fastcore/issues/717))
- Add pre-3.11 support for `batched` ([#716](https://github.com/AnswerDotAI/fastcore/issues/716))
- Handle `nm` in `patch_to` and `patch` ([#715](https://github.com/AnswerDotAI/fastcore/issues/715))


## 1.8.18

### New Features

- Add more itertools etc to `L` ([#714](https://github.com/AnswerDotAI/fastcore/issues/714))

### Bugs Squashed

- missing import in `detect_mime` ([#712](https://github.com/AnswerDotAI/fastcore/issues/712))


## 1.8.17

### New Features

- Add `detect_mime`, thanks to @KeremTurgutlu ([#711](https://github.com/AnswerDotAI/fastcore/issues/711))
- Support setting zero and empty string as element attrs ([#709](https://github.com/AnswerDotAI/fastcore/pull/709)), thanks to [@erikgaas](https://github.com/erikgaas)
- Add `img_bytes` ([#707](https://github.com/AnswerDotAI/fastcore/issues/707))


## 1.8.16

### New Features

- Add `__getitem__` to `NotStr` ([#705](https://github.com/AnswerDotAI/fastcore/issues/705))


## 1.8.15

### Bugs Squashed

- Incorrect json block in AttrDict ([#704](https://github.com/AnswerDotAI/fastcore/issues/704))


## 1.8.14

### New Features

- Add docments renderers (moved from nbdev) ([#703](https://github.com/AnswerDotAI/fastcore/issues/703))
- add `write_json` ([#702](https://github.com/AnswerDotAI/fastcore/pull/702)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)


## 1.8.13

### New Features

- Add pad to `chunked` ([#701](https://github.com/AnswerDotAI/fastcore/issues/701))
- Implement `__eq__` and `__hash__` for fastcore.xml.FT for value-based comparison


## 1.8.12

### New Features

- Add `friendly_name` ([#698](https://github.com/AnswerDotAI/fastcore/issues/698))
- Add `product` ([#698](https://github.com/AnswerDotAI/fastcore/issues/698))
- Add `shell`, `ssh`, and `rsync_multi` ([#699](https://github.com/AnswerDotAI/fastcore/issues/699))


## 1.8.11

### New Features

- Add sort param to globtastic ([#697](https://github.com/AnswerDotAI/fastcore/issues/697))


## 1.8.10

### New Features

- Require py 3.10 now that 3.9 is EOL ([#696](https://github.com/AnswerDotAI/fastcore/issues/696))
- Add `fastcore.tools` ([#695](https://github.com/AnswerDotAI/fastcore/issues/695))


## 1.8.9

### New Features

- Strip terminal queries in fastcore.ansi ([#693](https://github.com/AnswerDotAI/fastcore/issues/693))


## 1.8.8

### New Features

- Add `vars_pub` ([#692](https://github.com/AnswerDotAI/fastcore/issues/692))
- Add `__skipped__` and `__flds__` to `asdict` ([#692](https://github.com/AnswerDotAI/fastcore/issues/692))


## 1.8.7

### New Features

- Add uid and gid to `mk_write` as optional parameters ([#691](https://github.com/AnswerDotAI/fastcore/pull/691)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)


## 1.8.6

### New Features

- Add `exc` param to `test_fail` ([#690](https://github.com/AnswerDotAI/fastcore/issues/690))


## 1.8.5

### New Features

- Auto skip non usable types in `to_xml` ([#689](https://github.com/AnswerDotAI/fastcore/issues/689))
- Handle jpeg with COM segment ([#688](https://github.com/AnswerDotAI/fastcore/pull/688)), thanks to [@KeremTurgutlu](https://github.com/KeremTurgutlu)
- Add `sig2str` ([#687](https://github.com/AnswerDotAI/fastcore/issues/687))


## 1.8.4

### New Features

- Add `trim_wraps` and `save_iter` ([#685](https://github.com/AnswerDotAI/fastcore/issues/685))
- Add `asave_iter` ([#686](https://github.com/AnswerDotAI/fastcore/issues/686))
- Add `CachedIter`, `CachedAwaitable`, and `reawaitable` ([#684](https://github.com/AnswerDotAI/fastcore/issues/684))


## 1.8.2

### New Features

- stringify FT with `to_xml` ([#681](https://github.com/AnswerDotAI/fastcore/issues/681))
- render FT attrs with `to_xml` ([#680](https://github.com/AnswerDotAI/fastcore/issues/680))
- Add sort args to delegates ([#667](https://github.com/AnswerDotAI/fastcore/pull/667)), thanks to [@pydanny](https://github.com/pydanny)

### Bugs Squashed

- Ensure flexicache is LRU cached ([#679](https://github.com/AnswerDotAI/fastcore/pull/679)), thanks to [@pydanny](https://github.com/pydanny)


## 1.8.1

### New Features

- Empty tag handling in fastcore.xml to support Fragment ([#677](https://github.com/AnswerDotAI/fastcore/issues/677))
- Add `headers` arg to `urljson` ([#675](https://github.com/AnswerDotAI/fastcore/pull/675)), thanks to [@CarloLepelaars](https://github.com/CarloLepelaars)
- Add a setter to patch ([#674](https://github.com/AnswerDotAI/fastcore/pull/674)), thanks to [@galopyz](https://github.com/galopyz)


## 1.8.0

### Breaking Changes

- Move dispatch and transform modules to fasttransform ([#669](https://github.com/AnswerDotAI/fastcore/pull/669)), thanks to [@RensDimmendaal](https://github.com/RensDimmendaal)

### Bugs Squashed

- `list[object]` not handled correctly in docments ([#671](https://github.com/AnswerDotAI/fastcore/issues/671))


## 1.7.29

### New Features

- Add `partition_dict` ([#665](https://github.com/AnswerDotAI/fastcore/issues/665))
- Add `VAR_POSITIONAL` and `VAR_KEYWORD` to docments ([#664](https://github.com/AnswerDotAI/fastcore/issues/664))


## 1.7.28

### New Features

- Support documenting args and kwargs ([#660](https://github.com/AnswerDotAI/fastcore/pull/660)), thanks to [@Isaac-Flath](https://github.com/Isaac-Flath)
- Update Config to support ConfigParser keyword arguments ([#659](https://github.com/AnswerDotAI/fastcore/pull/659)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.7.27

### New Features

- Add `L.groupby` ([#658](https://github.com/AnswerDotAI/fastcore/issues/658))


## 1.7.26


### Bugs Squashed

- `splitlines` mis-spelled ([#656](https://github.com/AnswerDotAI/fastcore/issues/656))


## 1.7.25

### New Features

- Handle tuples in `groupby` ([#654](https://github.com/AnswerDotAI/fastcore/issues/654))


## 1.7.23

### New Features

- Add `cmp` and kwargs to `sort_ex` ([#652](https://github.com/AnswerDotAI/fastcore/issues/652))


## 1.7.22

### New Features

- Add `last` ([#651](https://github.com/AnswerDotAI/fastcore/issues/651))


## 1.7.20

### New Features

- Add ansi.py (from nbconvert) ([#647](https://github.com/fastai/fastcore/issues/647))
- Support latest CaptureShell version ([#644](https://github.com/fastai/fastcore/issues/644))
- Add `exec_eval` ([#643](https://github.com/fastai/fastcore/issues/643))


## 1.7.19

### Bugs Squashed

- Hyperscript attrs do not work in `FT` ([#642](https://github.com/fastai/fastcore/issues/642))


## 1.7.17

### New Features

- Add `FT.on` ([#640](https://github.com/fastai/fastcore/issues/640))


## 1.7.16

### Bugs Squashed

- `list_func` not passed recursively in `dict2obj` ([#639](https://github.com/fastai/fastcore/issues/639))


## 1.7.15

### New Features

- Add FT.set ([#638](https://github.com/fastai/fastcore/issues/638))


## 1.7.14

### New Features

- Add `parallel_async` ([#637](https://github.com/fastai/fastcore/issues/637))


## 1.7.13

### New Features

- Add support for type casting in the typed decorator ([#635](https://github.com/fastai/fastcore/pull/635)), thanks to [@ncoop57](https://github.com/ncoop57)


## 1.7.12

### New Features

- Add `BasicRepr` ([#634](https://github.com/fastai/fastcore/issues/634))


## 1.7.11

### New Features

- Show instance vars in `basic_repr()` ([#633](https://github.com/fastai/fastcore/issues/633))
- add Path to `untar` dest ([#632](https://github.com/fastai/fastcore/pull/632)), thanks to [@hamelsmu](https://github.com/hamelsmu)
- Nested attr supporting keys ([#631](https://github.com/fastai/fastcore/pull/631)), thanks to [@Isaac-Flath](https://github.com/Isaac-Flath)


## 1.7.10

### Bugs Squashed

- `dict2obj` does not handle `list_func` correctly or pass it recursively ([#630](https://github.com/fastai/fastcore/issues/630))


## 1.7.9

### New Features

- Add `Config.find` ([#628](https://github.com/fastai/fastcore/issues/628))

### Bugs Squashed

- Falsey attrs result in doubled tags in `to_xml` ([#629](https://github.com/fastai/fastcore/issues/629))


## 1.7.8

### New Features

- Handle whitespace-sensitive situations in `to_xml` automatically ([#626](https://github.com/fastai/fastcore/issues/626))


## 1.7.7

### New Features

- auto-update context ([#624](https://github.com/fastai/fastcore/pull/624)), thanks to [@hamelsmu](https://github.com/hamelsmu)


## 1.7.6

### New Features

- Add llm context files ([#621](https://github.com/fastai/fastcore/pull/621)), thanks to [@hamelsmu](https://github.com/hamelsmu)

### Bugs Squashed

- str2bool does not return a bool ([#625](https://github.com/fastai/fastcore/issues/625))


## 1.7.5

### New Features

- Add `ft_cls` to `ft` ([#620](https://github.com/fastai/fastcore/issues/620))


## 1.7.4

### New Features

- Add module `__getattr__` to `fastcore.xml` ([#619](https://github.com/fastai/fastcore/issues/619))


## 1.7.3

### Bugs Squashed

- Curried `risinstance` fails when passed `None` ([#618](https://github.com/fastai/fastcore/issues/618))


## 1.7.2

### New Features

- Add `AttrDictDefault` and `extract_docstrings` ([#617](https://github.com/fastai/fastcore/issues/617))
- Add `do_escape` to `to_xml` ([#617](https://github.com/fastai/fastcore/issues/617))
- add markdown to doc output ([#614](https://github.com/fastai/fastcore/issues/614))
- move patched methods to parent class ([#612](https://github.com/fastai/fastcore/pull/612)), thanks to [@comhar](https://github.com/comhar)
- add debug=True parameter to urlsend ([#611](https://github.com/fastai/fastcore/pull/611)), thanks to [@radam9](https://github.com/radam9)

### Bugs Squashed

- fix annotations generated by py2pyi ([#613](https://github.com/fastai/fastcore/pull/613)), thanks to [@comhar](https://github.com/comhar)


## 1.7.1

### New Features

- Add `UNSET` singleton
- nullable dataclass overhaul ([#607](https://github.com/fastai/fastcore/issues/607))
    - Update `nullable_dc` to use `UNSET` instead of `None`
    - Rename `mk_dataclass` to `flexiclass`
    - `flexiclass` uses `UNSET` instead of `None`
- Add `asdict`, like the `dataclasses` version but works on more types
- Add `is_typeddict` and `is_namedtuple`
- Flatten nested tuples in `ft`


## 1.7.0

### Breaking Changes

- The FT structure has been changed so it no longer inherits from `list` ([#606](https://github.com/fastai/fastcore/issues/606))
  - `.list` property added so you can still destructure it
  - `__getitem__` now returns the approach child element
  - `__add__` adds children


## 1.6.9

### New Features

- Handle embedded quotes in `to_xml` ([#604](https://github.com/fastai/fastcore/issues/604))
- Skip dict and listy valued attrs if empty in `ft` ([#603](https://github.com/fastai/fastcore/issues/603))


## 1.6.8

### New Features

- stringify list values in `ft` attr vals ([#602](https://github.com/fastai/fastcore/issues/602))
- Allow `__ft__` methods to return tuples ([#596](https://github.com/fastai/fastcore/pull/596)), thanks to [@Rahulbeniwal26119](https://github.com/Rahulbeniwal26119)


## 1.6.7

### New Features

- Do not update `-` to `_` if special chars present in `ft` ([#601](https://github.com/fastai/fastcore/issues/601))


## 1.6.6

### New Features

- Add `FT.get(k,default)` ([#600](https://github.com/fastai/fastcore/issues/600))
- Add `Safe` str and return it from `to_xml` ([#599](https://github.com/fastai/fastcore/issues/599))
- Feat: add an `indent` flag for `to_xml()` ([#594](https://github.com/fastai/fastcore/pull/594)), thanks to [@phact](https://github.com/phact)


## 1.6.5

### New Features

- Add `valmap` to `ft` ([#598](https://github.com/fastai/fastcore/issues/598))
- Allow embedding raw HTML inside FT templates using UTF-8 encoded bytes ([#597](https://github.com/fastai/fastcore/pull/597)), thanks to [@adamritter](https://github.com/adamritter)
- Inline flag for `to_xml()` ([#594](https://github.com/fastai/fastcore/pull/594)), thanks to [@phact](https://github.com/phact)


## 1.6.4

### New Features

- `attrmap` and hyperscript support in fastcore.xml.FT ([#595](https://github.com/fastai/fastcore/issues/595))


## 1.6.3

### New Features

- add `ver2tuple` ([#593](https://github.com/fastai/fastcore/issues/593))


## 1.6.2

### New Features

- Allow attrs to be added to `FT` using `__call__` ([#591](https://github.com/fastai/fastcore/issues/591))
- Experimental support for `FT.__call__`, h/t @cgarciae ([#590](https://github.com/fastai/fastcore/issues/590))
- `FT` interoperability with Django and Jinja using `__html__()` protocol ([#589](https://github.com/fastai/fastcore/pull/589)), thanks to [@collinanderson](https://github.com/collinanderson)


## 1.6.1

### Breaking Changes

- Rename `XT` to `FT` ([#586](https://github.com/fastai/fastcore/issues/586))


## 1.5.55

### New Features

- Add `ValEnum`

### Bugs Squashed

- `<!doctype html>` should be a void tag type ([#585](https://github.com/fastai/fastcore/issues/585))


## 1.5.54

### New Features

- `flexicache` async support
- Handle exceptions in `flexicache` function ([#582](https://github.com/fastai/fastcore/issues/582))


## 1.5.53

### New Features

- add `flexicache`, along with policies `time_policy` and `mtime_policy` ([#581](https://github.com/fastai/fastcore/issues/581))


## 1.5.52

### New Features

- Add `timed_cache` ([#580](https://github.com/fastai/fastcore/issues/580))


## 1.5.51

### New Features

- Add nullable dataclass functions ([#577](https://github.com/fastai/fastcore/issues/577))


## 1.5.48

### New Features

- New `expand_wildcards` function ([#576](https://github.com/fastai/fastcore/issues/576))
- New `replace_wildcards` CLI ([#576](https://github.com/fastai/fastcore/issues/576))


## 1.5.47

### New Features

- Add `void_` attr to `XT` and use for skipping closing tags in `to_xml` ([#575](https://github.com/fastai/fastcore/issues/575))


## 1.5.46

### New Features

- Unwrap `NotStr` passed to `NotStr.__init__` ([#574](https://github.com/fastai/fastcore/issues/574))
- Provide attr get/set in `XT` ([#572](https://github.com/fastai/fastcore/issues/572))
- Handle non-str types in `to_xml` ([#571](https://github.com/fastai/fastcore/issues/571))


## 1.5.45

### New Features

- Improve formatting of single child nodes in `to_xml` ([#570](https://github.com/fastai/fastcore/issues/570))


## 1.5.44

### Bugs Squashed

- bool args incorrectly parsed in `fastcore.xml` ([#569](https://github.com/fastai/fastcore/issues/569))


## 1.5.43

### New Features

- Add `parse_env` to provide similar functionality to `dotenv` pypi lib ([#568](https://github.com/fastai/fastcore/issues/568))
- Add `partition` ([#567](https://github.com/fastai/fastcore/issues/567))
- Add return value to `result` attr in `threaded` functions ([#563](https://github.com/fastai/fastcore/issues/563))


## 1.5.42

### New Features

- Add HTTP functions: `tobytes`, `http_response`, and `recv_once` ([#562](https://github.com/fastai/fastcore/issues/562))
- Convenience props for `XT` ([#561](https://github.com/fastai/fastcore/issues/561))
- annotations for `get_class` / `mk_class` ([#560](https://github.com/fastai/fastcore/issues/560))


## 1.5.41

### New Features

- Add `type2str` and `dataclass_src` to `xtras` ([#559](https://github.com/fastai/fastcore/issues/559))


## 1.5.40

### New Features

- Save orig method in `patch` and `patch_to` ([#558](https://github.com/fastai/fastcore/issues/558))


## 1.5.39

### New Features

- add `hl_md()` ([#557](https://github.com/fastai/fastcore/issues/557))
- bool value handling for `xt` ([#556](https://github.com/fastai/fastcore/issues/556))
- Add py2pyi ([#555](https://github.com/fastai/fastcore/issues/555))
- Add attr support to `nested_idx` ([#554](https://github.com/fastai/fastcore/issues/554))


## 1.5.38

### New Features

- add `fastcore.xml.highlight()` ([#553](https://github.com/fastai/fastcore/issues/553))


## 1.5.37

### New Features

- Do not add closing tags for void tag types ([#551](https://github.com/fastai/fastcore/issues/551))
- Add tuple support to `to_xml`
- Add `start_proc()`


## 1.5.35

### New Features

- Add `process` param to `threaded` ([#550](https://github.com/fastai/fastcore/issues/550))
- Check for `__ft__` in `to_xml`


## 1.5.34

### New Features

- Add `xml` module for XML and HTML generation ([#549](https://github.com/fastai/fastcore/issues/549))
- Add `NotStr`, which behaves like a `str`, but is not an instance of one ([#548](https://github.com/fastai/fastcore/issues/548))
- Add `NS`, a `SimpleNamespace` subclass that also adds `iter` and `dict` support ([#547](https://github.com/fastai/fastcore/issues/547))


## 1.5.33

### New Features

- Add deprecated python stdlib `imghdr` to fastcore, and add additional jpeg header ([#546](https://github.com/fastai/fastcore/issues/546))
- Add additional numpydoc sections ([#545](https://github.com/fastai/fastcore/pull/545)), thanks to [@dsm-72](https://github.com/dsm-72)


## 1.5.32

### Bugs Squashed

- Revert "Python 3.12 Deprecation of `pkg_resources`" ([#544](https://github.com/fastai/fastcore/pull/544))


## 1.5.30

### New Features

- allow docments to parse async function definitions
- expose timeout in `urlsend`

### Bugs Squashed

- patch classmethod not supporting subclasses correctly


## 1.5.29

### New Features

- extend test_eq_type ([#507](https://github.com/fastai/fastcore/pull/507)), thanks to [@ddobrinskiy](https://github.com/ddobrinskiy)
- PyTorch 2.0 compile compatibility, thanks to [@ggosline](https://github.com/ggosline)


## 1.5.28

### Bugs Squashed

- fix: `console_help` excludes entrypoints from the root module ([#495](https://github.com/fastai/fastcore/pull/495)), thanks to [@seeM](https://github.com/seeM)
- Improvements to test messages ([#508](https://github.com/fastai/fastcore/pull/508)), thanks to [@ddobrinskiy](https://github.com/ddobrinskiy)


## 1.5.27


### Bugs Squashed

- fix: error in IPython while handling `HTTP4xxClientError` ([#486](https://github.com/fastai/fastcore/pull/486)), thanks to [@seeM](https://github.com/seeM)
- fix: `Config.get` returns `False` instead of `None` for missing `bool` keys ([#482](https://github.com/fastai/fastcore/pull/482)), thanks to [@seeM](https://github.com/seeM)
- params overriding `delegates` ignored in `call_parse` ([#473](https://github.com/fastai/fastcore/issues/473))


## 1.5.26

### Bugs Squashed

- Delegatee docments not appearing ([#485](https://github.com/fastai/fastcore/issues/485))
- UnicodeDecodeError occurs when reading `settings.ini` file containing CJK characters on Windows ([#483](https://github.com/fastai/fastcore/issues/483))


## 1.5.25

### New Features

- Add more information upon HTTP request failures ([#479](https://github.com/fastai/fastcore/issues/479))

### Bugs Squashed

- fix: `Config.get` returns `False` instead of `None` for missing `bool` keys ([#482](https://github.com/fastai/fastcore/pull/482)), thanks to [@seeM](https://github.com/seeM)
- `but` in delegates ignored in `docments` ([#478](https://github.com/fastai/fastcore/issues/478))


## 1.5.23

### New Features

- Optional types for `Config` ([#472](https://github.com/fastai/fastcore/issues/472))
- Add `ret_false()`

### Bugs Squashed

- `docments` using nested delegates comments incorrectly ([#475](https://github.com/fastai/fastcore/issues/475))
- `true()` defined twice; replace 2nd with `ret_true()` ([#471](https://github.com/fastai/fastcore/issues/471))
- 'method-wrapper' object has no attribute '__annotations__' ([#470](https://github.com/fastai/fastcore/issues/470))


## 1.5.22

### New Features

- Recursively search for docments ([#468](https://github.com/fastai/fastcore/issues/468))
- `delegates()` now works with annotations too ([#467](https://github.com/fastai/fastcore/issues/467))


## 1.5.18

### New Features

- exclude `passed to {func}` from docments by passing `verbose=False` to `delegates` ([#464](https://github.com/fastai/fastcore/pull/464)), thanks to [@seeM](https://github.com/seeM)
- enable meta.delegates to enforce `KEYWORD_ONLY` for kwargs from ([#459](https://github.com/fastai/fastcore/pull/459)), thanks to [@EmbraceLife](https://github.com/EmbraceLife)

### Bugs Squashed

- fix `fastcore.style` format resets and auto-complete ([#462](https://github.com/fastai/fastcore/pull/462)), thanks to [@seeM](https://github.com/seeM)


## 1.5.17

### New Features

- Add `fastcore.style`: fast styling for friendly CLIs ([#460](https://github.com/fastai/fastcore/pull/460)), thanks to [@seeM](https://github.com/seeM)
- add `skip_folder` to `xtras.walk` ([#458](https://github.com/fastai/fastcore/issues/458))

### Bugs Squashed

- Fix scripts not executing ([#449](https://github.com/fastai/fastcore/pull/449)), thanks to [@renato145](https://github.com/renato145)


## 1.5.15

### New Features

- layered `Config` with `extra_files`; `Config` `repr` ([#456](https://github.com/fastai/fastcore/pull/456)), thanks to [@seeM](https://github.com/seeM)
- in-memory `Config` by passing `save=False` ([#455](https://github.com/fastai/fastcore/pull/455)), thanks to [@seeM](https://github.com/seeM)
- use `==` for non iterable args to `all_equal` ([#453](https://github.com/fastai/fastcore/issues/453))
- New method: `AttrDict.copy`, to return AttrDict instead of plain python dict ([#451](https://github.com/fastai/fastcore/pull/451)), thanks to [@Salehbigdeli](https://github.com/Salehbigdeli)
- add xdg module ([#450](https://github.com/fastai/fastcore/issues/450))
- add `console_help` ([#448](https://github.com/fastai/fastcore/issues/448))
- add module info to `basic_repr` ([#447](https://github.com/fastai/fastcore/issues/447))
- add `only` and `nested_setdefault` collection functions ([#446](https://github.com/fastai/fastcore/pull/446)), thanks to [@seeM](https://github.com/seeM)
- include annotations and qualname in `copy_func` ([#425](https://github.com/fastai/fastcore/pull/425)), thanks to [@seeM](https://github.com/seeM)

### Bugs Squashed

- Fix scripts not executing ([#449](https://github.com/fastai/fastcore/pull/449)), thanks to [@renato145](https://github.com/renato145)
- urllib opener can conflict with fork parallel on macos ([#444](https://github.com/fastai/fastcore/issues/444))


## 1.5.11

### New Features

- move `str2bool` to `fastcore.basics` ([#441](https://github.com/fastai/fastcore/issues/441))


## 1.5.9

### New Features

- start mode option for `parallel` ([#440](https://github.com/fastai/fastcore/issues/440))


## 1.5.8

### New Features

- port to nbdev2 ([#438](https://github.com/fastai/fastcore/issues/438))
- add `signature_ex`


## 1.5.7

### New Features

- always set `__wrapped__` in `call_parse` ([#435](https://github.com/fastai/fastcore/issues/435))


## 1.5.6

### Bugs Squashed

- Fix missing import


## 1.5.5

### New Features

- use ujson if available ([#432](https://github.com/fastai/fastcore/issues/432))
- new `func` param for `globtastic` ([#429](https://github.com/fastai/fastcore/issues/429))
- add nested parser support to `fastcore.script` ([#428](https://github.com/fastai/fastcore/pull/428)), thanks to [@seeM](https://github.com/seeM)


## 1.5.0

### Breaking Changes

- Importing `fastcore.utils` now longer imports `fastcore.net`

### New Features

- Move imports into functions to make import faster ([#426](https://github.com/fastai/fastcore/issues/426))
- use py310 style union annotations ([#421](https://github.com/fastai/fastcore/pull/421)), thanks to [@seeM](https://github.com/seeM)

### Bugs Squashed

- repr patching broken by pep 563 ([#270](https://github.com/fastai/fastcore/issues/270))


## 1.4.5

### New Features

- Custom raise message helper ([#419](https://github.com/fastai/fastcore/pull/419)), thanks to [@muellerzr](https://github.com/muellerzr)
- make `docments` handle delegates ([#418](https://github.com/fastai/fastcore/pull/418)), thanks to [@hamelsmu](https://github.com/hamelsmu)
- Add a `nested_callable` and `getcallable` util ([#417](https://github.com/fastai/fastcore/pull/417)), thanks to [@muellerzr](https://github.com/muellerzr)
- Add dataclass to docments ([#413](https://github.com/fastai/fastcore/pull/413)), thanks to [@MarkB2](https://github.com/MarkB2)
- Use docments ([#387](https://github.com/fastai/fastcore/pull/387)), thanks to [@muellerzr](https://github.com/muellerzr)

### Bugs Squashed

- `test_sig` returns NameError: name `test_eq` is not defined ([#372](https://github.com/fastai/fastcore/pull/372)), thanks to [@ababino](https://github.com/ababino)


## 1.4.4

### New Features

- backport shutil pathlib compat ([#416](https://github.com/fastai/fastcore/issues/416))
- handle plain files in `untar_dir` ([#412](https://github.com/fastai/fastcore/issues/412))


## 1.4.3

### New Features

- Add initial value for product and sum on L ([#406](https://github.com/fastai/fastcore/pull/406)), thanks to [@radekosmulski](https://github.com/radekosmulski)
- add ppretty print repr to AttrDict ([#403](https://github.com/fastai/fastcore/pull/403)), thanks to [@hamelsmu](https://github.com/hamelsmu)
- Raise better error when a config isn't found ([#394](https://github.com/fastai/fastcore/pull/394)), thanks to [@muellerzr](https://github.com/muellerzr)

### Bugs Squashed

- Bugfix handle edge case when we have string in list and want to flatten ([#410](https://github.com/fastai/fastcore/pull/410)), thanks to [@Salehbigdeli](https://github.com/Salehbigdeli)


## 1.4.2

### New Features

- numpy-style docstring support for `docments` ([#405](https://github.com/fastai/fastcore/issues/405))


## 1.4.1

### New Features

- py310 annotation support ([#402](https://github.com/fastai/fastcore/issues/402))
- add `set_nested_idx` ([#401](https://github.com/fastai/fastcore/issues/401))


## 1.4.0

### New Features

- Support union types with `|` in `typedispatch` and `@patch` ([#397](https://github.com/fastai/fastcore/issues/397))
- Support py3.10 annotations ([#396](https://github.com/fastai/fastcore/issues/396))

### Bugs Squashed

- fix missing import for `get_source_link` ([#392](https://github.com/fastai/fastcore/pull/392)), thanks to [@hamelsmu](https://github.com/hamelsmu)


## 1.3.29


### Bugs Squashed

- fix missing import for `get_source_link` ([#392](https://github.com/fastai/fastcore/pull/392)), thanks to [@hamelsmu](https://github.com/hamelsmu)
- fix missing import ([#391](https://github.com/fastai/fastcore/pull/391)), thanks to [@hamelsmu](https://github.com/hamelsmu)


## 1.3.28

### New Features

- add `get_source_link` from nbdev ([#390](https://github.com/fastai/fastcore/pull/390)), thanks to [@hamelsmu](https://github.com/hamelsmu)

## 1.3.27

### New Features

- add loop functions, thanks to @willmcgugan ([#363](https://github.com/fastai/fastcore/issues/363))
- add `walk` function ([#355](https://github.com/fastai/fastcore/issues/355))
- add `globtastic` and `compile_re` ([#354](https://github.com/fastai/fastcore/issues/354))
- add `exec_new` ([#350](https://github.com/fastai/fastcore/issues/350))
- add `PythonKernel` ([#348](https://github.com/fastai/fastcore/issues/348))
- add `flatten`

### Bugs Squashed

- avoid expansion of `%` format strings in `fastcore.script` ([#349](https://github.com/fastai/fastcore/issues/349))


## 1.3.26

### New Features

- add class init support to docments ([#347](https://github.com/fastai/fastcore/issues/347))
- add timeout param to url functions ([#346](https://github.com/fastai/fastcore/issues/346))
- add `L.argfirst` ([#345](https://github.com/fastai/fastcore/issues/345))
- add `Path.relpath` ([#344](https://github.com/fastai/fastcore/issues/344))
- add `full` and `returns` to `docments`, and derive type from default in `fastcore.script` ([#342](https://github.com/fastai/fastcore/issues/342))
- allow use of `docments` in `fastcore.script.call_parse` ([#341](https://github.com/fastai/fastcore/issues/341))
- add `docments` ([#340](https://github.com/fastai/fastcore/issues/340))


## 1.3.25

### Bugs Squashed

- `untar_dir` always extracts archive even if already exists ([#337](https://github.com/fastai/fastcore/issues/337))


## 1.3.23

### New Features

- Support py36 in `untar_dir`

## 1.3.22

### New Features

- New method: `Path.delete()` to remove a file or directory ([#336](https://github.com/fastai/fastcore/issues/336))
- Add `urlretrieve`, which as same as `urllib.request.urlretrieve` but also works with `Request` objects ([#335](https://github.com/fastai/fastcore/issues/335))


## 1.3.21

### New Features

- remove fastai-specific pieces from `Config` ([#334](https://github.com/fastai/fastcore/issues/334))
- in `untar_dir` create a directory if there is more than one item in root of archive ([#333](https://github.com/fastai/fastcore/issues/333))
- allow directory `dest` in `urlsave` ([#327](https://github.com/fastai/fastcore/issues/327))


## 1.3.20

### New Features

- make patch more compatible with classmethods ([#309](https://github.com/fastai/fastcore/pull/309)), thanks to [@tezike](https://github.com/tezike)
- Added order and list support for Pipeline.add ([#297](https://github.com/fastai/fastcore/pull/297)), thanks to [@marii-moe](https://github.com/marii-moe)
- support windows: only add lock if it runs parallelly ([#283](https://github.com/fastai/fastcore/pull/283)), thanks to [@mszhanyi](https://github.com/mszhanyi)

### Bugs Squashed

- fix #304 UnicodeDecodeError while downloading git archive ([#308](https://github.com/fastai/fastcore/pull/308)), thanks to [@pradeepbbl](https://github.com/pradeepbbl)
- Fix saving str as bytes in urlsave ([#278](https://github.com/fastai/fastcore/pull/278)), thanks to [@jochym](https://github.com/jochym)


## 1.3.19


### Bugs Squashed

- `sparkline` errors when a value is given that exceeds `mx` ([#277](https://github.com/fastai/fastcore/issues/277))


## 1.3.17

### New Features

- add `strcat` and `mapt` ([#273](https://github.com/fastai/fastcore/issues/273))


## 1.3.14

### New Features

- add `loads_multi` ([#271](https://github.com/fastai/fastcore/issues/271))

### Bugs Squashed

- ignored empty str `names` in `store_attr` ([#267](https://github.com/fastai/fastcore/issues/267))
- `returns_none` not returning non-none type ([#266](https://github.com/fastai/fastcore/issues/266))
- `Transform` return type ignored ([#265](https://github.com/fastai/fastcore/issues/265))
- `test_eq` incorrect for pandas `DataFrame` ([#188](https://github.com/fastai/fastcore/pull/188)), thanks to [@kessido](https://github.com/kessido)


## 1.3.13

### New Features
- add  `EventTimer` ([#263](https://github.com/fastai/fastcore/issues/263))
- Store kwargs in `store_attr  ([#262](https://github.com/fastai/fastcore/issues/262))
- add `truncstr` ([#261](https://github.com/fastai/fastcore/issues/261))
- add `sparkline` ([#260](https://github.com/fastai/fastcore/issues/260))
- add `autostart` for generators ([#249](https://github.com/fastai/fastcore/issues/249))
- dynamic fastcore.script help width ([#247](https://github.com/fastai/fastcore/issues/247))
- optional override to `risinstance` to support both types and str in the same function ([#191](https://github.com/fastai/fastcore/pull/191)), thanks to [@kessido](https://github.com/kessido)

### Bugs Squashed

- delegates doesn't pull the `__init__` of a class ([#217](https://github.com/fastai/fastcore/issues/217))
- `test_eq` incorrect for pandas `DataFrame` ([#188](https://github.com/fastai/fastcore/pull/188)), thanks to [@kessido](https://github.com/kessido)


## 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

- add `repr_dict` and use for display for `AttrDict` ([#172](https://github.com/fastai/fastcore/issues/172))
- add `urlsave`, `urlclean`, and `repo_details` ([#171](https://github.com/fastai/fastcore/issues/171))
- `remove_suffix` function ([#170](https://github.com/fastai/fastcore/issues/170))
- add `urlcheck` and `urlwrap` ([#168](https://github.com/fastai/fastcore/issues/168))
- new `AutoInit` mixin ([#165](https://github.com/fastai/fastcore/issues/165))

### Bugs Squashed

- `risinstance` fails if param is not truthy ([#166](https://github.com/fastai/fastcore/issues/166))


## 1.3.1

### New Features

- callable support for `Self` ([#162](https://github.com/fastai/fastcore/issues/162))
- add filter func to `first` ([#161](https://github.com/fastai/fastcore/issues/161))
- `maybe_open` context manager and fast `image_size` funcion ([#160](https://github.com/fastai/fastcore/issues/160))

### Bugs Squashed

- Redundent `L.map_filter` removed (since `L.map.filter` does the same thing)


## 1.3.0

### Breaking Changes

- `change param name `copy_meta`->`as_copy` in `retain_meta` ([#157](https://github.com/fastai/fastcore/issues/157))

### New Features

- `groupby` extensions for `int` and `str` instead of callables, and an optional `val` transform ([#155](https://github.com/fastai/fastcore/issues/155))
- add `modified_env` ([#148](https://github.com/fastai/fastcore/issues/148))

### Bugs Squashed

- `coll_repr` printing incorrectly when `max_n`!=10 ([#154](https://github.com/fastai/fastcore/pull/154)), thanks to [@kessido](https://github.com/kessido)


## 1.2.5

### New Features

- add `true`, `NullType`, `null`, and `tonull` ([#153](https://github.com/fastai/fastcore/issues/153))
- add `working_directory` ([#151](https://github.com/fastai/fastcore/issues/151))
- move `bind` et al to `fastcore.basics` ([#150](https://github.com/fastai/fastcore/issues/150))


## 1.2.4

### New Features

- move basic functionality into `fastcore.basics`, using minimal imports ([#149](https://github.com/fastai/fastcore/issues/149))
- add `anno_dict` and `empty2none` in `meta` ([#145](https://github.com/fastai/fastcore/issues/145))


## 1.2.3

### New Features

- add `try_attrs` ([#142](https://github.com/fastai/fastcore/issues/142))
- add `filter_dict`, `filter_keys`, and `filter_values` ([#140](https://github.com/fastai/fastcore/issues/140))
- add `str2bool` ([#138](https://github.com/fastai/fastcore/issues/138))

### Bugs Squashed

- `type` fails with `@typedispatch` ([#144](https://github.com/fastai/fastcore/issues/144))
- `with_cast` fails to cast default values ([#139](https://github.com/fastai/fastcore/issues/139))


## 1.2.2

### New Features

- support `store_true` and `store_false` in `fastcore.script` ([#137](https://github.com/fastai/fastcore/issues/137))
- add function `otherwise` ([#136](https://github.com/fastai/fastcore/issues/136))
- add `pdb` debug flag to scripts ([#133](https://github.com/fastai/fastcore/issues/133))
- Update `copy_func` to include required keyword defaults ([#134](https://github.com/fastai/fastcore/pull/134)), thanks to [@worc3131](https://github.com/worc3131)


## 1.2.0

### Breaking Changes

- `Config` no longer magically converts `str->Path` for any keys. Use new `path` method instead ([#131](https://github.com/fastai/fastcore/issues/131))

### New Features

- `rinstance`: Curried `isinstance` but with args reversed, suitable for `partial` ([#130](https://github.com/fastai/fastcore/issues/130))
- Use `_repr_pretty_` for `L` ([#129](https://github.com/fastai/fastcore/issues/129))
- `open_file` to open optionally-compressed files for reading and writing, and add compression support to `load_pickle` and `save_pickle` ([#128](https://github.com/fastai/fastcore/issues/128))
- add context manager for failed tests ([#126](https://github.com/fastai/fastcore/pull/126)), thanks to [@hamelsmu](https://github.com/hamelsmu)
- Add `Request.request` support to `urlread` ([#132](https://github.com/fastai/fastcore/issues/132))


## 1.1.2

### New Features

- runtime type checking with `typed` decorator ([#125](https://github.com/fastai/fastcore/issues/125))


## 1.1.1

### New Features

- `threaded` decorator ([#124](https://github.com/fastai/fastcore/issues/124))
- POST support for `urlread` ([#124](https://github.com/fastai/fastcore/issues/124))
- add `sorted_ex, `map_ex`, `filter_ex`, and `argwhere` ([#122](https://github.com/fastai/fastcore/issues/122))


## 1.1.0

### Breaking Changes

- Remove `Path.{read,write}` (use `Path.{read_text,write_text}` instead) and change `Path.{load,save}` to functions `load_pickle` and `save_pickle` ([#121](https://github.com/fastai/fastcore/issues/121))

## 1.0.22

### New Features

- add `L.setattrs`, inspired by Saul Pwanson ([#117](https://github.com/fastai/fastcore/issues/117))
- move `Config` from `nbdev` ([#116](https://github.com/fastai/fastcore/issues/116))
- add `nested_attr` and use it in `L.attrgot` ([#115](https://github.com/fastai/fastcore/issues/115))


## 1.0.21

### Deprecations (will be removed in future release)

- `patch_property`: use `patch(as_prop=True)` instead

### New Features

- New param `cast` for `store_attr` and new decorator `with_cast` ([#114](https://github.com/fastai/fastcore/issues/114))
- add `L.insert` and `exec_local` ([#113](https://github.com/fastai/fastcore/issues/113))
- Patch decorator with optional argument ([#110](https://github.com/fastai/fastcore/pull/110)), thanks to [@Salehbigdeli](https://github.com/Salehbigdeli)
- Make typedispatch decorator more general ([#106](https://github.com/fastai/fastcore/pull/106)), thanks to [@Salehbigdeli](https://github.com/Salehbigdeli)

### Bugs Squashed

- Fix default in oper ([#112](https://github.com/fastai/fastcore/pull/112)), thanks to [@Salehbigdeli](https://github.com/Salehbigdeli)
- Inconsistency with `cmp_instance` and `typedispatch` because of binary sort algorithm ([#100](https://github.com/fastai/fastcore/issues/100))


## 1.0.20

### New Features

- add `ignore_ex=False` and `as_bytes=False` params to `run` ([#108](https://github.com/fastai/fastcore/issues/108))
- `AttrDict`: a `dict` subclass that also provides access to keys as attrs; and change `dict2obj` to create `AttrDict`s instead of `SimpleNamespace`s ([#107](https://github.com/fastai/fastcore/issues/107))


## 1.0.19

### New Features

- `run`: flexibly run an external process and raise exception if it fails ([#105](https://github.com/fastai/fastcore/issues/105))


## 1.0.16

### New Features

- add `threadpool=False` param to `parallel` to use threads instead of processes ([#102](https://github.com/fastai/fastcore/issues/102))


## 1.0.15

### New Features

- add `L.map_filter` and `L.map_first` ([#97](https://github.com/fastai/fastcore/issues/97))
  - These support some nice refactorings, like changing from this:
    ```python
    d = []
    for c in cs:
      m = f(c)
      if not m:
        continue
      d.append(m.group(1))
    ```
    to this:
    ```python
    d = cs.map_filter(f).map(Self.group(1))
    ```


## 1.0.14

### Bugs Squashed

- Reapply fix for #86 which was unintentionally reverted by the next commit ([#91](https://github.com/fastai/fastcore/issues/91))

## 1.0.13

### New Features

- `dict2obj`: Convert (possibly nested) dicts (or lists of dicts) to `SimpleNamespace` ([#90](https://github.com/fastai/fastcore/issues/90))

## 1.0.12

### New Features

- add function support to `store_attr` ([#85](https://github.com/fastai/fastcore/issues/85))

### Bugs Squashed

- `mp_context` keyword for initialising concurrent.futures.ProcessPoolExecutor only supported in python 3.7+ ([#86](https://github.com/fastai/fastcore/issues/86))

## 1.0.10

### Breaking Changes

- remove `parallel_chunked`, use `chunksize` arg to `parallel` instead ([#81](https://github.com/fastai/fastcore/issues/81))

### New Features

- move fastscript to fastcore.script ([#84](https://github.com/fastai/fastcore/issues/84))
- add `run_proc` and `do_request` ([#83](https://github.com/fastai/fastcore/issues/83))
- added `chunksize` to `parallel`, which passes to `ProcessPoolExecutor.map` ([#82](https://github.com/fastai/fastcore/issues/82))
- move metaclasses and delegates et al to new `meta` module ([#80](https://github.com/fastai/fastcore/issues/80))

## 1.0.4

### New Features

- Remove numpy prerequisite ([#75](https://github.com/fastai/fastcore/issues/75))
  - NB: fastcore's `L` and other collection features still work with numpy
    arrays, but they do so internally using instance methods, so numpy is no longer a
    prerequisite, and numpy is not loaded if not used

## 1.0.2

### Bugs Squashed

- "has default params. These will be ignored" shown when not appropriate ([#74](https://github.com/fastai/fastcore/issues/74))


## 1.0.1

### Breaking Changes

- Change arguments of `store_attr()` and remove `store_attrs` attribute ([#71](https://github.com/fastai/fastcore/pull/71))
  - `store_attr`'s API has changed. `self` is now the second parameter, and is optional. Previously, if no names were passed to store,
    names were taken from the `store_attrs` attribute; now, however, names are taken from the list of arguments to the current function.

### New Features

- Warn if defaults passed to `typedispatch` ([#73](https://github.com/fastai/fastcore/pull/73))

- Add `urlread` and `urljson` ([#72](https://github.com/fastai/fastcore/pull/72))

## Version 1.0.0

- Initial release