zeroc-ice 3.7.11__cp314-cp314-win_amd64.whl

slice/IceStorm/IceStorm.ice

@@ -0,0 +1,414 @@
+//
+// Copyright (c) ZeroC, Inc. All rights reserved.
+//
+
+#pragma once
+
+[["cpp:dll-export:ICESTORM_API"]]
+[["cpp:doxygen:include:IceStorm/IceStorm.h"]]
+[["cpp:header-ext:h"]]
+[["cpp:include:IceStorm/Config.h"]]
+
+[["ice-prefix"]]
+
+[["js:module:ice"]]
+[["js:cjs-module"]]
+
+[["objc:dll-export:ICESTORM_API"]]
+[["objc:header-dir:objc"]]
+
+[["python:pkgdir:IceStorm"]]
+
+#include <Ice/Identity.ice>
+#include <Ice/SliceChecksumDict.ice>
+
+#include <IceStorm/Metrics.ice>
+
+#ifndef __SLICE2JAVA_COMPAT__
+[["java:package:com.zeroc"]]
+#endif
+
+/**
+ *
+ * A messaging service with support for federation. In contrast to
+ * most other messaging or event services, IceStorm supports typed
+ * events, meaning that broadcasting a message over a federation is as
+ * easy as invoking a method on an interface.
+ *
+ **/
+["objc:prefix:ICESTORM"]
+module IceStorm
+{
+
+interface Topic;
+
+/**
+ *
+ * Information on the topic links.
+ *
+ **/
+struct LinkInfo
+{
+    /**
+     *
+     * The linked topic.
+     *
+     **/
+    Topic* theTopic;
+
+    /**
+     *
+     * The name of the linked topic.
+     *
+     **/
+    string name;
+
+    /**
+     *
+     * The cost of traversing this link.
+     *
+     **/
+    int cost;
+}
+
+/**
+ *
+ * A sequence of {@link LinkInfo} objects.
+ *
+ **/
+sequence<LinkInfo> LinkInfoSeq;
+
+/**
+ *
+ * This dictionary represents quality of service parameters.
+ *
+ * @see Topic#subscribeAndGetPublisher
+ *
+ */
+dictionary<string, string> QoS;
+
+/**
+ *
+ * This exception indicates that an attempt was made to create a link
+ * that already exists.
+ *
+ **/
+exception LinkExists
+{
+    /**
+     *
+     * The name of the linked topic.
+     *
+     */
+    string name;
+}
+
+/**
+ *
+ * This exception indicates that an attempt was made to remove a
+ * link that does not exist.
+ *
+ **/
+exception NoSuchLink
+{
+    /**
+     *
+     * The name of the link that does not exist.
+     *
+     */
+    string name;
+}
+
+/**
+ *
+ * This exception indicates that an attempt was made to subscribe
+ * a proxy for which a subscription already exists.
+ *
+ **/
+exception AlreadySubscribed
+{
+}
+
+/**
+ *
+ * This exception indicates that an attempt was made to subscribe
+ * a proxy that is null.
+ *
+ **/
+exception InvalidSubscriber
+{
+    /**
+     *
+     * The reason for the failure.
+     *
+     **/
+    string reason;
+}
+
+/**
+ *
+ * This exception indicates that a subscription failed due to an
+ * invalid QoS.
+ *
+ **/
+exception BadQoS
+{
+    /**
+     *
+     * The reason for the failure.
+     *
+     **/
+    string reason;
+}
+
+/**
+ *
+ * Publishers publish information on a particular topic. A topic
+ * logically represents a type.
+ *
+ * @see TopicManager
+ *
+ **/
+interface Topic
+{
+    /**
+     *
+     * Get the name of this topic.
+     *
+     * @return The name of the topic.
+     *
+     * @see TopicManager#create
+     *
+     **/
+    ["nonmutating", "cpp:const"] idempotent string getName();
+
+    /**
+     *
+     * Get a proxy to a publisher object for this topic. To publish
+     * data to a topic, the publisher calls getPublisher and then
+     * casts to the topic type. An unchecked cast must be used on this
+     * proxy. If a replicated IceStorm deployment is used this call
+     * may return a replicated proxy.
+     *
+     * @return A proxy to publish data on this topic.
+     *
+     **/
+    ["nonmutating", "cpp:const"] idempotent Object* getPublisher();
+
+    /**
+     *
+     * Get a non-replicated proxy to a publisher object for this
+     * topic. To publish data to a topic, the publisher calls
+     * getPublisher and then casts to the topic type. An unchecked
+     * cast must be used on this proxy.
+     *
+     * @return A proxy to publish data on this topic.
+     *
+     **/
+    ["nonmutating", "cpp:const"] idempotent Object* getNonReplicatedPublisher();
+
+    /**
+     *
+     * Subscribe with the given <code>qos</code> to this topic.  A
+     * per-subscriber publisher object is returned.
+     *
+     * @param theQoS The quality of service parameters for this
+     * subscription.
+     *
+     * @param subscriber The subscriber's proxy.
+     *
+     * @return The per-subscriber publisher object.
+     *
+     * @throws AlreadySubscribed Raised if the subscriber object is
+     * already subscribed.
+     *
+     * @throws InvalidSubscriber Raised if the subscriber object is null.
+     *
+     * @throws BadQoS Raised if the requested quality of service
+     * is unavailable or invalid.
+     *
+     * @see #unsubscribe
+     *
+     **/
+    Object* subscribeAndGetPublisher(QoS theQoS, Object* subscriber)
+        throws AlreadySubscribed, InvalidSubscriber, BadQoS;
+
+    /**
+     *
+     * Unsubscribe the given <code>subscriber</code>.
+     *
+     * @param subscriber The proxy of an existing subscriber.
+     *
+     * @see #subscribeAndGetPublisher
+     *
+     **/
+    idempotent void unsubscribe(Object* subscriber);
+
+    /**
+     *
+     * Create a link to the given topic. All events originating
+     * on this topic will also be sent to <code>linkTo</code>.
+     *
+     * @param linkTo The topic to link to.
+     *
+     * @param cost The cost to the linked topic.
+     *
+     * @throws LinkExists Raised if a link to the same topic already
+     * exists.
+     *
+     **/
+    void link(Topic* linkTo, int cost) throws LinkExists;
+
+    /**
+     *
+     * Destroy the link from this topic to the given topic <code>linkTo</code>.
+     *
+     * @param linkTo The topic to destroy the link to.
+     *
+     * @throws NoSuchLink Raised if a link to the topic does not exist.
+     *
+     **/
+    void unlink(Topic* linkTo) throws NoSuchLink;
+
+    /**
+     *
+     * Retrieve information on the current links.
+     *
+     * @return A sequence of LinkInfo objects.
+     *
+     **/
+    ["nonmutating", "cpp:const"] idempotent LinkInfoSeq getLinkInfoSeq();
+
+    /**
+     *
+     * Retrieve the list of subscribers for this topic.
+     *
+     * @return The sequence of Ice identities for the subscriber objects.
+     *
+     **/
+    ["nonmutating", "cpp:const"] Ice::IdentitySeq getSubscribers();
+
+    /**
+     *
+     * Destroy the topic.
+     *
+     **/
+    void destroy();
+}
+
+/**
+ *
+ * Mapping of topic name to topic proxy.
+ *
+ **/
+dictionary<string, Topic*> TopicDict;
+
+/**
+ *
+ * This exception indicates that an attempt was made to create a topic
+ * that already exists.
+ *
+ **/
+exception TopicExists
+{
+    /**
+     *
+     * The name of the topic that already exists.
+     *
+     */
+    string name;
+}
+
+/**
+ *
+ * This exception indicates that an attempt was made to retrieve a
+ * topic that does not exist.
+ *
+ **/
+exception NoSuchTopic
+{
+    /**
+     *
+     * The name of the topic that does not exist.
+     *
+     */
+    string name;
+}
+
+/**
+ *
+ * A topic manager manages topics, and subscribers to topics.
+ *
+ * @see Topic
+ *
+ **/
+interface TopicManager
+{
+    /**
+     *
+     * Create a new topic. The topic name must be unique.
+     *
+     * @param name The name of the topic.
+     *
+     * @return A proxy to the topic instance.
+     *
+     * @throws TopicExists Raised if a topic with the same name already
+     * exists.
+     *
+     **/
+    Topic* create(string name) throws TopicExists;
+
+    /**
+     *
+     * Retrieve a topic by name.
+     *
+     * @param name The name of the topic.
+     *
+     * @return A proxy to the topic instance.
+     *
+     * @throws NoSuchTopic Raised if the topic does not exist.
+     *
+     **/
+    ["nonmutating", "cpp:const"] idempotent Topic* retrieve(string name) throws NoSuchTopic;
+
+    /**
+     *
+     * Retrieve all topics managed by this topic manager.
+     *
+     * @return A dictionary of string, topic proxy pairs.
+     *
+     **/
+    ["nonmutating", "cpp:const"] idempotent TopicDict retrieveAll();
+
+    /**
+     *
+     * Returns the checksums for the IceStorm Slice definitions.
+     *
+     * @return A dictionary mapping Slice type ids to their checksums.
+     *
+     **/
+    ["nonmutating", "cpp:const"] idempotent Ice::SliceChecksumDict getSliceChecksums();
+}
+
+/**
+ *
+ * This interface is advertised by the IceStorm service through the
+ * Ice object with the identity `IceStorm/Finder'. This allows clients
+ * to retrieve the topic manager with just the endpoint information of
+ * the IceStorm service.
+ *
+ **/
+interface Finder
+{
+    /**
+     *
+     * Get the topic manager proxy. The proxy might point to several
+     * replicas.
+     *
+     * @return The topic manager proxy.
+     *
+     **/
+    TopicManager* getTopicManager();
+}
+
+}

slice/IceStorm/Metrics.ice

@@ -0,0 +1,83 @@
+//
+// Copyright (c) ZeroC, Inc. All rights reserved.
+//
+
+#pragma once
+
+[["cpp:dll-export:ICESTORM_API"]]
+[["cpp:doxygen:include:IceStorm/IceStorm.h"]]
+[["cpp:header-ext:h"]]
+[["cpp:include:IceStorm/Config.h"]]
+
+[["ice-prefix"]]
+
+[["js:module:ice"]]
+[["js:cjs-module"]]
+
+[["objc:dll-export:ICESTORM_API"]]
+[["objc:header-dir:objc"]]
+
+[["python:pkgdir:IceStorm"]]
+
+#include <Ice/Metrics.ice>
+
+#ifndef __SLICE2JAVA_COMPAT__
+[["java:package:com.zeroc"]]
+#endif
+
+["objc:prefix:ICEMX", "swift:module:IceStorm:MX"]
+module IceMX
+{
+
+/**
+ *
+ * Provides information on IceStorm topics.
+ *
+ **/
+class TopicMetrics extends Metrics
+{
+    /**
+     *
+     * Number of events published on the topic by publishers.
+     *
+     **/
+    long published = 0;
+
+    /**
+     *
+     * Number of events forwarded on the topic by IceStorm topic links.
+     *
+     **/
+    long forwarded = 0;
+}
+
+/**
+ *
+ * Provides information on IceStorm subscribers.
+ *
+ **/
+class SubscriberMetrics extends Metrics
+{
+    /**
+     *
+     * Number of queued events.
+     *
+     **/
+    int queued = 0;
+
+    /**
+     *
+     * Number of outstanding events.
+     *
+     **/
+    int outstanding = 0;
+
+    /**
+     *
+     * Number of forwarded events.
+     *
+     **/
+    long delivered = 0;
+}
+
+}

slice2py.py

@@ -0,0 +1,21 @@
+#!/usr/bin/env python3
+#
+# Copyright (c) ZeroC, Inc. All rights reserved.
+#
+
+import sys
+import Ice
+import IcePy
+
+
+def main():
+    sliceDir = Ice.getSliceDir()
+    # Automatically add the slice dir.
+    if sliceDir is not None:
+        sys.argv.append('-I' + sliceDir)
+    val = IcePy.compile(sys.argv)
+    sys.exit(int(val))
+
+
+if __name__ == "__main__":
+    sys.exit(main())

zeroc_ice-3.7.11.dist-info/METADATA

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: zeroc-ice
+Version: 3.7.11
+Summary: Ice is a comprehensive RPC framework with support for Python, C++, .NET, Java, JavaScript and more.
+Author-email: "ZeroC, Inc." <info@zeroc.com>
+License-Expression: GPL-2.0-only
+Project-URL: Homepage, https://zeroc.com/ice
+Project-URL: Repository, https://github.com/zeroc-ice/ice
+Project-URL: Documentation, https://archive.zeroc.com/ice/3.7
+Project-URL: Issues, https://github.com/zeroc-ice/ice/issues
+Project-URL: Changelog, https://github.com/zeroc-ice/ice/blob/3.7/CHANGELOG-3.7.md
+Keywords: ice,RPC
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Ice for Python
+
+[Getting started] | [Examples] | [Documentation] | [Building from source]
+
+The [Ice framework] provides everything you need to build networked applications,
+including RPC, pub/sub, server deployment, and more.
+
+Ice for Python is the Python implementation of the Ice framework.
+
+## Sample Code
+
+```slice
+// Slice definitions (Hello.ice)
+
+module Demo
+{
+    interface Hello
+    {
+        void sayHello();
+    }
+}
+```
+
+```python
+// Client application (client.py)
+import sys
+import Ice
+
+Ice.loadSlice('Hello.ice')
+import Demo
+
+# Ice.initialize returns an initialized Ice communicator, the communicator is destroyed
+# once it goes out of scope.
+with Ice.initialize(sys.argv) as communicator:
+    hello = Demo.HelloPrx.checkedCast(
+        communicator.stringToProxy("hello:default -h localhost -p 10000"))
+    hello.sayHello()
+```
+
+```python
+// Server application (server.py)
+
+import signal
+import sys
+import Ice
+
+Ice.loadSlice('Hello.ice')
+import Demo
+
+class Printer(Demo.Hello):
+    def sayHello(self, current):
+        print("Hello World!")
+
+# Ice.initialize returns an initialized Ice communicator, the communicator is destroyed
+# once it goes out of scope.
+with Ice.initialize(sys.argv) as communicator:
+
+    # Install a signal handler to shutdown the communicator on Ctrl-C
+    signal.signal(signal.SIGINT, lambda signum, frame: communicator.shutdown())
+    if hasattr(signal, 'SIGBREAK'):
+        signal.signal(signal.SIGBREAK, lambda signum, frame: communicator.shutdown())
+    adapter = communicator.createObjectAdapterWithEndpoints("Hello", "default -h localhost -p 10000")
+    adapter.add(Printer(), Ice.stringToIdentity("hello"))
+    adapter.activate()
+    communicator.waitForShutdown()
+```
+
+[Getting started]: https://archive.zeroc.com/ice/3.7/hello-world-application/writing-an-ice-application-with-python
+[Examples]: https://github.com/zeroc-ice/ice-demos/tree/3.7/python
+[Documentation]: https://archive.zeroc.com/ice/3.7
+[Building from source]: https://github.com/zeroc-ice/ice/blob/3.7/python/BUILDING.md
+[Ice framework]: https://github.com/zeroc-ice/ice