# Python Documentation Turkish Translation

# Copyright (C) 2001-2023, Python Software Foundation

# This file is distributed under the same license as the Python package.

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.11\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2023-09-18 19:05+0000\n"

"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

"Last-Translator: \n"

"Language-Team: TURKISH <python.docs.tr@gmail.com>\n"

"Language: tr\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

#: howto/enum.rst:3

msgid "Enum HOWTO"

msgstr ""

#: howto/enum.rst:9

msgid ""

"An :class:`Enum` is a set of symbolic names bound to unique values. They "

"are similar to global variables, but they offer a more useful :func:"

"`repr()`, grouping, type-safety, and a few other features."

msgstr ""

#: howto/enum.rst:13

msgid ""

"They are most useful when you have a variable that can take one of a limited "

"selection of values. For example, the days of the week::"

msgstr ""

#: howto/enum.rst:26

msgid "Or perhaps the RGB primary colors::"

msgstr ""

#: howto/enum.rst:34

msgid ""

"As you can see, creating an :class:`Enum` is as simple as writing a class "

"that inherits from :class:`Enum` itself."

msgstr ""

#: howto/enum.rst:37

msgid "Case of Enum Members"

msgstr ""

#: howto/enum.rst:39

msgid ""

"Because Enums are used to represent constants we recommend using UPPER_CASE "

"names for members, and will be using that style in our examples."

msgstr ""

#: howto/enum.rst:42

msgid ""

"Depending on the nature of the enum a member's value may or may not be "

"important, but either way that value can be used to get the corresponding "

"member::"

msgstr ""

#: howto/enum.rst:49

msgid ""

"As you can see, the ``repr()`` of a member shows the enum name, the member "

"name, and the value. The ``str()`` of a member shows only the enum name and "

"member name::"

msgstr ""

#: howto/enum.rst:56

msgid "The *type* of an enumeration member is the enum it belongs to::"

msgstr ""

#: howto/enum.rst:63

msgid "Enum members have an attribute that contains just their :attr:`name`::"

msgstr ""

#: howto/enum.rst:68

msgid "Likewise, they have an attribute for their :attr:`value`::"

msgstr ""

#: howto/enum.rst:74

msgid ""

"Unlike many languages that treat enumerations solely as name/value pairs, "

"Python Enums can have behavior added. For example, :class:`datetime.date` "

"has two methods for returning the weekday: :meth:`weekday` and :meth:"

"`isoweekday`. The difference is that one of them counts from 0-6 and the "

"other from 1-7. Rather than keep track of that ourselves we can add a method "

"to the :class:`Weekday` enum to extract the day from the :class:`date` "

"instance and return the matching enum member::"

msgstr ""

#: howto/enum.rst:86

msgid "The complete :class:`Weekday` enum now looks like this::"

msgstr ""

#: howto/enum.rst:101

msgid "Now we can find out what today is! Observe::"

msgstr ""

#: howto/enum.rst:107

msgid ""

"Of course, if you're reading this on some other day, you'll see that day "

"instead."

msgstr ""

#: howto/enum.rst:109

msgid ""

"This :class:`Weekday` enum is great if our variable only needs one day, but "

"what if we need several? Maybe we're writing a function to plot chores "

"during a week, and don't want to use a :class:`list` -- we could use a "

"different type of :class:`Enum`::"

msgstr ""

#: howto/enum.rst:124

msgid ""

"We've changed two things: we're inherited from :class:`Flag`, and the values "

"are all powers of 2."

msgstr ""

#: howto/enum.rst:127

msgid ""

"Just like the original :class:`Weekday` enum above, we can have a single "

"selection::"

msgstr ""

#: howto/enum.rst:133

msgid ""

"But :class:`Flag` also allows us to combine several members into a single "

"variable::"

msgstr ""

#: howto/enum.rst:140

msgid "You can even iterate over a :class:`Flag` variable::"

msgstr ""

#: howto/enum.rst:147

msgid "Okay, let's get some chores set up::"

msgstr ""

#: howto/enum.rst:155

msgid "And a function to display the chores for a given day::"

msgstr ""

#: howto/enum.rst:164

msgid ""

"In cases where the actual values of the members do not matter, you can save "

"yourself some work and use :func:`auto()` for the values::"

msgstr ""

#: howto/enum.rst:183

msgid "Programmatic access to enumeration members and their attributes"

msgstr ""

#: howto/enum.rst:185

msgid ""

"Sometimes it's useful to access members in enumerations programmatically (i."

"e. situations where ``Color.RED`` won't do because the exact color is not "

"known at program-writing time). ``Enum`` allows such access::"

msgstr ""

#: howto/enum.rst:194

msgid "If you want to access enum members by *name*, use item access::"

msgstr ""

#: howto/enum.rst:201

msgid "If you have an enum member and need its :attr:`name` or :attr:`value`::"

msgstr ""

#: howto/enum.rst:211

msgid "Duplicating enum members and values"

msgstr ""

#: howto/enum.rst:213

msgid "Having two enum members with the same name is invalid::"

msgstr ""

#: howto/enum.rst:223

msgid ""

"However, an enum member can have other names associated with it. Given two "

"entries ``A`` and ``B`` with the same value (and ``A`` defined first), ``B`` "

"is an alias for the member ``A``. By-value lookup of the value of ``A`` "

"will return the member ``A``. By-name lookup of ``A`` will return the "

"member ``A``. By-name lookup of ``B`` will also return the member ``A``::"

msgstr ""

#: howto/enum.rst:244

msgid ""

"Attempting to create a member with the same name as an already defined "

"attribute (another member, a method, etc.) or attempting to create an "

"attribute with the same name as a member is not allowed."

msgstr ""

#: howto/enum.rst:250

msgid "Ensuring unique enumeration values"

msgstr ""

#: howto/enum.rst:252

msgid ""

"By default, enumerations allow multiple names as aliases for the same value. "

"When this behavior isn't desired, you can use the :func:`unique` decorator::"

msgstr ""

#: howto/enum.rst:269

msgid "Using automatic values"

msgstr ""

#: howto/enum.rst:271

msgid "If the exact value is unimportant you can use :class:`auto`::"

msgstr ""

#: howto/enum.rst:282

msgid ""

"The values are chosen by :func:`_generate_next_value_`, which can be "

"overridden::"

msgstr ""

#: howto/enum.rst:300

msgid ""

"The :meth:`_generate_next_value_` method must be defined before any members."

msgstr ""

#: howto/enum.rst:303

msgid "Iteration"

msgstr ""

#: howto/enum.rst:305

msgid "Iterating over the members of an enum does not provide the aliases::"

msgstr ""

#: howto/enum.rst:312

msgid ""

"Note that the aliases ``Shape.ALIAS_FOR_SQUARE`` and ``Weekday.WEEKEND`` "

"aren't shown."

msgstr ""

#: howto/enum.rst:314

msgid ""

"The special attribute ``__members__`` is a read-only ordered mapping of "

"names to members. It includes all names defined in the enumeration, "

"including the aliases::"

msgstr ""

#: howto/enum.rst:326

msgid ""

"The ``__members__`` attribute can be used for detailed programmatic access "

"to the enumeration members. For example, finding all the aliases::"

msgstr ""

#: howto/enum.rst:334

msgid ""

"Aliases for flags include values with multiple flags set, such as ``3``, and "

"no flags set, i.e. ``0``."

msgstr ""

#: howto/enum.rst:339

msgid "Comparisons"

msgstr ""

#: howto/enum.rst:341

msgid "Enumeration members are compared by identity::"

msgstr ""

#: howto/enum.rst:350

msgid ""

"Ordered comparisons between enumeration values are *not* supported. Enum "

"members are not integers (but see `IntEnum`_ below)::"

msgstr ""

#: howto/enum.rst:358

msgid "Equality comparisons are defined though::"

msgstr ""

#: howto/enum.rst:367

msgid ""

"Comparisons against non-enumeration values will always compare not equal "

"(again, :class:`IntEnum` was explicitly designed to behave differently, see "

"below)::"

msgstr ""

#: howto/enum.rst:376

msgid ""

"It is possible to reload modules -- if a reloaded module contains enums, "

"they will be recreated, and the new members may not compare identical/equal "

"to the original members."

msgstr ""

#: howto/enum.rst:381

msgid "Allowed members and attributes of enumerations"

msgstr ""

#: howto/enum.rst:383

msgid ""

"Most of the examples above use integers for enumeration values. Using "

"integers is short and handy (and provided by default by the `Functional "

"API`_), but not strictly enforced. In the vast majority of use-cases, one "

"doesn't care what the actual value of an enumeration is. But if the value "

"*is* important, enumerations can have arbitrary values."

msgstr ""

#: howto/enum.rst:389

msgid ""

"Enumerations are Python classes, and can have methods and special methods as "

"usual. If we have this enumeration::"

msgstr ""

#: howto/enum.rst:409

msgid "Then::"

msgstr ""

#: howto/enum.rst:418

msgid ""

"The rules for what is allowed are as follows: names that start and end with "

"a single underscore are reserved by enum and cannot be used; all other "

"attributes defined within an enumeration will become members of this "

"enumeration, with the exception of special methods (:meth:`__str__`, :meth:"

"`__add__`, etc.), descriptors (methods are also descriptors), and variable "

"names listed in :attr:`_ignore_`."

msgstr ""

#: howto/enum.rst:425

msgid ""

"Note: if your enumeration defines :meth:`__new__` and/or :meth:`__init__`, "

"any value(s) given to the enum member will be passed into those methods. See "

"`Planet`_ for an example."

msgstr ""

#: howto/enum.rst:431

msgid ""

"The :meth:`__new__` method, if defined, is used during creation of the Enum "

"members; it is then replaced by Enum's :meth:`__new__` which is used after "

"class creation for lookup of existing members. See :ref:`new-vs-init` for "

"more details."

msgstr ""

#: howto/enum.rst:438

msgid "Restricted Enum subclassing"

msgstr ""

#: howto/enum.rst:440

msgid ""

"A new :class:`Enum` class must have one base enum class, up to one concrete "

"data type, and as many :class:`object`-based mixin classes as needed. The "

"order of these base classes is::"

msgstr ""

#: howto/enum.rst:447

msgid ""

"Also, subclassing an enumeration is allowed only if the enumeration does not "

"define any members. So this is forbidden::"

msgstr ""

#: howto/enum.rst:457

msgid "But this is allowed::"

msgstr ""

#: howto/enum.rst:468

msgid ""

"Allowing subclassing of enums that define members would lead to a violation "

"of some important invariants of types and instances. On the other hand, it "

"makes sense to allow sharing some common behavior between a group of "

"enumerations. (See `OrderedEnum`_ for an example.)"

msgstr ""

#: howto/enum.rst:475

msgid "Pickling"

msgstr ""

#: howto/enum.rst:477

msgid "Enumerations can be pickled and unpickled::"

msgstr ""

#: howto/enum.rst:484

msgid ""

"The usual restrictions for pickling apply: picklable enums must be defined "

"in the top level of a module, since unpickling requires them to be "

"importable from that module."

msgstr ""

#: howto/enum.rst:490

msgid ""

"With pickle protocol version 4 it is possible to easily pickle enums nested "

"in other classes."

msgstr ""

#: howto/enum.rst:493

msgid ""

"It is possible to modify how enum members are pickled/unpickled by defining :"

"meth:`__reduce_ex__` in the enumeration class. The default method is by-"

"value, but enums with complicated values may want to use by-name::"

msgstr ""

#: howto/enum.rst:502

msgid ""

"Using by-name for flags is not recommended, as unnamed aliases will not "

"unpickle."

msgstr ""

#: howto/enum.rst:507

msgid "Functional API"

msgstr ""

#: howto/enum.rst:509

msgid ""

"The :class:`Enum` class is callable, providing the following functional API::"

msgstr ""

#: howto/enum.rst:519

msgid ""

"The semantics of this API resemble :class:`~collections.namedtuple`. The "

"first argument of the call to :class:`Enum` is the name of the enumeration."

msgstr ""

#: howto/enum.rst:522

msgid ""

"The second argument is the *source* of enumeration member names. It can be "

"a whitespace-separated string of names, a sequence of names, a sequence of 2-"

"tuples with key/value pairs, or a mapping (e.g. dictionary) of names to "

"values. The last two options enable assigning arbitrary values to "

"enumerations; the others auto-assign increasing integers starting with 1 "

"(use the ``start`` parameter to specify a different starting value). A new "

"class derived from :class:`Enum` is returned. In other words, the above "

"assignment to :class:`Animal` is equivalent to::"

msgstr ""

#: howto/enum.rst:538

msgid ""

"The reason for defaulting to ``1`` as the starting number and not ``0`` is "

"that ``0`` is ``False`` in a boolean sense, but by default enum members all "

"evaluate to ``True``."

msgstr ""

#: howto/enum.rst:542

msgid ""

"Pickling enums created with the functional API can be tricky as frame stack "

"implementation details are used to try and figure out which module the "

"enumeration is being created in (e.g. it will fail if you use a utility "

"function in a separate module, and also may not work on IronPython or "

"Jython). The solution is to specify the module name explicitly as follows::"

msgstr ""

#: howto/enum.rst:552

msgid ""

"If ``module`` is not supplied, and Enum cannot determine what it is, the new "

"Enum members will not be unpicklable; to keep errors closer to the source, "

"pickling will be disabled."

msgstr ""

#: howto/enum.rst:556

msgid ""

"The new pickle protocol 4 also, in some circumstances, relies on :attr:"

"`~definition.__qualname__` being set to the location where pickle will be "

"able to find the class. For example, if the class was made available in "

"class SomeData in the global scope::"

msgstr ""

#: howto/enum.rst:563

msgid "The complete signature is::"

msgstr ""

#: howto/enum.rst:0

msgid "value"

msgstr ""

#: howto/enum.rst:575

msgid "What the new enum class will record as its name."

msgstr ""

#: howto/enum.rst:0

msgid "names"

msgstr ""

#: howto/enum.rst:577

msgid ""

"The enum members. This can be a whitespace- or comma-separated string "

"(values will start at 1 unless otherwise specified)::"

msgstr ""

#: howto/enum.rst:582

msgid "or an iterator of names::"

msgstr ""

#: howto/enum.rst:586

msgid "or an iterator of (name, value) pairs::"

msgstr ""

#: howto/enum.rst:590

msgid "or a mapping::"

msgstr ""

#: howto/enum.rst:0

msgid "module"

msgstr ""

#: howto/enum.rst:594

msgid "name of module where new enum class can be found."

msgstr ""

#: howto/enum.rst:0

msgid "qualname"

msgstr ""

#: howto/enum.rst:596

msgid "where in module new enum class can be found."

msgstr ""

#: howto/enum.rst:0

msgid "type"

msgstr ""

#: howto/enum.rst:598

msgid "type to mix in to new enum class."

msgstr ""

#: howto/enum.rst:0

msgid "start"

msgstr ""

#: howto/enum.rst:600

msgid "number to start counting at if only names are passed in."

msgstr ""

#: howto/enum.rst:602

msgid "The *start* parameter was added."

msgstr ""

#: howto/enum.rst:607

msgid "Derived Enumerations"

msgstr ""

#: howto/enum.rst:610

msgid "IntEnum"

msgstr ""

#: howto/enum.rst:612

msgid ""

"The first variation of :class:`Enum` that is provided is also a subclass of :"

"class:`int`. Members of an :class:`IntEnum` can be compared to integers; by "

"extension, integer enumerations of different types can also be compared to "

"each other::"

msgstr ""

#: howto/enum.rst:633

msgid ""

"However, they still can't be compared to standard :class:`Enum` "

"enumerations::"

msgstr ""

#: howto/enum.rst:646

msgid ""

":class:`IntEnum` values behave like integers in other ways you'd expect::"

msgstr ""

#: howto/enum.rst:657

msgid "StrEnum"

msgstr ""

#: howto/enum.rst:659

msgid ""

"The second variation of :class:`Enum` that is provided is also a subclass "

"of :class:`str`. Members of a :class:`StrEnum` can be compared to strings; "

"by extension, string enumerations of different types can also be compared to "

"each other."

msgstr ""

#: howto/enum.rst:668

msgid "IntFlag"

msgstr ""

#: howto/enum.rst:670

msgid ""

"The next variation of :class:`Enum` provided, :class:`IntFlag`, is also "

"based on :class:`int`. The difference being :class:`IntFlag` members can be "

"combined using the bitwise operators (&, \\|, ^, ~) and the result is still "

"an :class:`IntFlag` member, if possible. Like :class:`IntEnum`, :class:"

"`IntFlag` members are also integers and can be used wherever an :class:`int` "

"is used."

msgstr ""

#: howto/enum.rst:678

msgid ""

"Any operation on an :class:`IntFlag` member besides the bit-wise operations "

"will lose the :class:`IntFlag` membership."

msgstr ""

#: howto/enum.rst:681

msgid ""

"Bit-wise operations that result in invalid :class:`IntFlag` values will lose "

"the :class:`IntFlag` membership. See :class:`FlagBoundary` for details."

msgstr ""

#: howto/enum.rst:688

msgid "Sample :class:`IntFlag` class::"

msgstr ""

#: howto/enum.rst:704

msgid "It is also possible to name the combinations::"

msgstr ""

#: howto/enum.rst:720

msgid ""

"Named combinations are considered aliases. Aliases do not show up during "

"iteration, but can be returned from by-value lookups."

msgstr ""

#: howto/enum.rst:725

msgid ""

"Another important difference between :class:`IntFlag` and :class:`Enum` is "

"that if no flags are set (the value is 0), its boolean evaluation is :data:"

"`False`::"

msgstr ""

#: howto/enum.rst:733

msgid ""

"Because :class:`IntFlag` members are also subclasses of :class:`int` they "

"can be combined with them (but may lose :class:`IntFlag` membership::"

msgstr ""

#: howto/enum.rst:744

msgid ""

"The negation operator, ``~``, always returns an :class:`IntFlag` member with "

"a positive value::"

msgstr ""

#: howto/enum.rst:750

msgid ":class:`IntFlag` members can also be iterated over::"

msgstr ""

#: howto/enum.rst:759

msgid "Flag"

msgstr ""

#: howto/enum.rst:761

msgid ""

"The last variation is :class:`Flag`. Like :class:`IntFlag`, :class:`Flag` "

"members can be combined using the bitwise operators (&, \\|, ^, ~). Unlike :"

"class:`IntFlag`, they cannot be combined with, nor compared against, any "

"other :class:`Flag` enumeration, nor :class:`int`. While it is possible to "

"specify the values directly it is recommended to use :class:`auto` as the "

"value and let :class:`Flag` select an appropriate value."

msgstr ""

#: howto/enum.rst:770

msgid ""

"Like :class:`IntFlag`, if a combination of :class:`Flag` members results in "

"no flags being set, the boolean evaluation is :data:`False`::"

msgstr ""

#: howto/enum.rst:784

msgid ""

"Individual flags should have values that are powers of two (1, 2, 4, "

"8, ...), while combinations of flags will not::"

msgstr ""

#: howto/enum.rst:796

msgid ""

"Giving a name to the \"no flags set\" condition does not change its boolean "

"value::"

msgstr ""

#: howto/enum.rst:810

msgid ":class:`Flag` members can also be iterated over::"

msgstr ""

#: howto/enum.rst:820

msgid ""

"For the majority of new code, :class:`Enum` and :class:`Flag` are strongly "

"recommended, since :class:`IntEnum` and :class:`IntFlag` break some semantic "

"promises of an enumeration (by being comparable to integers, and thus by "

"transitivity to other unrelated enumerations). :class:`IntEnum` and :class:"

"`IntFlag` should be used only in cases where :class:`Enum` and :class:`Flag` "

"will not do; for example, when integer constants are replaced with "

"enumerations, or for interoperability with other systems."

msgstr ""

#: howto/enum.rst:830

msgid "Others"

msgstr ""

#: howto/enum.rst:832

msgid ""

"While :class:`IntEnum` is part of the :mod:`enum` module, it would be very "

"simple to implement independently::"

msgstr ""

#: howto/enum.rst:838

msgid ""

"This demonstrates how similar derived enumerations can be defined; for "

"example a :class:`FloatEnum` that mixes in :class:`float` instead of :class:"

"`int`."

msgstr ""

#: howto/enum.rst:841

msgid "Some rules:"

msgstr ""

#: howto/enum.rst:843

msgid ""

"When subclassing :class:`Enum`, mix-in types must appear before :class:"

"`Enum` itself in the sequence of bases, as in the :class:`IntEnum` example "

"above."

msgstr ""

#: howto/enum.rst:846

msgid ""

"Mix-in types must be subclassable. For example, :class:`bool` and :class:"

"`range` are not subclassable and will throw an error during Enum creation if "

"used as the mix-in type."

msgstr ""

#: howto/enum.rst:849

msgid ""

"While :class:`Enum` can have members of any type, once you mix in an "

"additional type, all the members must have values of that type, e.g. :class:"

"`int` above. This restriction does not apply to mix-ins which only add "

"methods and don't specify another type."

msgstr ""

#: howto/enum.rst:853

msgid ""

"When another data type is mixed in, the :attr:`value` attribute is *not the "

"same* as the enum member itself, although it is equivalent and will compare "

"equal."

msgstr ""

#: howto/enum.rst:856

msgid "A ``data type`` is a mixin that defines :meth:`__new__`."

msgstr ""

#: howto/enum.rst:857

msgid ""

"%-style formatting: ``%s`` and ``%r`` call the :class:`Enum` class's :meth:"

"`__str__` and :meth:`__repr__` respectively; other codes (such as ``%i`` or "

"``%h`` for IntEnum) treat the enum member as its mixed-in type."

msgstr ""

#: howto/enum.rst:860

msgid ""

":ref:`Formatted string literals <f-strings>`, :meth:`str.format`, and :func:"

"`format` will use the enum's :meth:`__str__` method."

msgstr ""

#: howto/enum.rst:865

msgid ""

"Because :class:`IntEnum`, :class:`IntFlag`, and :class:`StrEnum` are "

"designed to be drop-in replacements for existing constants, their :meth:"

"`__str__` method has been reset to their data types' :meth:`__str__` method."

msgstr ""

#: howto/enum.rst:873

msgid "When to use :meth:`__new__` vs. :meth:`__init__`"

msgstr ""

#: howto/enum.rst:875

msgid ""

":meth:`__new__` must be used whenever you want to customize the actual value "

"of the :class:`Enum` member. Any other modifications may go in either :meth:"

"`__new__` or :meth:`__init__`, with :meth:`__init__` being preferred."

msgstr ""

#: howto/enum.rst:879

msgid ""

"For example, if you want to pass several items to the constructor, but only "

"want one of them to be the value::"

msgstr ""

#: howto/enum.rst:906

msgid ""

"*Do not* call ``super().__new__()``, as the lookup-only ``__new__`` is the "

"one that is found; instead, use the data type directly."

msgstr ""

#: howto/enum.rst:911

msgid "Finer Points"

msgstr ""

#: howto/enum.rst:914

msgid "Supported ``__dunder__`` names"

msgstr ""

#: howto/enum.rst:916

msgid ""

":attr:`__members__` is a read-only ordered mapping of ``member_name``:"

"``member`` items. It is only available on the class."

msgstr ""

#: howto/enum.rst:919

msgid ""

":meth:`__new__`, if specified, must create and return the enum members; it "

"is also a very good idea to set the member's :attr:`_value_` appropriately. "

"Once all the members are created it is no longer used."

msgstr ""

#: howto/enum.rst:925

msgid "Supported ``_sunder_`` names"

msgstr ""

#: howto/enum.rst:927

msgid "``_name_`` -- name of the member"

msgstr ""

#: howto/enum.rst:928

msgid ""

"``_value_`` -- value of the member; can be set / modified in ``__new__``"

msgstr ""

#: howto/enum.rst:930

msgid ""

"``_missing_`` -- a lookup function used when a value is not found; may be "

"overridden"

msgstr ""

#: howto/enum.rst:932

msgid ""

"``_ignore_`` -- a list of names, either as a :class:`list` or a :class:"

"`str`, that will not be transformed into members, and will be removed from "

"the final class"

msgstr ""

#: howto/enum.rst:935

msgid ""

"``_order_`` -- used in Python 2/3 code to ensure member order is consistent "

"(class attribute, removed during class creation)"

msgstr ""

#: howto/enum.rst:937

msgid ""

"``_generate_next_value_`` -- used by the `Functional API`_ and by :class:"

"`auto` to get an appropriate value for an enum member; may be overridden"

msgstr ""

#: howto/enum.rst:943

msgid ""

"For standard :class:`Enum` classes the next value chosen is the last value "

"seen incremented by one."

msgstr ""

#: howto/enum.rst:946

msgid ""

"For :class:`Flag` classes the next value chosen will be the next highest "

"power-of-two, regardless of the last value seen."

msgstr ""

#: howto/enum.rst:949

msgid "``_missing_``, ``_order_``, ``_generate_next_value_``"

msgstr ""

#: howto/enum.rst:950

msgid "``_ignore_``"

msgstr ""

#: howto/enum.rst:952

msgid ""

"To help keep Python 2 / Python 3 code in sync an :attr:`_order_` attribute "

"can be provided. It will be checked against the actual order of the "

"enumeration and raise an error if the two do not match::"

msgstr ""

#: howto/enum.rst:970

msgid ""

"In Python 2 code the :attr:`_order_` attribute is necessary as definition "

"order is lost before it can be recorded."

msgstr ""

#: howto/enum.rst:975

msgid "_Private__names"

msgstr ""

#: howto/enum.rst:977

msgid ""

":ref:`Private names <private-name-mangling>` are not converted to enum "

"members, but remain normal attributes."

msgstr ""

#: howto/enum.rst:984

msgid "``Enum`` member type"

msgstr ""

#: howto/enum.rst:986

msgid ""

"Enum members are instances of their enum class, and are normally accessed as "

"``EnumClass.member``. In certain situations, such as writing custom enum "

"behavior, being able to access one member directly from another is useful, "

"and is supported."

msgstr ""

#: howto/enum.rst:995

msgid "Creating members that are mixed with other data types"

msgstr ""

#: howto/enum.rst:997

msgid ""

"When subclassing other data types, such as :class:`int` or :class:`str`, "

"with an :class:`Enum`, all values after the ``=`` are passed to that data "

"type's constructor. For example::"

msgstr ""

#: howto/enum.rst:1009

msgid "Boolean value of ``Enum`` classes and members"

msgstr ""

#: howto/enum.rst:1011

msgid ""

"Enum classes that are mixed with non-:class:`Enum` types (such as :class:"

"`int`, :class:`str`, etc.) are evaluated according to the mixed-in type's "

"rules; otherwise, all members evaluate as :data:`True`. To make your own "

"enum's boolean evaluation depend on the member's value add the following to "

"your class::"

msgstr ""

#: howto/enum.rst:1020

msgid "Plain :class:`Enum` classes always evaluate as :data:`True`."

msgstr ""

#: howto/enum.rst:1024

msgid "``Enum`` classes with methods"

msgstr ""

#: howto/enum.rst:1026

msgid ""

"If you give your enum subclass extra methods, like the `Planet`_ class "

"below, those methods will show up in a :func:`dir` of the member, but not of "

"the class::"

msgstr ""

#: howto/enum.rst:1037

msgid "Combining members of ``Flag``"

msgstr ""

#: howto/enum.rst:1039

msgid ""

"Iterating over a combination of :class:`Flag` members will only return the "

"members that are comprised of a single bit::"

msgstr ""

#: howto/enum.rst:1057

msgid "``Flag`` and ``IntFlag`` minutia"

msgstr ""

#: howto/enum.rst:1059

msgid "Using the following snippet for our examples::"

msgstr ""

#: howto/enum.rst:1070

msgid "the following are true:"

msgstr ""

#: howto/enum.rst:1072

msgid "single-bit flags are canonical"

msgstr ""

#: howto/enum.rst:1073

msgid "multi-bit and zero-bit flags are aliases"

msgstr ""

#: howto/enum.rst:1074

msgid "only canonical flags are returned during iteration::"

msgstr ""

#: howto/enum.rst:1079

msgid ""

"negating a flag or flag set returns a new flag/flag set with the "

"corresponding positive integer value::"

msgstr ""

#: howto/enum.rst:1088

msgid "names of pseudo-flags are constructed from their members' names::"

msgstr ""

#: howto/enum.rst:1093

msgid "multi-bit flags, aka aliases, can be returned from operations::"

msgstr ""

#: howto/enum.rst:1104

msgid ""

"membership / containment checking: zero-valued flags are always considered "

"to be contained::"

msgstr ""

#: howto/enum.rst:1110

msgid ""

"otherwise, only if all bits of one flag are in the other flag will True be "

"returned::"

msgstr ""

#: howto/enum.rst:1119

msgid ""

"There is a new boundary mechanism that controls how out-of-range / invalid "

"bits are handled: ``STRICT``, ``CONFORM``, ``EJECT``, and ``KEEP``:"

msgstr ""

#: howto/enum.rst:1122

msgid "STRICT --> raises an exception when presented with invalid values"

msgstr ""

#: howto/enum.rst:1123

msgid "CONFORM --> discards any invalid bits"

msgstr ""

#: howto/enum.rst:1124