{"id":15017292,"url":"https://github.com/hexfusion/perl-net-etcd","last_synced_at":"2025-04-09T19:42:16.808Z","repository":{"id":145269946,"uuid":"92765242","full_name":"hexfusion/perl-net-etcd","owner":"hexfusion","description":"Net::Etcd etcd v3 gRPC-gateway Perl client","archived":false,"fork":false,"pushed_at":"2024-11-04T14:02:59.000Z","size":242,"stargazers_count":10,"open_issues_count":3,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-23T21:35:54.501Z","etag":null,"topics":["etcd","etcd-client","etcdv3","grpc-gateway","perl","perl5"],"latest_commit_sha":null,"homepage":"https://metacpan.org/release/Net-Etcd","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hexfusion.png","metadata":{"files":{"readme":"README","changelog":"Changes","contributing":null,"funding":null,"license":null,"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":"2017-05-29T18:28:44.000Z","updated_at":"2024-11-04T14:03:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"f1cd4034-27f3-4f02-aac8-dbd95d5ccbb5","html_url":"https://github.com/hexfusion/perl-net-etcd","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexfusion%2Fperl-net-etcd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexfusion%2Fperl-net-etcd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexfusion%2Fperl-net-etcd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexfusion%2Fperl-net-etcd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hexfusion","download_url":"https://codeload.github.com/hexfusion/perl-net-etcd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248100980,"owners_count":21047883,"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":["etcd","etcd-client","etcdv3","grpc-gateway","perl","perl5"],"created_at":"2024-09-24T19:50:16.190Z","updated_at":"2025-04-09T19:42:16.800Z","avatar_url":"https://github.com/hexfusion.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"NAME\n    Net::Etcd - etcd v3 REST API.\n\nSYNOPSIS\n        Etcd v3.1.0 or greater is required.   To use the v3 API make sure to set environment\n        variable ETCDCTL_API=3.  Precompiled binaries can be downloaded at https://github.com/etcd-io/etcd/releases.\n\n        $etcd = Net::Etcd-\u003enew(); # host: 127.0.0.1 port: 2379\n        $etcd = Net::Etcd-\u003enew({ host =\u003e $host, port =\u003e $port, ssl =\u003e 1 });\n\n        # put key\n        $put_key = $etcd-\u003eput({ key =\u003e'foo1', value =\u003e 'bar' });\n\n        # check for success of a transaction\n        $put_key-\u003eis_success;\n\n        # get single key\n        $key = $etcd-\u003erange({ key =\u003e'test0' });\n\n        # return single key value or the first in a list.\n        $key-\u003eget_value\n\n        # get range of keys\n        $range = $etcd-\u003erange({ key =\u003e'test0', range_end =\u003e 'test100' });\n\n        # return array { key =\u003e value } pairs from range request.\n        my @users = $range-\u003eall\n\n        # delete single key\n        $etcd-\u003edeleterange({ key =\u003e 'test0' });\n\n        # watch key range, streaming.\n        $watch = $etcd-\u003ewatch( { key =\u003e 'foo', range_end =\u003e 'fop'}, sub {\n            my ($result) =  @_;\n            print STDERR Dumper($result);\n        })-\u003ecreate;\n\n        # create/grant 20 second lease\n        $etcd-\u003elease( { ID =\u003e 7587821338341002662, TTL =\u003e 20 } )-\u003egrant;\n\n        # attach lease to put\n        $etcd-\u003eput( { key =\u003e 'foo2', value =\u003e 'bar2', lease =\u003e 7587821338341002662 } );\n\n        # add new user\n        $etcd-\u003euser( { name =\u003e 'samba', password =\u003e 'foo' } )-\u003eadd;\n\n        # add new user role\n        $role = $etcd-\u003erole( { name =\u003e 'myrole' } )-\u003eadd;\n\n        # grant read permission for the foo key to myrole\n        $etcd-\u003erole_perm( { name =\u003e 'myrole', key =\u003e 'foo', permType =\u003e 'READWRITE' } )-\u003egrant;\n\n        # grant role\n        $etcd-\u003euser_role( { user =\u003e 'samba', role =\u003e 'myrole' } )-\u003egrant;\n\n        # defrag member's backend database\n        $defrag = $etcd-\u003emaintenance()-\u003edefragment;\n        print \"Defrag request complete!\" if $defrag-\u003eis_success;\n\n        # member version\n        $v = $etcd-\u003eversion;\n\n        # list members\n        $etcd-\u003emember()-\u003elist;\n\nDESCRIPTION\n    Net::Etcd is object oriented interface to the v3 REST API provided by\n    the etcd grpc-gateway \u003chttps://github.com/grpc-ecosystem/grpc-gateway\u003e.\n\nACCESSORS\n  host\n    The etcd host. Defaults to 127.0.0.1\n\n  port\n    Default 2379.\n\n  name\n    Username for authentication, defaults to $ENV{ETCD_CLIENT_USERNAME}\n\n  password\n    Authentication credentials, defaults to $ENV{ETCD_CLIENT_PASSWORD}\n\n  ca_file\n    Path to ca_file, defaults to $ENV{ETCD_CLIENT_CA_FILE}\n\n  key_file\n    Path to key_file, defaults to $ENV{ETCD_CLIENT_KEY_FILE}\n\n  cert_file\n    Path to cert_file, defaults to $ENV{ETCD_CLIENT_CERT_FILE}\n\n  cacert\n    Path to cacert, defaults to $ENV{ETCD_CLIENT_CACERT_FILE}.\n\n  ssl\n    To enable set to 1\n\n  api_version\n    defaults to /v3beta\n\n  api_path\n    The full api path. Defaults to http://127.0.0.1:2379/v3alpha\n\n  auth_token\n    The token that is passed during authentication. This is generated during\n    the authentication process and stored until no longer valid or username\n    is changed.\n\nPUBLIC METHODS\n  version\n    Returns the etcd member version\n\n        $etcd-\u003eversion()\n\n  watch\n    See Net::Etcd::Watch\n\n        $etcd-\u003ewatch({ key =\u003e'foo', range_end =\u003e 'fop' })\n\n  role\n    See Net::Etcd::Auth::Role\n\n        $etcd-\u003erole({ role =\u003e 'foo' });\n\n  role_perm\n    See Net::Etcd::Auth::RolePermission\n\n    Grants or revoke permission of a specified key or range to a specified\n    role.\n\n        $etcd-\u003erole_perm(\n            { name =\u003e 'myrole', key =\u003e 'bar', permType =\u003e 'READ', prefix =\u003e 1 } )-\u003egrant;\n\n  user_role\n    See Net::Etcd::User::Role\n\n        $etcd-\u003euser_role({ name =\u003e 'samba', role =\u003e 'foo' });\n\n  auth\n    See Net::Etcd::Auth\n\n        $etcd-\u003eauth({ name =\u003e 'samba', password =\u003e 'foo' })-\u003eauthenticate;\n        $etcd-\u003eauth()-\u003eenable;\n        $etcd-\u003eauth()-\u003edisable\n\n  lease\n    See Net::Etcd::Lease\n\n        $etcd-\u003elease( { ID =\u003e 7587821338341002662, TTL =\u003e 20 } )-\u003egrant;\n\n  maintenance\n    See Net::Etcd::Maintenance\n\n        $etcd-\u003emaintenance()-\u003esnapshot\n\n  member\n    See Net::Etcd::Member\n\n        $etcd-\u003emember()-\u003elist\n\n  user\n    See Net::Etcd::User\n\n        $etcd-\u003euser( { name =\u003e 'samba', password =\u003e 'foo' } )-\u003eadd;\n\n  put\n    See Net::Etcd::KV::Put\n\n        $etcd-\u003eput({ key =\u003e'foo1', value =\u003e 'bar' });\n\n  deleterange\n    See Net::Etcd::KV::DeleteRange\n\n        $etcd-\u003edeleterange({ key=\u003e'test0' });\n\n  range\n    See Net::Etcd::KV::Range\n\n        $etcd-\u003erange({ key =\u003e'test0', range_end =\u003e 'test100' });\n\n  txn\n    See Net::Etcd::KV::Txn\n\n        $etcd-\u003etxn({ compare =\u003e \\@compare, success =\u003e \\@op });\n\n  op\n    See Net::Etcd::KV::Op\n\n        $etcd-\u003eop({ request_put =\u003e $put });\n        $etcd-\u003eop({ request_delete_range =\u003e $range });\n\n  compare\n    See Net::Etcd::KV::Compare\n\n        $etcd-\u003ecompare( { key =\u003e 'foo', result =\u003e 'EQUAL', target =\u003e 'VALUE', value =\u003e 'baz' });\n        $etcd-\u003ecompare( { key =\u003e 'foo', target =\u003e 'CREATE', result =\u003e 'NOT_EQUAL', create_revision =\u003e '2' });\n\n  configuration\n    Initialize configuration checks to see if etcd is installed locally.\n\nAUTHOR\n    Sam Batschelet (hexfusion)\n\nCONTRIBUTORS\n    Ananth Kavuri Michael Fung\n\nACKNOWLEDGEMENTS\n    The etcd \u003chttps://github.com/etcd-io/etcd\u003e developers and community.\n\nCAVEATS\n    The etcd \u003chttps://github.com/etcd-io/etcd\u003e v3 API is in heavy development\n    and can change at anytime please see api_reference_v3\n    \u003chttps://github.com/etcd-io/etcd/blob/master/Documentation/dev-guide/api_\n    reference_v3.md\u003e for latest details.\n\n    Authentication provided by this module will only work with etcd v3.3.0+\n\nLICENSE AND COPYRIGHT\n    Copyright 2018 Sam Batschelet (hexfusion).\n\n    This program is free software; you can redistribute it and/or modify it\n    under the terms of either: the GNU General Public License as published\n    by the Free Software Foundation; or the Artistic License.\n\n    See http://dev.perl.org/licenses/ for more information.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhexfusion%2Fperl-net-etcd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhexfusion%2Fperl-net-etcd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhexfusion%2Fperl-net-etcd/lists"}