The uWSGI server automagically adds a uwsgi module into your Python apps.
This is useful for configuring the uWSGI server, use its internal functions and get statistics. Also useful for detecting whether you’re actually running under uWSGI; if you attempt to import uwsgi and receive an ImportError you’re not running under uWSGI.
Note
Many of these functions are currently woefully undocumented.
Module-level globals¶The number of processes/workers currently running.
The current configured buffer size in bytes.
The Unix timestamp of uWSGI’s startup.
This is the dictionary used to define FastFuncs.
This is the list of applications currently configured.
This is the dynamic applications dictionary.
The callable to run when the uWSGI server receives a marshalled message.
The magic table of configuration placeholders.
The current configuration options, including any custom placeholders.
Get a value from the cache.
key – The cache key to read.
cache_name – The name of the cache in multiple cache mode (can be in the form name@address). Optional.
Set a value in the cache. If the key is already set but not expired, it doesn’t set anything.
key – The cache key to write.
value – The cache value to write.
expire – Expiry time of the value, in seconds.
cache_name – The name of the cache in multiple cache mode (can be in the form name@address). Optional.
Update a value in the cache. This always sets the key, whether it was already set before or not and whether it has expired or not.
key – The cache key to write.
value – The cache value to write.
expire – Expiry time of the value, in seconds.
cache_name – The name of the cache in multiple cache mode (can be in the form name@address). Optional.
Delete the given cached value from the cache.
key – The cache key to delete.
cache_name – The name of the cache in multiple cache mode (can be in the form name@address). Optional.
Quickly check whether there is a value in the cache associated with the given key.
key – The cache key to check.
cache_name – The name of the cache in multiple cache mode (can be in the form name@address). Optional.
str – The string containing the new community value.
Sets the SNMP community string.
oidnum – An integer containing the oid number target.
value – An integer containing the new value of the counter or gauge.
Sets the counter or gauge to a specific value.
oidnum – An integer containing the oid number target.
value – An integer containing the amount to increase or decrease the counter or gauge. If not specified the default is 1.
Increases or decreases the counter or gauge by a specific amount.
Note
uWSGI OID tree starts at 1.3.6.1.4.1.35156.17
message_dict – The message (string keys, string values) to spool. Either this, or **kwargs may be set.
spooler – The spooler (id or directory) to use.
priority – The priority of the message. Larger = less important.
at – The minimum UNIX timestamp at which this message should be processed.
body – A binary (bytestring) body to add to the message, in addition to the message dictionary itself. Its value will be available in the key body in the message.
Send data to the The uWSGI Spooler. Also known as spool().
Note
Any of the keyword arguments may also be passed in the message dictionary. This means they’re reserved words, in a way…
Set how often the spooler runs.
path – The relative or absolute path to the task to read
Send a generic message using The uwsgi Protocol.
Note
Until version 2f970ce58543278c851ff30e52758fd6d6e69fdc this function was called send_uwsgi_message().
Send a generic message to multiple recipients using The uwsgi Protocol.
Note
Until version 2f970ce58543278c851ff30e52758fd6d6e69fdc this function was called send_multi_uwsgi_message().
See also
Clustering for examples
Set the accepting flag of the current worker to the value. This is required when using `Overriding Workers`_ and touch-chain-reload at the same time.
Gracefully reload the uWSGI server stack.
Get a statistics dictionary of all the workers for the current server. A dictionary is returned.
Return the process identifier (PID) of the uWSGI master process.
Returns the total number of requests managed so far by the pool of uWSGI workers.
Also available as getoption().
Also available as setoption().
locknum – The lock number to lock. Lock 0 is always available.
locknum – The lock number to unlock. Lock 0 is always available.
num – the signal number to configure
who –
a magic string that will set which process/processes receive the signal.
worker/worker0 will send the signal to the first available worker. This is the default if you specify an empty string.
workers will send the signal to every worker.
workerN (N > 0) will send the signal to worker N.
mule/mule0 will send the signal to the first available mule. (See uWSGI Mules)
mules will send the signal to all mules
muleN (N > 0) will send the signal to mule N.
cluster will send the signal to all the nodes in the cluster. Warning: not implemented.
subscribed will send the signal to all subscribed nodes. Warning: not implemented.
spooler will send the signal to the spooler.
cluster and subscribed are special, as they will send the signal to the master of all cluster/subscribed nodes. The other nodes will have to define a local handler though, to avoid a terrible signal storm loop.
function – A callable that takes a single numeric argument.
num – the signal number to raise
Block the process/thread/async core until a signal is received. Use signal_received to get the number of the signal received. If a registered handler handles a signal, signal_wait will be interrupted and the actual handler will handle the signal.
signum – Optional - the signal to wait for
Get the number of the last signal received. Used in conjunction with signal_wait.
signum – The signal number to raise.
seconds – The interval at which to raise the signal.
Add an user-space (red-black tree backed) timer.
signum – The signal number to raise.
seconds – The interval at which to raise the signal.
iterations – How many times to raise the signal. 0 (the default) means infinity.
For the time parameters, you may use the syntax -n to denote “every n”. For instance hour=-2 would declare the signal to be sent every other hour.
signal – The signal number to raise.
minute – The minute on which to run this event.
hour – The hour on which to run this event.
day – The day on which to run this event. This is “OR”ed with weekday.
month – The month on which to run this event.
weekday – The weekday on which to run this event. This is “OR”ed with day. (In accordance with the POSIX standard, 0 is Sunday, 6 is Monday)
string – The symbol name to extract.
Extracts a symbol from the uWSGI binary image.
string – The bytestring message to send.
id – Optional - the mule ID to receive the message. If you do not specify an ID, the message will go to the first available programmed mule.
Send a message to a mule.
farm_name – The name of the farm to send the message to.
string – The bytestring message to send.
Send a message to a mule farm.
A mule message, once one is received.
Block until a mule message is received and return it. This can be called from multiple threads in the same programmed mule.
A mule message, once one is received.
Block until a mule message is received and return it. Only messages sent to the mule’s configured farm will be received. This can be called from multiple threads in the same programmed mule.
True if the mule is a member of a farm, False otherwise.
bool
Indicate whether the mule is a member of a farm.
Suspend handling the current request for seconds seconds and pass control to the next async core.
seconds – Sleep time, in seconds.
Suspend handling the current request and pass control to the next async core clamoring for attention.
Suspend handling the current request until there is something to be read on file descriptor fd. May be called several times before yielding/suspending to add more file descriptors to the set to be watched.
fd – File descriptor number.
timeout – Optional timeout (infinite if omitted).
Suspend handling the current request until there is nothing more to be written on file descriptor fd. May be called several times to add more file descriptors to the set to be watched.
fd – File descriptor number.
timeout – Optional timeout (infinite if omitted).
File descriptor or -1 on error
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4