Skip to content

Commit

Permalink
reformat, fix links, and fix missing text in some imports
Browse files Browse the repository at this point in the history
  • Loading branch information
davidism committed Aug 14, 2024
1 parent f39a27d commit eb7b5d5
Show file tree
Hide file tree
Showing 35 changed files with 703 additions and 295 deletions.
26 changes: 11 additions & 15 deletions content/blog/blinker-1-6-released.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,23 +5,19 @@ published = 2023-04-02
tags = ["releases"]
~~~~

Signalling allows for applications to be decoupled by allowing
designated receivers to be informed when an action has taken place
(the signal). Flask and Quart both utilise the excellent
[Blinker](https://github.com/pallets-eco/blinker) library to support
signals and it is version 1.6 of this library that has been released.
Signalling allows for applications to be decoupled by allowing designated
receivers to be informed when an action has taken place (the signal). Flask and
Quart both utilise the excellent [Blinker](https://github.com/pallets-eco/blinker)
library to support signals, and it is version 1.6 of this library that has been
released.

This is the second major release of Blinker since maintenance
transferred to the
[Pallets-eco](https://palletsprojects.com/blog/pallets-community-org/)
organisation, and represents a desire to maintain it for the benefit
of Flask, Quart, and indeed Blinker users.
This is the second major release of Blinker since maintenance transferred to the
[Pallets-eco](pallets-community-org.md) organisation, and represents a desire to
maintain it for the benefit of Flask, Quart, and indeed Blinker users.

The
[Changelog](https://github.com/pallets-eco/blinker/blob/main/CHANGES.rst)
for 1.6 is headlined by a mondernisation of the project structure
which should ensure easier maintenance into the years to come. In
addition we've added:
The [Changelog](https://blinker.readthedocs.io/page/changes/) for 1.6 is
headlined by a mondernisation of the project structure which should ensure
easier maintenance into the years to come. In addition, we've added:

- an ability to temporarily mute signals,
- support for int senders,
Expand Down
45 changes: 34 additions & 11 deletions content/blog/click-7-0-released.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,30 +5,47 @@ published = 2018-09-25
tags = ["releases"]
~~~~

The Pallets team is pleased to release Click 7.0. Thank you to everyone who contributed online and in person at the PyCon US 2018 sprint! With the help of the community as well as some new maintainers, we've managed to resolve hundreds of long standing issues and pull requests.
The Pallets team is pleased to release Click 7.0. Thank you to everyone who contributed
online and in person at the PyCon US 2018 sprint! With the help of the community as well
as some new maintainers, we've managed to resolve hundreds of long standing issues and
pull requests.

Due to the length of time since the last release, there are a significant number of new features and fixes. [Check out the changelog](https://click.palletsprojects.com/en/master/changelog/#version-7-0) for a list of all code changes and links to the relevant issues. Changes include:
Due to the length of time since the last release, there are a significant number of new
features and
fixes. [Check out the changelog](https://click.palletsprojects.com/page/changes/#version-7-0)
for a list of all code changes and links to the relevant issues. Changes include:

* Shell autocompletion has improved in a number of areas.
* Native ZSH completion was added, and supports its enhanced parameter documentation.
* Native ZSH completion was added, and supports its enhanced parameter
documentation.
* The choice type can be completed.
* Completion correctly handles chained commands, spaces, defaults, and partial completions.
* Completion correctly handles chained commands, spaces, defaults, and partial
completions.
* Parameters can provide a callback to customize completion.
* On Windows `click.echo` can now output more than 16k characters in one call. On Windows 7, a 64k limit on binary stream output is also worked around.
* On Windows `click.echo` can now output more than 16k characters in one call. On
Windows 7, a 64k limit on binary stream output is also worked around.
* `click.getchar` returns Unicode on Windows.
* When piping input and output, more cases of closed pipes are detected and handled instead of raising errors.
* When piping input and output, more cases of closed pipes are detected and handled
instead of raising errors.
* The `CliRunner` used for testing separates stdout and stderr.
* New `DateTime` and `FloatRange` parameter types.
* Flags to mark a parameter as hidden or deprecated.
* Numerous improvements and fixes to i/o, help, parameters, and testing.

## Read the Docs

Click is the first Pallets project to move its docs to Read the Docs. Our projects currently use a custom builder and hosting, but this became too difficult with limited maintainer time. Thank you to everyone at RTD who helped with the transition!
Click is the first Pallets project to move its docs to Read the Docs. Our projects
currently use a custom builder and hosting, but this became too difficult with limited
maintainer time. Thank you to everyone at RTD who helped with the transition!

The new URL for the docs is https://click.palletsprojects.com/. The old http://click.pocoo.org/ domain will redirect to the new one while we continue to migrate, but will eventually go away. Please use the new URL going forward.
The new URL for the docs is https://click.palletsprojects.com/. The
old `https://click.palletsprojects.com/` domain will redirect to the new one while we
continue to migrate, but will eventually go away. Please use the new URL going forward.

Click's docs use a custom Sphinx theme and extensions. As part of the move, these were extracted to a separate Python package. Install [Pallets-Sphinx-Themes](https://pypi.org/project/Pallets-Sphinx-Themes) to use Click's theme when writing extensions for a more cohesive look.
Click's docs use a custom Sphinx theme and extensions. As part of the move, these were
extracted to a separate Python package.
Install [Pallets-Sphinx-Themes](https://pypi.org/project/Pallets-Sphinx-Themes) to use
Click's theme when writing extensions for a more cohesive look.

## Install or Upgrade

Expand All @@ -38,8 +55,14 @@ Install from [PyPI](https://pypi.org/project/Click) with pip:

## Get Involved

Click and the Pallets team depends on you, the community. Whether you report issues, write documentation, create patches, or answer questions, we appreciate all the help you provide. [Star the project on GitHub](https://github.com/pallets/click) to show support, and [watch](https://help.github.com/articles/watching-and-unwatching-repositories/) the repository to see discussions and pull requests as they happen.
Click and the Pallets team depends on you, the community. Whether you report issues,
write documentation, create patches, or answer questions, we appreciate all the help you
provide. [Star the project on GitHub](https://github.com/pallets/click) to show support,
and [watch](https://help.github.com/articles/watching-and-unwatching-repositories/) the
repository to see discussions and pull requests as they happen.

## Donate

We now accept donations through the Python Software Foundation in order to support our efforts to maintain the projects and grow the community. [**Click here to donate.**](/donate)
We now accept donations through the Python Software Foundation in order to support our
efforts to maintain the projects and grow the community. [**Click here to donate.
**](../donate.md)
21 changes: 9 additions & 12 deletions content/blog/click-7-1-released.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,39 +7,36 @@ tags = ["releases"]

The Pallets team is pleased to release Click 7.1.

[Read the full changelog](https://click.palletsprojects.com/en/7.x/changelog/#version-7-1)
[Read the full changelog](https://click.palletsprojects.com/page/changes/#version-7-1)
to understand what may affect your code when upgrading.

- Drop support for Python 3.4. This will be the last version to
support Python 2.7 and 3.5.
- Multiple fixes in low-level Windows compatibility code.
- Colored output in Jupyter notebooks on Linux and Mac.
- Updated Bash and ZSH tab completion support. Add support for Fish.
- Better formatting when option help text contains newlines.
- Drop support for Python 3.4. This will be the last version to
support Python 2.7 and 3.5.
- Multiple fixes in low-level Windows compatibility code.
- Colored output in Jupyter notebooks on Linux and Mac.
- Updated Bash and ZSH tab completion support. Add support for Fish.
- Better formatting when option help text contains newlines.

This also fixes a packaging issue from 7.0 where the project name in the
package metadata was changed to "Click" with an upper case "C". This has
been reverted, the name is now correctly reported in all lower case, "click".


## Version 8.0 Coming Soon

As outlined in [Ending Python 2 Support](/blog/ending-python2-support),
As outlined in [Ending Python 2 Support](ending-python2-support.md),
7.1.x will be the last version to support Python 2.7 and 3.5. The next
version will be 8.0 and will support Python 3.6 and newer.


## Install or Upgrade

Install from [PyPI](https://pypi.org/project/click/) with pip:

pip install -U click


## Donate to Support Pallets

The Pallets organization accepts donations as part of the non-profit
Python Software Foundation (PSF). Donations through the PSF support our
efforts to maintain the projects and grow the community.

[Click here to donate. ❤](/donate)
[Click here to donate. ❤](../donate.md)
10 changes: 8 additions & 2 deletions content/blog/community-survey-2019.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,14 @@ published = 2019-01-29
tags = ["meta"]
~~~~

One of my goals as a Pallets maintainer is to build the community around our projects. The Pallets projects (Flask, Jinja, Click, etc.) are downloaded millions of times each month, but it's hard to get a clear picture of what our users do and want with downloads stats only. We'd like to learn about you and your projects. Knowing more about our community will help us decide what to focus on to grow the Pallets projects.
One of my goals as a Pallets maintainer is to build the community around our projects.
The Pallets projects (Flask, Jinja, Click, etc.) are downloaded millions of times each
month, but it's hard to get a clear picture of what our users do and want with downloads
stats only. We'd like to learn about you and your projects. Knowing more about our
community will help us decide what to focus on to grow the Pallets projects.

[**Click here to take our Community Survey.**](https://goo.gl/forms/CtZrOgWUa8gy1FNz2)

Please share the link with friends, coworkers, and the internet! We're looking forward to seeing everyone's responses! You can follow https://twitter.com/PalletsTeam or this blog to get updates about Pallets, including the survey results.
Please share the link with friends, coworkers, and the internet! We're looking forward
to seeing everyone's responses! You can follow https://twitter.com/PalletsTeam or this
blog to get updates about Pallets, including the survey results.
2 changes: 1 addition & 1 deletion content/blog/donate.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,4 +41,4 @@ growing the community even more.

[**Click here to donate today.**][donate]

[donate]: https://psfmember.org/civicrm/contribute/transact?reset=1&id=20
[donate]: ../donate.md
38 changes: 18 additions & 20 deletions content/blog/end-python2-prereleases.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ now available for the next major version of each project.

Check out the changelogs for every project to see what's new:

- [Flask 2.0](https://flask.palletsprojects.com/en/master/changes#version-2-0-0)
- [Jinja2 3.0](https://jinja.palletsprojects.com/en/master/changes/#version-3-0-0)
- [Click 8.0](https://click.palletsprojects.com/en/master/changes/#version-8-0)
- [Werkzeug 2.0](https://werkzeug.palletsprojects.com/en/master/changes/#version-2-0-0)
- [ItsDangerous 2.0](https://itsdangerous.palletsprojects.com/en/master/changes/#version-2-0-0)
- [MarkupSafe 2.0](https://markupsafe.palletsprojects.com/en/master/changes/#version-2-0-0)
- [Flask 2.0](https://flask.palletsprojects.com/page/changes#version-2-0-0)
- [Jinja2 3.0](https://jinja.palletsprojects.com/page/changes/#version-3-0-0)
- [Click 8.0](https://click.palletsprojects.com/page/changes/#version-8-0)
- [Werkzeug 2.0](https://werkzeug.palletsprojects.com/page/changes/#version-2-0-0)
- [ItsDangerous 2.0](https://itsdangerous.palletsprojects.com/page/changes/#version-2-0-0)
- [MarkupSafe 2.0](https://markupsafe.palletsprojects.com/page/changes/#version-2-0-0)

Please help us prepare for the final release by testing the prerelease
versions and reporting any issues you have. To upgrade to pre-releases
Expand All @@ -26,26 +26,24 @@ with pip, use the `--pre` flag, e.g.:
These new major versions all drop support for Python 2 and 3.5,
requiring Python 3.6 as the minimum supported version.


## Release highlights

These are a few highlights, see the changelogs linked above for the
full release details. More detailed posts about each project's
highlights will be made with the final releases.

- All projects (Jinja coming soon) now provide type hints.
- Flask gains limited `async`/`await` support.
- Flask supports nested blueprints.
- Flask tells the browser to cache static files more intelligently, so
changes to CSS or images show up immediately.
- Flask introduces short form route decorators, such as `@app.post()`
as a shortcut for `@app.route(methods=["POST"])`.
- Click's shell completion system has been rewritten.
- Click will now prompt for values where they are omitted.
- Werkzeug now provides `send_file` and `send_from_directory` helpers.
- Werkzeug's test client always returns a `Response` object.
- Werkzeug's multipart parsing performance increases by a factor of 15.

- All projects (Jinja coming soon) now provide type hints.
- Flask gains limited `async`/`await` support.
- Flask supports nested blueprints.
- Flask tells the browser to cache static files more intelligently, so
changes to CSS or images show up immediately.
- Flask introduces short form route decorators, such as `@app.post()`
as a shortcut for `@app.route(methods=["POST"])`.
- Click's shell completion system has been rewritten.
- Click will now prompt for values where they are omitted.
- Werkzeug now provides `send_file` and `send_from_directory` helpers.
- Werkzeug's test client always returns a `Response` object.
- Werkzeug's multipart parsing performance increases by a factor of 15.

## Release date

Expand Down
4 changes: 4 additions & 0 deletions content/blog/ending-python2-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,11 @@ who has made this transition a reality. We look forward to continuing
to develop the Pallets projects with you!

[pep]: https://www.python.org/dev/peps/pep-0373/

[community]: https://python3statement.org/

[pytest]: https://docs.pytest.org/en/5.3.2/py27-py34-deprecation.html

[devguide]: https://devguide.python.org/#status-of-python-branches

[psf]: https://www.jetbrains.com/research/python-developers-survey-2018/#python-3-adoption
Loading

0 comments on commit eb7b5d5

Please sign in to comment.