twitter 4.4.1 → 4.4.2

data/spec/twitter/api/search_spec.rb

@@ -11,18 +11,18 @@ describe Twitter::API::Search do
       stub_get("/1.1/search/tweets.json").with(:query => {:q => "twitter"}).to_return(:body => fixture("search.json"), :headers => {:content_type => "application/json; charset=utf-8"})
     end
     it "requests the correct resource" do
-      @client.search('twitter')
+      @client.search("twitter")
       expect(a_get("/1.1/search/tweets.json").with(:query => {:q => "twitter"})).to have_been_made
     end
     it "returns recent Tweets related to a query with images and videos embedded" do
-      search = @client.search('twitter')
+      search = @client.search("twitter")
       expect(search).to be_a Twitter::SearchResults
       expect(search.results).to be_an Array
       expect(search.results.first).to be_a Twitter::Tweet
       expect(search.results.first.text).to eq "Bubble Mailer #freebandnames"
     end
     it "returns the max_id value for a search result" do
-      search = @client.search('twitter')
+      search = @client.search("twitter")
       expect(search.max_id).to eq 250126199840518145
     end
 
@@ -32,7 +32,7 @@ describe Twitter::API::Search do
       end
 
       it "returns an empty array" do
-        search = @client.search('twitter')
+        search = @client.search("twitter")
         expect(search.results).to be_an Array
         expect(search.results).to be_empty
       end

data/spec/twitter/api/suggested_users_spec.rb

@@ -56,39 +56,4 @@ describe Twitter::API::SuggestedUsers do
     end
   end
 
-  describe "#following_followers_of" do
-    context "with a screen_name passed" do
-      before do
-        stub_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"}).to_return(:body => fixture("users_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-      end
-      it "requests the correct resource" do
-        @client.following_followers_of("sferik")
-        expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"})).to have_been_made
-      end
-      it "returns an array of numeric IDs for every user following the specified user" do
-        following_followers_of = @client.following_followers_of("sferik")
-        expect(following_followers_of).to be_a Twitter::Cursor
-        expect(following_followers_of.users).to be_an Array
-        expect(following_followers_of.users.first).to be_a Twitter::User
-      end
-    end
-    context "without arguments passed" do
-      before do
-        stub_get("/1.1/account/verify_credentials.json").to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-        stub_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"}).to_return(:body => fixture("users_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-      end
-      it "requests the correct resource" do
-        @client.following_followers_of
-        expect(a_get("/1.1/account/verify_credentials.json")).to have_been_made
-        expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"})).to have_been_made
-      end
-      it "returns an array of numeric IDs for every user following the specified user" do
-        following_followers_of = @client.following_followers_of
-        expect(following_followers_of).to be_a Twitter::Cursor
-        expect(following_followers_of.users).to be_an Array
-        expect(following_followers_of.users.first).to be_a Twitter::User
-      end
-    end
-  end
-
 end

data/spec/twitter/api/undocumented_spec.rb

@@ -49,6 +49,35 @@ describe Twitter::API::Undocumented do
         expect(following_followers_of.users).to be_an Array
         expect(following_followers_of.users.first).to be_a Twitter::User
       end
+      context "with all" do
+        before do
+          stub_get("/users/following_followers_of.json").with(:query => {:cursor => "1322801608223717003", :screen_name => "sferik"}).to_return(:body => fixture("users_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+        it "requests the correct resource" do
+          @client.following_followers_of("sferik").all
+          expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"})).to have_been_made
+          expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "1322801608223717003", :screen_name => "sferik"})).to have_been_made
+        end
+      end
+    end
+    context "with a user ID passed" do
+      before do
+        stub_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :user_id => "7505382"}).to_return(:body => fixture("users_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.following_followers_of(7505382)
+        expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :user_id => "7505382"})).to have_been_made
+      end
+      context "with all" do
+        before do
+          stub_get("/users/following_followers_of.json").with(:query => {:cursor => "1322801608223717003", :user_id => "7505382"}).to_return(:body => fixture("users_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+        it "requests the correct resource" do
+          @client.following_followers_of(7505382).all
+          expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :user_id => "7505382"})).to have_been_made
+          expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "1322801608223717003", :user_id => "7505382"})).to have_been_made
+        end
+      end
     end
     context "without arguments passed" do
       before do
@@ -66,6 +95,16 @@ describe Twitter::API::Undocumented do
         expect(following_followers_of.users).to be_an Array
         expect(following_followers_of.users.first).to be_a Twitter::User
       end
+      context "with all" do
+        before do
+          stub_get("/users/following_followers_of.json").with(:query => {:cursor => "1322801608223717003", :screen_name => "sferik"}).to_return(:body => fixture("users_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+        it "requests the correct resource" do
+          @client.following_followers_of.all
+          expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"})).to have_been_made
+          expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "1322801608223717003", :screen_name => "sferik"})).to have_been_made
+        end
+      end
     end
   end
 

data/spec/twitter/api/users_spec.rb

@@ -18,7 +18,7 @@ describe Twitter::API::Users do
     it "returns settings" do
       settings = @client.settings
       expect(settings).to be_a Twitter::Settings
-      expect(settings.language).to eq 'en'
+      expect(settings.language).to eq "en"
     end
     it "requests the correct resource on POST" do
       @client.settings(:trend_location_woeid => "23424803")
@@ -27,7 +27,7 @@ describe Twitter::API::Users do
     it "returns settings" do
       settings = @client.settings(:trend_location_woeid => "23424803")
       expect(settings).to be_a Twitter::Settings
-      expect(settings.language).to eq 'en'
+      expect(settings.language).to eq "en"
     end
   end
 
@@ -186,6 +186,16 @@ describe Twitter::API::Users do
       expect(blocking.users.first).to be_a Twitter::User
       expect(blocking.users.first.id).to eq 7505382
     end
+    context "with all" do
+      before do
+        stub_get("/1.1/blocks/list.json").with(:query => {:cursor => "1322801608223717003"}).to_return(:body => fixture("users_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.blocking.all
+        expect(a_get("/1.1/blocks/list.json").with(:query => {:cursor => "-1"})).to have_been_made
+        expect(a_get("/1.1/blocks/list.json").with(:query => {:cursor => "1322801608223717003"})).to have_been_made
+      end
+    end
   end
 
   describe "#blocked_ids" do
@@ -202,6 +212,16 @@ describe Twitter::API::Users do
       expect(blocked_ids.ids).to be_an Array
       expect(blocked_ids.ids.first).to eq 14100886
     end
+    context "with all" do
+      before do
+        stub_get("/1.1/blocks/ids.json").with(:query => {:cursor => "1305102810874389703"}).to_return(:body => fixture("ids_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.blocked_ids.all
+        expect(a_get("/1.1/blocks/ids.json").with(:query => {:cursor => "-1"})).to have_been_made
+        expect(a_get("/1.1/blocks/ids.json").with(:query => {:cursor => "1305102810874389703"})).to have_been_made
+      end
+    end
   end
 
   describe "#block?" do
@@ -244,7 +264,7 @@ describe Twitter::API::Users do
         stub_get("/1.1/blocks/ids.json").with(:query => {:cursor => "1305102810874389703"}).to_return(:body => fixture("ids_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
       end
       it "requests the correct resources" do
-        user = Twitter::User.new(:id => '7505382')
+        user = Twitter::User.new(:id => "7505382")
         @client.block?(user)
         expect(a_get("/1.1/blocks/ids.json").with(:query => {:cursor => "-1"})).to have_been_made
         expect(a_get("/1.1/blocks/ids.json").with(:query => {:cursor => "1305102810874389703"})).to have_been_made
@@ -333,8 +353,8 @@ describe Twitter::API::Users do
           stub_post("/1.1/users/lookup.json").with(:body => {:user_id => "7505382,14100886"}).to_return(:body => fixture("users.json"), :headers => {:content_type => "application/json; charset=utf-8"})
         end
         it "requests the correct resource" do
-          user1 = Twitter::User.new(:id => '7505382')
-          user2 = Twitter::User.new(:id => '14100886')
+          user1 = Twitter::User.new(:id => "7505382")
+          user2 = Twitter::User.new(:id => "14100886")
           @client.users(user1, user2)
           expect(a_post("/1.1/users/lookup.json").with(:body => {:user_id => "7505382,14100886"})).to have_been_made
         end
@@ -389,8 +409,8 @@ describe Twitter::API::Users do
           stub_get("/1.1/users/lookup.json").with(:query => {:user_id => "7505382,14100886"}).to_return(:body => fixture("users.json"), :headers => {:content_type => "application/json; charset=utf-8"})
         end
         it "requests the correct resource" do
-          user1 = Twitter::User.new(:id => '7505382')
-          user2 = Twitter::User.new(:id => '14100886')
+          user1 = Twitter::User.new(:id => "7505382")
+          user2 = Twitter::User.new(:id => "14100886")
           @client.users(user1, user2, :method => :get)
           expect(a_get("/1.1/users/lookup.json").with(:query => {:user_id => "7505382,14100886"})).to have_been_made
         end
@@ -523,6 +543,15 @@ describe Twitter::API::Users do
         expect(contributees.first.name).to eq "Twitter API"
       end
     end
+    context "with a user ID passed" do
+      before do
+        stub_get("/1.1/users/contributees.json").with(:query => {:user_id => "7505382"}).to_return(:body => fixture("contributees.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.contributees(7505382)
+        expect(a_get("/1.1/users/contributees.json").with(:query => {:user_id => "7505382"})).to have_been_made
+      end
+    end
     context "without arguments passed" do
       before do
         stub_get("/1.1/account/verify_credentials.json").to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
@@ -544,7 +573,6 @@ describe Twitter::API::Users do
   describe "#contributors" do
     context "with a screen name passed" do
       before do
-        stub_get("/1.1/account/verify_credentials.json").to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
         stub_get("/1.1/users/contributors.json").with(:query => {:screen_name => "sferik"}).to_return(:body => fixture("contributors.json"), :headers => {:content_type => "application/json; charset=utf-8"})
       end
       it "requests the correct resource" do
@@ -558,6 +586,15 @@ describe Twitter::API::Users do
         expect(contributors.first.name).to eq "Biz Stone"
       end
     end
+    context "with a user ID passed" do
+      before do
+        stub_get("/1.1/users/contributors.json").with(:query => {:user_id => "7505382"}).to_return(:body => fixture("contributors.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.contributors(7505382)
+        expect(a_get("/1.1/users/contributors.json").with(:query => {:user_id => "7505382"})).to have_been_made
+      end
+    end
     context "without arguments passed" do
       before do
         stub_get("/1.1/account/verify_credentials.json").to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
@@ -576,41 +613,6 @@ describe Twitter::API::Users do
     end
   end
 
-  describe "#following_followers_of" do
-    context "with a screen_name passed" do
-      before do
-        stub_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"}).to_return(:body => fixture("users_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-      end
-      it "requests the correct resource" do
-        @client.following_followers_of("sferik")
-        expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"})).to have_been_made
-      end
-      it "returns an array of numeric IDs for every user following the specified user" do
-        following_followers_of = @client.following_followers_of("sferik")
-        expect(following_followers_of).to be_a Twitter::Cursor
-        expect(following_followers_of.users).to be_an Array
-        expect(following_followers_of.users.first).to be_a Twitter::User
-      end
-    end
-    context "without arguments passed" do
-      before do
-        stub_get("/1.1/account/verify_credentials.json").to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-        stub_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"}).to_return(:body => fixture("users_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-      end
-      it "requests the correct resource" do
-        @client.following_followers_of
-        expect(a_get("/1.1/account/verify_credentials.json")).to have_been_made
-        expect(a_get("/users/following_followers_of.json").with(:query => {:cursor => "-1", :screen_name => "sferik"})).to have_been_made
-      end
-      it "returns an array of numeric IDs for every user following the specified user" do
-        following_followers_of = @client.following_followers_of
-        expect(following_followers_of).to be_a Twitter::Cursor
-        expect(following_followers_of.users).to be_an Array
-        expect(following_followers_of.users.first).to be_a Twitter::User
-      end
-    end
-  end
-
   describe "#remove_profile_banner" do
     before do
       stub_post("/1.1/account/remove_profile_banner.json").to_return(:body => fixture("empty.json"), :headers => {:content_type => "application/json; charset=utf-8"})
@@ -639,22 +641,31 @@ describe Twitter::API::Users do
     end
   end
 
-  describe '#profile_banner' do
+  describe "#profile_banner" do
     context "with a screen_name passed" do
       before do
         stub_get("/1.1/users/profile_banner.json").with(:query => {:screen_name => "sferik"}).to_return(:body => fixture("profile_banner.json"), :headers => {:content_type => "application/json; charset=utf-8"})
       end
       it "requests the correct resource" do
-        @client.profile_banner('sferik')
+        @client.profile_banner("sferik")
         expect(a_get("/1.1/users/profile_banner.json").with(:query => {:screen_name => "sferik"})).to have_been_made
       end
       it "returns a user's profile banner" do
-        banner = @client.profile_banner('sferik')
+        banner = @client.profile_banner("sferik")
         expect(banner).to be_a Twitter::ProfileBanner
         expect(banner.sizes).to be_a Hash
         expect(banner.sizes[:mobile].height).to eq 160
       end
     end
+    context "with a user ID passed" do
+      before do
+        stub_get("/1.1/users/profile_banner.json").with(:query => {:user_id => "7505382"}).to_return(:body => fixture("profile_banner.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.profile_banner(7505382)
+        expect(a_get("/1.1/users/profile_banner.json").with(:query => {:user_id => "7505382"})).to have_been_made
+      end
+    end
     context "without arguments passed" do
       before do
         stub_get("/1.1/account/verify_credentials.json").to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})

data/twitter.gemspec

@@ -5,16 +5,10 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'faraday', '~> 0.8'
   spec.add_dependency 'multi_json', '~> 1.3'
   spec.add_dependency 'simple_oauth', '~> 0.2'
-  spec.add_development_dependency 'json'
   spec.add_development_dependency 'kramdown'
   spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'pry-nav'
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'pry-debugger'
   spec.add_development_dependency 'simplecov'
-  spec.add_development_dependency 'timecop'
-  spec.add_development_dependency 'webmock'
-  spec.add_development_dependency 'yard'
   spec.authors = ["John Nunemaker", "Wynn Netherland", "Erik Michaels-Ober", "Steve Richert"]
   spec.description = %q{A Ruby interface to the Twitter API.}
   spec.email = ['nunemaker@gmail.com', 'wynn.netherland@gmail.com', 'sferik@gmail.com', 'steve.richert@gmail.com']

metadata

@@ -2,7 +2,7 @@
 name: twitter
 version: !ruby/object:Gem::Version
   prerelease: 
-  version: 4.4.1
+  version: 4.4.2
 platform: ruby
 authors:
 - John Nunemaker
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-08 00:00:00.000000000 Z
+date: 2012-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
@@ -62,22 +62,6 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.2'
     none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: json
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -117,39 +101,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
     none: false
-  name: pry-nav
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: rake
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: rspec
+  name: pry-debugger
   type: :development
   prerelease: false
   requirement: !ruby/object:Gem::Requirement
@@ -174,54 +126,6 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
     none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: timecop
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: webmock
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: yard
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
 description: A Ruby interface to the Twitter API.
 email:
 - nunemaker@gmail.com
@@ -348,9 +252,11 @@ files:
 - spec/fixtures/enhance_your_calm.text
 - spec/fixtures/favorites.json
 - spec/fixtures/followers_list.json
+- spec/fixtures/followers_list2.json
 - spec/fixtures/following.json
 - spec/fixtures/forbidden.json
 - spec/fixtures/friends_list.json
+- spec/fixtures/friends_list2.json
 - spec/fixtures/friendships.json
 - spec/fixtures/ids.json
 - spec/fixtures/ids_list.json
@@ -366,6 +272,7 @@ files:
 - spec/fixtures/media_timeline.json
 - spec/fixtures/members.json
 - spec/fixtures/memberships.json
+- spec/fixtures/memberships2.json
 - spec/fixtures/not_acceptable.json
 - spec/fixtures/not_following.json
 - spec/fixtures/not_found.json
@@ -397,6 +304,7 @@ files:
 - spec/fixtures/status_with_media.json
 - spec/fixtures/statuses.json
 - spec/fixtures/subscriptions.json
+- spec/fixtures/subscriptions2.json
 - spec/fixtures/suggestions.json
 - spec/fixtures/tos.json
 - spec/fixtures/totals.json
@@ -409,6 +317,7 @@ files:
 - spec/fixtures/user_timeline.json
 - spec/fixtures/users.json
 - spec/fixtures/users_list.json
+- spec/fixtures/users_list2.json
 - spec/fixtures/video_facets.json
 - spec/fixtures/we_concept_bg2.png
 - spec/fixtures/wildcomet2.jpe
@@ -514,9 +423,11 @@ test_files:
 - spec/fixtures/enhance_your_calm.text
 - spec/fixtures/favorites.json
 - spec/fixtures/followers_list.json
+- spec/fixtures/followers_list2.json
 - spec/fixtures/following.json
 - spec/fixtures/forbidden.json
 - spec/fixtures/friends_list.json
+- spec/fixtures/friends_list2.json
 - spec/fixtures/friendships.json
 - spec/fixtures/ids.json
 - spec/fixtures/ids_list.json
@@ -532,6 +443,7 @@ test_files:
 - spec/fixtures/media_timeline.json
 - spec/fixtures/members.json
 - spec/fixtures/memberships.json
+- spec/fixtures/memberships2.json
 - spec/fixtures/not_acceptable.json
 - spec/fixtures/not_following.json
 - spec/fixtures/not_found.json
@@ -563,6 +475,7 @@ test_files:
 - spec/fixtures/status_with_media.json
 - spec/fixtures/statuses.json
 - spec/fixtures/subscriptions.json
+- spec/fixtures/subscriptions2.json
 - spec/fixtures/suggestions.json
 - spec/fixtures/tos.json
 - spec/fixtures/totals.json
@@ -575,6 +488,7 @@ test_files:
 - spec/fixtures/user_timeline.json
 - spec/fixtures/users.json
 - spec/fixtures/users_list.json
+- spec/fixtures/users_list2.json
 - spec/fixtures/video_facets.json
 - spec/fixtures/we_concept_bg2.png
 - spec/fixtures/wildcomet2.jpe