Details

Reviewers

epriestley

Group Reviewers

Blessed Reviewers

Maniphest Tasks

T4245: Make repository URIs slightly prettier

Commits

Restricted Diffusion Commit
rPf33e2de09286: make repo callsigns optional

Summary

Ref T4245 Make repo callsigns optional
This is far from done and still very ugly. I'm just submitting it to check if i'm solving this in the right places.
Right now there's three places with duplicate code and building the identifierMap in the CommitQuery is very ugly.
If we only want to support this in the user frontend then i could hack it into the Markup rule itself and not touch the CommitQuery. Even uglier but more limited in scope...

Generally this approach will need a lot of "check this first and then try the other" in a few places.
I could move the Repository queries into a specialised PhabricatorRepositoryQuery method (withCallsignOrID) but i'm not sure about that.

Test Plan

phid.lookup works with R1 and rTEST (which is the same repo)
R1 and rTEST euqally work in remarkup (tested in comments).
Reviewed the following syntax also all works:

rTEST
rTESTd773137a7cb9
rTEST:d773137a7cb9
R1
R1:d773137a7cb9
d773137a7cb9
{rTEST}
{rTESTd773137a7cb9}
{rTEST:d773137a7cb9}
rJX Javelin
{R1:d773137a7cb9}
{d773137a7cb9}

Diff Detail

Repository

rP Phabricator

Branch

repocallsigns

Lint

Lint Passed

Unit

Tests Passed

Build Status

Buildable 3393
Build 3400: [Placeholder Plan] Wait for 30 Seconds

Event Timeline

fabe updated this revision to Diff 26532.Dec 29 2014, 3:32 PM

fabe retitled this revision from to make repo callsigns optional.

fabe updated this object.

fabe edited the test plan for this revision. (Show Details)

fabe added a task: T4245: Make repository URIs slightly prettier.

Herald added a reviewer: Blessed Reviewers. · View Herald TranscriptDec 29 2014, 3:32 PM

Herald added a subscriber: epriestley. · View Herald Transcript

Yep, this is on the right track.

I could move the Repository queries into a specialised PhabricatorRepositoryQuery method (withCallsignOrID) but i'm not sure about that.

Yeah, I think this is a good idea. It would have the added advantage of letting us issue one query instead of two in the cases where there's both a callsign and an ID (these will probably be very rare, but maybe not).

I wouldn't worry too much about deduplicating the regexps. If there are cases where it's easy, go for it, but at least with other rules they tend to be matching slightly different things or matching in slightly different contexts, and we sometimes end up needing slightly different rules (for example, IIRC #project. is a valid project hashtag, but if you type #project. in a comment we assume you meant #project + ., because 99.9% of the time that's what users meant, so the two places use slightly different regexps. T6818 has a similar case where we'll adjust the regexp used in one context but not in the other).

For the projects stuff, at least, just getting test coverage (here, in DiffusionCommitRemarkupRuleTestCase) has worked better than trying to make sure we never duplicate regexps.

src/applications/diffusion/query/DiffusionCommitQuery.php
373–380	We should check for `if ($callsigns)` and `if ($ids)` before issuing these queries.
378	Consider `ctype_digit()` instead of `is_numeric` because values like "0.0", "1e5", and "-3" satisfy `is_numeric()`. (I think it doesn't matter in this case, but it's nice to do the stricter check when we have stricter expectations about the input.)

This revision now requires changes to proceed.Dec 29 2014, 4:03 PM

first stage of cleanup. PhabricatorRepositoryQuery now builds an identifierMap (just like the DiffusionCommitQuery supports)
and also allows searching for multiple different kinds of identifiers at the same time (ids, phid, callsigns)
building the identifierMap in CommitQuery is still a mess and work in progress

Herald added a subscriber: Korvin. · View Herald TranscriptDec 30 2014, 10:08 AM

api actually was that way all along

clean up CommitQuery identifierMap generation.
I tried to refactor it completely but was unable to achieve O(n) in any other way as it is.

found out about non capturing syntax for regexes and fixed the unit test :)

added a few more test cases for the new repos without callsigns

Some inlines, this is looking really good.

One thought is that ideally we shouldn't recognize r123, because this is commonly used in Subversion to refer to a specific commit, and I worry it will be confusing for subversion users if we treat it as a repository reference. We can recognize R123 instead. I think this is just a matter of tweaking the regular expressions, though.

src/applications/diffusion/query/DiffusionCommitQuery.php
338	Prefer `$commit_identifier`, for consistency. This is actually a bug with lint, which should have caught this automatically. D11087 should have a fix for it.
src/applications/repository/phid/PhabricatorRepositoryRepositoryPHIDType.php
47	On the `r` vs `R` thing, this would just become something like `/^(?:r[A-Z]+\|R[0-9]+)$/`, I think.
65–71	It looks like removing this code might incorrectly remove the "r" from the result map?
src/applications/repository/query/PhabricatorRepositoryQuery.php
60–63	I think we should either disallow this "r" stripping, or preserve it in `getIdentifierMap()`. That is, if you make a call like: ->withIdentifiers(array('r1')) ...and the query finds a matching result, the key `r1` (i.e., the exact key you passed in) should always be present in the identifier map. Otherwise you have to trim the "r" off yourself to figure out which result matches, and you might as well do that in the first place.
68	You can use this to identify repository PHIDs: $repository_type = PhabricatorRepositoryRepositoryPHIDType::TYPECONST; if (phid_get_type($identifier) === $repository_type) { // ... } (It's not perfect, but should always behave in reasonable/expected ways.)
456–460	I think it might be cleaner to not reuse the `ids` and `phids` property to construct this clause. One issue with the current approach is that this: $some_query ->withIdentifiers(array('1', 'X')) ->withPHIDs(array('the-PHID-of-repository-1', 'the-phid-of-repository-Q')) ...will incorrectly select repositories r1, rX, and rQ, when it should select only repository r1. You could just define separate properties like: public function withIdentifiers(array $identifiers) { // ... split them up ... $this->numericIdentifiers = $numbery_ones; $this->callsignIdentifiers = $callsigney_ones; } ...and then do this: if ($this->numericIdentifiers \|\| $this->callsignIdentifiers) { $identifier_clause = array(); if ($this->numericIdentifiers) { $identifier_cause[] = qsprintf(...); } if ($this->callsignIdentifiers) { $identifier_clause[] = qsprinf(...); } $where[] = '('.implode(') OR (', $identifier_clause).')'; } Then `withIdentifiers()` will interact as expected with calls separate calls to `withIDs()`, `withPHIDs()`, and `withCallsigns()`.

This revision now requires changes to proceed.Dec 30 2014, 3:21 PM

PhabricatorRepositoryQuery now disallows leading 'r' and classes using it have to strip / attach it themselves. Preserving it in the identifierMap leads to much worse problems.
Refactored the Query to use it's own private variables and added phid support.
I'll change the r1 rTEST vs. R1 rTEST next

sry, i'll have to do this tomorrow. Somehow the RepositoryRemarkupRule doesen't allow me not to specify a word prefix (just like in the commit Remarkup rule)...

now only allow R123 R123:commit rTEST rTEST:1234
lowercase r for callsigns and uppercase for IDs

rPHUba927e22f98477e8a8aed28459391dd8ff512ae0
rPHUba927
rPHU:ba927e22f98477e8a8aed28459391dd8ff512ae0
rPHU:ba927
R2:ba927e22f98477e8a8aed28459391dd8ff512ae0
R2:ba927
R2
rPHU

rPHUba927e22f984: Implement kvcache profiling with a proxy instead of in each cache
rPHUba927e22f984: Implement kvcache profiling with a proxy instead of in each cache
rPHUba927e22f984: Implement kvcache profiling with a proxy instead of in each cache
rPHUba927e22f984: Implement kvcache profiling with a proxy instead of in each cache
{R2:ba927e22f98477e8a8aed28459391dd8ff512ae0}
{R2:ba927}
rARC Arcanist
rPHU libphutil

some samples. (replace ID2 with the id of the libphutil repo)

src/applications/diffusion/application/PhabricatorDiffusionApplication.php
45 ↗	(On Diff #26707)	This somehow only works when inserted at the end of this array. I was unable to do this with only one remarkup rule and i've got no idea why this now works when placed here. Are remarkup rules applied here when another one already matched?

Let me see if I can figure out the order thing, everything else looks good to me.

src/applications/diffusion/application/PhabricatorDiffusionApplication.php
45 ↗	(On Diff #26707)	Hmm, I'm surprised that these are order-dependent. Using two separate rules seems reasonable to me, though. Let me poke around at this locally...
src/applications/repository/query/PhabricatorRepositoryQuery.php
464	This should be `%Ld` (list of integers) vs `%Ls` (list of strings).

Ah -- the order thing is because the rules internally get sorted by getPriority(), and the sort isn't stable, so they're kind of ending up executing in "random" order.

After sorting, DiffusionRepositoryRemarkupRule happens to end up after DiffusionCommitRemarkupRule, but DiffusionRepositoryByIDRemarkupRule does not unless you put it at the end of the array and get lucky.

Both "Repository" and "RepositoryByID" should run after "Commit". If they don't, they consume the rAB or R12 prefix and leave an internal token in its place, so the commit rule can no longer match.

To enforce this, just implement getPriority() on both rules and have it return 460.0;. This will make sure they run after the Commit rule, which runs at priority 450.

src/applications/repository/query/PhabricatorRepositoryQuery.php
240–241	We should initialize the identifier map in `loadPage()`, before executing the query: if ($this->identifierMap === null) { $this->identifierMap = array(); } Two reasons: willFilterPage() may get called multiple times in one query. For example, if the caller requests 100 results, and we load 100 rows but then privacy-filter 50 of them, we'll go load another 100 results to complete the request. If the query returns 0 results, willFilterPage() won't get called at all, so getIdentifierMap() will throw an exception ("you must call execute()") instead of returning an empty array.

This revision now requires changes to proceed.Jan 1 2015, 3:24 PM

enforce order of markup rules by setting priority (now works as expected)
initialize identifierMap only once loadPage() instead of willFilterPage()
%Ld instead of %Ls

Thanks for tracking this down!

Thanks!

This revision is now accepted and ready to land.Jan 1 2015, 4:07 PM

Closed by commit rPf33e2de09286: make repo callsigns optional (authored by fabe, committed by epriestley). · Explain WhyJan 1 2015, 4:07 PM

This revision was automatically updated to reflect the committed changes.

techdragon added a subscriber: techdragon.Feb 28 2015, 12:33 PM

techdragon mentioned this in T4245: Make repository URIs slightly prettier.Feb 28 2015, 1:11 PM

make repo callsigns optional
ClosedPublic
Actions

Details

Diff Detail

Event Timeline

Revision Contents
Changeset List

Diff 26617

src/applications/diffusion/query/DiffusionCommitQuery.php

src/applications/diffusion/remarkup/DiffusionCommitRemarkupRule.php

src/applications/diffusion/remarkup/DiffusionRepositoryRemarkupRule.php

src/applications/diffusion/remarkup/tests/DiffusionCommitRemarkupRuleTestCase.php

src/applications/repository/phid/PhabricatorRepositoryCommitPHIDType.php

src/applications/repository/phid/PhabricatorRepositoryRepositoryPHIDType.php

src/applications/repository/query/PhabricatorRepositoryQuery.php

make repo callsigns optionalClosedPublicActions

Details

Diff Detail

Event Timeline

Revision ContentsChangeset List

Diff 26617

src/applications/diffusion/query/DiffusionCommitQuery.php

src/applications/diffusion/remarkup/DiffusionCommitRemarkupRule.php

src/applications/diffusion/remarkup/DiffusionRepositoryRemarkupRule.php

src/applications/diffusion/remarkup/__tests__/DiffusionCommitRemarkupRuleTestCase.php

src/applications/repository/phid/PhabricatorRepositoryCommitPHIDType.php

src/applications/repository/phid/PhabricatorRepositoryRepositoryPHIDType.php

src/applications/repository/query/PhabricatorRepositoryQuery.php

make repo callsigns optional
ClosedPublic
Actions

Revision Contents
Changeset List

src/applications/diffusion/remarkup/tests/DiffusionCommitRemarkupRuleTestCase.php