NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #662 most downloaded on PyPI
GraphQL Framework for Python
Latest stable
3.4.3
Last release 2 years ago
no release in 18 months
Release timing varies
gaps range from 9 days to 1.2 years
Most releases are documented
notes for 52 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
102 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
A proper error will now be raised when invalid UUIDs are passed as input variables.
A proper error will now be raised when invalid UUIDs are passed as input variables.
Full Changelog: https://github.com/graphql-python/graphene/compare/v3.4.2...v3.4.3
Graphene now supports overriding the Union options!
Graphene now supports overriding the Union options!
Full Changelog: https://github.com/graphql-python/graphene/compare/v3.4.1...v3.4.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This release brings a regression fix for DateTime parsing in python versions before 3.11, caused by the removal of aniso8601. The issue was introduced
This release brings a regression fix for DateTime parsing in python versions before 3.11, caused by the removal of aniso8601. The issue was introduced in 3.4.0.
If you are using the DateTime scalar together with a Python <= 3.10, please update Graphene to this version.
Full Changelog: https://github.com/graphql-python/graphene/compare/v3.4.0...v3.4.1
This release brings a regression fix for DateTime parsing in python versions before 3.11, caused by the removal of aniso8601. The issue was introduced in 3.4.0.
If you are using the DateTime scalar together with a Python <= 3.10, please update Graphene to this version.
Full Changelog: v3.4.0...v3.4.1
CI: fix deprecation warning by @dulmandakh in https://github.com/graphql-python/graphene/pull/1551
This release brings housekeeping changes and support for Python 3.13. Thanks to all contributors who made this release happen, and special thanks to @dulmandakh for bringing our CI up to modern standards.
type arg of Field by @andrewswait in https://github.com/graphql-python/graphene/pull/1527snapshottest dependency by @PoByBolek in https://github.com/graphql-python/graphene/pull/1572Full Changelog: https://github.com/graphql-python/graphene/compare/v3.3.0...v3.4.0
In the future, the default Value will be set to UNDEFINED, making this a soft migration and deprecation of the previous situation.
This release brings two new features and several fixes and semantic upgrades due to new Python features. Thanks to everyone that contributed! 😊
⚠️⚠️ACTION REQUIRED⚠️⚠️
In GraphQL, inputs can have fields which are optional. Currently, if those fields are not specified in the query, they are passed to the python inputs as None. This renders them indistinguishable from fields that are actually passed to the query with a value of null. While the alternative would be to check the definition via "key" in input, it is more accessible to mark these fields as explicitly UNDEFINED.
This PR adds a new global override, which allows unspecified fields to be set to graphql.UNDEFINED. In the future, the default Value will be set to UNDEFINED, making this a soft migration and deprecation of the previous situation.
This is a soft migration. Long-Term, the Input Objects will ALWAYS contain the value UNDEFINED Make sure your code supports these cases in None checks. After the default has been set to UNDEFINED, you will still be able to switch back to None for the foreseeable future.
Custom Relay connection classes can now be made NonNull using the strict_types option on the connection meta.
Using this example
class MyObjectConnection(Connection):
class Meta:
node = MyObject
strict_types = True
will change from
type MyObjectConnection {
edges: [MyObjectEdge]
}
to
type MyObjectConnection {
edges: [MyObjectEdge!]!
}
We want to make sure you're informed about using NonNull relay connections. While they are a great way to get rid of some null checks in typed frontends, it's important to be mindful of error handling with these connections. When working with NonNull connections, it's crucial to remember that if a requested field or edge is not available or the resolver throws an error, the error will bubble up to the next nullable parent field, which is oftentimes the root node. That way, you cannot handle partial results in case of partial errors anymore. In a nullable connection, only the nullable fields will be set to null and the error will not bubble up.
To address this, we recommend considering waiting for the future release of client-controlled nullability for cases where certain connections might be nullable. By opting for client-controlled nullability, you gain more control over error handling, enabling you to handle potential null values more gracefully and enhance the overall user experience. Read more about client controlled nullability here: https://github.com/graphql/graphql-spec/issues/867
typing.TYPE_CHECKING instead of MYPY by @rapsealk in https://github.com/graphql-python/graphene/pull/1503Full Changelog: https://github.com/graphql-python/graphene/compare/v3.2.2...v3.3.0
This release provides some internal refactoring to the relay types to improve support for adding custom fields to them.
This release provides some internal refactoring to the relay types to improve support for adding custom fields to them.
Non-required InputFields and Arguments can now be marked as deprecated by passing the deprecation_reason keyword argument to the constructor.
Non-required InputFields and Arguments can now be marked as deprecated by passing the deprecation_reason keyword argument to the constructor.
Full Changelog: https://github.com/graphql-python/graphene/compare/v3.2.0...v3.2.1
The global ID type of a Node can now be customized:
relay.NodeThe global ID type of a Node can now be customized:
class CustomNode(Node):
class Meta:
global_id_type = CustomGlobalIDType
class User(ObjectType):
class Meta:
interfaces = [CustomNode]
name = String()
@classmethod
def get_node(cls, _type, _id):
return self.users[_id]
Currently, the following types are available:
DefaultGlobalIDType: Default global ID type: base64 encoded version of "<node type name>: <node id>". (Previously the only option) Scalar: IDSimpleGlobalIDType : Simple global ID type: simply the id of the object. Scalar: IDUUIDGlobalIDType : UUID global ID type. Scalar: UUIDTo create a custom global type, BaseGlobalIDType must be extended:
class CustomGlobalIDType(BaseGlobalIDType):
graphene_type = CustomScalar
@classmethod
def resolve_global_id(cls, info, global_id):
_type = custom_get_type_from_global_id(global_id)
return _type, global_id
@classmethod
def to_global_id(cls, _type, _id):
return _id
graphene_type specifies the type of scalar to be used in the schema. Remember, that if you're using ID as a scalar, you might need to deserialize your custom global ID first!
Relevant PR:
ObjectTypes can be copied again #1333 by @keu210description: #1478 by @mike-roberts-healxFull Changelog: https://github.com/graphql-python/graphene/compare/v3.1.1...v3.2.0
Graphene now includes an updated version of aiodataloader by Syrus Akbary under graphene.utils.dataloader due to inactivity of the old repository. The
Graphene now includes an updated version of aiodataloader by Syrus Akbary under graphene.utils.dataloader due to inactivity of the old repository. The update fixes an issue some users experienced when trying to use dataloader in conjunction with pytest (https://github.com/syrusakbary/aiodataloader/issues/13). Further contributions and updates to dataloader in this repo are welcome!
A custom typename can now be added when using from_enum:
from enum import Enum as PyEnum
class Color(PyEnum):
RED = 1
YELLOW = 2
BLUE = 3
GColor = Enum.from_enum(Color, description="original colors")
UniqueGColor = Enum.from_enum(
Color, name="UniqueColor", description="unique colors"
)
type Query {
color: Color!
uniqueColor: UniqueColor!
}
"""original colors"""
enum Color {
RED
YELLOW
BLUE
}
"""unique colors"""
enum UniqueColor {
RED
YELLOW
BLUE
}
Interfaces extending interfaces is now supported!
class FooInterface(Interface):
foo = String()
class BarInterface(Interface):
class Meta:
interfaces = [FooInterface]
foo = String()
bar = String()
interface FooInterface {
foo: String
}
interface BarInterface implements FooInterface {
foo: String
bar: String
}
Thank you to everyone that contributed to this release!
DataLoader from aiodataloader and move get_event_loop() out of __init__ function. by @flipbit03 in https://github.com/graphql-python/graphene/pull/1459Full Changelog: https://github.com/graphql-python/graphene/compare/v3.1.0...v3.1.1
Various spelling and grammar fixes for the documentation. by @justinrmiller in https://github.com/graphql-python/graphene/pull/1324
Full Changelog: https://github.com/graphql-python/graphene/compare/v3.0.0...v3.1.0
The full release notes including an upgrade guide can be found here: https://github.com/graphql-python/graphene/wiki/v3-release-notes
The full release notes including an upgrade guide can be found here: https://github.com/graphql-python/graphene/wiki/v3-release-notes
args by @jkimbo in https://github.com/graphql-python/graphene/pull/1170default_value regardless if the input field is required by @minhtule in https://github.com/graphql-python/graphene/pull/1326Full Changelog: https://github.com/graphql-python/graphene/compare/v2.1.8...v3.0.0
fix: graphql-core dependency resolution.
graphql-core dependency resolution. (#1377)All changes: https://github.com/graphql-python/graphene-django/compare/v3.0.0b7...v3.0.0b8
fix(Decimal): parse integers as decimal.
All changes: https://github.com/graphql-python/graphene-django/compare/v3.0.0b6...v3.0.0b7
Add UnforgivingExecutionContext
All changes: https://github.com/graphql-python/graphene-django/compare/v3.0.0b5...v3.0.0b6
Full changelog: https://github.com/graphql-python/graphene-django/compare/v3.0.0b4...v3.0.0b5
Full changelog: https://github.com/graphql-python/graphene-django/compare/v3.0.0b4...v3.0.0b5
Rename variables called type to type_
Full changelog: https://github.com/graphql-python/graphene-django/compare/v3.0.0b3...v3.0.0b4
Fix DateTime Scalar parse_literal methods
Full changelog: https://github.com/graphql-python/graphene-django/compare/v3.0.0b2...v3.0.0b3
Third beta release for Graphene v3.
Third beta release for Graphene v3.
Changes: https://github.com/graphql-python/graphene/compare/v3.0.0b1...v3.0.0b2
Second beta release for Graphene v3.
Second beta release for Graphene v3.
Changes: https://github.com/graphql-python/graphene/compare/v3.0.0b0...v3.0.0b1
source attribute now uses the default resolver function #1155First beta release of Graphene based on GraphQL-Core v3.1
First beta release of Graphene based on GraphQL-Core v3.1
Second Graphene alpha release compatible with GraphQL-Core v3.0
Second Graphene alpha release compatible with GraphQL-Core v3.0
Nothing published for this version
Propagate arguments of relay.NodeField to Field
Allow mutations to apply the interfaces META argument to have the payload object type implement the desired interfaces
Update graphql-relay dependency to fix incompatibility.
Update graphql-relay dependency to fix incompatibility.
Fix malformed version on aniso8601 requirement (#995) 431e93c
Full changelog: https://github.com/graphql-python/graphene/compare/v2.1.5...v2.1.6
from_enum can now take a deprecation reason 6a4091b3e4734fe032397b0bcd350820f6037d0f
NonNull type abff3d75a39bc8f2d1fdb48aafa1866cf47dfff6from_enum can now take a deprecation reason 6a4091b3e4734fe032397b0bcd350820f6037d0fToo many documentation improvements to list out here and lots more to come. Watch this space.
Full changelog: https://github.com/graphql-python/graphene/compare/v2.1.3...v2.1.5
Note: v2.1.4 was never released to PyPi due to build issues. We went straight from v2.1.3 to v2.1.5
Added crunch and deduplicator utitlities https://github.com/graphql-python/graphene/commit/fa5f5b0acbede77a27d2f6e24d651ac8d6ea8c74 https://github.com
crunch and deduplicator utitlities https://github.com/graphql-python/graphene/commit/fa5f5b0acbede77a27d2f6e24d651ac8d6ea8c74 https://github.com/graphql-python/graphene/commit/2e41db8d95daa3ab09c294118e20b7c38387e00aEnum library to graphql-core, use graphql-core>=2.1 https://github.com/graphql-python/graphene/commit/d28dc68abca5597f44274e1dbd6d000ff3826084Bugfix release to fix a couple of issues. Thanks to the effort of contributors for this new release @jlowin @nxtman123 @danpalmer @dan98765 @femesq 🎉
Bugfix release to fix a couple of issues. Thanks to the effort of contributors for this new release @jlowin @nxtman123 @danpalmer @dan98765 @femesq 🎉
A small bugfix release to fix a couple of issues. Thanks to the effort of contributors for this new release @nikordaris @dan98765 @femesq @devArtoria
A small bugfix release to fix a couple of issues. Thanks to the effort of contributors for this new release @nikordaris @dan98765 @femesq @devArtoria 🎉
default_value on NonNull fields (9408ba70d165284ff7ab5efd159a62e1d40a9a7f)Fixed deprecations url in deprecation message a96ed550bd0c67b7a9ec0b9f636f71c530441e5f
This is a minor release, fixing a lot of small issues, with better support for Date, DateTime and Time scalars and tons of improvements on docs.
Thanks to the effort of contributors for this new release @jkimbo @danpalmer @g-- @dfee @Prince-Leto @simonwoerpel @pjdelport @anisjonischkeit @abawchen 🎉
InputObjectType meta a16c5ba00be1d963d438c5e96962b79d1b145cc3to_camel_case utility function be1f7d72a46f29eb491d3a6110fd955d0b72dea4required=True in ConnectionField 8c7ca74c6f083007a7c83c843f494357aec69371Date, DateTime and Time scalars to fail with GraphQLError is format is invalid 84fbf5dc23351c26a852271aa6529a60bce13735 9973fd314f6134a96a78617fee1caf21d592b6afMeta included in Enum members 2594cdb61409f8ecedf0958ee959f8f8ded3efbcstr on abstract types, improved repr 562cafc14f66bbad7f76e7600fa0acd71d00194eaniso8601 instead of iso8601 b4255e55fd28ca5b31f86876fe3f95f38f0f0838Date, DateTime and Time from main packageDate scalar to documentation 98366c6add10fa1532301145e9768bffcbb09dc5Scalar documentation 5036d164b74038ad4ef82add05beb73def11c317NonNull lists e26c0a3717c4ff3f90ed8bd710436f8cb6ff4713Node example d3b708533d05ef13a6b15e7a3f29eac23f812a09Prevent breaking changes for future releases 71177fe9776d8cf958ac3054885f891f49c1ef4d
Date type in datetime 045d5fffbec0d32550b19421fa01a088f5cd0d8cInputObjectType value should be None (rather than the Field) b5abccb1dc733522df19d56e0906890531a700d3InputObjectType f6697188ee9cbbe22df5e6971ef9686b589f4dafPlease read the upgrade guide to learn how to upgrade: https://github.com/graphql-python/graphene/blob/master/UPGRADE-v2.0.md
Please read the upgrade guide to learn how to upgrade: https://github.com/graphql-python/graphene/blob/master/UPGRADE-v2.0.md
__init_subclass__, and a polyfill implementation for Python 2).And... Subscriptions!!
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added type consistency for Arguments #467
Arguments #467DataLoader docs 0a9dbb608a0ee71dd556c0bd206a0b39bd5a337dImproved Enums comparison and getters afed25a18015643749439288a9536235232dd493
Enums comparison and getters afed25a18015643749439288a9536235232dd493Client (graphene.test.Client) dfcd7f256340301d7551e2af383e4e84454db097possible_types option in ObjectType.Meta that mimics is_type_of -> isinstance(root, possible_types) a7511d3a2c2eb59ad8342d3db85f18ea477ae379promise package requirement to 2.0graphql-core package requirement to 1.1Fix docstring whitespace 62e58bd95325604186563f54c898736db9d39585
ObjectType 98825fa4bc0f2fd6f88d11796b1093e0d63a51eeObjectType inheritance with custom Meta ad251e9a8dd46d212e39da67945df4fc3e02b361 48efec307ce245bfe692f75b5dc07c14d8bce15blazy_import to accept also dotted attributes d594a0eca86102ce2ebf9633018437eef8997f42Promise.resolve instead of promisify (so we adapt to Promise 2.0) bd0d418986cf69b51801f8e4d361c0c9a5dbc17cField, InputField, List and NonNull accepting also now string attributes (will be treated as imports, like: Field("graphene.String") 4b714659225a93ea44e95ccdd9ad1b5ea9e36c05partial functions can be now passed as type to Field 774e9bf4639ca459d0a12a10e090d9ab671b6459
partial functions can be now passed as type to Field 774e9bf4639ca459d0a12a10e090d9ab671b6459GenericScalar (based on @hung-phan work for JSON)Union as UnmountedType 2ef0e23dcf036aa41e7ee96dd2468c7177021829test packages to setup.py as extra_requires (so it's easier to install tests dependencies) 256c84a9a535e62a04942d2e96f6972ea269bd78Node.get_node_from_global_id e8fc58afd6f67d904cf40cf8a81bab4747c54fb8Dynamic Field to optionally include the schema on type creation and improved TypeMap validator 2f87698a0b4951cdc685f22db0a28cae7090c08blazy_import to graphene 74400642ed8cc0b3d84fa326cf609de35f3b42fcNode docs 8dff91d4c689ea6a92c13a5a5520c1ce9c360e04List and NonNull e2cdd80a5cc5524af0a45273fd257c08b0ff8bc2Added new Time type to graphene.types.datetime 692d7e76ad06b0b0eb777c14197d041913519868
Time type to graphene.types.datetime 692d7e76ad06b0b0eb777c14197d041913519868promise fix: https://github.com/syrusakbary/promise/commit/8b0d5da3dca2d99671b820478ef74353ac24c97b)Added type getter in the schema when accessing its attrs. 5e0923b56073f42ce25da6628c46ebed120b0654
Added type getter in the schema when accessing its attrs. 5e0923b56073f42ce25da6628c46ebed120b0654
Now is possible to access Graphene types in a schema by typing schema.TYPE_NAME directly.
register method from graphene.Schema df2900e215c88f78dc3fe213df78c8ea9832f3eaFixed resolved interfaces and unions that have is_type_of defined in the inner types when used inside List or NonNull 67c0872c9fceed737b2300d118e6950e
is_type_of defined in the inner types when used inside List or NonNull 67c0872c9fceed737b2300d118e6950ee20e97feUpdated datetime with tests 95280e4f7c2a4b372902d590f0b0f8bc13a57a85
List/NonNull inner type exceptions 2e58f53f18050230f5947159334edf2528f78dcaAnd... Added automatic PyPI upload 90e8e30a3a343e57789a4f2695ccf7eab1e3a29f :)
Connection resolvers can now return a Connection instance instead of a Iterator c7929234294a181993158b4439c24006e9ed1ebd
ConnectionField arguments c961f0b3c60c3a7a6223d5218c912d69585aef5cmutate method in Mutation 999bca84c98d452634dd530e374ea6b649167c64Fixed requiring an overwrite of the is_type_of method in ObjectType in the case the resolver was returning an object that was not an instance of the t
is_type_of method in ObjectType in the case the resolver was returning an object that was not an instance of the type. [8030fea44318b9dfcda854c96dfa5091b266f95e]http://graphene-python.org/blog/graphene-production-ready/
More info here!
http://graphene-python.org/blog/graphene-production-ready/
https://github.com/graphql-python/graphene/blob/master/UPGRADE-v1.0.md
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.