1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

#![ cfg_attr( nightly, feature( doc_cfg ) ) ]
#![ doc = include_str!( "../README.md" ) ]

#![ doc    ( html_root_url = "https://docs.rs/pharos" ) ]
#![ deny   ( missing_docs                             ) ]
#![ forbid ( unsafe_code                              ) ]
#![ allow  ( clippy::suspicious_else_formatting       ) ]

#![ warn
(
	missing_debug_implementations ,
	missing_docs                  ,
	nonstandard_style             ,
	rust_2018_idioms              ,
	trivial_casts                 ,
	trivial_numeric_casts         ,
	unused_extern_crates          ,
	unused_qualifications         ,
	single_use_lifetimes          ,
	unreachable_pub               ,
	variant_size_differences      ,
)]


mod error         ;
mod events        ;
mod observable    ;
mod pharos        ;
mod filter        ;
mod shared_pharos ;



pub use
{
	self::pharos :: { Pharos                                              } ,
	filter       :: { Filter                                              } ,
	observable   :: { Observable, ObservableLocal, ObserveConfig, Channel } ,
	events       :: { Events                                              } ,
	error        :: { PharErr, ErrorKind                                  } ,
	shared_pharos:: { SharedPharos                                        } ,
};


mod import
{
	pub(crate) use
	{
		std            :: { fmt, error::Error as ErrorTrait, ops::Deref, any::type_name  } ,
		std            :: { task::{ Poll, Context }, pin::Pin, future::Future, sync::Arc } ,
		futures        :: { Stream, Sink, SinkExt, ready, future::FutureExt, lock::Mutex } ,

		futures::channel::mpsc::
		{
			self                                      ,
			Sender            as FutSender            ,
			Receiver          as FutReceiver          ,
			UnboundedSender   as FutUnboundedSender   ,
			UnboundedReceiver as FutUnboundedReceiver ,
			SendError         as FutSendError         ,
		},
	};

	#[ cfg( test ) ]
	//
	pub(crate) use
	{
		assert_matches :: { assert_matches                      } ,
		futures        :: { future::poll_fn, executor::block_on } ,
	};
}

use import::*;


/// A pinned boxed future returned by the Observable::observe method.
//
pub type Observe<'a, Event, Error> = Pin<Box< dyn Future< Output = Result<Events<Event>, Error> > + 'a + Send >>;

/// A pinned boxed future returned by the ObservableLocal::observe_local method.
//
pub type ObserveLocal<'a, Event, Error> = Pin<Box< dyn Future< Output = Result<Events<Event>, Error> > + 'a >>;