Dave Pearson
a283689d1d
Merge pull request #1913 from davep/pre-commit-install-makefile-target
...
Add a Makefile target for installing pre-commit hooks
2023-03-01 13:40:33 +00:00
Dave Pearson
106c5aa2c8
Add a class docstring to Tree
2023-03-01 13:35:24 +00:00
Dave Pearson
6d038299fd
Remove default information from TreeNode.add_leaf's docstring
2023-03-01 13:32:34 +00:00
Dave Pearson
acb1cc61fc
Improve the docstring for TreeNode.set_label
2023-03-01 13:31:39 +00:00
Dave Pearson
2e060c07d7
Reword the documentation for TreeNode.allow_expand
...
Make it more property-like.
2023-03-01 13:30:44 +00:00
Dave Pearson
65ba559943
Reword the documentation for TreeNode.is_last
...
Make it more property-like.
2023-03-01 13:30:06 +00:00
Dave Pearson
e8d0f7a50f
Reword the documentation for TreeNode.is_expanded
...
Make it more property-like.
2023-03-01 13:29:18 +00:00
Dave Pearson
3f90812743
Reword the documentation for TreeNode.id
...
Make it more property-like.
2023-03-01 13:28:47 +00:00
Dave Pearson
6e836de1ef
Reword the documentation for TreeNode.line
...
Make it more property-like.
2023-03-01 13:28:03 +00:00
Dave Pearson
3658610792
Add a docstring for TreeNode.data
2023-03-01 13:27:16 +00:00
Dave Pearson
3192ee7402
Add a docstring for TreeNode.__init__
2023-03-01 13:26:27 +00:00
Dave Pearson
dbb52637c5
Document NodeID
...
It's in the public interface for tree, so it should be documented.
2023-03-01 13:23:28 +00:00
Dave Pearson
ac35c1d1d5
Document TreeNode via Tree itself
...
There's a couple of other types in the public interface of Tree that should
be teased out, and it feels odd to have one type in one file and a bunch of
others in another. So this sets us up for having them all the same place.
This should make it easier for the reader to find related information.
2023-03-01 13:21:45 +00:00
Dave Pearson
a837cd1d85
Ensure PlaceholderVariant gets included in the docs
2023-03-01 13:08:40 +00:00
Dave Pearson
e21e55200d
Add a module docstring to _tree.py
2023-03-01 12:59:19 +00:00
Dave Pearson
662c1d8f7d
Add a missing
2023-03-01 12:56:28 +00:00
Dave Pearson
865a8e5e4e
Add a docstring to Pretty.update
2023-03-01 12:55:00 +00:00
Dave Pearson
7ca3357cbd
Add a docstring for Pretty.render
2023-03-01 12:54:11 +00:00
Dave Pearson
52adf3f58e
Add a docstring to Pretty.__init__
2023-03-01 12:53:12 +00:00
Dave Pearson
75625ef6f3
Add a class docstring for the Pretty widget.
2023-03-01 12:51:26 +00:00
Dave Pearson
9c45c7df89
Add a module docstring for _pretty.py
2023-03-01 12:49:51 +00:00
Dave Pearson
27ebdc4ec3
Add a Makefile target for installing pre-commit hooks
...
Any time I cause my venv to be rebuilt, I need to remember to do this, and I
always have to search my shell history to remind myself what the command is.
That feels like it deserves to go into the Makefile.
2023-03-01 12:44:51 +00:00
Dave Pearson
4971e0e638
Remove defaults from the Placeholder.__init__ docstring args
2023-03-01 12:41:57 +00:00
Dave Pearson
8f9cf74381
Add a docstring to Placeholder.render
2023-03-01 12:39:33 +00:00
Dave Pearson
46bf55877d
Add a docstring to Placeholder.variant
2023-03-01 12:38:47 +00:00
Dave Pearson
d50fcc7479
Add a docstring to PlaceholderVariant
2023-03-01 12:37:56 +00:00
Dave Pearson
bba5017354
Type TextLog.max_lines in a way that works in all Pythons
...
Well, all *supported* Pythons.
2023-03-01 12:36:32 +00:00
Dave Pearson
5a6145980b
Remove unused import
2023-03-01 11:53:07 +00:00
Dave Pearson
a4f22d085b
Add a module docstring to _placeholder.py
2023-03-01 11:52:09 +00:00
Dave Pearson
d4ef173525
Remove unnecessary pass
2023-03-01 11:49:15 +00:00
Dave Pearson
a326169b92
Add a docstring to ListItem.highlighted
2023-03-01 11:48:53 +00:00
Dave Pearson
3478615592
Add a class docstring to ListItem
2023-03-01 11:48:13 +00:00
Dave Pearson
43cc67d254
Add a module docstring to _list_item.py
2023-03-01 11:44:36 +00:00
Dave Pearson
11e16b406a
Remove unused import in _text_log.py
2023-03-01 11:23:34 +00:00
Dave Pearson
b4da48a893
Merge pull request #1902 from davep/lazy-scrolling
...
Fixes and improvements relating to scrolling
2023-03-01 11:13:11 +00:00
Dave Pearson
db708bf265
Add typing and a docstring to _lazily_scroll_end
2023-03-01 11:05:15 +00:00
Dave Pearson
42718869f1
Tidy up the TextLog.write docstring
2023-03-01 10:47:32 +00:00
Dave Pearson
8b22875e37
Fix TextLog.__init__ copy/paste-os
2023-03-01 10:45:58 +00:00
Dave Pearson
c0cc080b7c
Be explicit about the type of TextLog.max_lines
2023-03-01 10:44:59 +00:00
Dave Pearson
c619984845
Add a docstring to TextLog
2023-03-01 10:44:20 +00:00
Dave Pearson
74526c1902
Add a module docstring to _text_log
2023-03-01 10:42:14 +00:00
Dave Pearson
87f216980d
Add the Welcome widget to the documentation
...
While it's arguably not the most useful widget, it's in the code, exported,
and can be seen by people; I feel it should be in the documentation. I've
ensured that it also links to Placeholder given it sort of is a Placeholder
and so people might arrive at it first and it makes sense to redirect them
to something more comprehensive.
2023-03-01 10:39:30 +00:00
Dave Pearson
ed2d547fcf
Add docstrings to the Welcome widget
2023-03-01 10:39:08 +00:00
Dave Pearson
287ef15c24
Add a module docstring for Header
2023-03-01 10:27:12 +00:00
Dave Pearson
61aa558d78
Document Header.tall
2023-03-01 10:26:07 +00:00
Dave Pearson
4258698855
Document all of the Header __init__ arguments
2023-03-01 10:25:26 +00:00
Dave Pearson
766cae2f47
Make Header.show_clock private
...
Header.show_clock was just a good old plain object attribute, not a
reactive, and also wasn't done as a read-only property. This means someone
could get the impression that it could be modified on the fly and the header
would react.
There might be an argument for turning it into that; but for the moment this
commit makes it private so that nobody gets the wrong impression.
2023-03-01 10:20:47 +00:00
Dave Pearson
b071121af7
Migrate the HeaderTitle.render return type hint to RenderResult
2023-03-01 10:17:06 +00:00
Dave Pearson
4a505e8a6c
Add a docstring to HeaderTitle.render
2023-03-01 10:16:31 +00:00
Dave Pearson
d0dedc0fde
Add a docsrtring for HeaderTitle.sub_text
2023-03-01 10:13:18 +00:00
