zeroc-ice 3.7.10.1__cp312-cp312-macosx_14_0_arm64.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 inferface 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())