changes for 1.0.0 release

Author: craigbarratt

docs/conf.py

@@ -23,7 +23,7 @@
 author = 'Craig Barratt'
 
 # The full version, including alpha/beta/rc tags
-release = '0.32'
+release = '1.0.0'
 
 master_doc = 'index'
 

docs/new_features.rst

@@ -8,66 +8,19 @@ You can also install the master (head of tree) version from GitHub, either using
 Because pyscript has quite a few unit tests, generally master should work ok. But it's not guaranteed
 to work at any random time.
 
-The latest release is 0.32, released on October 21, 2020.  Here is the `stable documentation <https://hacs-pyscript.readthedocs.io/en/stable>`__
+The latest release is 1.0.0, released on November 9, 2020.  Here is the `stable documentation <https://hacs-pyscript.readthedocs.io/en/stable>`__
 for that release.
 
 Since that release, the master (head of tree) version in GitHub has several new features and bug fixes.
 Here is the master `latest documentation <https://hacs-pyscript.readthedocs.io/en/latest>`__.
 
-The new features since 0.32 in master include:
+Planned new features post 1.0.0 include:
 
-- Pyscript state variables (entity_ids) can be persisted across pyscript reloads and HASS restarts,
-  from @swazrgb and @dlashua (#48).
-- Entities ``domain.entity`` now support a virtual method ``service`` (eg, ``domain.entity.service()``)
-  that calls the service ``domain.service`` for any service that has an ``entity_id`` parameter, with
-  that ``entity_id`` set to ``domain.entity``. Proposed by @dlashua (#64).
-- ``@state_trigger`` now supports triggering on an attribute change with ``"domain.entity.attr"`` and
-  any attribute change with ``"domain.entity.*"``, from @dlashua (#82)
-- State variables now support virtual attributes ``last_changed`` and ``last_updated`` for the UTC time when state
-  values or any attribute was last changed.
-- State variable attributes can be set by direct assignment, eg: ``DOMAIN.name.attr = value``.
-  An equivalent new function ``state.setattr()`` allows a specific attribute to be set.
-- State variable values (eg, from ``domain.entity`` or ``state.get()``) now include attributes that can be accessed
-  after they are assigned to another, normal, variable.
-- ``@state_trigger`` and ``task.wait_until`` now have an optional ``state_hold`` duration in seconds that requires
-  the state trigger to remain true for that period of time. The trigger occurs after that time elapses. If the state
-  trigger changes to false before the time expires, the process of waiting for a new trigger starts over.
-- ``@time_active`` now has an optional ``hold_off`` duration in seconds, which ignores a new trigger if the last
-  one happened within that time.  Can be used for rate limiting or debouncing. Also, ``@time_active`` can now take
-  zero time range arguments, in case you want to just specify ``hold_off``.
-- The ``hass`` object is available in all pyscript global contexts if the ``hass_is_global`` configuration parameter
-  is true (default false). This allows access to HASS internals that might not be otherwise exposed by pyscript.
-  Use with caution (#51).
-- Improvements to UI config flow, including allowing parameters to be updated, and the UI reload now works the same
-  as the ``pyscript.reload`` service call, from @raman325 (#53)
-- Added inbound ``context`` variable to trigger functions and support optional ``context`` setting on state,
-  event firing and service calls. Proposal and PR from @dlashua (#50, #60).
-- Logbook now supported using ``context`` and informational message based on trigger type. Proposal and PR
-  from @dlashua (#50, #62).
-- Required Python packages can be specified in ``requirements.txt`` files at the top-level pyscript
-  directory, and each module's or app's directory. Those files are read and any missing packages are
-  installed on HASS startup and pyscript reload. If a specific version of a package is needed, it must be
-  pinned using the format 'package_name==version'. Contributed by @raman325 (#66, #68, #69, #70, #78).
-- The reload service now takes an optional parameter ``global_ctx`` that specifies just that
-  global context is reloaded, eg: ``global_ctx="file.my_scripts"``.  Proposed by @dlashua (#63).
-- The ``state.get_attr()`` function has been renamed ``state.getattr()``. The old function is
-  still available and will be removed in some future release (it logs a warning when used).
-- VSCode connections to pyscript's Jupyter kernel now work.  Two changes were required: VSCode immediately
-  closes the heartbeat port, which no longer causes pyscript to shut down the kernel.  Also, ``stdout``
-  messages are flushed prior to sending the execute complete message. This is to ensure `log` and `print`
-  messages get displayed in VSCode. One benign but unresolved bug with VSCode is that when you connect
-  to the pyscript kernel, VSCode starts a second pyscript Jupyter kernel, before shutting that second one
-  down.
-- Service calls now accept ``blocking`` and ``limit`` parameters. The default behavior for a service call is
-  to run it in the background, but using ``blocking=True`` will force a task to wait up to ``limit`` seconds
-  for the service call to finish executing before continuing. Contributed by @raman325 (#85).
+- ``del`` can delete state variables and state variable attributes
+- use ``aionofity`` to auto-reload newly written script files, at least on linux (#74)
+- consider allowing native Python functions inside pyscript (#71)
+- consider implementing function decorators (#43)
 
-The bug fixes since 0.32 in master include:
+The new features since 1.0.0 in master include:
 
-- The ``@state_trigger`` expression is only evaluated when at least one of specific state variable
-  or attribute values mentioned in the expression have changed; fixed by @dlashua (#82).
-- Jupyter autocomplete now works on multiline code blocks.
-- Improved error message reporting for syntax errors inside f-strings.
-- Fixed incorrect global context update on calling module that, in turn, does a callback (#58).
-- ``task.wait_until`` no longer silently ignores unrecognized keyword arguments (#80).
-- ``task.wait_until`` incorrectly ignored the keyword optional state_check_now argument (#81).
+- None so far

docs/reference.rst

@@ -694,9 +694,9 @@ which you can’t do if you are directly assigning to the variable:
   ``AttributeError`` exception is thrown if that attribute doesn't exist.
 ``state.getattr(name)``
   Returns a ``dict`` of attribute values for the state variable ``name`` string, or ``None`` if it
-  doesn’t exist.  Alternatively, ``name`` can be a state variable.  In pyscript versions 0.32 and
-  earlier, this function was ``state.get_attr()``. That deprecated name is still supported, but
-  logs a warning message and will be removed in a future version.
+  doesn’t exist.  Alternatively, ``name`` can be a state variable.  In pyscript prior to 1.0.0,
+  this function was ``state.get_attr()``. That deprecated name is still supported, but it logs a
+  warning message and will be removed in a future version.
 ``state.names(domain=None)``
   Returns a list of all state variable names (ie, ``entity_id``\ s) of a
   domain. If ``domain`` is not specified, it returns all HASS state variable (``entity_id``) names.