{"id":16683366,"url":"https://github.com/ellpeck/dynamicenums","last_synced_at":"2026-02-15T10:02:04.987Z","repository":{"id":62360286,"uuid":"559915346","full_name":"Ellpeck/DynamicEnums","owner":"Ellpeck","description":"Enum-like single-instance values with additional capabilities, including dynamic addition of new arbitrary values and flags","archived":false,"fork":false,"pushed_at":"2024-08-12T20:53:56.000Z","size":79,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-20T23:37:23.719Z","etag":null,"topics":["bigint","biginteger","dynamic","enum","enumeration","long"],"latest_commit_sha":null,"homepage":"https://www.nuget.org/packages/DynamicEnums","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ellpeck.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-31T11:17:59.000Z","updated_at":"2024-08-12T20:54:00.000Z","dependencies_parsed_at":"2024-11-19T07:16:55.379Z","dependency_job_id":null,"html_url":"https://github.com/Ellpeck/DynamicEnums","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ellpeck%2FDynamicEnums","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ellpeck%2FDynamicEnums/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ellpeck%2FDynamicEnums/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ellpeck%2FDynamicEnums/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ellpeck","download_url":"https://codeload.github.com/Ellpeck/DynamicEnums/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234757922,"owners_count":18882082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bigint","biginteger","dynamic","enum","enumeration","long"],"created_at":"2024-10-12T14:24:18.308Z","updated_at":"2026-02-15T10:01:59.913Z","avatar_url":"https://github.com/Ellpeck.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DynamicEnums\nEnum-like single-instance values with additional capabilities, including dynamic addition of new arbitrary values and flags\n\nA dynamic enum uses `BigInteger` as its underlying type, allowing for an arbitrary number of enum values to be created, even when a `Flags`-like structure is used that would only allow for up to 64 values in a regular enum. All boolean operations including `And\u003cT\u003e(T, T)`, `Or\u003cT\u003e(T, T)`, `Xor\u003cT\u003e(T, T)` and `Neg\u003cT\u003e(T)` are supported and can be implemented in derived classes using operator overloads.\n\n## Setting it up\nTo create a custom dynamic enum, simply create a class that extends `DynamicEnum`. New values can then be added using `Add\u003cT\u003e(string, BigInteger)`, `AddValue\u003cT\u003e(string)` or `AddFlag\u003cT\u003e(string)`. In this example, they are added as static values in the class itself, but they can be added from anywhere.\n\n```cs\npublic class MyEnum : DynamicEnum {\n \n    // adding specifically defined values\n    public static readonly MyEnum ValueOne = DynamicEnum.Add\u003cMyEnum\u003e(\"ValueOne\", 1);\n    public static readonly MyEnum ValueTwo = DynamicEnum.Add\u003cMyEnum\u003e(\"ValueTwo\", 2);\n    public static readonly MyEnum ValueThree = DynamicEnum.Add\u003cMyEnum\u003e(\"ValueThree\", 3);\n    \n    // adding flags, which automatically uses the next available power of two as its value\n    public static readonly MyEnum FlagOne = DynamicEnum.AddFlag\u003cMyEnum\u003e(\"FlagOne\");\n    public static readonly MyEnum FlagTwo = DynamicEnum.AddFlag\u003cMyEnum\u003e(\"FlagTwo\");\n    public static readonly MyEnum FlagThree = DynamicEnum.AddFlag\u003cMyEnum\u003e(\"FlagThree\");\n \n    // you can optionally create operator overloads for easier operations\n    public static implicit operator BigInteger(MyEnum value) =\u003e DynamicEnum.GetValue(value);\n    public static implicit operator MyEnum(BigInteger value) =\u003e DynamicEnum.GetEnumValue\u003cMyEnum\u003e(value);\n    public static MyEnum operator |(MyEnum left, MyEnum right) =\u003e DynamicEnum.Or(left, right);\n    public static MyEnum operator \u0026(MyEnum left, MyEnum right) =\u003e DynamicEnum.And(left, right);\n    public static MyEnum operator ^(MyEnum left, MyEnum right) =\u003e DynamicEnum.Xor(left, right);\n    public static MyEnum operator ~(MyEnum value) =\u003e DynamicEnum.Neg(value);\n}\n```\n\n## Using it\nDynamic enums work very similarly to regular enums in how you use them, and each operation us optimized through an internal cache. Here are some examples of interactions with the dynamic enum we created above.\n\n```cs\n// getting the underlying value\nBigInteger val1 = DynamicEnum.GetValue(MyEnum.FlagTwo); // using GetValue\nBigInteger val2 = (BigInteger) MyEnum.FlagTwo; // using our operator overloads\n\n// creating a combined flag\nMyEnum allFlags1 = DynamicEnum.Or(MyEnum.FlagOne, DynamicEnum.Or(MyEnum.FlagTwo, MyEnum.FlagThree)); // using Or\nMyEnum allFlags2 = MyEnum.FlagOne | MyEnum.FlagTwo | MyEnum.FlagThree; // using our operator overloads\nMyEnum mixedFlags = DynamicEnum.Or(MyEnum.FlagOne, DynamicEnum.GetEnumValue\u003cMyEnum\u003e(17)); // using non-defined values in our combined flags\n\n// querying flag information\nbool hasAny = allFlags1.HasAnyFlags(MyEnum.FlagOne | MyEnum.ValueOne); // true\nbool hasAll = allFlags1.HasAllFlags(MyEnum.FlagOne | MyEnum.ValueOne); // false\n\n// displaying a dynamic enum value or flag\nConsole.WriteLine(MyEnum.FlagOne); // \"FlagOne\"\nConsole.WriteLine(allFlags1); // \"FlagOne, FlagTwo, FlagThree\"\n\n// parsing a dynamic enum value\nMyEnum parsed1 = DynamicEnum.Parse\u003cMyEnum\u003e(\"FlagOne\");\nMyEnum parsed2 = DynamicEnum.Parse\u003cMyEnum\u003e(\"FlagOne, FlagThree\");\n```\n\nYou can also check out [the tests](https://github.com/Ellpeck/DynamicEnums/tree/main/Tests) for some more complex examples.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fellpeck%2Fdynamicenums","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fellpeck%2Fdynamicenums","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fellpeck%2Fdynamicenums/lists"}