Skip to content

Commit 565d24c

Browse files
committed
docs: update documentation for project rename to msgspec-x
1 parent ba0f119 commit 565d24c

File tree

10 files changed

+55
-32
lines changed

10 files changed

+55
-32
lines changed

docs/source/_templates/help.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<h3>Need help?</h3>
22

33
<p>
4-
Open an issue in the <a href="https://github.com/jcrist/msgspec/issues">issue tracker</a>.
5-
</p>
4+
Open an issue in the <a href="https://github.com/nightsailer/msgspec-x/issues">issue tracker</a>.
5+
</p>

docs/source/benchmarks.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@ Benchmarks
22
==========
33

44
.. note::
5+
These benchmarks are for ``msgspec-x``, a community-driven fork of the original msgspec project.
56

67
Benchmarks are *hard*.
78

docs/source/converters.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -127,9 +127,9 @@ support by wrapping the standard library's `tomllib` module as follows:
127127
``msgspec`` uses these APIs to implement ``toml`` and ``yaml`` support,
128128
wrapping external serialization libraries:
129129

130-
- ``msgspec.toml`` (`code <https://github.com/jcrist/msgspec/blob/main/msgspec/toml.py>`__)
130+
- ``msgspec.toml`` (`code <https://github.com/nightsailer/msgspec-x/blob/main/msgspec/toml.py>`__)
131131

132-
- ``msgspec.yaml`` (`code <https://github.com/jcrist/msgspec/blob/main/msgspec/yaml.py>`__)
132+
- ``msgspec.yaml`` (`code <https://github.com/nightsailer/msgspec-x/blob/main/msgspec/yaml.py>`__)
133133

134134
The implementation in ``msgspec.toml`` is *almost* identical to the one above,
135135
with some additional code for error handling.

docs/source/examples/geojson.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ types, and :ref:`struct-tagged-unions` to differentiate between them. See the
2121
relevant docs for more information.
2222

2323
The full example source can be found `here
24-
<https://github.com/jcrist/msgspec/blob/main/examples/geojson>`__.
24+
<https://github.com/nightsailer/msgspec-x/blob/main/examples/geojson>`__.
2525

2626
.. literalinclude:: ../../../examples/geojson/msgspec_geojson.py
2727
:language: python

docs/source/examples/pyproject-toml.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ file. This includes full schema definitions for all fields in the
2323
``tool``.
2424

2525
The full example source can be found `here
26-
<https://github.com/jcrist/msgspec/blob/main/examples/pyproject-toml>`__.
26+
<https://github.com/nightsailer/msgspec-x/blob/main/examples/pyproject-toml>`__.
2727

2828
.. literalinclude:: ../../../examples/pyproject-toml/pyproject.py
2929
:language: python

docs/source/index.rst

Lines changed: 21 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,13 @@
1-
msgspec
1+
msgspec-x
22
=======
33

4-
``msgspec`` is a *fast* serialization and validation library, with builtin
4+
``msgspec-x`` is a community-driven fork of the original msgspec library. It provides two namespaces:
5+
- ``msgspec``: 100% compatible with the original API for drop-in replacement.
6+
- ``msgspec_x``: Extended features and community contributions.
7+
8+
Do not install both ``msgspec`` and ``msgspec-x`` in the same environment.
9+
10+
``msgspec-x`` is a *fast* serialization and validation library, with builtin
511
support for JSON_, MessagePack_, YAML_, and TOML_. It features:
612

713
- 🚀 **High performance encoders/decoders** for common protocols. The JSON and
@@ -12,7 +18,7 @@ support for JSON_, MessagePack_, YAML_, and TOML_. It features:
1218
be supported through :doc:`extensions <extending>`.
1319

1420
- 🔍 **Zero-cost schema validation** using familiar Python type annotations.
15-
In :doc:`benchmarks <benchmarks>` ``msgspec`` decodes *and* validates JSON
21+
In :doc:`benchmarks <benchmarks>` ``msgspec-x`` decodes *and* validates JSON
1622
faster than orjson_ can decode it alone.
1723

1824
- ✨ **A speedy Struct type** for representing structured data. If you already
@@ -24,9 +30,9 @@ All of this is included in a :ref:`lightweight library
2430

2531
-----
2632

27-
``msgspec`` may be used for serialization alone, as a faster JSON or
33+
``msgspec-x`` may be used for serialization alone, as a faster JSON or
2834
MessagePack library. For the greatest benefit though, we recommend using
29-
``msgspec`` to handle the full serialization & validation workflow:
35+
``msgspec-x`` to handle the full serialization & validation workflow:
3036

3137
**Define** your message schemas using standard Python type annotations.
3238

@@ -66,40 +72,40 @@ MessagePack library. For the greatest benefit though, we recommend using
6672
File "<stdin>", line 1, in <module>
6773
msgspec.ValidationError: Expected `str`, got `int` - at `$.groups[0]`
6874
69-
``msgspec`` is designed to be as performant as possible, while retaining some
75+
``msgspec-x`` is designed to be as performant as possible, while retaining some
7076
of the nicities of validation libraries like pydantic_. For supported types,
71-
encoding/decoding a message with ``msgspec`` can be :doc:`~10-80x faster than
77+
encoding/decoding a message with ``msgspec-x`` can be :doc:`~10-80x faster than
7278
alternative libraries <benchmarks>`.
7379

7480
Highlights
7581
----------
7682

77-
- ``msgspec`` is **fast**. It :doc:`benchmarks <benchmarks>` as the fastest
83+
- ``msgspec-x`` is **fast**. It :doc:`benchmarks <benchmarks>` as the fastest
7884
serialization library for Python, outperforming all other JSON/MessagePack
7985
libraries compared.
8086

81-
- ``msgspec`` is **friendly**. Through use of Python's type annotations,
87+
- ``msgspec-x`` is **friendly**. Through use of Python's type annotations,
8288
messages are :ref:`validated <typed-decoding>` during deserialization in a
83-
declarative way. ``msgspec`` also works well with other type-checking tooling
89+
declarative way. ``msgspec-x`` also works well with other type-checking tooling
8490
like mypy_ and pyright_, providing excellent editor integration.
8591

86-
- ``msgspec`` is **flexible**. It natively supports a :doc:`wide range of
92+
- ``msgspec-x`` is **flexible**. It natively supports a :doc:`wide range of
8793
Python builtin types <supported-types>`. Support for additional types can
8894
also be added through :doc:`extensions <extending>`.
8995

90-
- ``msgspec`` is **lightweight**. It has no required dependencies, and the
96+
- ``msgspec-x`` is **lightweight**. It has no required dependencies, and the
9197
binary size is :ref:`a fraction of that of comparable libraries
9298
<benchmark-library-size>`.
9399

94-
- ``msgspec`` is **correct**. The encoders/decoders implemented are strictly
100+
- ``msgspec-x`` is **correct**. The encoders/decoders implemented are strictly
95101
compliant with their respective specifications, providing stronger guarantees
96102
of compatibility with other systems.
97103

98104
Used By
99105
-------
100106

101-
``msgspec`` is used by many organizations and `open source projects
102-
<https://github.com/jcrist/msgspec/network/dependents>`__, here we highlight a
107+
``msgspec-x`` is used by many organizations and `open source projects
108+
<https://github.com/nightsailer/msgspec-x/network/dependents>`__, here we highlight a
103109
few:
104110

105111
.. grid:: 2 2 4 4

docs/source/inspect.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ subclass. See the :ref:`API docs <inspect-api>` for a complete list of types.
142142
For an example of using these functions, you might find our builtin
143143
:doc:`jsonschema` generator implementation useful - the code for this can be
144144
found `here
145-
<https://github.com/jcrist/msgspec/blob/main/msgspec/_json_schema.py>`__. In
145+
<https://github.com/nightsailer/msgspec-x/blob/main/msgspec/_json_schema.py>`__. In
146146
particular, take a look at the large if-else statement in ``_to_schema``.
147147

148148

docs/source/install.rst

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,28 @@
11
Installation
22
============
33

4-
``msgspec`` may be installed via ``pip`` or ``conda``. Note that Python >= 3.8
5-
is required. The basic install has no required dependencies.
4+
``msgspec-x`` may be installed via ``pip`` or ``conda``. Note that Python >= 3.9 is required. The basic install has no required dependencies.
65

76
**pip**
87

98
.. code-block:: shell
109
11-
pip install msgspec
10+
pip install msgspec-x
1211
1312
**conda**
1413

1514
.. code-block:: shell
1615
17-
conda install msgspec -c conda-forge
16+
conda install msgspec-x -c conda-forge
17+
18+
.. note::
19+
Do not install both ``msgspec`` and ``msgspec-x`` in the same environment.
1820

1921

2022
Optional Dependencies
2123
---------------------
2224

23-
Depending on your platform, the base install of ``msgspec`` may not support
25+
Depending on your platform, the base install of ``msgspec-x`` may not support
2426
TOML_ or YAML_ without additional dependencies.
2527

2628
TOML
@@ -40,13 +42,13 @@ extra:
4042

4143
.. code-block:: shell
4244
43-
pip install "msgspec[toml]"
45+
pip install "msgspec-x[toml]"
4446
4547
**conda**
4648

4749
.. code-block:: shell
4850
49-
conda install msgspec-toml -c conda-forge
51+
conda install msgspec-x-toml -c conda-forge
5052
5153
YAML
5254
~~~~
@@ -58,13 +60,13 @@ this dependency manually, or depend on the ``yaml`` extra:
5860

5961
.. code-block:: shell
6062
61-
pip install "msgspec[yaml]"
63+
pip install "msgspec-x[yaml]"
6264
6365
**conda**
6466

6567
.. code-block:: shell
6668
67-
conda install msgspec-yaml -c conda-forge
69+
conda install msgspec-x-yaml -c conda-forge
6870
6971
7072
Installing from GitHub

docs/source/supported-types.rst

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1616,5 +1616,9 @@ TOML_ types are decoded to Python types as follows:
16161616
.. _pyright: https://github.com/microsoft/pyright
16171617
.. _generic types:
16181618
.. _user-defined generic types: https://docs.python.org/3/library/typing.html#user-defined-generic-types
1619-
.. _open an issue: https://github.com/jcrist/msgspec/issues>
1619+
.. _open an issue: https://github.com/nightsailer/msgspec-x/issues>
16201620
.. _ISO 8601 duration strings: https://en.wikipedia.org/wiki/ISO_8601#Durations
1621+
1622+
- ``msgspec`` is used by many organizations and `open source projects
1623+
<https://github.com/nightsailer/msgspec-x/network/dependents>`__, here we highlight a
1624+
few:

msgspec_x/__init__.py

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
"""
2+
msgspec_x - Extended features for msgspec
3+
4+
This namespace provides additional functionality and community contributions
5+
that extend the original msgspec library capabilities.
6+
7+
8+
For compatibility with existing code, use the `msgspec` namespace.
9+
For new extended features, use this `msgspec_x` namespace.
10+
"""

0 commit comments

Comments
 (0)